Reto
Localizar por qué la API externa rechazaba parte de los pedidos, corregirlo y poder detectar estos fallos con rapidez.
Caso de éxito
Integración de pedidos Magento 2 con API externa
Integración de pedidos Magento 2 con API externa
Diagnóstico y corrección de la integración entre una tienda Magento 2 y un sistema externo: pedidos rechazados, logging estructurado, alertas con contexto y mapeo de datos corregido.
Magento 2APIEcommerce
Cuando un pedido no llega y nadie sabe por qué
La tienda enviaba sus pedidos a un sistema externo mediante API. Algunos se rechazaban con errores HTTP 400 y las alertas no daban información suficiente para saber qué había fallado ni en qué pedido.
Enfoque
Se amplió el sistema de alertas con logging estructurado, incluyendo el contexto de cada pedido, y se comparó la petición enviada con lo que esperaba la API.
Resultado
La dirección de envío se enviaba como un objeto anidado cuando la API esperaba campos simples. Se corrigió el mapeo y los pedidos pasaron a enviarse en el formato correcto.
Tecnología
Un stack elegido para el problema
El trabajo se hizo sobre el propio módulo de integración de la tienda: logging con contexto mediante el logger de Magento, revisión del payload de cada pedido y comparación con el contrato de la API externa.
Magento 2PHPAPI REST
Errores que se pueden explicar
Una integración no falla solo cuando se cae: también cuando rechaza datos sin que nadie lo vea. El valor del trabajo fue hacer visibles esos fallos y su causa.
Alertas con contexto
Alertas con contexto
Cada alerta incluye los datos del pedido afectado.
Causa corregida
Causa corregida
El mapeo de la dirección de envío se ajustó al formato que espera la API.
Diagnóstico más rápido
Diagnóstico más rápido
Los logs estructurados permiten encontrar un problema sin reproducirlo a ciegas.
Integración más robusta
Integración más robusta
El contrato de datos con la API queda claro para futuros cambios.
Qué cambió en la operativa de la tienda
El caso está anonimizado, así que no publicamos cifras del cliente. Estos son los cambios que aportó el trabajo.
Visibilidad
Visibilidad
Antes: alertas genéricas. Ahora: alertas con los datos del pedido.
Pedidos aceptados
Pedidos aceptados
Antes: rechazos con error 400. Ahora: los pedidos se envían en el formato que espera la API.
Menos tiempo de diagnóstico
Menos tiempo de diagnóstico
Antes: revisar pedidos uno a uno. Ahora: logs estructurados para localizar cualquier fallo.
Base para mantener
Base para mantener
Antes: formato de datos implícito. Ahora: contrato con la API reflejado en el código.
¿Tienes un reto parecido?
Podemos revisarlo sin suposiciones y definir una primera fase realista.