Facturator API es la puerta de entrada HTTP/JSON para integrar tu sistema con la plataforma de facturación electrónica de One Soft. Toda la operación (emisión, consulta, descarga de comprobantes) ocurre sobre un único conjunto coherente de endpoints REST.
¿Qué puedes hacer con la API?
- Registrar y administrar los negocios emisores (RUC, firma electrónica, logo, establecimientos).
- Mantener catálogos propios de clientes, proveedores, transportistas y productos / servicios.
- Emitir los seis tipos de comprobantes electrónicos del SRI: Factura, Liquidación de Compra, Nota de Crédito, Nota de Débito, Guía de Remisión y Comprobante de Retención.
- Descargar el comprobante autorizado en PDF o XML.
- Enviar el comprobante por correo electrónico al receptor.
- Consultar los catálogos oficiales del SRI (tipos de identificación, formas de pago, impuestos, etc.).
Principios de diseño
- REST por recurso. Cada dominio expone
GET / POST / PUT / DELETEsobre rutas estables y predecibles. - JSON en todas las direcciones. Excepto la descarga de archivos (PDF/XML) y la subida de la firma (
multipart/form-data). - Errores RFC 7807 (
application/problem+json) con detalle por campo en errores de validación. - Idempotencia natural en
GET / PUT / DELETE. ElPOSTde creación admite reintentos seguros mediante validaciones del propio backend. - Cálculo automático de impuestos para los tipos de comprobante 01, 03, 04 y 05. No necesitas calcular ni enviar
subtotal,totalnitaxes.