Facturación Electrónica

Crea, procesa y consulta FE desde tu software utilizando los scopes de Facturación.

Facturación Electrónica#

Crear#

POST /companies/{company_id}/fe/facturas - scope fe.write.

El flujo crea, firma y procesa/envía la factura. Use draft_key estable por operación. Descubra method_id con GET /fe/payment-methods; los IDs son específicos de cada empresa.

Impuestos#

En FE, la tarifa exactamente 8% se normaliza como INC código DIAN 04. Otros porcentajes positivos sin código explícito usan IVA 01. No traslade esta regla a DSE.

Consulta#

GET /fe/docs
GET /fe/docs/{doc_id}
GET /fe/terceros
GET /fe/payment-methods
POST /dian/get-acquirer

Consulte el manual maestro y OpenAPI para esquemas completos.

Ejemplo JSON - contado#

{
  "receptor": {
    "tipo_doc": "13",
    "numero_doc": "1000000000",
    "nombre": "CLIENTE DE PRUEBA",
    "email": "cliente@example.com",
    "direccion": "Bogotá D.C."
  },
  "items": [
    {
      "desc": "Servicio de integración",
      "cant": 1,
      "unit": 100000,
      "iva": 19,
      "iva_incluido": true,
      "unit_input": 119000
    }
  ],
  "subtotal": 100000,
  "impuestos": 19000,
  "total": 119000,
  "es_contingencia": false,
  "fecha_emision": "2026-10-07",
  "payment": {
    "form": "contado",
    "method_id": "REEMPLAZAR_CON_ID_EMPRESA",
    "means_code": "10",
    "due_date": ""
  },
  "aiu": {
    "enabled": false,
    "contract_base": 100000,
    "administracion_percent": 0,
    "imprevistos_percent": 0,
    "utilidad_percent": 0,
    "tax_rate": 19,
    "iva_base_mode": "AIU_TOTAL"
  },
  "withholdings": [],
  "observaciones": "Ejemplo FE contado",
  "attachment_tokens": [],
  "draft_key": "venta-demo-000001"
}

En FE, una tarifa exactamente 8% se normaliza como INC código DIAN 04 en la lógica documentada. No traslade esta regla a DSE.