Capa de interoperabilidad · Prueba técnica de arquitectura

ADR-007: qué es síncrono y qué es asíncrono

Aceptado el 10/11/2026 por Andrés. Responde la "regla importante" del PDF.

Regla

Es síncrono lo que el canal necesita saber antes de seguir y que la capa puede responder con sus propios datos. Es asíncrono todo lo que depende de un sistema que la capa no controla.

Aplicación

Síncrono Asíncrono
Consultas de stock y precio (modelo de lectura) Alimentación del modelo de lectura desde ERP y WMS
Validación de token, catálogo y precio Cobro en la pasarela
Reserva de stock (gRPC interno) Registro de la orden en el OMS
Consulta de estado de orden Notificaciones a partners
Eventos de despacho y entrega

Tabla completa con razones en docs/to-be/01-arquitectura.md.

Qué se sacrifica

Crear orden responde 202 y no el resultado final. El canal debe escuchar el webhook o consultar el estado.

Consecuencia verificable

Ninguna API externa llama en línea a ERP, WMS, OMS ni CRM. Se comprueba apagando los mocks: las lecturas siguen respondiendo y las órdenes se siguen aceptando.