Empresa

Serviço para validar uma empresa pelo NIT registrado na Colômbia ou pelo número de documento nos Estados Unidos, e retornar as informações da empresa e o registro mercantil.

POST/validate/company/representativeschave privadaprk_

info

Este serviço usa a chave privada da organização.

Nome	Descrição
email String	Obrigatório. E-mail do criador do processo. Este e-mail deve estar registrado na plataforma Auco e pertencer à organização.
documentNumber String	Obrigatório. NIT (sem dígito verificador) da empresa a ser consultada no caso da Colômbia, ou número de documento no caso dos Estados Unidos. Para a Colômbia (CO), deve ter exatamente 9 dígitos.
country String	Obrigatório. País onde a empresa a ser consultada está registrada. Valores aceitos: CO
targetWebhooks Array<String>	Opcional. Lista de webhooks a serem notificados. Se não for definida, será enviada ao webhook "default".
tags Array<String>	Opcional. Lista de tags a serem enviadas ao notificar os webhooks configurados.
complete Boolean	Opcional. Apenas para a Colômbia (CO). Indica se o detalhe completo do registro mercantil é solicitado.

🧪 Exemplos de uso

Curl

curl -X POST '{{api_auco}}/validate/company/representatives' \
  -H 'Authorization: {{private_key}}' \
  -d '{
    "email": "prueba@auco.ai",
    "documentNumber": "901431536",
    "country": "CO"
  }'

Python

import requests

response = requests.post(
  '{{api_auco}}/validate/company/representatives',
  headers={'Authorization': '{{private_key}}'},
  json={
    "email": "prueba@auco.ai",
    "documentNumber": "901431536",
    "country": "CO"
  }
)
print(response.json())

Node.js

const axios = require('axios');

axios.post('{{api_auco}}/validate/company/representatives', {
  email: 'prueba@auco.ai',
  documentNumber: '901431536',
  country: 'CO'
}, {
  headers: { Authorization: '{{private_key}}' }
})
.then((response) => console.log(response.data));

📥 Exemplos de respostas

200: Consulta bem-sucedida na Colômbia.

{
  "code": "XXXXXXXX",
  "codigo_camara": "21",
  "camara_comercio": "MEDELLIN PARA ANTIOQUIA",
  "matricula": "68393312",
  "inscripcion_proponente": "000000000000",
  "razon_social": "MICONTRATO S.A.S.",
  "codigo_clase_identificacion": "02",
  "clase_identificacion": "NIT",
  "numero_identificacion": "901431536",
  "nit": "901431536",
  "digito_verificacion": "3",
  "cod_ciiu_act_econ_pri": "6201",
  "cod_ciiu_act_econ_sec": "6202",
  "ciiu3": "5820",
  "fecha_matricula": "20201118",
  "fecha_renovacion": "20250328",
  "ultimo_ano_renovado": "2025",
  "fecha_vigencia": "99991231",
  "codigo_tipo_sociedad": "02",
  "tipo_sociedad": "SOCIEDAD COMERCIAL",
  "codigo_organizacion_juridica": "16",
  "organizacion_juridica": "SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS",
  "codigo_categoria_matricula": "01",
  "categoria_matricula": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
  "codigo_estado_matricula": "01",
  "estado_matricula": "ACTIVA",
  "clase_identificacion_rl": "CEDULA DE CIUDADANIA",
  "num_identificacion_representante_legal": "1037644437",
  "representante_legal": "SANTIAGO  MONTOYA GIRALDO",
  "fecha_actualizacion": "2025/03/28 17:30:59.340000000",
  "detailRM": {
    "id": "210068393312",
    "cod_camara": "21",
    "camara": "MEDELLIN PARA ANTIOQUIA",
    "matricula": "0068393312",
    "razon_social": "MICONTRATO S.A.S.",
    "sigla": null,
    "clase_identificacion": "NIT",
    "numero_identificacion": "901431536",
    "numero_identificacion_2": "00000901431536",
    "dv": "3",
    "dir_comercial": null,
    ...
    "cod_ciiu_act_econ_pri": "6201",
    "desc_ciiu_act_econ_pri": "Actividades de desarrollo de sistemas informáticos (planificación, análisis, diseño, programación, pruebas)",
    "cod_ciiu_act_econ_sec": "6202",
    "desc_ciiu_act_econ_sec": "Actividades de consultoría informática y actividades de administración de instalaciones informáticas",
    "ciiu3": "5820",
    "desc_ciiu3": "Edición de programas de informática (software)",
    "ciiu4": "",
    "desc_ciiu4": "",
    "fecha_matricula": "20201118",
    "fecha_renovacion": "20250328",
    "ultimo_ano_renovado": "2025",
    "fecha_vigencia": "99991231",
    "fecha_cancelacion": "",
    "motivo_cancelacion": "",
    "cod_tipo_sociedad": "02",
    "tipo_sociedad": "SOCIEDAD COMERCIAL",
    "organizacion_juridica": "SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS",
    "categoria_matricula": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
    "indicador_emprendimiento_social": "N",
    "extincion_dominio": "N",
    "estado": "ACTIVA",
    "fecha_actualizacion": "20251014",
    "control_inactivacion_sipref": null,
    ...
    "url_venta_certificados": "http://virtuales.camaramedellin.com.co/e-cer/"
  }
}

⚠️ Respostas de erro

Código	Descrição
400	Parâmetros ausentes como photo ou documentImage. Formato de imagem incorreto.
401	Autenticação inválida ou ausente.