Órdenes
Consulta de órdenes y avance de su ciclo de vida.
- Consultas y cambios de estado usan la URL de Seller Center.
- Subir comprobante de pago usa la URL del gateway (requiere
apiKey).
Flujo de una orden
Lo que haces depende de tu modalidad de despacho. Cada seller tiene una sola modalidad, acordada con Intercorp Retail; la orden no trae un campo que la indique.
Confirma tu modalidad antes de integrar el paso 4. Solo lo usan los sellers con despacho propio. Si tu modalidad es despacho por Intercorp Retail, no lo ejecutes: actualizar ese estado le corresponde a Intercorp Retail. Si no estás seguro de tu modalidad, consúltala con tu contacto de Intercorp Retail antes de integrar.
Resumen:
- Despacho por Intercorp Retail: 1 → 2 → 3. Recibirás los webhooks de los estados siguientes.
- Despacho propio: 1 → 2 → 3 → 4.
Datos del cliente y dirección de despacho
En Detalle de orden, el teléfono (clientProfileData.phone) y la dirección (shippingData.address, salvo receiverName) vienen enmascarados (**********). Los datos completos llegan en el webhook ORDER_READY_FOR_HANDLING (ver Webhooks): guárdalos al recibirlo.
Todos los estados (status)
Errores al cambiar de estado
Eventos que no dependen de ti
Con despacho por Intercorp Retail, también recibirás ORDER_DELIVERY, ORDER_PENDING_WITHDRAWAL y ORDER_RETIRED como informativos.
Integración recomendada
- Recibe las órdenes nuevas por el webhook
ORDER_READY_FOR_HANDLINGy guarda los datos de despacho que trae. Como respaldo, consulta Listar órdenes constatus=ready-for-handlingcada 5–10 minutos. - Obtén el Detalle de orden, revisa el tipo de entrega e inicia el manejo lo antes posible.
- Al despachar, factura y sube el comprobante.
- Con despacho propio, confirma la entrega cuando el cliente reciba el pedido.

