Este servicio permitirá cambiar de estado un pedido, desde una fuenta externa.
- Se invoca de la siguiente manera: https://[direccion_ip]:[puerto]/order/change-status - Ejemplo: https://200.100.100.100:8090/order/change-status
- Se invoca via POST.
- 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 |
Ejemplo del JSON a enviar:
{
"internalOrderNumber": "00001",
"newStatus": "clos",
"notes": "el pedido se ha surtido por la totalidad de lo requerido"
} |
Descripción de los campos:
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) |
|---|
| internalOrderNumber | String | Código de la orden interna asignado por BRIDGE. Este código se retorna al momento de la creación de la orden. | SI | 000001 | 991: el código de orden es requerido. 1022: el número de orden informado no existe en la base de datos. |
| newStatus | String | Estado al cual pasa la orden | SI | Dentro de los siguientes valores: - canc: canccelada
- comp: completa
- coti: cotización
- inac: Inactiva
- opck: en picking
- open: abierta
- pend: a verificar crédito
- rjct: rechazada
- rpck: lista para facturar
- tdel: para enviar
- tinv: para facturar
- tngt: para negociar
- env: enviada (nuevo)
- clos: cerrada. (nuevo)
| 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)
|
| notes | String | Observaciones sobre el cambio de estado | NO | El cliente canceló la orden |
|
Respuesta del servicio:
{
"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 |