Arquitectura de integración¶

Vista de alto nivel para equipos de desarrollo. No expone componentes internos confidenciales de Kordata ERP.

Flujo de una petición¶

Su sistema envía una petición HTTPS al host del API Gateway.
El gateway valida credenciales, versión y permisos.
Se ejecuta la operación correspondiente en el backend de negocio.
La respuesta se normaliza al formato documentado en Formato de respuestas.

Responsabilidades¶

Componente	Responsabilidad
Su aplicación	Construir peticiones, manejar reintentos, persistir correlaciones, proteger la API Key
API Gateway	Seguridad perimetral, contrato REST, límites, trazabilidad (`requestId`)

REST en el gateway¶

Usted trabaja con recursos HTTP familiares (GET, POST, PUT, DELETE) y rutas como /productos/{id}. El gateway se encarga de invocar las operaciones adecuadas en el ERP. No necesita conocer el lenguaje o protocolo interno de api.gateway.

Idempotencia y consistencia¶

Use identificadores devueltos en data (por ejemplo id tras un POST) para correlacionar registros entre su sistema y Kordata ERP.
Ante errores 5xx o timeouts, reintente con backoff; si el alta ya se aplicó, la api puede responder con error de duplicado — diseñe sus integraciones para consultar antes de re-crear.
Los listados paginados siguen convenciones tipo Spring (content, totalElements, page, size) dentro de data.

Documentación y contrato¶

Artefacto	Uso
Referencia API	Explorar y probar endpoints
Módulos	Vista por dominio de negocio