Entreprise

Service permettant de valider une entreprise à partir du NIT enregistré en Colombie ou du numéro de document aux États-Unis, et de renvoyer les informations de l'entreprise ainsi que son registre du commerce.

POST/validate/company/representativesclé privéeprk_

info

Ce service utilise la clé privée de l'organisation.

Nom	Description
email String	Obligatoire. E-mail du créateur du processus. Cet e-mail doit être enregistré sur la plateforme Auco et appartenir à l'organisation.
documentNumber String	Obligatoire. NIT (sans chiffre de contrôle) de l'entreprise à consulter dans le cas de la Colombie, ou numéro de document dans le cas des États-Unis. Pour la Colombie (CO), il doit comporter exactement 9 chiffres.
country String	Obligatoire. Pays dans lequel l'entreprise à consulter est enregistrée. Valeurs acceptées : CO
targetWebhooks Array<String>	Facultatif. Liste des webhooks à notifier. S'il n'est pas défini, la notification sera envoyée au webhook « default ».
tags Array<String>	Facultatif. Liste des étiquettes (tags) à envoyer lors de la notification des webhooks configurés.
complete Boolean	Facultatif. Uniquement pour la Colombie (CO). Indique si le détail complet du registre du commerce est demandé.

🧪 Exemples d'utilisation

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));

📥 Exemples de réponses

200 : Consultation réussie en Colombie.

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

⚠️ Réponses d'erreur

Code	Description
400	Paramètres manquants tels que photo ou documentImage. Format d'image incorrect.
401	Authentification invalide ou absente.