Emitir factura electrónica de venta
const url = 'https://example.com/v1/invoices?wait=true';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"operationType":"example","currency":"example","exchangeRate":{"rate":1,"date":"2026-04-15","currency":"example"},"taxPointDate":"2026-04-15","despatchReferences":[{"id":"example","issueDate":"2026-04-15"}],"receiptReferences":[{"id":"example","issueDate":"2026-04-15"}],"taxRepresentative":{"idType":"11","idNumber":"example","dv":"example"},"delivery":{"date":"2026-04-15","time":"example","address":{"line":"example","cityCode":"example","cityName":"example","departmentCode":"example","departmentName":"example","postalCode":"example","countryCode":"CO","countryName":"example"},"party":{"personType":"1","idType":"11","idNumber":"example","dv":"example","name":"example","tradeName":"example","firstName":"example","familyName":"example","email":"hello@example.com","phone":"example","address":{"line":"example","cityCode":"example","cityName":"example","departmentCode":"example","departmentName":"example","postalCode":"example","countryCode":"CO","countryName":"example"},"taxResponsibilities":["example"],"taxScheme":"01"}},"deliveryTerms":{"incoterm":"CFR","description":"example","specialTerms":"example"},"interoperability":[{"group":"example","collections":[{"name":"example","fields":[{"name":"example","value":"example","schemeId":"example","schemeName":"example"}]}]}],"notes":["example"],"orderReference":"example","payment":{"form":"1","method":"10","dueDate":"2026-04-15","paymentId":"example"},"items":[{"code":"example","description":"example","quantity":1,"unitCode":"94","unitPrice":1,"discount":1,"discountReason":"example","taxes":[{"code":"20","rate":1,"perUnitAmount":1,"baseUnitMeasure":1,"baseUnitCode":"example","name":"example"}],"standardCodeScheme":"999","freeOfCharge":true,"note":"example","sellersItemId":"example","additionalIds":[{"id":"example","schemeName":"example"}],"brand":"example","model":"example","attributes":[{"name":"example","value":"example","quantity":1,"unitCode":"example"}],"principal":{"idType":"11","idNumber":"example","dv":"example","name":"example"},"transport":{"filingNumber":"example","remittanceNumber":"example","freightValue":1,"quantity":1,"unitCode":"KGM"},"deliveryLocation":{"id":"example","schemeName":"example"},"packSize":1,"purchaseDate":"2026-04-15"}],"withholdings":[{"code":"05","rate":1,"taxableAmount":1}],"allowanceCharges":[{"isCharge":true,"reason":"example","amount":1,"reasonCode":"example"}],"prepayments":[{"id":"example","amount":1,"receivedDate":"2026-04-15","paidDate":"2026-04-15","paidTime":"example","instructions":"example"}],"payableRounding":1,"rangeId":"example","customer":{"personType":"1","idType":"11","idNumber":"example","dv":"example","name":"example","tradeName":"example","firstName":"example","familyName":"example","email":"hello@example.com","phone":"example","address":{"line":"example","cityCode":"example","cityName":"example","departmentCode":"example","departmentName":"example","postalCode":"example","countryCode":"CO","countryName":"example"},"taxResponsibilities":["example"],"taxScheme":"01"},"dueDate":"2026-04-15","contingency":true,"dueDiligence":"01","export":true}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url 'https://example.com/v1/invoices?wait=true' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "operationType": "example", "currency": "example", "exchangeRate": { "rate": 1, "date": "2026-04-15", "currency": "example" }, "taxPointDate": "2026-04-15", "despatchReferences": [ { "id": "example", "issueDate": "2026-04-15" } ], "receiptReferences": [ { "id": "example", "issueDate": "2026-04-15" } ], "taxRepresentative": { "idType": "11", "idNumber": "example", "dv": "example" }, "delivery": { "date": "2026-04-15", "time": "example", "address": { "line": "example", "cityCode": "example", "cityName": "example", "departmentCode": "example", "departmentName": "example", "postalCode": "example", "countryCode": "CO", "countryName": "example" }, "party": { "personType": "1", "idType": "11", "idNumber": "example", "dv": "example", "name": "example", "tradeName": "example", "firstName": "example", "familyName": "example", "email": "hello@example.com", "phone": "example", "address": { "line": "example", "cityCode": "example", "cityName": "example", "departmentCode": "example", "departmentName": "example", "postalCode": "example", "countryCode": "CO", "countryName": "example" }, "taxResponsibilities": [ "example" ], "taxScheme": "01" } }, "deliveryTerms": { "incoterm": "CFR", "description": "example", "specialTerms": "example" }, "interoperability": [ { "group": "example", "collections": [ { "name": "example", "fields": [ { "name": "example", "value": "example", "schemeId": "example", "schemeName": "example" } ] } ] } ], "notes": [ "example" ], "orderReference": "example", "payment": { "form": "1", "method": "10", "dueDate": "2026-04-15", "paymentId": "example" }, "items": [ { "code": "example", "description": "example", "quantity": 1, "unitCode": "94", "unitPrice": 1, "discount": 1, "discountReason": "example", "taxes": [ { "code": "20", "rate": 1, "perUnitAmount": 1, "baseUnitMeasure": 1, "baseUnitCode": "example", "name": "example" } ], "standardCodeScheme": "999", "freeOfCharge": true, "note": "example", "sellersItemId": "example", "additionalIds": [ { "id": "example", "schemeName": "example" } ], "brand": "example", "model": "example", "attributes": [ { "name": "example", "value": "example", "quantity": 1, "unitCode": "example" } ], "principal": { "idType": "11", "idNumber": "example", "dv": "example", "name": "example" }, "transport": { "filingNumber": "example", "remittanceNumber": "example", "freightValue": 1, "quantity": 1, "unitCode": "KGM" }, "deliveryLocation": { "id": "example", "schemeName": "example" }, "packSize": 1, "purchaseDate": "2026-04-15" } ], "withholdings": [ { "code": "05", "rate": 1, "taxableAmount": 1 } ], "allowanceCharges": [ { "isCharge": true, "reason": "example", "amount": 1, "reasonCode": "example" } ], "prepayments": [ { "id": "example", "amount": 1, "receivedDate": "2026-04-15", "paidDate": "2026-04-15", "paidTime": "example", "instructions": "example" } ], "payableRounding": 1, "rangeId": "example", "customer": { "personType": "1", "idType": "11", "idNumber": "example", "dv": "example", "name": "example", "tradeName": "example", "firstName": "example", "familyName": "example", "email": "hello@example.com", "phone": "example", "address": { "line": "example", "cityCode": "example", "cityName": "example", "departmentCode": "example", "departmentName": "example", "postalCode": "example", "countryCode": "CO", "countryName": "example" }, "taxResponsibilities": [ "example" ], "taxScheme": "01" }, "dueDate": "2026-04-15", "contingency": true, "dueDiligence": "01", "export": true }'Authorizations
Sección titulada «Authorizations»Parameters
Sección titulada «Parameters»Header Parameters
Sección titulada «Header Parameters»Id o NIT del facturador. Obligatorio con llaves de cuenta; ignorado con llaves restringidas.
Repetir la petición con la misma llave devuelve el mismo documento, sin emitir otro.
Solo con API keys de sandbox (sk_sandbox_…): elige el resultado de la DIAN simulada: accepted (por defecto), rejected:
Query Parameters
Sección titulada «Query Parameters»True: espera la respuesta de la DIAN en la misma petición
Request Bodyrequired
Sección titulada «Request Bodyrequired»Una factura electrónica de venta
object
El tipo de operación (CustomizationID); cada tipo de documento tiene el suyo por defecto. Facturas: 10 estándar (por defecto), 09 AIU, 11 mandatos (ingresos para terceros: las líneas indican su mandante), 12 transporte de carga (las líneas llevan su remesa del RNDC), 14 notarios, 15 compra y 16 venta de divisas (envíe dueDiligence). Documentos soporte y sus notas de ajuste: 10 residente (por defecto), 11 no residente. POS: 10; sus notas de ajuste: 20. Notas crédito: 20 con referencia a una factura (por defecto) o 22 sin ella; notas débito: 30 (por defecto) o 32. Facturas y notas del sector salud: SS-CUFE, SS-CUDE, SS-POS (notas que referencian un documento), SS-SNum, SS-Recaudo, SS-Reporte, SS-SinAporte (con los datos del sector en interoperability). Cualquier otro se rechaza
La moneda, ISO 4217 (tabla 13.3.3); COP si no se envía. Un documento en otra moneda necesita exchangeRate
La tasa de cambio (PaymentExchangeRate): obligatoria para un documento en moneda extranjera; opcional para uno en COP. Los totales del documento se informan también en la otra moneda (la extensión TotalesCop de la DIAN)
object
El día en que se fijó la tasa
Para un documento en COP: la moneda extranjera (ISO 4217) en la que también se informan sus totales. No la envíe cuando el documento mismo está en moneda extranjera (la conversión es entonces a COP)
Cuándo se causa el impuesto, si no es la fecha de emisión (TaxPointDate)
Documentos de despacho relacionados con el documento (DespatchDocumentReference)
Un documento relacionado: un documento de despacho o de recepción
object
Su número, con prefijo (hasta 20 caracteres)
Su fecha de emisión
Documentos de recepción relacionados con el documento (ReceiptDocumentReference)
Un documento relacionado: un documento de despacho o de recepción
object
Su número, con prefijo (hasta 20 caracteres)
Su fecha de emisión
La persona autorizada para descargar el documento en nombre del comprador (TaxRepresentativeParty)
object
Tipo de documento de identidad (tabla 13.2.1): 11 registro civil, 12 tarjeta de identidad, 13 cédula de ciudadanía, 21 tarjeta de extranjería, 22 cédula de extranjería, 31 NIT, 41 pasaporte, 42 documento de identificación extranjero, 47 PEP, 48 PPT, 50 NIT de otro país, 91 NUIP
El número del documento de identidad, sin el dígito de verificación
El dígito de verificación del NIT; obligatorio si idType es 31
La entrega de los bienes: cuándo, dónde y a quién
object
Cuándo se entregaron los bienes
A qué hora, HH:mm:ss en hora de Bogotá
Dónde se entregaron; en el exterior para una exportación
object
La dirección, ej. “Calle 100 # 10-20”
El código DIVIPOLA del municipio, 5 dígitos, p. ej. 11001 (Bogotá); obligatorio solo en Colombia
El nombre del municipio (o de la ciudad extranjera)
El código DIVIPOLA del departamento, 2 dígitos, p. ej. 11; obligatorio solo en Colombia
El nombre del departamento (un estado o provincia en el exterior)
Código postal
País, ISO 3166-1 alfa-2; CO por defecto
Nombre del país en español; Colombia si el país es CO y no se envía
Quién los recibió o los transportó: el destinatario o el transportador
object
1 = persona jurídica, 2 = persona natural
Tipo de documento de identidad (tabla 13.2.1): 11 registro civil, 12 tarjeta de identidad, 13 cédula de ciudadanía, 21 tarjeta de extranjería, 22 cédula de extranjería, 31 NIT, 41 pasaporte, 42 documento de identificación extranjero, 47 PEP, 48 PPT, 50 NIT de otro país, 91 NUIP
Número del documento de identidad, sin dígito de verificación, puntos ni guiones
Dígito de verificación del NIT; obligatorio cuando idType es 31
Razón social, o el nombre completo de una persona natural
Nombre comercial, si es distinto de la razón social
Nombres de una persona natural, por separado (se muestran en la representación gráfica)
Apellidos de una persona natural, por separado
Correo donde recibe los documentos electrónicos
Teléfono de contacto
Dirección; solo se puede omitir para el consumidor final de un documento POS
object
La dirección, ej. “Calle 100 # 10-20”
El código DIVIPOLA del municipio, 5 dígitos, p. ej. 11001 (Bogotá); obligatorio solo en Colombia
El nombre del municipio (o de la ciudad extranjera)
El código DIVIPOLA del departamento, 2 dígitos, p. ej. 11; obligatorio solo en Colombia
El nombre del departamento (un estado o provincia en el exterior)
Código postal
País, ISO 3166-1 alfa-2; CO por defecto
Nombre del país en español; Colombia si el país es CO y no se envía
Responsabilidades fiscales del RUT (los códigos de GET /v1/catalogs/tax-responsibilities, del Anexo Técnico 1.9): O-13 gran contribuyente, O-15 autorretenedor, O-23 agente de retención de IVA, O-47 régimen simple, O-48 responsable de IVA, O-49 no responsable de IVA, R-99-PN no responsable (por defecto si no se envía)
Régimen tributario: 01 IVA, 04 impuesto al consumo (INC), ZA IVA e INC, ZZ no aplica (por defecto)
Las condiciones de la entrega (DeliveryTerms): quién asume el costo y el riesgo
object
El INCOTERM (tabla 13.3.7): CFR, CIF, CIP, CPT, DAP, DAT, DDP, EXW, FAS, FCA, FOB
La condición en palabras (LossRisk); si no se envía, el nombre del catálogo, p. ej. ‘Franco a bordo’
Condiciones especiales pactadas para la entrega, en palabras, p. ej. ‘Portes pagados’
Valores con nombre de un sector (la extensión Interoperabilidad de la DIAN): el sector salud informa aquí sus datos, una exportación sus datos adicionales
Un grupo de la extensión Interoperabilidad: valores con nombre de un sector (los del sector salud, los datos adicionales de una exportación)
object
El nombre del grupo, como lo definen las reglas del sector (p. ej. ‘Sector Salud’ o ‘Exportación’)
Sus colecciones
Una colección de valores con nombre
object
El nombre de la colección, p. ej. ‘Usuario’
Sus valores
Un valor con nombre
object
El nombre del campo, p. ej. ‘CODIGO_PRESTADOR’
Su valor
El identificador del esquema del valor, cuando el sector lo define
El nombre del esquema del valor, cuando el sector lo define
Notas de texto libre, se imprimen en el documento
Número de la orden de compra del comprador
Cómo se paga el documento
object
1 = contado (se paga ya), 2 = crédito (se paga después: envíe dueDate)
Medio de pago (tabla 13.3.4.2): 10 efectivo (por defecto), 42 consignación bancaria, 47 transferencia, 48 tarjeta crédito, 49 tarjeta débito, ZZZ otro
Cuándo se debe pagar una venta a crédito
La referencia propia del pago (PaymentID): un número de transferencia, un acuerdo de pago
Las líneas: de 1 a 1000
Una línea del documento: un producto o servicio
object
Código del producto en su estándar (ver standardCodeScheme)
Lo que se vende
Unidad de medida, recomendación 20 de UN/ECE: 94 unidad (por defecto), KGM kilogramo, HUR hora, MTR metro…
Por qué se da el descuento
Impuestos de la línea; vacío (por defecto) para una línea que no lleva
Un tributo de una línea, como porcentaje de su valor o como valor por unidad
object
El tributo (tabla 13.2.6.1): 01 IVA, 02 impuesto al consumo (IC), 03 ICA, 04 impuesto nacional al consumo (INC), 20 a 36 los tributos especiales (22 bolsas, 23 carbono, 24 combustibles, 32 licores ICL, 33 plásticos de un solo uso INPP, 34 bebidas azucaradas IBUA, 35 comestibles ultraprocesados ICUI, 36 ad valorem ADV…), ZZ otro tributo (envíe su nombre)
Para un tributo que se cobra por unidad: el valor por unidad de medida, con máximo 2 decimales — por bolsa en el 22, por cada 100 ml en el IBUA (34), por gramo en el INPP (33), por grado alcoholimétrico en el ICL (32), por galón en los combustibles. El tributo es perUnitAmount × baseUnitMeasure (÷ 100 en el IBUA; × la cantidad en las bolsas). Envíe rate o perUnitAmount, no ambos: 21 timbre, 22 bolsas, 23 carbono, 24 combustibles, 33 INPP y 34 IBUA siempre van por unidad
Para un tributo por unidad: a cuántas unidades de medida se aplica (los mililitros, gramos, grados alcoholimétricos o galones vendidos en la línea). Por defecto, la cantidad de la línea; no se acepta en el impuesto a las bolsas (22), que siempre se cobra por bolsa sobre la cantidad
Para un tributo por unidad: la unidad de baseUnitMeasure, recomendación 20 de UN/ECE (MLT mililitro, GRM gramo, GLL galón, LTR litro…). Por defecto, el unitCode de la línea
El nombre del tributo: obligatorio para ZZ (p. ej. ‘Impuesto especial para la estabilidad fiscal’); no se acepta en los demás códigos
Estándar del código: 999 propio del facturador (por defecto), 001 UNSPSC, 010 GTIN, 020 partida arancelaria
Muestra o regalo: la línea declara su valor comercial (unitPrice) pero se cobra en 0 y no suma a los totales
Una nota en la línea
El código propio del emisor para el producto (SellersItemIdentification), cuando es distinto de code
Otros códigos con los que se conoce el producto: códigos de barras (EAN13…), códigos de catálogo
Otro código con el que se conoce el producto
object
El código
El nombre del esquema del código, p. ej. EAN13
La marca del producto (BrandName); las exportaciones la declaran
El modelo del producto (ModelName); las exportaciones lo declaran
Propiedades del producto (AdditionalItemProperty): un nombre, un valor y, opcionalmente, una cantidad
Una propiedad del producto, con una cantidad opcional
El tercero para quien se recibe el ingreso de la línea (el mandante), en una factura de mandato (operationType 11), que lo necesita en al menos una línea (las demás son ingresos propios del emisor), y en sus notas. No se acepta en otros documentos
object
Tipo de documento de identidad (tabla 13.2.1): 11 registro civil, 12 tarjeta de identidad, 13 cédula de ciudadanía, 21 tarjeta de extranjería, 22 cédula de extranjería, 31 NIT, 41 pasaporte, 42 documento de identificación extranjero, 47 PEP, 48 PPT, 50 NIT de otro país, 91 NUIP
El número del documento de identidad, sin el dígito de verificación
El dígito de verificación del NIT; obligatorio si idType es 31
El nombre del tercero
La remesa de transporte de la línea, en una factura de transporte de carga (operationType 12): al menos una línea la lleva; las demás son servicios adicionales. La línea de una remesa no admite attributes
object
El número de radicación de la remesa en el RNDC (la aceptación que le entrega a la empresa)
El número propio de la remesa en la empresa de transporte, hasta 15 caracteres (admite prefijos)
Su unidad: KGM kilogramos o GLL galones
Dónde se entregan los bienes de la línea
object
El código del lugar, p. ej. un GLN
El nombre de su esquema, p. ej. EAN
Cuándo se hizo la compra: solo en un documento soporte de acumulado semanal (generationForm 2), donde cada línea la indica, hasta 6 días antes de la fecha de emisión
Retenciones que aplica el comprador; se informan, no se restan del total a pagar
object
La retención: 05 ReteIVA, 06 ReteFuente (renta), 07 ReteICA
Descuentos y cargos sobre todo el documento (no sobre una línea), ej. un flete o un descuento global
object
True para un cargo (suma), false para un descuento (resta)
El motivo, en palabras, ej. “Flete”
El código del motivo (tabla 13.3.8): descuentos 00 no condicionado, 01 condicionado; recargos 02 no condicionado, 03 condicionado (las propinas son un recargo 03 con el motivo “Propina”)
Pagos que el comprador hizo antes del documento (PrepaidPayment); se restan del valor a pagar y su suma es el PrepaidAmount. No se aceptan en las notas crédito
Un pago recibido antes del documento
object
La referencia propia del pago (un número de recibo o de transferencia); única
Cuándo se recibió el pago
Cuándo lo hizo el comprador
A qué hora lo hizo el comprador, HH:mm:ss en hora de Bogotá
Instrucciones sobre el pago
Rango de numeración a usar, por su id; si no se envía, el rango activo más reciente del facturador para ese tipo
El comprador
object
1 = persona jurídica, 2 = persona natural
Tipo de documento de identidad (tabla 13.2.1): 11 registro civil, 12 tarjeta de identidad, 13 cédula de ciudadanía, 21 tarjeta de extranjería, 22 cédula de extranjería, 31 NIT, 41 pasaporte, 42 documento de identificación extranjero, 47 PEP, 48 PPT, 50 NIT de otro país, 91 NUIP
Número del documento de identidad, sin dígito de verificación, puntos ni guiones
Dígito de verificación del NIT; obligatorio cuando idType es 31
Razón social, o el nombre completo de una persona natural
Nombre comercial, si es distinto de la razón social
Nombres de una persona natural, por separado (se muestran en la representación gráfica)
Apellidos de una persona natural, por separado
Correo donde recibe los documentos electrónicos
Teléfono de contacto
Dirección; solo se puede omitir para el consumidor final de un documento POS
object
La dirección, ej. “Calle 100 # 10-20”
El código DIVIPOLA del municipio, 5 dígitos, p. ej. 11001 (Bogotá); obligatorio solo en Colombia
El nombre del municipio (o de la ciudad extranjera)
El código DIVIPOLA del departamento, 2 dígitos, p. ej. 11; obligatorio solo en Colombia
El nombre del departamento (un estado o provincia en el exterior)
Código postal
País, ISO 3166-1 alfa-2; CO por defecto
Nombre del país en español; Colombia si el país es CO y no se envía
Responsabilidades fiscales del RUT (los códigos de GET /v1/catalogs/tax-responsibilities, del Anexo Técnico 1.9): O-13 gran contribuyente, O-15 autorretenedor, O-23 agente de retención de IVA, O-47 régimen simple, O-48 responsable de IVA, O-49 no responsable de IVA, R-99-PN no responsable (por defecto si no se envía)
Régimen tributario: 01 IVA, 04 impuesto al consumo (INC), ZA IVA e INC, ZZ no aplica (por defecto)
Cuándo se debe pagar la factura (ventas a crédito)
Emitida durante una contingencia del propio facturador (InvoiceTypeCode 03 en vez de 01)
La debida diligencia del cliente que aplicó el profesional de cambio (tabla 18.3): 01 general, 02 reforzada, 03 simplificada, 04 intensificada. Obligatoria en los tipos de operación 15 y 16, rechazada en los demás
Una factura de exportación (InvoiceTypeCode 02): bienes o servicios vendidos al exterior. Cada línea declara su marca y modelo, y la dirección del comprador puede estar en el exterior
Responses
Sección titulada «Responses»Documento creado (201) o el mismo de antes con la misma Idempotency-Key (200)
object
Documento creado (201) o el mismo de antes con la misma Idempotency-Key (200)
object
Id del documento
Tipo de documento
Pending → sent → accepted / rejected; retrying y failed cuando la DIAN no responde
Ambiente DIAN: 1 = producción, 2 = habilitación (pruebas)
True cuando se emitió con una API key de sandbox (DIAN simulada, sin consumir bolsa)
Número completo (prefijo + consecutivo)
Prefijo del rango de numeración (puede estar vacío)
Consecutivo dentro del rango
CUFE, CUDE, CUDS o CUNE
Tipo y algoritmo del código único, ej. CUFE-SHA384
Cuándo se emitió; la fecha y hora del XML son este instante en hora de Bogotá
Sus valores y su contraparte
object
Valor del documento: el total a pagar, o el total de la nómina
Valor antes de impuestos (en nómina, los devengados)
Impuestos (en nómina, las deducciones)
Moneda, ISO 4217
Número de identificación de la contraparte: el comprador, el vendedor o el empleado
Nombre de la contraparte
Contenido del código QR de la representación gráfica
Lo que respondió la DIAN
object
Último código de estado de la DIAN: 00 procesado correctamente, 99 rechazado (null: aún sin respuesta)
Último texto de estado de la DIAN (null: aún sin respuesta)
Reglas de validación que la DIAN reportó
Llave de seguimiento de la DIAN (ZipKey), para documentos enviados al set de pruebas (null en los demás)
Cuántas veces se envió o se consultó su estado
Último error transitorio (la DIAN caída, un timeout); null una vez pasa
Documento al que hace referencia: una nota, a su factura; un ajuste, a su nómina (null: ninguno)
Cuándo se creó
Cuándo cambió por última vez
Example
{ "data": { "kind": "invoice", "status": "pending", "environment": "1", "issuedAt": "2026-01-15T15:30:00.000Z", "nextAttemptAt": "2026-01-15T15:30:00.000Z", "acceptedAt": "2026-01-15T15:30:00.000Z", "createdAt": "2026-01-15T15:30:00.000Z", "updatedAt": "2026-01-15T15:30:00.000Z" }}La petición no cumple el esquema (VALIDATION_ERROR, con details por campo)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Falta la credencial o no es válida (UNAUTHORIZED)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Sin saldo de documentos (INSUFFICIENT_BALANCE)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}La llave no puede hacer esto (FORBIDDEN)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}No existe, o no es de esta cuenta (NOT_FOUND)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Conflicto con el estado actual (CONFLICT, INVALID_STATE)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Regla de negocio (VALIDATION_ERROR, NUMBERING_*, CERTIFICATE_UNAVAILABLE…)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Demasiadas peticiones para esta cuenta (RATE_LIMITED; vea X-RateLimit-* y Retry-After)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Error del servicio o de la DIAN (DIAN_UNAVAILABLE, DIAN_PROTOCOL_ERROR)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}