Ir al contenido

Emitir nómina electrónica individual

POST
/v1/payrolls
curl --request POST \
--url 'https://example.com/v1/payrolls?wait=true' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "period": { "hireDate": "2026-04-15", "retirementDate": "2026-04-15", "settlementStartDate": "2026-04-15", "settlementEndDate": "2026-04-15", "workedTime": 1 }, "employee": { "workerType": "example", "workerSubtype": "example", "highRiskPension": true, "idType": "11", "idNumber": "example", "firstSurname": "example", "secondSurname": "example", "firstName": "example", "otherNames": "example", "workplace": { "line": "example", "cityCode": "example", "cityName": "example", "departmentCode": "example", "departmentName": "example", "postalCode": "example", "countryCode": "CO", "countryName": "example" }, "integralSalary": true, "contractType": "example", "salary": 1, "employeeCode": "example" }, "payment": { "form": "1", "method": "example", "bank": "example", "accountType": "example", "accountNumber": "example" }, "paymentDates": [ "2026-04-15" ], "payrollPeriod": "example", "currency": "example", "exchangeRate": 1, "notes": [ "example" ], "earnings": { "basic": { "workedDays": 1, "amount": 1 }, "transport": { "allowance": 1, "viaticSalary": 1, "viaticNonSalary": 1 }, "overtime": [ { "type": "HED", "startTime": "example", "endTime": "example", "quantity": 1, "percentage": 1, "amount": 1 } ], "vacations": { "common": [ { "startDate": "2026-04-15", "endDate": "2026-04-15", "days": 1, "amount": 1 } ], "compensated": [ { "days": 1, "amount": 1 } ] }, "bonus": { "quantity": 1, "amount": 1, "nonSalaryAmount": 1 }, "severance": { "amount": 1, "percentage": 1, "interestAmount": 1 }, "incapacities": [ { "startDate": "2026-04-15", "endDate": "2026-04-15", "quantity": 1, "type": "1", "amount": 1 } ], "licenses": { "maternity": [ { "startDate": "2026-04-15", "endDate": "2026-04-15", "quantity": 1, "amount": 1 } ], "paid": [ { "startDate": "2026-04-15", "endDate": "2026-04-15", "quantity": 1, "amount": 1 } ], "unpaid": [ { "startDate": "2026-04-15", "endDate": "2026-04-15", "quantity": 1 } ] }, "bonuses": [ { "salary": 1, "nonSalary": 1 } ], "aids": [ { "salary": 1, "nonSalary": 1 } ], "otherConcepts": [ { "salary": 1, "nonSalary": 1, "description": "example" } ], "commissions": [ 1 ], "endowment": 1, "support": 1, "telecommuting": 1, "compensations": [ { "ordinary": 1, "extraordinary": 1 } ], "strikes": [ { "startDate": "2026-04-15", "endDate": "2026-04-15", "days": 1 } ], "vouchers": [ { "salary": 1, "nonSalary": 1, "foodSalary": 1, "foodNonSalary": 1 } ], "thirdPartyPayments": [ 1 ], "advances": [ 1 ], "retirementBonus": 1, "indemnity": 1, "refund": 1 }, "deductions": { "health": { "percentage": 1, "amount": 1 }, "pension": { "percentage": 1, "amount": 1 }, "solidarityFund": { "percentage": 1, "amount": 1, "subsistencePercentage": 1, "subsistenceAmount": 1 }, "unions": [ { "percentage": 1, "amount": 1 } ], "sanctions": [ { "public": 1, "private": 1 } ], "libranzas": [ { "description": "example", "amount": 1 } ], "thirdPartyPayments": [ 1 ], "advances": [ 1 ], "otherDeductions": [ 1 ], "voluntaryPension": 1, "withholdingTax": 1, "afc": 1, "cooperative": 1, "taxLien": 1, "supplementaryPlan": 1, "education": 1, "refund": 1, "debt": 1 }, "rounding": 1, "generationPlace": { "countryCode": "example", "departmentCode": "example", "cityCode": "example" }, "rangeId": "example" }'
X-Tenant-Id
string

Id o NIT del facturador. Obligatorio con llaves de cuenta; ignorado con llaves restringidas.

Idempotency-Key
string
<= 255 characters

Repetir la petición con la misma llave devuelve el mismo documento, sin emitir otro.

X-Sandbox-Outcome
string
<= 60 characters

