Bienvenida a Emitia

Emitia es una API HTTP de facturación electrónica DIAN Colombia, diseñada para desarrolladores. El objetivo: que puedas emitir tu primera factura válida ante la DIAN en menos de 10 minutos.

¿Qué hace Emitia por ti?

Lo que necesitas	Lo que Emitia resuelve
UBL XML válido DIAN	Lo construye por ti desde los datos del request
Firma XAdES-EPES	La aplica con tu certificado `.p12` (custodiado en Vault)
Envío SOAP a la DIAN	Lo gestiona con reintentos exponenciales
Contingencia Tipo 04	Automática cuando la DIAN está caída
Numeración atómica	Sin huecos, sin duplicados, sin race conditions
Multi-tenant	Cada tenant tiene su ambiente, su consecutivo, su certificado

Claves de API

Emitia usa Bearer tokens con prefijo tipado, igual que Stripe:

Prefijo	Modo	Alcance
`sk_test_…`	Sandbox	Llama endpoints reales sin enviar a la DIAN
`sk_live_…`	Producción	Envía facturas a la DIAN real

Nunca compartas una clave sk_live_. Rótala si sospechas que se filtró.

Ambientes

Ambiente	URL base	DIAN destino
Sandbox (test)	`https://api.emitia.co` + `sk_test_`	Ninguno (simulado)
Habilitación	`https://api.emitia.co` + `sk_live_` + tenant en habilitación	VPFE habilitación
Producción	`https://api.emitia.co` + `sk_live_` + tenant en producción	VPFE producción

Siguiente paso

Continúa con la guía de Inicio rápido para emitir tu primera factura de prueba en menos de 10 minutos.