API y webhooks

Soluciones 4marketplace · API y webhooks

API REST y webhooks para marketplace — vendedores, anuncios, pedidos y comisiones

Todo lo que hace funcionar tu marketplace es accesible por código: das de alta vendedores, sincronizas sus anuncios desde un ERP o un feed, lees los pedidos enrutados por vendedor y sigues comisiones y liquidaciones.

Qué cubre la API del marketplace

Onboarding de vendedor por API

Crear un vendedor, enviar sus datos de empresa y los documentos de verificación, lanzar la activación — útil cuando la captación de vendedores pasa por tu propio CRM.

Anuncios y existencias

Crear y actualizar anuncios por vendedor, con precio, existencias y categoría. Un vendedor puede llamar al mismo endpoint con su propia clave y sincronizar desde su ERP.

Pedidos enrutados por vendedor

Leer los pedidos ya desglosados por vendedor: un pedido con artículos de tres tiendas vuelve como tres líneas, cada una con su propio estado de envío.

Comisiones y liquidaciones

Consultar la comisión retenida en cada transacción y el estado de la liquidación por vendedor — la base de tus propios informes o de tu exportación contable.

Webhooks de eventos

Registras tu URL y recibes los eventos de nuevo pedido, pago, anulación, devolución y activación de vendedor — con reintentos y firma para comprobar la autenticidad.

Documentación OpenAPI 3

Especificación completa con ejemplos, más una clave de entorno de pruebas para que tu equipo desarrolle sobre datos ficticios antes de tocar el marketplace real.

Generas una clave API desde el panel de operador, eliges los permisos y llamas a los endpoints REST de vendedores, anuncios, pedidos y comisiones. Para los eventos registras tu URL de webhook; las llamadas fallidas se reintentan con intervalos crecientes.

Preguntas frecuentes sobre la API

Sí. Además de la clave de operador, cada vendedor recibe en su área una clave con permisos limitados a sus propios anuncios y pedidos.

Gestiona tu marketplace por código

Especificación OpenAPI 3, clave de pruebas y webhooks firmados están incluidos en todos los planes.