Resumen

Quetzal Invoicing es una sola API REST para emitir documentos fiscales — facturas, notas de crédito, notas de débito, complementos de pago y cancelaciones — contra las autoridades tributarias de Latinoamérica. Abstrae las diferencias por país (DIAN en Colombia, SAT en México, SRI en Ecuador, SUNAT en Perú) detrás de una sola forma de recurso: el Document.

POST /v1/documents

Le envías a Quetzal un documento con un issuer, un receiver, unos line_items y un country. Quetzal se encarga del resto: armar el payload específico del país (CFDI, UBL, XML), autenticar contra la autoridad tributaria, reintentar fallos transitorios y devolverte el ID fiscal final.

Qué hay en la API

Seis recursos cubren toda la superficie:

Recurso	Endpoint	Rol
Documents	/v1/documents	Documentos fiscales — el recurso principal. Tiene una máquina de estados (DRAFT → PENDING_SUBMISSION → EMITTED, más ramas de FAILED / CANCELLED).
Parties	/v1/parties	Emisores y receptores — cualquiera que aparezca como contraparte fiscal. Reutilizables entre documentos.
Issuer Profiles	/v1/issuer_profiles	La identidad fiscal de un tenant por país (certificado, rango de numeración, metadatos regulatorios).
Webhook Subscriptions	/v1/webhook_subscriptions	Endpoints que Quetzal llama cuando un documento cambia de estado.
FacturaGreen Webhooks	/v1/webhooks/factura_green	Endpoint entrante del proveedor MX — uso interno, no para llamadores directos.
Health	/v1/health	Probe de liveness.

Qué cubre hoy

País	Autoridad	Tipos de documento validados en producción
🇨🇴 Colombia	DIAN	Factura, nota de crédito, nota de débito, cancelación
🇲🇽 México	SAT	Factura, complemento de pago (CFDI), cancelación
🇪🇨 Ecuador	SRI	Factura, nota de crédito
🇵🇪 Perú	SUNAT	Factura

Los requisitos por país (folios, certificados, códigos de dirección) viven en el campo country_specific de cada request. Mirá la sección de Country specifics en la API Reference para la forma específica por país.

Adónde seguir

• ¿Construyendo una integración? Empezá por el Quickstart — un POST /v1/documents real de punta a punta en cinco minutos.
• ¿Buscando un endpoint o un campo? Abrí el API Reference — OpenAPI 3.1 renderizado inline.
• ¿Revisando el diseño? Leé los Principios y el System Design Document.
• ¿Atorado con un término? Revisá el Glosario.

Qué Quetzal NO hace

Para ajustar expectativas:

• No es un sistema contable. Quetzal registra documentos emitidos; el libro mayor, las conciliaciones y los reportes viven en otro lado.
• No es una pasarela de pagos. Los complementos de pago registran que un pago sucedió — Quetzal no cobra, ni rutea, ni liquida fondos.
• No es un motor de billing para clientes finales. Quetzal acepta documentos listos para emitir; el llamador decide cuándo y qué facturar.

En corto: vos calculás los ítems, Quetzal los vuelve legalmente fiscales.