Skip to navigation

Introducción

Bienvenido a la documentación oficial de integración de Seller Center de Intercorp Retail (Promart, Oechsle, plazaVea, Real Plaza y más).

Con esta API conectas tu sistema (ERP, OMS o e-commerce propio) con Seller Center para:

ProcesoQué puedes hacer
AutenticaciónObtener tu token de acceso
Datos maestrosConsultar marcas, categorías, especificaciones y ecommerces
ProductosCrear productos y SKUs; consultar su estado de aprobación
Precio y stockActualizar precio, ofertas y stock por SKU
ÓrdenesConsultar órdenes y avanzarlas: atender → facturar → entregar
WebhooksRecibir notificaciones en línea de órdenes y controversias

Primeros pasos

1

Solicita tus credenciales de QA

Completa el formulario de solicitud eligiendo Credenciales de QA. Las recibirás por correo:

  • un usuario y contraseña de Seller Center habilitado para APIs, y
  • una apiKey.
2

Haz login

Llama a Login con tu usuario, contraseña y el header apiKey. Recibirás un accessToken que dura 24 horas.

3

Prueba los flujos que vas a usar

Envía el token en cada llamada como Authorization: Bearer <accessToken>. Puedes probar cada endpoint desde la Referencia de la API con el botón Try it.

4

Pide el pase a producción

Cuando tu integración funcione en QA, sigue los pasos de Paso a producción.

Límite de llamadas

La API admite hasta 300 solicitudes por minuto. Si lo superas recibirás 429 Too Many Requests: espera y reintenta, idealmente con esperas cada vez más largas.

Soporte

Antes de escribir, revisa la guía y la referencia del endpoint que estás usando. Si necesitas ayuda, escribe a tu contacto de Intercorp Retail indicando: ambiente, endpoint usado, hora, código de respuesta y el body de respuesta.

Nunca compartas tu contraseña, tu apiKey ni tu token.