Saltar al contenido principal

Cambios de estados y eventos

Cambios de estado del canal​

El canal puede transicionar las ventas luego de ser creadas, usando el endpoint POST /v1/{marketplace_code}/orders/{reference}?marketplace_connection={connection_id}. Recomendamos su uso por parte del canal para lo mencionado en el punto anterior.

require 'rest-client'

url = "https://marketplace.api.fulljaus.com/v1/acme/orders/test-01?marketplace_connection=1250"
headers = {
  Authorization: "Bearer aa4f19d8c7a26b4f2943ca606d91c5f64cf354fcddadebfc5a",
  Content_Type: :json
}

payload = {
  status: "APRO"
}

response = RestClient.put(url, payload.to_json, headers)

Actualizaciones por parte del seller​

Durante el ciclo de vida de una venta, el seller puede actualizar una venta cambiándole el estado, o adjuntando documentos como la factura en formato PDF, o eventos de una etiqueta de envío.

Los cambios de estado que hace el seller no siempre son relevantes para el canal, ya que algunos representan estadíos internos de la operación de una venta. Los estados que son relevantes para el canal son los siguientes:

  • ENV (Enviado). El seller indica que el pedido ya fue empaquetado y está en camino al destino.
  • ENT (Entregado). El seller indica que el cliente ya recibió su pedido.

Cuando el seller sube la factura, se envía una notificación por webhook y se encuentra la URL pública de la factura en formato PDF disponible dentro del arreglo documents de la venta. Todo está dentro del mensaje enviado por webhook, no es necesario hacer más API Calls.

order_notification.png