Este servicio permitirá cambiar de estado un pedido, desde una fuenta fuente externa.
- Se invoca de la siguiente manera: https://[direccion_ip]:[puerto]/order/state/:orderState - Ejemplo: https://200.100.100.100:8090/order/state/confirmed
- Se invoca via vía POST.
Parámetros enviados por URL
| 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) |
...
| 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 |
...
JSON ejemplo
| Bloco de código |
|---|
|
{
"internalNumber": "00001",
"notes": "el pedido ha sido cancelado por el cliente"
} |
...
| Bloco de código |
|---|
{
"ack": 0,
"message": "-",
} |
- 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 |
Estados de un pedido:
| Estado | Nombre | Descripción |
|---|
| 1 | open |
Abierto| abierto/creado | El pedido ha ingresado a Bridge, aún no se ha tratado |
| cancelled | Cancelado | El pedido ha sido cancelado por el cliente o por la empresa. |
| rejected | Rechazado | El pedido se rechaza, debido a errores en su estructura o inconsistencias. |
| paused | Pausado | El pedido se pausa por alguna razón. |
| negotiation | En proceso de negociación | Por algún faltante, se deberá negociar con el cliente como completar el pedido. |
inproc | En proceso de surtido- se importa el pedido
- si no hay stock suficiente se informa y no se crea el pedido
|
| 2 | confirmed | confirmado | El pedido tiene pagos asociados y se encuentra para surtir - se debe haber recibido del integrador si fue cobrado o las cobranzas
- caso Garbarino debe venir informado el medio de pago default y ese se exportará como cobranza
- caso Fravega/MKTPlace se informaría que fue cobrado pero la cobranza vendrá con delay
- caso Rapipago u otro medio de pago: se reciben los datos de la cobranza o que fue cobrado
|
| 3 | readyToPick | listo para surtir | El pedido cuenta con las actualizaciones de datos de envío - se debe haber recibido del integrador datos del shipping+etiqueta
|
| 4 | inproc | surtiendo | El pedido se encuentra en proceso de surtido - el pedido fue tomado para su surtido (en una packing List en la gestión del depósito)
|
| 5 | complete | completo | El pedido se ha surtido |
El pedido se ha surtido. | transit. - se deben haber recibido o completado los series e ítems del pedido confirmados (siempre es total, no hay parcial)
- (paquete en jaula en espera del operador logístico o en estante en tienda a la espera del retiro del cliente)
|
| 6 | transit | entregado | En proceso de envío |
El pedido se ha enviado al cliente. | closed | Cerrado| Código de Error | Descripción |
|---|
| 0 | La operación se ha ejecutado con éxito. |
9999 | Error desconocido- se debe haber recibido alguna novedad del operador logístico o ser pasado de estado manualmente (ej: entregar PackingList en la gestión del depósito)
|
| 7 | closed | cerrado (estado final) | El pedido se ha cerrado con éxito. |
- 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.
| 8 | cancelled | cancelado (estado final) | El pedido ha sido cancelado por el cliente o por la empresa. |
