Image Modified
BRIDGE API - REST - Cambio de Estado del Pedido
© 2024 Napse. Todos los derechos reservados.
| Painel |
|---|
| borderColor | #E4E3E3 |
|---|
| titleColor | #ffffff |
|---|
| borderWidth | 1 |
|---|
| titleBGColor | #704581 |
|---|
| title | CONTENIDO |
|---|
|
|
...
| Informações |
|---|
|
- Primero se debe invocar al servicio de autenticación para obtener un token.
- Cuando se llama a cualquier servicio este token se envía como un parámetro más de la llamada en el header (x-access-token).
- Si al llamar al servicio el token expiró, se recibirá respuesta de token inválido y se deberá volver a pedir uno nuevo.
Ver BRIDGE API - REST – Autenticación: token |
Este servicio de cambio de estado se podrá complementar con: BRIDGE API - REST - Consulta de solicitud de cambio de estado del pedido
De esta manera, luego del envío de un cambio de estado podrá consultarse si el mismo fue realizado o no con éxito. El motivo principal radica en que las solicitudes como el cambio de estado son enviados a BRIDGE API Central, pero quien realiza el cambio finalmente es BRIDGE API en la tienda (luego se replica su actualización a Central)
JSON ejemplo
| Bloco de código |
|---|
|
{
"orderState": "closed",
"internalNumber": "00001",
"externalNumber": "PEYA_001230",
"channel": "PEYA",
"notes": "el pedido ha sido cancelado por el cliente"
} |
...
Importante: los campos que poseen este ícono 
, son valores tipificados que deben respetar los valores expuestos por BRIDGE en sus servicios.
| Campo | Tipo | Descripción | Requerido | Ejemplos | Validación (código) |
|---|
| orderState | String | Codigo del estado al cual pasa la orden | SI | Ver cuadro de estados. | 1040: el nuevo estado es requerido.
1021: el nuevo estado no puede ser idéntico al actual.
1023: no se puede cambiar de estado una orden enviada (env) o cerrada (clos) |
| internalNumber | String | Código de la orden interna asignado por BRIDGE. Este código se retorna al momento de la creación de la orden. | SINO | 000001bridge000001 | 991: el código de orden es requerido.
1022: el número de orden informado no existe en la base de datos. |
| externalNumber | String | Nro de pedido externo | NO | PEYA_01230 |
|
| channel | String | Código del canal | NO | PEYA |
|
| notes | String | Observaciones sobre el cambio de estado | NO | El cliente canceló la orden |
|
| Informações |
|---|
|
Se debe enviar el internalNumber ó el externalNumber y channel (para poder determinar el pedido unívocamente) |
Respuesta del servicio:
| Bloco de código |
|---|
{
"ack": 0,
"message": "El cambio de estado para la orden: bridge0000000294 se ejecutó con éxito"
} |
| Informações |
|---|
|
- ack es el código de respuesta, en caso de ser un error, mirar tabla a continuación.
- message: descripción del error en caso de existir.
|
| Código de Error | Descripción |
|---|
| 0 | La operación se ha ejecutado con éxito. |
| 9999 | Error desconocido |
...