factadesarrolladores API 0.1.0-esqueleto

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

PiezaEstadoDetalle
API v1PublicadoEn 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.yamlPublicadoVersión 0.1.0-esqueleto. La propia API lo sirve en GET /v1/openapi.json, sin autenticar.
@facta-dte/api · TypeScript / JavaScriptPaquete públicoInstá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 localPublicado en el paqueteFileInvoiceArchive guarda archivos cifrados y issueAndArchive conserva los bytes JSON/PDF recibidos.
facta-dte/api · PHPDisponible en PackagistVersió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, GoPendientes; sin fechaPara esos lenguajes la recomendación es HTTP directo. Lo que hay son ejemplos, no clientes.
URL de staging públicaNo existeLas 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.
WebhooksPlanificadoSin fecha. Hoy el sello se conoce por la respuesta o consultando.
Tipos 04 y 07 en la APIEn stagingLa 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 APIPlanificadoEl 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.version0.1.0-esqueleto
SHA-256 de openapi.yaml511a82d2e104abcc34e9672adefb8004ed8080696f71dad9916bf8fa31a378d7
Rutas descritas54
Códigos de error112 en el contrato (el SDK añade network_error)
Esquemas76

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).

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

  • Los tributos especiales y ventaTercero todaví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, regimen y recintoFiscal son obligatorios: sin ellos la API responde 400 invalid_request antes 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.

Escriba para buscar Por ejemplo: idempotencia, contingencia, 422, emitir.

↑ ↓ moverse Enter abrir Esc cerrar