BRIDGE API - REST - Cambio de Estado del Pedido

Este servicio permitirá cambiar de estado un pedido, desde una 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 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)

Tener en cuenta:

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

{
	"internalNumber": "00001",
    "notes": "el pedido ha sido cancelado por el cliente"
}

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)
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.	SI	000001	991: el código de orden es requerido. 1022: el número de orden informado no existe en la base de datos.
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

Estados de un pedido:

	Estado	Nombre	Descripción
1	open	abierto/creado	El pedido ha ingresado a Bridge, aún no se ha tratado 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. 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 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.
8	cancelled	cancelado (estado final)	El pedido ha sido cancelado por el cliente o por la empresa.

Árvore de páginas