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 · las diez rutas | Publicado | En producción, en la URL única. Emite 01, 03, 05, 06, 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/api · TypeScript | Solo código fuente | 0.1.0-beta.1. Vive en sdks/typescript/ del repositorio. Todavía no está en npm; publicarlo es una puerta de liberación pendiente. |
| Adaptador de almacenamiento local | No disponible | El cliente no expone ninguno. downloadDocument le entrega los bytes y la persistencia es suya. El contrato se documentará aquí antes de habilitarse. |
| Librerías para Python, PHP, C#, Java, Go | No están planificadas | 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 | ce706ab617b33f6d7f9bd4e18e556e9fa0fd31d16d071f5b2da1ce37a78fb749 |
| Rutas descritas | 9 |
| Códigos de error | 29 en el contrato (el SDK añade network_error) |
| Esquemas | 23 |
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
ventaTercerotampoco. - El comprobante de liquidación (08) está congelado, y el de contribuyente (09) queda fuera: lo emiten las administradoras de tarjetas.
- Los eventos de Retorno y de Operaciones Especiales están construidos y validados, pero el Manual Tecnológico 2.0 no publica todavía una ruta donde enviarlos.
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.