Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 16 Próxima »




BRIDGE API - REST - Cambio de Estado del Pedido




CONTENIDO




Este servicio permitirá cambiar de estado un pedido, desde una fuente externa.

  1. Se invoca de la siguiente manera: https://[direccion_ip]:[puerto]/order/state/change - Ejemplo: https://200.100.100.100:8090/order/state/change
  2. Se invoca vía POST.


Tener en cuenta:

  1. Primero se debe invocar al servicio de autenticación para obtener un token.
  2. 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).
  3.  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

{
    "orderState": "closed",	
    "internalNumber": "00001",
    "externalNumber": "PEYA_001230",
    "channel": "PEYA",
    "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.

CampoTipoDescripciónRequeridoEjemplosValidación (código)
orderStateStringCodigo del estado al cual pasa la ordenSI

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)

internalNumberStringCódigo de la orden interna asignado por BRIDGE. Este código se retorna al momento de la creación de la orden.NObridge000001

991: el código de orden es requerido.
1022: el número de orden informado no existe en la base de datos.

externalNumberStringNro de pedido externoNOPEYA_01230


channelStringCódigo del canal NOPEYA


notesStringObservaciones sobre el cambio de estadoNOEl cliente canceló la orden

NOTA: se debe enviar el internalNumber ó el externalNumber y channel (para poder determinar el pedido unívocamente) 

Respuesta del servicio: 


{
	"ack": 0,
	"message": "El cambio de estado para la orden: bridge0000000294 se ejecutó con éxito"
}
  1. ack es el código de respuesta, en caso de ser un error, mirar tabla a continuación.
  2. message: descripción del error en caso de existir.


Código de ErrorDescripción
0La operación se ha ejecutado con éxito.
9999Error desconocido

Estados de un pedido:


Estado

Nombre

Descripción

1openabierto/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
2confirmedconfirmado

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
3readyToPicklisto para surtir

El pedido cuenta con las actualizaciones de datos de envío

  • se debe haber recibido del integrador datos del shipping+etiqueta
4inprocsurtiendo

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)
5completecompleto

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)
6transit

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)
7closed

cerrado (estado final)

El pedido se ha cerrado con éxito.
8cancelledcancelado (estado final)El pedido ha sido cancelado por el cliente o por la empresa.



  • Sem rótulos