Ir al contenido
Catalog Mobile

Ayuda del producto

Integración webhook de Catalog Mobile para ERP, stock, precios y pedidos

Guía técnica para publicar productos, sincronizar stock y precio, recibir pedidos y operar el flujo asíncrono del webhook.

Qué resuelve la integración

El webhook elimina el trabajo manual de publicación. El ERP pasa a ser la fuente de verdad para productos, stock, precios y pedidos.

  • Publica productos, precios y stock desde un único contrato técnico.
  • Recibe pedidos estructurados en lugar de mensajes sueltos.
  • Da un flujo único a integradores y al equipo interno.

Cómo definir el contrato del integrador

La implementación más segura usa un identificador externo estable, opera en modo asíncrono y guarda request_id para auditoría.

  • Usa idMapeamento como identificador canónico siempre que sea posible.
  • Guarda request_id y el estado final de cada proceso.
  • Mantén el código comercial como respaldo operativo.

Rutina operativa recomendada

Separa publicación, consulta de estado y recuperación de errores. Así se mantiene estable una operación con cambios frecuentes de stock y precio.

  • Programa ventanas claras de sincronización.
  • Actualiza el stock con mayor frecuencia que el resto del catálogo.
  • Crea alertas para fallas repetidas por SKU o lista de precios.

Autorización y límites del contrato

Usa el integrationCode de la configuración y el idEcommerce asignado por soporte; idEcommerce identifica el origen de la integración, no un producto. El contrato público requiere cnpj, idEcommerce y tipo. Consulta la referencia vigente: las solicitudes individuales, lotes y fotos tienen límites diferentes.

¿Encaja con mi forma de vender?

¿Cuándo debo guardar request_id?

Siempre que el flujo sea asíncrono o cuando necesites conciliar errores con el ERP.

¿Puedo sincronizar solo stock y precio?

Sí. La carga estructural y la actualización operativa deben tener cadencias distintas.

¿Cuándo conviene hablar con soporte?

Cuando ya tengas el payload probado, el request_id y la ruta exacta utilizada, especialmente si el estado final termina en failed o duplicate.

Guías

Continúa en la ayuda

Todas las guías de ayuda →