Qué podés hacer con la API
La API expone endpoints REST con respuestas JSON para las operaciones centrales del ciclo de un comprobante.
La conexión con DGI, los certificados digitales y la infraestructura son problema nuestro, no tuyo: tu software habla con la API y la plataforma se encarga del resto.
[DOCUMENTAR: URL base de la API en producción y en pruebas. Listado completo de endpoints con método HTTP, ruta y parámetros. Formato exacto del payload de emisión con un ejemplo completo de request y response. Tabla de códigos de error.]
- Emitir CFE
e-facturas, e-tickets, notas de crédito y débito, remitos electrónicos y resguardos: todos los tipos de comprobante definidos por DGI para emisores electrónicos.
- Consultar CFE
Estado y datos de comprobantes ya emitidos.
- Anular CFE
Cuando un comprobante no debió salir, se anula por la misma vía.
- Recibir webhooks
Notificaciones automáticas cuando un comprobante cambia de estado, para que tu sistema reaccione sin consultar en bucle.
Autenticación
[DOCUMENTAR: método de autenticación (clave de API, token, OAuth u otro), dónde se generan las credenciales, si hay credenciales separadas para pruebas y producción, y cómo se envían en cada request.]
Lo que sí podemos adelantarte: las credenciales se gestionan por cuenta, y en el modelo multi-RUT operás los RUTs de todos tus clientes bajo un solo contrato, sin manejar una integración distinta por cada empresa.
El flujo de emisión de un comprobante
Así se ve el ciclo completo de un CFE emitido por API.
- 1. Tu sistema arma el comprobante
Con los datos de la venta: receptor, líneas, importes y tipo de CFE. [DOCUMENTAR: campos obligatorios y opcionales.]
- 2. Lo enviás al endpoint de emisión
La API valida el pedido y lo procesa contra DGI. [DOCUMENTAR: ruta y método del endpoint, y si la emisión es síncrona o asíncrona.]
- 3. Recibís la respuesta
[DOCUMENTAR: contenido de la respuesta de emisión, identificador del CFE, estado inicial, y si incluye la representación impresa o el enlace para descargarla.]
- 4. El estado se actualiza solo
Cuando DGI acepta, rechaza o procesa el comprobante, un webhook le avisa a tu sistema. No hace falta consultar cada tantos segundos.
- 5. Consultás o anulás cuando haga falta
Los endpoints de consulta y anulación cierran el ciclo.
Webhooks: enterate cuando algo cambia
En lugar de que tu sistema pregunte por el estado de cada comprobante, la plataforma te avisa. Los webhooks notifican los cambios de estado de un CFE: aceptado, rechazado o anulado. Con eso podés marcar la venta como facturada recién cuando DGI aceptó el comprobante, o disparar una alerta interna ante un rechazo.
[DOCUMENTAR: cómo se registra la URL del webhook, formato del payload de cada evento, política de reintentos si el receptor no responde, y mecanismo de verificación de autenticidad.]
Entorno de pruebas
Tenés acceso a un entorno de pruebas para desarrollar y validar tu integración completa antes de pasar a producción, sin afectar RUTs reales ni la facturación de tus clientes. Emitís, consultás, anulás y recibís webhooks contra ese entorno hasta que todo funcione, y recién ahí cambiás.
[DOCUMENTAR: cómo se solicita el acceso al entorno de pruebas y en qué se diferencia técnicamente del de producción.]
Integraciones listas: WooCommerce y PrestaShop
Si tu caso es una tienda online, quizás no necesites escribir código: hay integraciones para WooCommerce y PrestaShop que generan el comprobante automáticamente con cada venta y sincronizan clientes y productos sin intervención manual. La API queda para lo que las integraciones no cubren, o para sistemas propios: es compatible con cualquier sistema que pueda hacer pedidos HTTP.
[DOCUMENTAR: cómo se instala y configura cada complemento, y dónde se descargan.]
Multi-RUT y marca blanca: facturá por tus clientes, bajo tu marca
El modelo pensado para casas de software, agencias y revendedores: ofrecés facturación electrónica como parte de tu producto, con tu marca, y Host Factura opera todo lo de atrás.
Cómo funciona el modelo multi-RUT
Gestionás múltiples RUTs bajo un solo contrato. Los CFE se emiten contra el RUT de cada empresa cliente tuya, mientras la plataforma opera la infraestructura, los certificados y la conexión con DGI en segundo plano. Arrancás con 5 RUTs y podés crecer a más de 2.000 sin cambiar de plataforma ni interrumpir el servicio a tus clientes.
La homologación ante DGI
Con un mínimo de 5 RUTs activos accedés al régimen de homologación simplificada: Host Factura gestiona el proceso completo en tu nombre. Tus clientes no tienen que pelearse con el trámite.
Cuánto cuesta
Todos los planes para revendedores parten de una tarifa base de $2.000 más IVA por mes con 5 RUTs incluidos. Desde ahí elegís entre pago por uso o bloques prepago, donde el precio por RUT baja a medida que escalás, con 20% de descuento en el pago anual.
Cómo empezar
- 1. Escribinos contándonos qué querés integrar
Tu stack, tu producto y tu volumen estimado. Con eso te orientamos sobre el plan y el camino técnico.
- 2. Te damos acceso al entorno de pruebas
Desarrollás y validás la integración completa, con acompañamiento del equipo técnico.
- 3. Pasás a producción
Cuando la integración está probada, activamos tu cuenta productiva y, si vas por el modelo multi-RUT, gestionamos la homologación simplificada.
Preguntas frecuentes
¿Host Factura tiene una API REST?
Sí. Endpoints REST con respuestas JSON para emisión, consulta y anulación de CFE, más webhooks para recibir los cambios de estado. Hay un entorno de pruebas para validar la integración antes de producción.
¿Qué tipos de comprobante puedo emitir por API?
Todos los definidos por DGI para emisores electrónicos: e-facturas, e-tickets, notas de crédito y débito, remitos electrónicos y resguardos.
¿Necesito integrarme por API si tengo una tienda WooCommerce o PrestaShop?
No necesariamente. Hay integraciones listas para ambas plataformas que generan el comprobante automáticamente con cada venta y sincronizan clientes y productos.
¿Puedo ofrecer la facturación bajo mi propia marca?
Sí. En el modelo de marca blanca comercializás la facturación dentro de tu producto y con tu marca. Los CFE se emiten contra el RUT de cada cliente tuyo y Host Factura opera la infraestructura, los certificados y la conexión con DGI.
¿Mis clientes tienen que homologarse ante DGI uno por uno?
Con un mínimo de 5 RUTs activos accedés a la homologación simplificada: Host Factura gestiona el proceso completo en tu nombre.
¿Cuánto cuesta integrar y revender?
La tarifa base es de $2.000 más IVA por mes con 5 RUTs incluidos. Después elegís pago por uso o bloques prepago, con 20% de descuento en el pago anual.