Skip to main content
POST
/
companies
curl https://api.onepay.la/v1/companies \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: company-001" \
  -d '{
    "type": "organization",
    "name": "Acme Inc",
    "legal_name": "Acme Inc S.A.S",
    "document_type": "NIT",
    "document_number": "123456789-1",
    "phone": "+573001234567",
    "email": "contacto@acme.co",
    "website": "https://acme.co",
    "economic_activity": "0111",
    "industry": "0742",
    "sales": 35,
    "fiscal_responsibilities": ["O_47"],
    "retention_rules": {
      "iva": true,
      "ica": false,
      "fuente": true
    },
    "city_id": 1,
    "address": {
      "address": "Calle 100 #15-20",
      "hint": "Oficina 301",
      "zipcode": "170004"
    },
    "documents": {
      "rut": "https://storage.example.com/rut.pdf",
      "ccc": "https://storage.example.com/ccc.pdf",
      "dni": "https://storage.example.com/dni.pdf",
      "bank": "https://storage.example.com/bank.pdf",
      "simple": "https://storage.example.com/simple.pdf"
    },
    "company_owner": {
      "name": "Juan",
      "last_name": "Pérez",
      "phone": "+573001234568",
      "email": "juan@acme.co",
      "document_type": "cc",
      "dni": "10000001"
    },
    "account": {
      "type": "savings",
      "bank_id": "9da58912-101d-46f8-86c9-20a52119c0bf",
      "number": "1234567890",
      "terms": true
    }
  }'

{
  "id": "9da58912-101d-46f8-86c9-20a52119c0bf",
  "name": "Acme Inc",
  "legal_name": "Acme Inc S.A.S",
  "phone": "+573001234567",
  "document_type": "NIT",
  "document_number": "123456789-1",
  "status": "pending",
  "industry": "0742",
  "currency": "COP"
}

Documentation Index

Fetch the complete documentation index at: https://docs.onepay.la/llms.txt

Use this file to discover all available pages before exploring further.

​
Headers

​
x-idempotency
string
required
Token único para garantizar la idempotencia de la petición

​
Body

​
type
string
required
Tipo de empresa. Valores permitidos: organization (persona jurídica), individual (persona natural).
​
name
string
required
Nombre comercial de la empresa (2-255 caracteres).
​
legal_name
string
required
Razón social de la empresa (2-255 caracteres).
​
document_type
string
required
Tipo de documento. Para organization: NIT, RUT. Para individual: CC, CE, PPT, PEP, PASSPORT.
​
document_number
string
required
Número de documento de identidad (5-30 caracteres).
​
phone
string
required
Número de teléfono en formato E.164 (ejemplo: +573001234567).
​
email
string
required
Correo electrónico de la empresa.
​
website
string
required
Sitio web de la empresa (URL válida).
​
economic_activity
string
required
Código de actividad económica CIIU (4 dígitos).
​
industry
string
Código de industria (4 dígitos).
​
sales
integer
required
Rango de ventas anuales en millones COP. Valores permitidos: 10, 35, 110, 240, 500.
​
fiscal_responsibilities
array
required
Lista de códigos de responsabilidades fiscales DIAN (ejemplo: ["O_47", "R_99_PN"]).
​
retention_rules
object
Reglas de retención aplicables a la empresa.
​
city_id
integer
required
ID de la ciudad donde opera la empresa. Consulta el endpoint de ciudades para obtener los IDs válidos.
​
address
object
required
Dirección de la empresa.
​
documents
object
required
URLs de los documentos legales de la empresa. Cada URL debe ser accesible públicamente para su descarga.
​
company_owner
object
Información del representante legal. Requerido si type es organization.
​
account
object
Cuenta bancaria para dispersiones. Opcional.
Los usuarios de tu empresa que tengan el permiso switch_company serán vinculados automáticamente como miembros de la nueva empresa.

​
Response

​
id
string
Identificador único de la empresa.
​
name
string
Nombre comercial.
​
legal_name
string
Razón social.
​
phone
string
Teléfono de la empresa.
​
document_type
string
Tipo de documento.
​
document_number
string
Número de documento.
​
status
string
Estado de la empresa. Las empresas nuevas se crean con estado pending.
​
industry
string
Código de industria.
​
currency
string
Moneda de la empresa (por defecto COP).
{
  "id": "9da58912-101d-46f8-86c9-20a52119c0bf",
  "name": "Acme Inc",
  "legal_name": "Acme Inc S.A.S",
  "phone": "+573001234567",
  "document_type": "NIT",
  "document_number": "123456789-1",
  "status": "pending",
  "industry": "0742",
  "currency": "COP"
}

curl https://api.onepay.la/v1/companies \
  -X POST \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "x-idempotency: company-001" \
  -d '{
    "type": "organization",
    "name": "Acme Inc",
    "legal_name": "Acme Inc S.A.S",
    "document_type": "NIT",
    "document_number": "123456789-1",
    "phone": "+573001234567",
    "email": "contacto@acme.co",
    "website": "https://acme.co",
    "economic_activity": "0111",
    "industry": "0742",
    "sales": 35,
    "fiscal_responsibilities": ["O_47"],
    "retention_rules": {
      "iva": true,
      "ica": false,
      "fuente": true
    },
    "city_id": 1,
    "address": {
      "address": "Calle 100 #15-20",
      "hint": "Oficina 301",
      "zipcode": "170004"
    },
    "documents": {
      "rut": "https://storage.example.com/rut.pdf",
      "ccc": "https://storage.example.com/ccc.pdf",
      "dni": "https://storage.example.com/dni.pdf",
      "bank": "https://storage.example.com/bank.pdf",
      "simple": "https://storage.example.com/simple.pdf"
    },
    "company_owner": {
      "name": "Juan",
      "last_name": "Pérez",
      "phone": "+573001234568",
      "email": "juan@acme.co",
      "document_type": "cc",
      "dni": "10000001"
    },
    "account": {
      "type": "savings",
      "bank_id": "9da58912-101d-46f8-86c9-20a52119c0bf",
      "number": "1234567890",
      "terms": true
    }
  }'