Solo con API keys de sandbox (sk_sandbox_…): elige el resultado de la DIAN simulada: accepted (por defecto), rejected: (ej. rejected:FAD06), timeout, rule90:accepted, rule90:rejected: o rule90:pending. Se rechaza con otras llaves.

wait
string
Allowed values: true false

True: espera la respuesta de la DIAN en la misma petición

Media typeapplication/json

Una nómina electrónica individual: el pago de un empleado en un periodo

object
period
required

Fechas de la relación laboral y de la liquidación

object
hireDate
required

Fecha de ingreso del empleado

string format: date
retirementDate

Fecha de retiro, para una liquidación final

string format: date
settlementStartDate
required

Primer día que liquida esta nómina

string format: date
settlementEndDate
required

Último día que liquida esta nómina; no antes del primero

string format: date
workedTime
required

Tiempo laborado con el empleador, en días

Any of:
number
employee
required

El empleado

object
workerType
required

Tipo de trabajador (tabla 5.5.3): 01 dependiente, 02 servicio doméstico, 12 aprendiz…

string
>= 2 characters <= 2 characters
workerSubtype
required

Subtipo de trabajador: 00 no aplica, 01 pensionado que sigue trabajando

string
>= 2 characters <= 2 characters
highRiskPension
required

Si el cargo es de alto riesgo para pensión (aumenta el aporte)

boolean
idType
required

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

string
Allowed values: 11 12 13 21 22 31 41 42 47 48 50 91
idNumber
required

Número del documento de identidad del empleado

string
>= 1 characters <= 20 characters
firstSurname
required

Primer apellido

string
>= 1 characters <= 60 characters
secondSurname

Segundo apellido, si lo tiene

string
<= 60 characters
firstName
required

Primer nombre

string
>= 1 characters <= 60 characters
otherNames

Otros nombres

string
<= 60 characters
workplace
required

Lugar de trabajo del empleado

object
line
required

La dirección, ej. “Calle 100 # 10-20”

string
>= 1 characters <= 300 characters
cityCode
required

Código DIVIPOLA del municipio, 5 dígitos, ej. 11001 (Bogotá)

string
/^\d{5}$/
cityName
required

Nombre del municipio

string
>= 1 characters <= 100 characters
departmentCode
required

Código DIVIPOLA del departamento, 2 dígitos, ej. 11 (Bogotá D.C.)

string
/^\d{2}$/
departmentName
required

Nombre del departamento

string
>= 1 characters <= 100 characters
postalCode

Código postal

string
<= 10 characters
countryCode

País, ISO 3166-1 alfa-2; CO por defecto

string
default: CO >= 2 characters <= 2 characters
countryName

Nombre del país en español; Colombia si el país es CO y no se envía

string
<= 100 characters
integralSalary
required

Si el salario es integral (ya incluye las prestaciones; no genera cesantías)

boolean
contractType
required

Tipo de contrato (tabla 5.5.6): 1 término fijo, 2 término indefinido, 3 obra o labor, 4 aprendizaje, 5 prácticas

string
>= 1 characters <= 2 characters
salary
required

Salario base mensual pactado

Any of:
number
employeeCode

Código propio del empleador para el empleado

string
<= 50 characters
payment
required

Cómo se le paga al empleado

object
form

Forma de pago: 1 contado (por defecto; la nómina nunca es a crédito)

string
default: 1 <= 2 characters
method
required

Medio de pago (tabla 13.3.4.2 del anexo de facturación): 10 efectivo, 42 consignación bancaria, 47 transferencia…

string
>= 1 characters <= 3 characters
bank

Nombre del banco, para una transferencia

string
<= 100 characters
accountType

Tipo de cuenta (ahorros, corriente), para una transferencia

string
<= 50 characters
accountNumber

Número de cuenta, para una transferencia

string
<= 50 characters
paymentDates
required

Fechas de pago; al menos una

Array<string>
>= 1 items <= 31 items
payrollPeriod
required

Periodicidad de pago (tabla 5.5.1): 1 semanal, 2 decenal, 3 catorcenal, 4 quincenal, 5 mensual, 6 otro

string
>= 1 characters <= 2 characters
currency

Moneda, ISO 4217; COP si no se envía

string
>= 3 characters <= 3 characters
exchangeRate

Tasa de cambio (TRM) a COP, cuando la moneda es otra

Any of:
number
notes

Notas de texto libre

Array<string>
<= 50 items
earnings
required

Devengados del periodo; solo basic es obligatorio

object
basic
required

Salario básico por los días trabajados

