Generar clave y CSR (.p10)
const url = 'https://example.com/v1/tenant/certificates/csr';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"commonName":"example","organization":"example","organizationalUnit":"example","locality":"example","state":"example","country":"example","email":"hello@example.com","serialNumber":"example"}'};
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/tenant/certificates/csr \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "commonName": "example", "organization": "example", "organizationalUnit": "example", "locality": "example", "state": "example", "country": "example", "email": "hello@example.com", "serialNumber": "example" }'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.
Request Bodyrequired
Sección titulada «Request Bodyrequired»Sujeto de la solicitud de certificado; cada campo que no se envíe se toma de los datos del facturador
object
Nombre común del sujeto (CN); la razón social del facturador si no se envía
Organización (O); la razón social del facturador si no se envía
Unidad organizacional (OU)
Ciudad (L); la del facturador si no se envía
Departamento (ST); el del facturador si no se envía
País (C), ISO 3166-1 alfa-2; CO si no se envía
Correo; el del facturador si no se envía
Número de serie del sujeto; el NIT del facturador si no se envía
Example generated
{ "commonName": "example", "organization": "example", "organizationalUnit": "example", "locality": "example", "state": "example", "country": "example", "email": "hello@example.com", "serialNumber": "example"}Responses
Sección titulada «Responses»Certificado pendiente, con su CSR
object
Certificado pendiente, con su CSR
object
Id del certificado
Pending (existen la clave y el CSR, aún no se importa el certificado), active (firma), expired (vencido) o revoked (revocado)
A quién se emitió (el sujeto del certificado)
La entidad de certificación (ECD) que lo emitió
Número de serie del certificado
Desde cuándo es válido
Hasta cuándo es válido
Si la clave y el CSR se generaron en la plataforma
Cuándo se creó
CSR PKCS#10 en PEM (.p10)
Example
{ "data": { "status": "pending", "validFrom": "2026-01-15T15:30:00.000Z", "validTo": "2026-01-15T15:30:00.000Z", "createdAt": "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" }}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" }}