Documento Soporte

Emite documentos soporte en adquisiciones a sujetos no obligados a facturar, conforme a la resolución DIAN.

POST/v1/support-documents

Crea un documento soporte para compras a proveedores no obligados a facturar.

CampoTipoReq.Descripción
companyIdstring✅UUID de la empresa adquiriente
supplierobject✅Datos del proveedor (documento, nombre)
itemsarray✅Bienes o servicios adquiridos
curl -X POST https://api.mercalo.co/v1/support-documents \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "uuid-empresa",
    "supplier": {
      "documentType": "CC",
      "document": "98765432",
      "name": "Proveedor Ejemplo"
    },
    "items": [{
      "description": "Servicio de consultoría",
      "quantity": 1,
      "unitPrice": 800000,
      "taxRate": 0
    }]
  }'

Response (200 OK)

{
  "id": "sd_jkl012",
  "cude": "j0k1l2...",
  "status": "ACCEPTED",
  "total": 800000,
  "pdfUrl": "https://api.mercalo.co/v1/support-documents/sd_jkl012/pdf",
  "createdAt": "2026-03-12T16:00:00Z"
}
GET/v1/support-documents/:id

Consulta el detalle de un documento soporte.

curl https://api.mercalo.co/v1/support-documents/sd_jkl012 \
  -H "Authorization: Bearer sk_live_xxx"
GET/v1/support-documents

Lista documentos soporte con paginación.

curl "https://api.mercalo.co/v1/support-documents?companyId=xxx" \
  -H "Authorization: Bearer sk_live_xxx"

Errores comunes

CódigoDescripciónSolución
400Proveedor no válidoEl proveedor debe ser persona natural no facturadora
422Tipo documento inválidoUsar CC, CE, NIT o pasaporte
NóminaWebhooks