object
workedDays
required

Días trabajados en el periodo, un número entero

Any of:
integer
<= 9007199254740991
amount
required

Salario de esos días

Any of:
number
transport

Auxilio de transporte y viáticos

object
allowance

Auxilio de transporte legal, para quienes ganan hasta dos salarios mínimos

Any of:
number
viaticSalary

Viáticos de manutención y alojamiento salariales

Any of:
number
viaticNonSalary

Viáticos de manutención y alojamiento no salariales

Any of:
number
overtime

Horas extra y recargos, una entrada por tipo

Array<object>
<= 100 items
object
type
required

HED hora extra diurna (+25 %), HEN hora extra nocturna (+75 %), HRN recargo nocturno (+35 %), HEDDF hora extra diurna dominical o festiva (+100 %), HRDDF recargo diurno dominical o festivo (+75 %), HENDF hora extra nocturna dominical o festiva (+150 %), HRNDF recargo nocturno dominical o festivo (+110 %)

string
Allowed values: HED HEN HRN HEDDF HRDDF HENDF HRNDF
startTime

Cuándo empezaron las horas (YYYY-MM-DDTHH:mm:ss), si se registró

string
<= 30 characters
endTime

Cuándo terminaron las horas, si se registró

string
<= 30 characters
quantity
required

Cuántas horas

Any of:
number
percentage
required

Porcentaje de recargo aplicado (25, 75…)

Any of:
number
amount
required

Lo que se paga

Any of:
number
vacations

Vacaciones, disfrutadas o compensadas

object
common

Días de vacaciones disfrutados

Array<object>
<= 20 items
object
startDate

Primer día

string format: date
endDate

Último día

string format: date
days
required

Cuántos días, un número entero

Any of:
integer
<= 9007199254740991
amount
required

Lo que se paga

Any of:
number
compensated

Días de vacaciones pagados en dinero en vez de disfrutados

Array<object>
<= 20 items
object
days
required

Cuántos días, un número entero

Any of:
integer
<= 9007199254740991
amount
required

Lo que se paga

Any of:
number
bonus

Prima de servicios legal

object
quantity
required

Días que liquida la prima, un número entero

Any of:
integer
<= 9007199254740991
amount
required

La parte salarial de la prima

Any of:
number
nonSalaryAmount

La parte no salarial, si la hay

Any of:
number
severance

Cesantías y sus intereses anuales

object
amount
required

Cesantías pagadas

Any of:
number
percentage
required

Tasa de intereses sobre las cesantías (12 % anual por ley)

Any of:
number
interestAmount
required

Intereses pagados

Any of:
number
incapacities

Incapacidades por enfermedad o accidente

Array<object>
<= 50 items
object
startDate

Primer día

string format: date
endDate

Último día

string format: date
quantity
required

Cuántos días, un número entero

Any of:
integer
<= 9007199254740991
type
required

Origen de la incapacidad: 1 común, 2 profesional, 3 laboral

string
Allowed values: 1 2 3
amount
required

Lo que paga el empleador por ellas

Any of:
number
licenses

Licencias en el periodo

object
maternity

Licencias de maternidad o paternidad

Array<object>
<= 20 items
object
startDate

Primer día

string format: date
endDate

Último día

string format: date
quantity
required

Cuántos días, un número entero

Any of:
integer
<= 9007199254740991
amount
required

Lo que se paga

Any of:
number
paid

Otras licencias remuneradas, ej. por luto o por ser jurado de votación

Array<object>
<= 20 items
object
startDate

Primer día

string format: date
endDate

Último día

string format: date
quantity
required

Cuántos días, un número entero

Any of:
integer
<= 9007199254740991
amount
required

Lo que se paga

Any of:
number
unpaid

Licencias no remuneradas: se informan, pero no suman

Array<object>
<= 20 items
object
startDate

Primer día

string format: date
endDate

Último día

string format: date
quantity
required

Cuántos días, un número entero

Any of:
integer
<= 9007199254740991
bonuses

Bonificaciones

Array<object>
<= 50 items
object
salary

La parte salarial (genera aportes)

Any of:
number
nonSalary

La parte no salarial

Any of:
number
aids

Auxilios distintos al de transporte

Array<object>
<= 50 items
object
salary

La parte salarial (genera aportes)

Any of:
number
nonSalary

La parte no salarial

Any of:
number
otherConcepts

Otros conceptos devengados que no tienen elemento propio en el esquema de la DIAN

Array<object>
<= 50 items
object
salary

