JSON en APIs e integraciones ERP: formatear, validar y depurar sin romper producción

JSON como lingua franca de integración

ERP Siesa, e-commerce headless, pasarelas de pago y apps logísticas intercambian JSON por REST o webhooks. Un coma faltante o comilla sin escapar tumba el parser del receptor — a veces silenciosamente, dejando pedidos en limbo.

El JSON Formatter de Conecta procesa en el navegador: pegas payload de log, obtienes árbol colapsable, validación de sintaxis y minify/pretty sin enviar datos de clientes al servidor. Crítico cuando el JSON contiene PII o precios negociados.

Separa entornos: nunca pruebes payload de producción contra endpoint de staging si comparten esquema pero no IDs — puedes crear duplicados de pedido en ERP.

Depurar webhooks entrantes

Captura raw body antes de que middleware lo transforme. Muchos frameworks parsean y pierden el original — guarda log en archivo rotado con timestamp y correlation ID.

Compara estructura esperada vs recibida en Formatter: campos anidados (customer.address.line1), arrays vacíos vs null, números como string ("12345" vs 12345) que rompen validación estricta en .NET o Java.

Reproduce localmente con curl -d @payload.json -H "Content-Type: application/json". Si falla local, el bug no es «la red» — es esquema o auth.

Contratos y versionado de API

Documenta schema JSON con OpenAPI o JSON Schema en repo. En code review, diff de schema cuando cambia campo — integraciones Siesa no perdonan renombrar clave sin aviso.

Versiona API en path (/v2/orders) o header Accept. Breaking change en payload de stock sincronizado un viernes 6 p.m. cuesta fin de semana de bodega contando manual.

Campos opcionales explícitos: omite vs null debe significar lo mismo en doc y código. Ambigüedad genera tickets «a veces funciona» imposibles de reproducir.

Errores frecuentes en integraciones logísticas

Encoding UTF-8 roto en nombres con tildes — cliente «José» llega corrupto y falla validación de guía de transporte.

Timezone en timestamps: ISO 8601 con Z o offset explícito. «2026-07-18 00:00:00» sin zona desplaza cortes de inventario.

Límites de tamaño: payload de 500 líneas de detalle de pedido supera body limit de nginx. Responde 413 sin log claro; Formatter ayuda a estimar bytes antes de deploy.

Idempotency-Key ausente en reintentos HTTP — pasarela o ERP duplica cargo o albarán. Header estándar en POST de creación.

De debug manual a software robusto

Si el equipo pasa más de 5 horas semanales formateando JSON de logs, necesitas observabilidad: structured logging, trace IDs, dashboard de fallos de integración.

Software a medida Conecta implementa adapters ERP con validación schema, dead-letter queue y alertas Slack cuando webhook falla 3 veces consecutivas.

Usa JSON Formatter como primera línea de defensa; escala a ingeniería cuando el mismo error aparece en más de dos integraciones — señal de deuda arquitectónica, no de usuario distraído.