Logo de Think²Think²
Entrar

Guías

Antes de reintentar, comprueba si la acción ya ocurrió

Una conexión puede cortarse después de que el servicio haya enviado el correo o procesado el cargo. Repetir a ciegas no recupera necesariamente el trabajo: puede duplicarlo. Esta guía distingue no ejecutado, confirmado y desconocido, y propone qué evidencia revisar antes de decidir.

Lista de espera; no garantiza acceso inmediato ni plan gratuito.

Situaciones para revisar

Un procesador de pagos no devuelve confirmación y el flujo muestra timeout.

Consulta el estado de la operación en la fuente receptora autorizada y coteja referencia, importe, moneda y destinatario. Si la operación admite idempotencia, revisa la documentación de ese endpoint y versión: identificador, parámetros y retención. No reutilices una clave para otra intención ni generes una distinta para ocultar un reintento.

Un resultado confirmado no se vuelve a ejecutar. Si la consulta es inconcluyente, queda desconocido y se detiene para revisión; no se marca fallido por no recibir respuesta.

Una automatización de correo se interrumpe sin mostrar el resultado del envío.

Busca el identificador del mensaje y el historial del sistema de correo. Destinatario, asunto y hora ayudan a investigar, pero por sí solos no identifican inequívocamente un envío. Comprueba también acciones pendientes. La ausencia en una búsqueda parcial no demuestra que el mensaje no saliera.

Si hay evidencia suficiente de envío, registra el efecto y no repitas. Sin evidencia concluyente, escala el resultado desconocido: una nueva aprobación no demuestra que el intento anterior no ocurrió.

Una actualización de un registro devuelve un error de conexión.

Compara el dato de destino y su historial con la propuesta. Fijar un campo, incrementar un saldo y crear un objeto no son la misma operación. Comprueba conflictos de versión y efectos secundarios como avisos o registros derivados.

No se deduce idempotencia del nombre del conector ni del uso de HTTP. Si el cambio ya está aplicado, no se repite a ciegas; si faltan pruebas de efectos secundarios, se conserva la incertidumbre.

Cómo evaluar el trabajo

  1. Describe la intención, sistema receptor, recurso, referencia, parámetros y consecuencia externa. Define qué evidencia demostraría que la operación comenzó o terminó. Un mensaje genérico de error no identifica el punto del fallo.
  2. Clasifica por evidencia: no ejecutado cuando se puede demostrar; confirmado cuando el destino acredita el efecto; desconocido cuando la respuesta o el historial son insuficientes. Un timeout por sí solo no decide entre esos estados.
  3. Consulta las reglas del servicio concreto antes del reintento: idempotencia, vigencia del identificador, parámetros, concurrencia y límites. Stripe documenta comportamientos distintos para sus API v1 y v2; no se extrapolan a otros proveedores. Think² permite organizar colaboradores, grupos y contexto con modelos compatibles y herramientas autorizadas; cada colaborador puede tener su propio computador. Eso no acredita deduplicación técnica ni ejecución exactamente una vez. Las acciones externas requieren aprobación y evidencia vigente.
  4. Plantilla: intención; destino; referencia; parámetros; evidencia/fecha; estado confirmado/no ejecutado/desconocido; regla documentada de repetición; decisión; responsable; aprobación aplicable. Ejemplo ficticio: En PagoDemo se registra la orden ficticia ORD-204 por 48 unidades de moneda de prueba. Tras un timeout, el historial de prueba muestra la operación ORD-204 como aprobada con los mismos parámetros: decisión, no repetir. Si la consulta no devuelve una coincidencia concluyente, estado desconocido y revisión, no nuevo cargo. Es un recorrido documental ficticio, no una prueba de pago ni integración. Detente si cambian parámetros, caduca la protección contra duplicados o no puedes verificar el destino.

Preguntas frecuentes

¿Un timeout significa que no se hizo nada?

No. La respuesta puede perderse después de ejecutar la acción. Comprueba la fuente receptora y conserva el estado desconocido si no hay evidencia suficiente.

¿Una clave de idempotencia funciona para siempre?

No lo presupongas. Su alcance, retención, versión y tratamiento de parámetros dependen del servicio. Reutilizar una clave fuera de sus condiciones puede no protegerte de una nueva operación.

¿La aprobación de Think² evita duplicados?

La aprobación autoriza una acción externa concreta; no prueba que un intento anterior no ocurriera ni garantiza deduplicación técnica. Primero verifica la evidencia y la acción que se aprobaría.

Fuentes y alcance

Sigue explorando

Lista de espera; no garantiza acceso inmediato ni plan gratuito.