GravamenexAPI
Obtener API key
Adquisiciones a no obligados a facturar · DSNO

Documento soporte

En habilitación

Respalda compras de bienes y servicios a sujetos no obligados a facturar. Implementado en el servicio de facturación con tipo de documento 05, huella CUDS-SHA384, notas de ajuste tipo 95 y entrega asíncrona de artefactos.

Qué incluye
  • POST /v1/acquisition-supports para documento soporte electrónico (tipo 05) y POST /v1/acquisition-support-adjustments para notas de ajuste (tipo 95).
  • Roles invertidos: emitido por el adquirente con los datos del vendedor no obligado (cédula o NIT) en el bloque de proveedor.
  • Huella CUDS-SHA384 firmada con el PIN del software, sin requerir clave técnica de la DIAN.
  • Modalidad acumulada semanal opcional para operaciones con el mismo proveedor (máximo 7 días dentro del mismo mes calendario).
  • Numeración autorizada propia por empresa registrada vía POST /v1/admin/organizations/{organization_id}/numbering-ranges.
  • Mismos artefactos y entrega asíncrona de facturación: XML UBL firmado, PDF con QR oficial, AttachedDocument y webhooks HMAC.
Estado del servicio

El documento soporte está implementado y disponible para pruebas en el ambiente de desarrollo y sandbox.

La salida a producción queda sujeta a la ejecución del set de pruebas de habilitación del documento soporte ante la DIAN.

Ejemplo mínimo
POST /v1/acquisition-supports
{
  "organization_nit": "900234567",
  "source_reference": "compra-2026-09-13-0007",
  "currency": "COP",
  "vendor": {
    "identification_type": "CC",
    "identification_number": "1020304050",
    "organization_type": "natural_person",
    "given_names": "Vendedor no obligado"
  },
  "period": { "start_date": "2026-09-07", "end_date": "2026-09-13" },
  "lines": [{
    "code": "SERV-01",
    "description": "Servicios de mantenimiento",
    "quantity": "1.00",
    "unit_code": "EA",
    "standard_code": "001",
    "unit_price_minor": 85000000,
    "taxes": [{ "code": "VAT", "rate_basis_points": 0, "treatment": "excluded" }]
  }],
  "payment_details": [{ "form": "cash", "method_code": "10", "amount_minor": 85000000 }]
}