Documento Soporte Electrónico

Crea, firma, transmite y consulta DSE con idempotencia obligatoria.

Documento Soporte Electrónico#

Crear + firmar + enviar#

POST /companies/{company_id}/dse/documentos - scope dse.write.

Header obligatorio: Idempotency-Key. Misma llave + mismo payload no duplica; misma llave + payload distinto devuelve 409.

Cada item requiere codigo UNSPSC de 8 dígitos, cantidad > 0 y precio/base. Para tarifa de IVA use porcentaje_iva; en DSE el alias iva se interpreta como valor monetario, no porcentaje.

Consultar#

GET /companies/{company_id}/dse/documentos/{doc_id} - scope dse.read.

Si recibe 502 con pending:true, no cree otra llave ni otro documento. Consulte el estado.

Ejemplo JSON - contado#

{
  "fecha_documento": "2026-10-07",
  "forma_generacion": "1",
  "forma_pago": "1",
  "medio_pago_codigo": "10",
  "moneda": "COP",
  "proveedor": {
    "tipo_documento": "31",
    "nit": "900000001",
    "dv": "1",
    "nombre": "PROVEEDOR DE PRUEBA SAS",
    "nombre_comercial": "PROVEEDOR DE PRUEBA",
    "regimen": "O-49",
    "dian_tax_scheme_code": "ZZ",
    "direccion": "Calle 1 # 2-3",
    "municipio": "Bogotá",
    "codigo_municipio": "11001",
    "departamento": "Cundinamarca",
    "codigo_departamento": "11",
    "pais": "CO",
    "email": "proveedor@example.com",
    "telefono": "3000000000",
    "codigo_postal": "111711"
  },
  "items": [
    {
      "codigo": "81112100",
      "descripcion": "Servicio de soporte tecnológico",
      "cantidad": 1,
      "unidad_medida": "EA",
      "precio_unitario": 100000,
      "porcentaje_iva": 19
    }
  ],
  "retenciones": []
}

[!IMPORTANT] Para la tarifa de IVA en DSE use porcentaje_iva. El campo iva se interpreta como valor monetario, no como porcentaje.