Ir al contenido

Generar clave y CSR (.p10)

POST
/v1/tenant/certificates/csr
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" }'
X-Tenant-Id
string

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

Media typeapplication/json

Sujeto de la solicitud de certificado; cada campo que no se envíe se toma de los datos del facturador

object
commonName

Nombre común del sujeto (CN); la razón social del facturador si no se envía

string
<= 200 characters
organization

Organización (O); la razón social del facturador si no se envía

string
<= 200 characters
organizationalUnit

Unidad organizacional (OU)

string
<= 200 characters
locality

Ciudad (L); la del facturador si no se envía

string
<= 100 characters
state

Departamento (ST); el del facturador si no se envía

string
<= 100 characters
country

País (C), ISO 3166-1 alfa-2; CO si no se envía

string
>= 2 characters <= 2 characters
email

Correo; el del facturador si no se envía

string format: email
<= 200 characters
serialNumber

Número de serie del sujeto; el NIT del facturador si no se envía

string
<= 64 characters

Example generated

{
"commonName": "example",
"organization": "example",
"organizationalUnit": "example",
"locality": "example",
"state": "example",
"country": "example",
"email": "hello@example.com",
"serialNumber": "example"
}

Certificado pendiente, con su CSR

Media typeapplication/json
object
data
required

Certificado pendiente, con su CSR

object
id
required

Id del certificado

string
status
required

Pending (existen la clave y el CSR, aún no se importa el certificado), active (firma), expired (vencido) o revoked (revocado)

string
Allowed values: pending active expired revoked
subject

A quién se emitió (el sujeto del certificado)

string
issuer

La entidad de certificación (ECD) que lo emitió

string
serialNumber

Número de serie del certificado

string
validFrom

Desde cuándo es válido

string format: date-time
validTo

Hasta cuándo es válido

string format: date-time
hasCsr
required

Si la clave y el CSR se generaron en la plataforma

boolean
createdAt
required

Cuándo se creó

string format: date-time
csrPem
required

CSR PKCS#10 en PEM (.p10)

string

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)

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"
}
}

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"
}
}