Orden

Una orden registra una venta que llegó desde un marketplace conectado al seller. Es el objeto que concentra el ciclo operativo de compra, pago, envío y seguimiento.

La composición principal es Order y se apoya en sub-estructuras como BillingAddress, ShippingAddress, Carrier, Items y Payments.

{
  "date_add": "2026-05-15T10:30:00Z",
  "marketplace_connection_id": 347,
  "reference": "ORD-10001",
  "billing_address": {},
  "shipping_address": {},
  "carrier": {},
  "items": [],
  "payments": []
}

Ver Listar ordenes, Crear una nueva orden y Listar estados.

Sub-recursos

Las órdenes se gestionan por separado bajo /orders/{id}/:

• Items - modificar líneas de la orden.
• Payments - registrar o modificar pagos.
• Shippings - gestionar envíos.
• Documents - facturas, remitos y otros documentos.
• Comments - notas internas.
• Incidents - incidencias o problemas.

Estados

El endpoint /orders/status devuelve los estados disponibles.

Webhooks

Próximamente, no documentados todavía en el spec.

En la práctica, órdenes es el dominio donde más sentido tiene seguir el flujo completo desde ingreso, modificación de datos, pago, envío y resolución de incidentes.