La decisión
La integración une operaciones, no solo endpoints. Defina registros, autoridad por campo, autenticación, tiempos y quién atiende interrupciones. Una solicitud correcta prueba solo una parte.
Un ejemplo práctico
En un envío ficticio, trace pedido, corrección de dirección, despacho y cancelación. Vincule identificador interno y del transportista. Decida qué hacer si se crea etiqueta pero se pierde respuesta: repetir podría duplicar envío.
Alternativas que conviene valorar
Llamada directa sirve a respuestas inmediatas; cola persistente, al trabajo que continúa; conciliación programada detecta faltantes. Pueden coexistir con estados comprensibles.
Dónde falla el plan
Aísle campos del proveedor en un mapeo y valide entradas. Distinga fallo temporal de dirección inválida; reenviar datos incorrectos no los arregla.
Escriba el contrato del registro en lenguaje empresarial
Para envíos, describa estados visibles: pendiente, aceptado por el transportista, expedido, cancelado o con incidencia. Defina identificador compartido y eventos que permiten transiciones. Una respuesta de transporte puede acreditar solo recepción; la confirmación empresarial puede llegar después. No convierta cada respuesta HTTP correcta en envío terminado.
Documente campos ausentes, zonas horarias, unidades y valores opcionales. Una instrucción vacía puede significar que no hay instrucciones; omitirla en una actualización puede significar conservarla. Pruebe el contrato real. Pregunte por rotación de credenciales, límites, versiones y entorno de pruebas. Mantenga respuestas no verificadas como dependencias abiertas, no como fechas de entrega seguras.
Asigne responsable a las transferencias interrumpidas
Si el transportista crea una etiqueta pero pierde la respuesta, una clave de idempotencia admitida o consulta por referencia puede resolverlo. Si ninguna existe, retenga el caso para investigar en lugar de duplicar el envío. Demuéstrelo con servicio local ficticio o entorno autorizado, nunca con pedidos reales.
Una herramienta privada debe mostrar referencia fallida, categoría segura y último estado confirmado. Reprocesar conserva identidad lógica y valida igual que el primer intento. Asigne credenciales, cambios de mapeo y excepciones diarias. Ejemplos versionados y pruebas de contrato detectan cambios del proveedor, pero alguien debe decidir cómo tratar un nuevo significado empresarial.
Antes de encargar el trabajo
¿Quién posee la cuenta? ¿Hay pruebas representativas? ¿Puede un operador encontrar y repetir un registro con seguridad? Acuerde aceptación de éxito y fallo con el socio de integración.