Definir la semántica
Un identificador necesita un significado compartido: quién lo genera, cuál es su alcance y durante cuánto tiempo es único. Conviene documentar también qué campos son obligatorios, qué significa un valor vacío y cómo se expresa la zona horaria de un evento.
Diseñar el fallo
Un timeout no demuestra que la operación haya fallado. El receptor pudo completar la escritura antes de que se perdiera la respuesta. Para operaciones que pueden repetirse, una clave de idempotencia y una política explícita de duplicados ayudan a evitar efectos repetidos. Los reintentos deben tener límites y distinguir errores transitorios de errores de contrato.
Poder explicar lo ocurrido
Un identificador de correlación permite seguir una operación entre servicios. Los registros deben aportar contexto suficiente para diagnosticar el flujo, sin exponer credenciales ni datos personales innecesarios. Contrato, observabilidad y política de recuperación forman parte de la misma entrega.