Skip to navigation

Webhooks

Seller Center puede notificarte en línea cuando ocurre un evento, en lugar de que consultes periódicamente.

Cómo suscribirte

Indica la URL y los tópicos en el formulario de solicitud: en la solicitud de Credenciales de QA para QA, y en la de Pase a producción para PRD. Para cambiarlos después, escríbele a tu contacto de Intercorp Retail. En cada caso necesitas:

  1. La URL de tu endpoint.
  2. Los tópicos que quieres recibir (puedes usar la misma URL para varios).

Requisitos de tu endpoint

  • Método POST, recibe JSON.
  • Debe responder 2xx en menos de 10 segundos. Procesa en segundo plano si tu lógica tarda más.
  • Seller Center no envía headers de autenticación (apiKey, token). Si quieres proteger tu endpoint, incluye un secreto en la URL: https://tusitio.pe/webhooks/sellercenter?key=TU_SECRETO.
  • Debe ser idempotente: puedes recibir la misma notificación más de una vez.

Reintentos

Si tu endpoint no responde 2xx (o tarda más de 10 s), Seller Center reintenta 10 veces durante las siguientes 12 horas. Luego la notificación se marca como fallida.

Como respaldo, consulta periódicamente Listar órdenes para recuperar eventos que hayas perdido.

Headers que recibirás

HeaderEjemploDescripción
X-SellerCenter-TopicORDER_READY_FOR_HANDLINGTópico del evento.
X-SellerCenter-Domainhttps://inretailqa.mysellercenter.com (QA)Origen de la notificación.
X-SellerCenter-SignatureVFJJQVRITE9OOmh0dHBz...Base64 de accountName:<URL registrada> (p. ej. MITIENDA:https://tusitio.pe/webhooks/sellercenter?key=...). Puedes compararlo con el valor esperado para validar el origen.
Content-Typeapplication/json—

Tópicos

Órdenes (el payload es la orden completa, con la misma estructura del Detalle de orden):

TópicoCuándo se envía
ORDER_READY_FOR_HANDLINGNueva orden pagada, lista para atender.
ORDER_HANDLINGLa orden pasó a preparación.
ORDER_INVOICELa orden fue facturada y entregada al operador logístico.
ORDER_DELIVERYEntregada al cliente (domicilio) o en tienda.
ORDER_PENDING_WITHDRAWALPendiente de retiro en tienda.
ORDER_RETIREDRetirada por el cliente.
ORDER_CANCELCancelada. No debe atenderse.
ORDER_IN_ANNULMENTSe inició una solicitud de anulación.
ORDER_IN_RETURNSe inició una solicitud de devolución.
ORDER_RETURNEDOrden devuelta.

Controversias:

TópicoCuándo se envíaPayload
CONTROVERSY_CREATIONSe creó una controversia (queja, reclamo, solicitud de anulación, devolución o cambio) en una de tus órdenes.La controversia: id, type, orderId, text, state[], controversyStatus, responsible, userTypeControversy (SELLER o ADMIN), monto.

Tipos de controversia (type)

TagNombre
DYDelivery exitoso
CTControversia abierta de cualquier tipo
DRSolicitud de devolución
ECError del cliente
PIPrimer despacho infructuoso
DIDespacho infructuoso (segundo intento)
DXDevolución – Entrega incompleta
DEDevolución – Entrega de producto errado
DPDevolución – Error en elección del producto
DFDevolución – Producto fallado
DNDevolución – Producto no cumple expectativas
DDDevolución – Características no coinciden con la descripción
DCDevolución – Compra duplicada
DODevolución – Cambio de opinión
DBDevolución – Pedido abandonado por el cliente (retiro en tienda)
ACAnulación – Desistimiento del cliente
AIAnulación – Datos insuficientes del cliente
ARAnulación – Despacho rechazado
AZAnulación – Zona inaccesible
AEAnulación – Error en elección de producto
ASAnulación – Quiebre de stock
ADAnulación – Compra duplicada
AOAnulación – No contacto con el cliente
ALAnulación – Inconformidad con el flete
AFAnulación – Fraude
ABAnulación – Incumplimiento de entrega
APAnulación – Producto no recogido por el operador logístico
SSiniestro
CDDCambio – Fecha de entrega
CPFCambio – Producto fallado
CSCCambio – Solicitud del cliente
CRCambio – Entrega errada
CPEComprobante de pago errado
NRHSeller no inició manejo
SNASeller no aceptó el pedido
PNCProducto no conforme
STServicio técnico
LDRLibro de reclamaciones