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 →](https://catalogmobile.com/es-mx/kb/)

---
Canonical: https://catalogmobile.com/es-mx/kb/integracion-webhook/
Language: es-MX