Contrato y disponibilidad
Referencia contractualOpenAPI 3.1 disponible
Abrir referencia API La referencia navegable se genera desde el mismo contrato tipado que usa la API.
Fuente única
Sección titulada «Fuente única»La referencia de operaciones, esquemas, seguridad, servidores y errores se genera desde:
packages/public-api/generated/openapi.jsonLas guías explican decisiones y responsabilidades; no mantienen una segunda lista de endpoints.
Qué significa “documentado”
Sección titulada «Qué significa “documentado”»Una operación en OpenAPI define su contrato, pero su disponibilidad depende además de:
- ambiente;
- feature flag del piloto;
- contribuyente;
- estado de certificación;
- tipos e-CF;
- scopes de la cuenta de servicio.
Compatibilidad
Sección titulada «Compatibilidad»El contrato público usa la versión mayor en la URL y registra cambios en el changelog. Las modificaciones incompatibles no se introducen silenciosamente dentro de la misma versión mayor.
Los ejemplos generados desde OpenAPI muestran la forma vigente, pero no sustituyen:
- credenciales del ambiente;
- fixtures acordados con el piloto;
- reglas fiscales aplicables al contribuyente;
- respuesta oficial de la DGII.
Acceso piloto
Sección titulada «Acceso piloto»Antes de recibir una credencial, se confirman:
- contribuyente y responsable;
- estado del emisor;
- tipos e-CF;
- volumen y SLA del piloto;
- sistema fuente por etapa;
- identificador externo;
- corte contra doble emisión;
- contacto técnico y fiscal.