Registrar facturador (NIT)
const url = 'https://example.com/v1/tenants';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"nit":"example","dv":"example","idType":"11","personType":"1","legalName":"example","tradeName":"example","taxResponsibilities":["example"],"taxScheme":"01","address":{"line":"example","cityCode":"example","cityName":"example","departmentCode":"example","departmentName":"example","postalCode":"example","countryCode":"CO","countryName":"example"},"email":"hello@example.com","phone":"example","merchantRegistration":"example","industryCodes":["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/tenants \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "nit": "example", "dv": "example", "idType": "11", "personType": "1", "legalName": "example", "tradeName": "example", "taxResponsibilities": [ "example" ], "taxScheme": "01", "address": { "line": "example", "cityCode": "example", "cityName": "example", "departmentCode": "example", "departmentName": "example", "postalCode": "example", "countryCode": "CO", "countryName": "example" }, "email": "hello@example.com", "phone": "example", "merchantRegistration": "example", "industryCodes": [ "example" ] }'Authorizations
Sección titulada «Authorizations»Request Bodyrequired
Sección titulada «Request Bodyrequired»Un facturador: un NIT de la cuenta, con su propia configuración ante la DIAN
object
NIT, de 5 a 15 dígitos, sin dígito de verificación; único en la cuenta
Dígito de verificación del NIT; se valida contra el NIT
Tipo de documento de identidad; 31 (NIT) por defecto
1 = persona jurídica, 2 = persona natural
Razón social, como figura en el RUT
Nombre comercial, si es distinto
Sus 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
Su régimen tributario: 01 IVA, 04 INC, ZA IVA e INC, ZZ no aplica
Su dirección fiscal
object
La dirección, ej. “Calle 100 # 10-20”
Código DIVIPOLA del municipio, 5 dígitos, ej. 11001 (Bogotá)
Nombre del municipio
Código DIVIPOLA del departamento, 2 dígitos, ej. 11 (Bogotá D.C.)
Nombre del departamento
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
Su correo de facturación electrónica; aparece en sus documentos
Teléfono de contacto
Número de matrícula mercantil en la cámara de comercio
Sus actividades económicas según su RUT: códigos CIIU de 4 dígitos, hasta 4, p. ej. [“6201”]. Se escriben en sus documentos (IndustryClassificationCode)
Responses
Sección titulada «Responses»Facturador creado
object
Facturador creado
object
Id del facturador; X-Tenant-Id recibe este id o el NIT
La cuenta dueña
NIT, sin dígito de verificación
Dígito de verificación del NIT
Tipo de documento de identidad (31: NIT)
1 = persona jurídica, 2 = persona natural
Razón social, como figura en el RUT
Nombre comercial, si es distinto
Sus responsabilidades fiscales del RUT (O-13, O-15…)
Su régimen tributario: 01 IVA, 04 INC, ZA IVA e INC, ZZ no aplica
Su dirección fiscal
object
La dirección
Código DIVIPOLA del municipio
Nombre del municipio
Código DIVIPOLA del departamento
Nombre del departamento
Código postal
País, ISO 3166-1 alfa-2
Nombre del país
Su correo de facturación electrónica; aparece en sus documentos
Teléfono de contacto
Número de matrícula mercantil en la cámara de comercio
Sus actividades económicas: códigos CIIU de 4 dígitos
Active, o suspended: un facturador suspendido no puede emitir
Cuándo se creó
Example
{ "data": { "status": "active", "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" }}