Factura electrónica de venta · FEV

Facturación electrónica

Disponible

Emite facturas electrónicas de venta, notas crédito y notas débito a nombre de cualquier empresa autorizada con un solo contrato JSON. Gravamenex construye el XML UBL 2.1, firma con XAdES, transmite a la DIAN y entrega los artefactos.

Qué incluye
  • POST /v1/invoices, /v1/credit-notes y /v1/debit-notes con respuesta 202 y procesamiento asíncrono.
  • Numeración autorizada por empresa: rangos DIAN sincronizados, alerta de agotamiento y series internas para notas.
  • Cálculo con enteros en COP: IVA, INC, ICA, retenciones, anticipos y pagos a crédito con vencimiento.
  • Catálogos oficiales 2026 de motivos de nota, tipos de identificación y responsabilidades fiscales.
  • Idempotencia por header, reintentos sin duplicar CUFE y auditoría por documento.
Estados del documento
EstadoSignificadoEvento webhook
queuedPersistido y numerado; pendiente de firma y envío—
acceptedValidación previa DIAN correcta (código 00)document.accepted
rejectedRechazo con reglas FAD/FAJ detalladasdocument.rejected
manual_reviewRespuesta ambigua o timeout; conciliación pendientedocument.manual_review
Ejemplo mínimo

Ejemplo de código · sustituye los datos antes de usarlo

POST /v1/invoices
{
  "organization_nit": "900234567",
  "source_reference": "FEV-1042",
  "currency": "COP",
  "buyer": {
    "identification_type": "NIT",
    "identification_number": "800123456",
    "verification_digit": "1",
    "organization_type": "legal_entity",
    "tax_tribute_code": "01",
    "legal_name": "Inversiones Bogotá S.A.S."
  },
  "lines": [{
    "code": "SRV-01",
    "description": "Servicio de consultoría",
    "quantity": "1",
    "unit_code": "EA",
    "standard_code": "001",
    "unit_price_minor": 45000000,
    "taxes": [{ "code": "VAT", "rate_basis_points": 1900, "treatment": "taxed" }]
  }],
  "payment_details": [{ "form": "cash", "method_code": "CASH", "amount_minor": 53550000 }]
}