La parte salarial (genera aportes)

Any of:
number
nonSalary

La parte no salarial

Any of:
number
description
required

Qué es el concepto

string
>= 1 characters <= 500 characters
commissions

Comisiones por ventas, un valor cada una

Array
<= 50 items
endowment

Dotación, pagada en dinero

Any of:
number
support

Apoyo de sostenimiento del aprendiz

Any of:
number
telecommuting

Auxilio de conectividad por teletrabajo

Any of:
number
compensations

Compensaciones que paga una cooperativa de trabajo asociado a sus asociados

Array<object>
<= 50 items
object
ordinary
required

Compensación ordinaria

Any of:
number
extraordinary
required

Compensación extraordinaria

Any of:
number
strikes

Días de huelga legal: se informan, pero no suman (HuelgasLegales)

Array<object>
<= 50 items
object
startDate

Primer día

string format: date
endDate

Último día

string format: date
days
required

Cuántos días, un número entero

Any of:
integer
<= 9007199254740991
vouchers

Pagos con bonos electrónicos o de papel, tarjetas, cheques o recargas (BonoEPCTVs)

Array<object>
<= 50 items
object
salary

Pagado con bono, constitutivo de salario

Any of:
number
nonSalary

Pagado con bono, no constitutivo de salario

Any of:
number
foodSalary

Alimentación pagada con bono, constitutiva de salario

Any of:
number
foodNonSalary

Alimentación pagada con bono, no constitutiva de salario

Any of:
number
thirdPartyPayments

Pagos que el empleador hizo a terceros a nombre del trabajador, un valor por cada uno

Array
<= 50 items
advances

Anticipos de nómina pagados en el periodo, un valor por cada uno

Array
<= 50 items
retirementBonus

La bonificación pagada cuando el trabajador se retira de la empresa (BonifRetiro)

Any of:
number
indemnity

La indemnización que establece la ley (Indemnizacion), p. ej. por despido sin justa causa

Any of:
number
refund

El reintegro de una deducción mal hecha en una nómina anterior (Reintegro)

Any of:
number
deductions
required

Deducciones del periodo; salud y pensión son obligatorias

object
health
required

Aporte a salud

object
percentage
required

Porcentaje (4 para salud y pensión, por ley)

Any of:
number
amount
required

Valor deducido

Any of:
number
pension
required

Aporte a pensión

object
percentage
required

Porcentaje (4 para salud y pensión, por ley)

Any of:
number
amount
required

Valor deducido

Any of:
number
solidarityFund

Fondo de solidaridad pensional, para salarios de cuatro mínimos o más

object
percentage
required

Porcentaje para la subcuenta de solidaridad

Any of:
number
amount
required

Valor para la subcuenta de solidaridad

Any of:
number
subsistencePercentage

Porcentaje para la subcuenta de subsistencia (salarios de 16 mínimos o más)

Any of:
number
subsistenceAmount

Valor para la subcuenta de subsistencia

Any of:
number
unions

Cuotas sindicales

Array<object>
<= 50 items
object
percentage
required

Porcentaje (4 para salud y pensión, por ley)

Any of:
number
amount
required

Valor deducido

Any of:
number
sanctions

Sanciones disciplinarias descontadas del salario

Array<object>
<= 50 items
object
public
required

Sanción impuesta por una autoridad pública

Any of:
number
private
required

Sanción impuesta por el empleador

Any of:
number
libranzas

Cuotas de libranzas

Array<object>
<= 50 items
object
description
required

Con quién es el crédito

string
<= 200 characters
amount
required

Cuota descontada

Any of:
number
thirdPartyPayments

Pagos a terceros ordenados por el empleado

Array
<= 50 items
advances

Anticipos de salario que se están devolviendo

Array
<= 50 items
otherDeductions

Otras deducciones que no tienen elemento propio en el esquema de la DIAN

Array
<= 50 items
voluntaryPension

Aportes voluntarios a pensión

Any of:
number
withholdingTax

Retención en la fuente

Any of:
number
afc

Ahorro en cuenta AFC (para compra de vivienda)

Any of:
number
cooperative

Pagos a una cooperativa

Any of:
number
taxLien

Embargo fiscal

Any of:
number
supplementaryPlan

Planes complementarios de salud

Any of:
number
education

Pagos de educación

Any of:
number
refund

Reintegro: dinero que el empleado devuelve al empleador

Any of:
number
debt

Una deuda con el empleador

Any of:
number
rounding

