Skip to navigation

Ó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.

ModalidadQuién lleva el pedidoHasta dónde actualizas el estado
Despacho por Intercorp RetailEmpacas el pedido e Intercorp Retail lo recoge en tu almacén.Hasta invoiced (Enviada). Los estados siguientes los actualiza Intercorp Retail.
Despacho propioTú entregas el pedido en el domicilio del cliente.Hasta delivered (Entregada).

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.

Llega una orden pagada (webhook ORDER_READY_FOR_HANDLING)
│
▼
┌────────────────────┐
│ ready-for-handling │
└────────────────────┘
│ 1. Iniciar manejo
▼
┌────────────────────┐
│ handling │
└────────────────────┘
│ 2. Facturar y despachar
▼
┌────────────────────┐
│ invoiced │ ◀── 3. Subir comprobante de pago (no cambia el estado)
└────────────────────┘
├──▶ Despacho por Intercorp Retail: tu parte termina aquí
│
│ ── Desde aquí, solo despacho propio ──
│ 4. Confirmar entrega
▼
┌────────────────────┐
│ delivered │ ──▶ Despacho propio: termina aquí
└────────────────────┘
PasoCuándoRequestEstado antes → despuésWebhook que recibirás
1Aceptas la orden y empiezas a prepararla1. Iniciar manejoready-for-handling → handlingORDER_HANDLING
2Facturas y despachas el pedido (o lo dejas listo para el recojo de Intercorp Retail)2. Facturar y despacharhandling → invoicedORDER_INVOICE
3Adjuntas la boleta o factura emitida al cliente3. Subir comprobante de pagoinvoiced (no cambia)—
4Solo despacho propio: el cliente recibió el pedido4. Confirmar entregainvoiced → deliveredORDER_DELIVERY

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)

CódigoNombre en Seller CenterSignificado
payment-pendingNo pagadaEl cliente aún no paga. No atender.
ready-for-handlingPara manejoPagada; debes iniciar el manejo.
handlingPara envíoEn preparación; debes facturar y despachar.
partially-invoicedEnvío incompletoSe despachó solo parte de los items.
invoicedEnviadaFacturada y despachada.
partially-deliveredParcialmente entregadaSe entregó solo parte de los items.
deliveredEntregadaEntregada al cliente.
pending-withdrawalPendiente de retiroRetiro en tienda: lista para que el cliente la recoja. Lo actualiza Intercorp Retail.
retiredRetiradoRetiro en tienda: el cliente la recogió. Lo actualiza Intercorp Retail.
canceledCanceladaNo atender.
in-annulmentEn anulaciónSolicitud de anulación en curso.
in-returnEn devoluciónSolicitud de devolución en curso.
returnedDevueltaDevolución completada.

Errores al cambiar de estado

RespuestaCausa
400 {"message": null} o {"message": "Invalid order status"}La orden no está en el estado requerido para ese paso. Consulta el Detalle de orden y revisa status.
401 {"message": "Access is denied"} (con token válido)La orden no existe o no pertenece a tu tienda.

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.

WebhookSignificadoQué hacer
ORDER_CANCELOrden canceladaNo atender. Si ya la preparaste, no la despaches.
ORDER_IN_ANNULMENTSolicitud de anulación en cursoEsperar resolución antes de despachar.
ORDER_IN_RETURNSolicitud de devolución en cursoPreparar recepción de la devolución.
ORDER_RETURNEDOrden devueltaReingresar el stock si corresponde.

Integración recomendada

  1. Recibe las órdenes nuevas por el webhook ORDER_READY_FOR_HANDLING y guarda los datos de despacho que trae. Como respaldo, consulta Listar órdenes con status=ready-for-handling cada 5–10 minutos.
  2. Obtén el Detalle de orden, revisa el tipo de entrega e inicia el manejo lo antes posible.
  3. Al despachar, factura y sube el comprobante.
  4. Con despacho propio, confirma la entrega cuando el cliente reciba el pedido.