Estado de publicación

Esta página existe para que nadie planifique sobre algo que todavía no hay. Cada fila dice en qué estado está de verdad, y las que no están listas dicen por qué.

Qué hay y qué no

Pieza	Estado	Detalle
API v1	Publicado	En producción, en la URL única. Emite 01, 03, 05, 06, 11 y 14, anula y registra eventos de retorno sobre 01, 11 y 14.
Contrato `openapi.yaml`	Publicado	Versión `0.1.0-esqueleto`. La propia API lo sirve en `GET /v1/openapi.json`, sin autenticar.
`@facta-dte/api` · TypeScript / JavaScript	Paquete público	Instálelo desde npm; consulte el código, los ejemplos y las versiones en GitHub. Esta referencia se comprueba contra el código fuente de `0.3.0`, la versión publicada en npm que el portal tiene fijada.
Adaptador de almacenamiento local	Publicado en el paquete	`FileInvoiceArchive` guarda archivos cifrados y `issueAndArchive` conserva los bytes JSON/PDF recibidos.
`facta-dte/api` · PHP	Disponible en Packagist	Versión `0.1.0`, publicada en Packagist. Se instala con `composer require facta-dte/api`, o con el ZIP de la página de versiones por FTP si el servidor no tiene Composer. El repositorio es Facta-DTE/facta-api-sdk-php. Cubre todo lo que necesita solo HTTP; el catálogo local cifrado, los destinos propios (BYOS) y el archivo local no están todavía. Detalle en SDK de PHP. Esta referencia se comprueba contra el código de la revisión `a6a16f8`.
Librerías para Python, C#, Java, Go	Pendientes; sin fecha	Para esos lenguajes la recomendación es HTTP directo. Lo que hay son ejemplos, no clientes.
URL de staging pública	No existe	Las pruebas se hacen en la misma URL con una llave `facta_test_`. No se publica una segunda URL, y si alguien le da una, no es de Facta.
Webhooks	Planificado	Sin fecha. Hoy el sello se conoce por la respuesta o consultando.
Tipos 07 y 15 en la API	Planificado	Comprobante de retención y de donación se emiten desde la app; por la API llegan con su tanda.

El contrato

Todo lo de este sitio se genera desde el mismo archivo en cada build. Si esta documentación y el servidor discrepan, manda el servidor — y es un error que conviene reportar a soporte@factadte.com.


`info.version`	`0.1.0-esqueleto`
SHA-256 de `openapi.yaml`	`adb50dfe668193e50ee4e6fa5b867e8c650c853283463037ca2cbeb858d00496`
Rutas descritas	25
Códigos de error	49 en el contrato (el SDK añade `network_error`)
Esquemas	52

Descargas: openapi.yaml (el original, con los comentarios que explican cada decisión de cable) y openapi.json (los mismos bytes en JSON, para Postman, Swagger Editor o un generador).

Lo que falta del catálogo

Dicho para que nadie lo descubra a mitad de una integración:

Ventas exentas o no sujetas por línea y los tributos especiales todavía no viajan en el cuerpo.
Los pagos mixtos y ventaTercero tampoco.
El comprobante de liquidación (08) está congelado, y el de contribuyente (09) queda fuera: lo emiten las administradoras de tarjetas.
El evento de Operaciones Especiales está construido y validado, pero el Manual Tecnológico 2.0 no publica todavía una ruta donde enviarlo. El evento de retorno sí se envía: por el servicio ordinario de recepción, y la API lo expone en POST /v1/dte/{codigoGeneracion}/return (guía). Su hoja en PDF viene en la respuesta.

Cómo se anuncia un cambio

Una ruta nueva, un campo nuevo o un código de error nuevo suben el número de versión del contrato y aparecen aquí y en la referencia el mismo día. Un campo no desaparece sin aviso: cuando algo se retire, esta página lo dirá antes con su fecha.

Para lo demás —caídas, mantenimiento, el estado del servicio del Ministerio— la fuente es la página de disponibilidad.