Ajuste por redondeo que se suma al total a pagar (puede ser negativo)

Any of:
number
generationPlace

Lugar donde se genera el XML; la dirección del empleador si no se envía

object
countryCode
required

País, ISO 3166-1 alfa-2

string
>= 2 characters <= 2 characters
departmentCode
required

Código DIVIPOLA del departamento

string
/^\d{2}$/
cityCode
required

Código DIVIPOLA del municipio

string
/^\d{5}$/
rangeId

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

string
<= 36 characters

Documento creado (201) o el mismo de antes con la misma Idempotency-Key (200)

Media typeapplication/json
object
data
required

Documento creado (201) o el mismo de antes con la misma Idempotency-Key (200)

object
id
required

Id del documento

string
kind
required

Tipo de documento

string
Allowed values: invoice credit_note debit_note support_document support_document_adjustment pos_document pos_credit_adjustment pos_debit_adjustment payroll payroll_adjustment radian_event
status
required

Pending → sent → accepted / rejected; retrying y failed cuando la DIAN no responde

string
Allowed values: pending sent retrying accepted rejected failed
environment
required

Ambiente DIAN: 1 = producción, 2 = habilitación (pruebas)

string
Allowed values: 1 2
sandbox
required

True cuando se emitió con una API key de sandbox (DIAN simulada, sin consumir bolsa)

boolean
number
required

Número completo (prefijo + consecutivo)

string
prefix
required

Prefijo del rango de numeración (puede estar vacío)

string
consecutive
required

Consecutivo dentro del rango

integer
>= -9007199254740991 <= 9007199254740991
uniqueCode
required

CUFE, CUDE, CUDS o CUNE

string
uniqueCodeScheme
required

Tipo y algoritmo del código único, ej. CUFE-SHA384

string
issuedAt
required

Cuándo se emitió; la fecha y hora del XML son este instante en hora de Bogotá

string format: date-time
summary
required

Sus valores y su contraparte

object
total
required

Valor del documento: el total a pagar, o el total de la nómina

string
subtotal

Valor antes de impuestos (en nómina, los devengados)

string
taxes

Impuestos (en nómina, las deducciones)

string
currency
required

Moneda, ISO 4217

string
counterpartyId

Número de identificación de la contraparte: el comprador, el vendedor o el empleado

string
counterpartyName

Nombre de la contraparte

string
qrData
required

Contenido del código QR de la representación gráfica

string
dian
required

Lo que respondió la DIAN

object
statusCode
required

Último código de estado de la DIAN: 00 procesado correctamente, 99 rechazado (null: aún sin respuesta)

string | null
statusMessage
required

Último texto de estado de la DIAN (null: aún sin respuesta)

string | null
errors
required

Reglas de validación que la DIAN reportó

Array<string>
zipKey
required

Llave de seguimiento de la DIAN (ZipKey), para documentos enviados al set de pruebas (null en los demás)

string | null
attempts
required

Cuántas veces se envió o se consultó su estado

integer
>= -9007199254740991 <= 9007199254740991
nextAttemptAt
required

Cuándo toca el próximo envío o consulta (null: ninguno pendiente)

Any of:

Fecha y hora en UTC (ISO 8601)

string format: date-time
lastError
required

Último error transitorio (la DIAN caída, un timeout); null una vez pasa

string | null
referencedDocumentId
required

Documento al que hace referencia: una nota, a su factura; un ajuste, a su nómina (null: ninguno)

string | null
acceptedAt
required

Cuándo lo aceptó la DIAN (null: no aceptado)

Any of:

Fecha y hora en UTC (ISO 8601)

string format: date-time
createdAt
required

Cuándo se creó

string format: date-time
updatedAt
required

Cuándo cambió por última vez

string format: date-time

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)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

Falta la credencial o no es válida (UNAUTHORIZED)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

Sin saldo de documentos (INSUFFICIENT_BALANCE)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

La llave no puede hacer esto (FORBIDDEN)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

No existe, o no es de esta cuenta (NOT_FOUND)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

Conflicto con el estado actual (CONFLICT, INVALID_STATE)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

Regla de negocio (VALIDATION_ERROR, NUMBERING_*, CERTIFICATE_UNAVAILABLE…)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

Demasiadas peticiones para esta cuenta (RATE_LIMITED; vea X-RateLimit-* y Retry-After)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

Error del servicio o de la DIAN (DIAN_UNAVAILABLE, DIAN_PROTOCOL_ERROR)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}