Skip to main content
Version: 1.0.0

Pedidos

Este API proporciona funcionalidades para la gestión de pedidos en un sistema de marketplace. Las principales funcionalidades incluyen:

  • Listado de pedidos de un comercio: Permite obtener el listado de pedidos de un comercio específico.

  • Descarga de orden de compra en formato PDF: Permite descargar la orden de compra de un pedido específico en formato PDF.

  • Descarga de etiquetas de envío en formato PDF: Permite descargar las etiquetas de envío de un pedido específico en formato PDF.

  • Carga de detalles de guía de un pedido: Permite cargar los detalles de la guía de un pedido, incluyendo el tipo, el carrier y los números de partidas.

  • Actualización del estado de envío de una guía manual: Permite actualizar el estado de envío de las partidas que se encuentran en una guía manual.

La transición de estatus de una partida sigue el siguiente flujo:

  1. Por enviar: La partida está lista para ser enviada.
  2. Por recolectar: La partida está lista para ser recolectada por el transportista.
  3. En camino: La partida está en camino hacia su destino.
  4. Entregado: La partida ha sido entregada al destinatario. Si la guía de las partidas entregadas es de tipo "Manual", es necesario carga la evidencia de entrega para que pueda ser pagada al vendedor.
  5. Facturado: Se ha cargado la evidencia de entrega de las partidas de un pedido enviadas por una guía manual.
  6. Cancelado por cliente: La partida ha sido cancelada por el cliente antes de ser enviada.
  7. Cancelado por vendedor: La partida ha sido cancelada por el vendedor antes de ser enviada.

Notas:

  • A. Solo se puede cancelar por vendedor un pedido si está en el estado "por enviar". Esto significa que un pedido no se puede cancelar si ya tiene guía asignada.

  • B. Para las guías automáticas y las partidas marcadas como FF, no es necesario cargar la evidnecia de entrega para su liquidación.

Las especificaciones detalladas para cada endpoint se encuentran descritas en la sección respectiva.

Authentication

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Bearer format:

JWT