Facturación

Emite comprobantes electrónicos autorizados por el SRI desde tu aplicación con el API de Taxo Facturación.

Taxo Facturación emite comprobantes electrónicos autorizados por el SRI: facturas, notas de crédito, notas de débito, comprobantes de retención, guías de remisión y liquidaciones de compra.

El API está diseñado como un servicio web REST. Todas las operaciones reciben y responden JSON, incluso los errores.

URL base

Todas las rutas de esta sección son relativas a:

https://invoice.taxo.ws

Una operación se arma combinando el verbo HTTP, la URL base y la ruta descrita en cada página. Por ejemplo, para emitir una factura:

POSThttps://invoice.taxo.ws/invoices/issue

Ambientes

Cada comprobante declara el ambiente contra el que se emite en el campo ambiente:

Valor	Ambiente	Uso
`1`	Pruebas	Los comprobantes se autorizan contra el ambiente de pruebas del SRI.
`2`	Producción	Los comprobantes tienen validez tributaria.

Un comprobante emitido en pruebas no tiene validez tributaria. Verificá el valor de ambiente antes de salir a producción.

Credenciales

Para consumir el API necesitás dos claves:

Clave del API (X-Key): identifica a tu aplicación.
Clave del certificado de firma (X-Password): firma electrónicamente cada comprobante antes de enviarlo al SRI.

Solicitá tu API key al equipo de Taxo. El detalle de las cabeceras está en Autenticación.

Proceso de emisión

Taxo Facturación se encarga del ciclo completo. Bajo condiciones normales toma entre 3 y 5 segundos; después de ese período basta con consultar el comprobante para conocer su estado.

Creación: se registra el comprobante para referencia posterior.
Firmado: el comprobante se firma con el certificado de firma electrónica para que el SRI pueda verificar su legitimidad.
Envío al SRI: el comprobante se envía al SRI para ser procesado.
Consulta de autorización: tras un período de espera, Taxo consulta la autorización del comprobante ante el SRI.
Envío por correo: si se proveyó una dirección válida, el comprobante se envía al receptor.

El campo estado refleja en qué punto del proceso está el comprobante:

Estado	Significado
`RECIBIDO`	El comprobante fue recibido y registrado.
`ENVIADO`	El comprobante fue enviado al SRI.
`AUTORIZADO`	El SRI autorizó el comprobante.
`NO AUTORIZADO`	El SRI rechazó el comprobante. Revisá los mensajes de la respuesta.
`DEVUELTO`	El SRI devolvió el comprobante por errores de estructura.
`ERROR`	Ocurrió un error durante el proceso de emisión.

El proceso lo administramos nosotros. Para emitir un comprobante alcanza con enviarlo siguiendo la sección correspondiente de esta documentación.

Referencia de la API

Referencia interactiva de todos los endpoints del API de Extracción, generada desde la especificación OpenAPI de producción.

Autenticación

Cabeceras de autenticación, clave del certificado de firma e idempotencia del API de Taxo Facturación.