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 en producción (y, en staging, la nota de remisión 04 y el comprobante de retención 07, vea su guía), 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.2.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 046b661. |
| 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 04 y 07 en la API | En staging | La nota de remisión (04) y el comprobante de retención (07, solo para agentes de retención) están en staging; llegan a producción con su publicación. Tipado en el SDK de TypeScript: próxima versión; en el SDK de PHP: una versión posterior. Vea la guía. |
| Tipo 15 en la API | Planificado | El comprobante de donación se emite desde la app; por la API llega 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 | 511a82d2e104abcc34e9672adefb8004ed8080696f71dad9916bf8fa31a378d7 |
| Rutas descritas | 54 |
| Códigos de error | 112 en el contrato (el SDK añade network_error) |
| Esquemas | 76 |
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:
- Los tributos especiales y
ventaTercerotodavía no viajan en el cuerpo. (Las ventas exentas o no sujetas por línea sí:tipoVenta. Los cargos y abonos que no afectan la base imponible también:noGravado. Los pagos mixtos también:pagos[], vea Forma de pago.) - En una exportación de bienes
exportacion.tipoRegimen,regimenyrecintoFiscalson obligatorios: sin ellos la API responde400 invalid_requestantes de gastar correlativo (Exportación). - 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.