Cómo se piden y se contestan las cosas entre dos sistemas, y por qué repetir un pedido no debe repetir su efecto.
Terminada la estructura, Marta, la residente, presenta a la supervisión la planilla 5, la del hito de estructura. En la supervisión trabajan varios ingenieros, y quien revisó la 4 no siempre revisa la 5.
Por eso la planilla llega completa, con su número, el número de contrato y sus ítems con su cómputo métrico. Quien la reciba la resuelve sin suponer lo que se habló la semana pasada.
En esta supervisión, la respuesta se da por escrito y con uno de tres resultados. Aprobada, y el pago sigue. Observada, cuando la falla está en lo presentado, como un ítem que no coincide con el cómputo métrico. Marta corrige. No atendida, cuando la falla es de la oficina, que ese día no pudo procesar. Marta la presenta igual más tarde.
Un día Marta deja la planilla 5 y no le devuelven la copia sellada. No sabe si se perdió o si se aprobó. Si la presenta otra vez y la toman por nueva, el propietario paga dos veces la estructura. Por eso la oficina anota cada número que resuelve y, si llega de nuevo la 5, contesta con lo ya resuelto. La planilla 6, que es otro cobro, lleva otro número.
Debajo del trámite hay una carretera. Vehículos de cualquier marca la usan porque todos aceptan las mismas señales y reglas. Y el fierro que llega en cuatro camiones trae una nota de remisión que dice «camión 2 de 4», para reclamar el que falte.
Funciona porque cada trámite se entiende solo y repetirlo no cuesta dos pagos.
Rosa escanea el QR de un negocio y toca «Transferir» para mandar 800 Bs. La app llama al servidor, y la lista de pedidos que este acepta, con sus respuestas, es su API.
Al principio, el servidor recuerda cada paso. Al escanear el QR anota «Rosa va a pagar al negocio 9032», y el pedido siguiente solo dice «confirmar». Pero el banco tiene varios servidores, y a veces atiende otro, que no sabe de qué se trata.
Además, Rosa está en un túnel con mala señal. Toca «Transferir» y la pantalla se queda esperando. El pedido se hizo, pero la respuesta se perdió, y Rosa toca otra vez.
—¿Por qué el negocio recibió 1.600 Bs? —pregunta la gerente.
—Para el servidor eran dos pedidos distintos —responde el programador—. Y la app no supo si el primero había llegado.
Es la planilla y su resultado. El pedido dice qué se quiere hacer, sobre qué y con qué datos. Quien pide espera la respuesta antes de seguir, a diferencia de la circular del capítulo 16. La respuesta trae uno de tres resultados, aprobado, observado o no atendido. A veces no llega ninguna, como en el túnel de Rosa. Ni esa falta ni el no atendido dicen si algo se hizo, que es la duda de Marta y la resuelve la tercera pieza.
pedido transferir 800 Bs de la cuenta 4471 a la 9032
número de pedido 7c1e, con el pase de Rosa
respuestas aprobado: se hizo, comprobante 18873
observado: el saldo disponible no alcanza (repetir igual, en general, no sirve)
no atendido: falló el servidor, no se sabe si se hizo (repetir con el mismo número)
sin respuesta: no se sabe si se hizo (repetir con el mismo número)
cada respuesta dice si salió bien, si hay que corregir el pedido o si se puede reintentar.
Es la planilla que se presenta completa. Cada pedido lleva el pase de Rosa, que dice quién es (capítulo 18), lo que quiere hacer y los datos necesarios. El servidor no guarda lo que pasó en pedidos anteriores, que es lo que se llama estado. Por eso cualquier servidor atiende cualquier pedido.
Sin estado no significa sin memoria. Las cuentas siguen en la base de datos. Lo que no se guarda es la conversación.
todo lo necesario viaja en el pedido, y lo que debe durar se guarda en un lugar compartido.
Es el número de la planilla. Una operación es idempotente cuando hacerla una vez o diez deja el mismo efecto (capítulo 3). Bloquear una tarjeta lo es. «Transferir 800 Bs» no, y se vuelve idempotente con un número de pedido.
La app genera un código largo y único (aquí, 7c1e) por cada intención de Rosa y lo repite si reenvía el pedido. El servidor anota cada número con su respuesta en la base de datos compartida. Si llega uno ya anotado, devuelve esa respuesta sin transferir, y si trae otro monto, lo rechaza. Otros 800 Bs al mismo negocio son otra intención, con otro número.
Es lo que pedía el capítulo 15 para lo que se rehace tras un choque de versión, y lo que necesitan los mensajes que llegan dos veces (capítulo 16).
cada intención lleva su número, y repetir un pedido devuelve lo ya resuelto.
Son la carretera con sus señales y reglas. Un protocolo es el conjunto de reglas con que dos computadoras se entienden. En la red se apilan en capas, cada una con un solo trabajo.
La app conoce solo la capa de arriba. Rosa pasa del wifi a los datos móviles y el pedido es el mismo, y puede viajar además cifrado (capítulo 19).
cada capa resuelve un solo problema apoyándose en la de abajo, y se cambia una sin tocar las demás.
El número y la transferencia van juntos. Si el servidor comprueba el número, transfiere y después lo anota, dos pedidos iguales que llegan a la vez pasan los dos la comprobación, una condición de carrera (capítulo 15). Por eso se anota en el mismo todo o nada que la transferencia (capítulo 8), y la base rechaza un segundo registro igual.
Cuándo no conviene. Un programa chico, con un solo servidor y sin plata de por medio, puede guardar el paso de cada usuario en memoria. Una consulta tampoco necesita número.
Con qué se combina. Con los casos de uso (capítulo 6), la unidad de trabajo (capítulo 8), la concurrencia (capítulo 15), los eventos (capítulo 16), la seguridad (capítulo 18) y la criptografía (capítulo 19).
| En el edificio | En la app del banco | Patrón |
|---|---|---|
| Planilla con tres resultados posibles | Pedido con tres respuestas posibles | Request-Response |
| Planilla completa, que se entiende sola | Pedido completo, sin memoria del servidor | Stateless |
| Planilla con número, presentada dos veces, se paga una | Pedido con número, tocado dos veces, se transfiere una | Idempotency |
| Señales y reglas de la carretera | Protocolos en capas | Layered Protocols |
¿No sería más simple una ventanilla única, con un funcionario que conozca el caso de Marta?
Sí, mientras ese funcionario esté. Si falta, el trámite se frena, y un servidor que recuerda a Rosa tampoco se reemplaza sin que ella pierda el paso.
La carretera mezcla el medio con las reglas, porque asfalto y señal van en el mismo camino. En la red cada capa se cambia sola, y las capas reales a veces se juntan.
En la oficina, repetir cuesta papel y espera. En la red los reintentos son automáticos y pueden llegar miles a la vez (capítulo 24), así que la idempotencia la garantiza el servidor, con el número que la app repite, y no la buena voluntad de quien llama.
Los tres resultados son una convención, no una garantía. En una obra real la planilla se aprueba o se observa, y el tercer resultado es una licencia de este ejemplo. Un servidor mal hecho puede contestar «aprobado» con un error adentro.
En la práctica, a noviembre de 2026. La web usa HTTP, y tres de sus familias de códigos, 2xx, 4xx y 5xx, corresponden al aprobado, el observado y el no atendido. El estándar define GET, PUT y DELETE como idempotentes y no da esa garantía para POST, y las API de pagos suelen aceptar una clave de idempotencia, a menudo en el encabezado Idempotency-Key. Spring Boot (Java), ASP.NET Core (.NET) y FastAPI (Python) declaran cada ruta con su verbo y devuelven el código de cada respuesta. Debajo suelen ir TLS, TCP e IP, o QUIC sobre UDP en HTTP/3. Ver el mapa de tecnologías, en el capítulo 28.