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:
Primeros pasos
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.
Haz login
Llama a Login con tu usuario, contraseña y el header apiKey. Recibirás un accessToken que dura 24 horas.
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.
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.

