Skip to main content
POST

Headers

string
required
Token único para garantizar la idempotencia de la petición

Body

string
required
Tipo de empresa. Valores permitidos: organization (persona jurídica), individual (persona natural).
string
required
Nombre comercial de la empresa (2-255 caracteres).
Razón social de la empresa (2-255 caracteres).
string
required
Tipo de documento. Para organization: NIT, RUT. Para individual: CC, CE, PPT, PEP, PASSPORT.
string
required
Número de documento de identidad (5-30 caracteres).
string
required
Número de teléfono en formato E.164 (ejemplo: +573001234567).
string
required
Correo electrónico de la empresa.
string
required
Sitio web de la empresa (URL válida).
string
required
Código de actividad económica CIIU (4 dígitos).
string
Código de industria (4 dígitos).
integer
required
Rango de ventas anuales en millones COP. Valores permitidos: 10, 35, 110, 240, 500.
array
required
Lista de códigos de responsabilidades fiscales DIAN (ejemplo: ["O_47", "R_99_PN"]).
object
Reglas de retención aplicables a la empresa.
integer
required
ID de la ciudad donde opera la empresa. Consulta el endpoint de ciudades para obtener los IDs válidos.
object
required
Dirección de la empresa.
object
required
URLs de los documentos legales de la empresa. Cada URL debe ser accesible públicamente para su descarga.
object
Información del representante legal. Requerido si type es organization.
object
Cuenta bancaria para dispersiones. Opcional.
string
Solo en ambiente test (sk_test_): fuerza el resultado de la verificación de la empresa. Con VERIFIED recibirás el webhook company.verified y con REJECTED el webhook company.rejected en los endpoints suscritos a tu entorno de pruebas. En producción el campo es ignorado.
Los usuarios de tu empresa que tengan el permiso switch_company serán vinculados automáticamente como miembros de la nueva empresa.

Simular la verificación en pruebas

La verificación de una empresa (revisión de documentos y validación de identidad) ocurre fuera de la API y su resultado se notifica por webhook: company.verified o company.rejected. En ambiente test esa revisión no se ejecuta, así que usa test_scenario para forzar el resultado y probar tu integración. El body es el mismo del alta normal, más el campo test_scenario:
cURL
Los escenarios solo funcionan con llaves de ambiente test (sk_test_) y el webhook simulado se entrega únicamente a los endpoints suscritos al entorno de pruebas. La empresa creada permanece en estado pending: la respuesta de este endpoint y GET /companies/{id} no cambian, solo se simula la notificación del resultado. En producción, el campo test_scenario es ignorado.

Response

string
Identificador único de la empresa.
string
Nombre comercial.
Razón social.
string
Teléfono de la empresa.
string
Tipo de documento.
string
Número de documento.
string
Estado de la empresa. Las empresas nuevas se crean con estado pending.
string
Código de industria.
string
Moneda de la empresa (por defecto COP).