Introducción a Host Factura

Host Factura es la plataforma de facturación electrónica de Host Admin para Uruguay. Su API REST permite emitir, consultar y administrar Comprobantes Fiscales Electrónicos (CFE) integrándose con los servicios de la DGI (Dirección General Impositiva), sin que tengas que armar la integración SOAP/XML contra DGI desde cero.

Y, en las cuentas que lo tengan habilitado, también cobra: links de pago, cobro con tarjeta registrada y suscripciones, con el comprobante fiscal emitido automáticamente cuando el cobro se confirma. Ver Cobros con tarjeta.

La idea es simple: tu sistema envía un JSON con los datos de la operación y Host Factura se encarga de armar el XML del CFE, calcular totales e IVA, asignar el CAE y la numeración, firmarlo digitalmente y enviarlo a DGI.

Qué resuelve

Necesidad	Cómo la cubre Host Factura
Emitir CFE sin operar SOAP de DGI	Enviás un JSON estructurado a `POST /v1/cfe/emitir` y la plataforma hace el resto. Ver Emisión de CFE.
Migrar un armador de XML existente	Si ya emitías XML contra DGI, lo enviás tal cual a `POST /v1/cfe/emitir-xml`; Host Factura solo firma, numera y envía.
Cubrir todos los tipos de comprobante	e-Ticket, e-Factura, Exportación, Cuenta Ajena, Boleta de Entrada, e-Remito, e-Resguardo y sus Notas. Ver Tipos de CFE.
Numeración y CAE sin colisiones	Serie y número se asignan dentro de una transacción con lock sobre el CAE vigente.
Capturar datos propios del negocio en cada CFE	Campos no fiscales definidos por cuenta (transacción de pago, referencia externa, etc.). Ver Metadatos personalizados.
PDF e impresión	PDF con QR de DGI en formato A4 o rollo térmico (`GET /v1/cfe/pdf/{id}`).
Leer los comprobantes que recibís	Listado, detalle, PDF y XML firmado de los CFE que te mandan tus proveedores, aunque no emitas. Ver CFE recibidos.
Consultar padrón y cotizaciones	Datos de empresas por RUT y tipos de cambio del BCU.
Notificaciones en tiempo real	Webhooks para recibir eventos de CFE, cobros, reportes diarios y alertas de CAE/certificado sin polling. Ver Webhooks.
Cobrar con tarjeta	Links de cobro, tarjetas guardadas del cliente y suscripciones recurrentes. Cobrar no obliga a facturar: el CFE del cobro se emite si lo pedís, al cobrar o después. Ver Cobros con tarjeta.
Tener tus clientes en Host Factura	Crear o recuperar un cliente con tu propio identificador, con o sin documento. Ver Clientes.
Acotar lo que una credencial puede hacer	Alcances por `ApiAccess`: una clave que sólo cobra no puede emitir ni tocar tarjetas. Ver Autenticación.
Integrar una vez y facturar por varias empresas	Una credencial de revendedor opera sobre las subcuentas de su cartera con la cabecera `x-cuenta-id`.

Cómo encaja con DGI

DGI define un régimen de documentación electrónica obligatorio en el que cada operación comercial debe respaldarse con un CFE válido. El flujo, simplificado:

Tu sistema le pide a Host Factura emitir un CFE (JSON o XML).
Host Factura asigna CAE (Código de Autorización de Emisión: serie, rango y vencimiento autorizados por DGI), arma y firma el XML con el certificado digital de la cuenta.
Se construye el sobre, se valida contra los XSD oficiales de DGI y se envía por SOAP.
DGI responde con un estado (aceptado / observado / rechazado / pendiente) que queda persistido en el CFE.
Diariamente se envía a DGI el reporte diario con el detalle de lo emitido.

Por dónde empezar

Si querés ver la API funcionando primero, seguí el Inicio rápido: de la credencial al primer e-Ticket emitido en homologación.
Conseguí tu API_KEY y entendé el modelo de credenciales en Autenticación.
Repasá los Tipos de CFE para saber qué comprobante corresponde a cada operación, explicado como lo plantea DGI.
Emití tu primer CFE siguiendo Emisión de CFE.
Si necesitás capturar datos propios del negocio en cada CFE, mirá Metadatos personalizados.
Configurá notificaciones en tiempo real con Webhooks.
Si además vas a cobrar, seguí Cobros con tarjeta.