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.

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}`).
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, reportes diarios y alertas de CAE/certificado sin polling. Ver Webhooks.

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

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.