> ## Documentation Index
> Fetch the complete documentation index at: https://gotrebol.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Items de consultas públicas — KYB Colombia
> Consultas públicas aplicables a verificaciones KYB de Colombia: RUES, NIT en la DIAN, Cámara de Comercio.
Este documento describe los items de tipo **consulta pública** aplicables a verificaciones KYB en Colombia. Su valor no cambia una vez creados. Para cada item se incluye su descripción y estructura de respuesta.
Para documentos cargables (RUT, escrituras), consulta [Items de documentos — KYB Colombia](/docs/guia-devs/uso-kyb/colombia/items-documentos).
## Tabla resumen
| Ítem | Descripción |
| ---------------------- | ------------------------------------------------------------------------------- |
| `rues` | Consulta de NIT en el Registro Único Empresarial (RUES). |
| `public_address_cc_co` | Consulta de NIT para obtener dirección y contacto (Cámara de Comercio pública). |
| `public_rut_co` | Verifica existencia, estado y facturación del NIT en la DIAN. |
| `cc_co_ops` | Certificado de representación legal (Cámara de Comercio - variación "ops"). |
`cc_co_ops` puede funcionar como consulta pública (Trébol lo obtiene directamente de Cámara de Comercio) o como documento cargable (el cliente lo sube). Ver también [Items de documentos — KYB Colombia](/docs/guia-devs/uso-kyb/colombia/items-documentos).
***
`rues` — Consulta RUES
Consulta de NIT en el Registro Único Empresarial y Social (RUES).
### Estructura de respuesta
```json theme={"dark"}
{
"item_type": "rues",
"item_value": {
"tax_id_number": "900123456-7",
"tax_id_verification_code": "7",
"legal_name": "EMPRESA EJEMPLO COLOMBIA S.A.S.",
"address": "Calle 123 # 45-67, Oficina 901, Bogotá, Cundinamarca",
"country_registration": "Colombia",
"state_registration": "Cundinamarca",
"city_registration": "Bogotá",
"registration_category": "Sociedad por Acciones Simplificada",
"registration_status": "Activo",
"registration_city_chamber": "Cámara de Comercio de Bogotá",
"registration_id": "CCB-2020-001234",
"renewal_date": "2024-01-01",
"registration_date": "2020-01-01",
"registry_end_date": "2025-01-01",
"last_update_date": "2024-06-01",
"cancellation_date": null,
"cancellation_motive": null,
"society_type": "Sociedad por Acciones Simplificada",
"organization_type": "Empresa",
"business_activities": {},
"signatory_powers": "Representante Legal",
"signatories": {},
"request_id": "RUES-2024-001234",
"status": "Activo"
}
}
```
Para saber cómo detectar si la consulta RUES falló (e.g. `"NIT NO EXISTE"`), consulta la [referencia de errores en consultas públicas](/docs/guia-devs/referencia/errores-consultas-publicas#rues).
***
`public_rut_co` — Consulta de NIT en la DIAN
Verifica en la DIAN que el NIT exista, esté activo y la empresa sea facturable.
### Estructura de respuesta
```json theme={"dark"}
{
"item_type": "public_rut_co",
"item_value": {
"nit": "900123456",
"verification_digit": "7",
"business_name": "EMPRESA EJEMPLO COLOMBIA S.A.S.",
"date": "2024-01-01",
"status": "ACTIVO",
"message": "Process finished successfully.",
"rut_validation_result": "success"
}
}
```
**Valores de `rut_validation_result`:** `"success"` | `"failed"`.
`status` refleja el campo `estado` de la DIAN tal como lo devuelve la fuente — la capitalización puede variar (por ejemplo `"ACTIVO"`). Para lógica de negocio, prioriza `rut_validation_result` y `status` sobre `message` (que es texto operativo en inglés).
Para detectar si la consulta DIAN falló (`status` = `"EXCEPTION"` o `"invalid"`, o `rut_validation_result` = `"failed"`), consulta la [referencia de errores en consultas públicas → DIAN](/docs/guia-devs/referencia/errores-consultas-publicas#dian).
***
`public_address_cc_co` — Dirección pública Cámara de Comercio
### Estructura de respuesta
```json theme={"dark"}
{
"item_type": "public_address_cc_co",
"item_value": {
"legal_name": "EMPRESA EJEMPLO COLOMBIA S.A.S.",
"organization_type": "Sociedad por Acciones Simplificada",
"legal_email": "legal@empresa-ejemplo.com.co",
"phone": "+57 1 2345678",
"business_address": {
"address": "Calle 123 # 45-67, Oficina 901",
"city": "Bogotá",
"state": "Cundinamarca",
"country": "Colombia"
},
"request_id": "CC-2024-001234",
"tax_id_number": "900123456"
}
}
```
`tax_id_number` se reenvía del NIT enviado al crear la verificación (`legal_id` o `options.nit`): solo dígitos, sin guión. A diferencia de `rues`, este ítem no almacena el dígito de verificación en un campo separado.
Este ítem no incluye `status` ni `message` en `item_value`. Para detectar si la consulta falló (por ejemplo `legal_name` vacío), consulta la [referencia de errores en consultas públicas → Cámara de Comercio](/docs/guia-devs/referencia/errores-consultas-publicas#camara-de-comercio).
## `cc_co_ops` — Certificado CC (ops)
### Estructura de respuesta
```json theme={"dark"}
{
"item_type": "cc_co_ops",
"item_value": {
"tax_id_number": "900123456-7",
"expedition_date": "2024-01-01",
"legal_name": "EMPRESA EJEMPLO COLOMBIA S.A.S.",
"organization_type": "Sociedad por Acciones Simplificada",
"department": "Cundinamarca",
"municipality": "Bogotá",
"legal_email": "legal@empresa-ejemplo.com.co",
"phone": "+57 1 2345678",
"corporate_purpose": "Desarrollo de software y servicios tecnológicos",
"legal_address": {"city": "Bogotá D.C.",
"country": "COLOMBIA",
"addressLine1": "Tv 70 F # 20 A 78"},
"business_address": {
"city": "Bogotá D.C.",
"country": "COLOMBIA",
"addressLine1": "Tv 70 F # 20 A 78"
},
"equity": {
"paid": {
"value": 350000000,
"numberOfShares": 350000,
"nominalValue": 1000
},
"authorized": {
"value": 350000000,
"numberOfShares": 350000,
"nominalValue": 1000
},
"subscribed": {
"value": 350000000,
"numberOfShares": 350000,
"nominalValue": 1000
}
},
"board_members": {
"data": [
{
"id": "49409839",
"name": "Eliana Echevarria Bernal",
"role": "Gerente general",
"id_type": "CC"|"CE"|"PP"|"NIT"|"other"
}
]
},
"tax_auditors": {
"data": [
{
"id": "230667889",
"name": "ACCOUNTING SERVICES & TAXES SAS",
"role": "Revisor Fiscal Persona Juridica",
"id_type": "CC"|"CE"|"PP"|"NIT"|"other"
},
{
"id": "108846768",
"name": "Claudia Gutierrez Uribe",
"role": "Revisor Fiscal Principal",
"id_type": "CC"|"CE"|"PP"|"NIT"|"other"
}
]
},
"document_metadata": {
"url": "https://camara-col-extractor-...",
"verificationCode": "B2324173892087",
"expeditionDate": "2023-06-06"
},
"extracted_data": {
"facultades_empresa": {
"obtener_creditos": {
"tiene_poder": true,
"limitaciones": []
},
"dar_activos_en_garantia": {
"tiene_poder": true,
"limitaciones": []
},
"obligarse_solidariamente": {
"tiene_poder": true,
"limitaciones": []
}
},
"limitaciones_empresa": [],
"representantes_legales": [
{
"name": "Andres Gomez Saenz",
"role": "Gerente General",
"limitaciones": [],
"identificacion": {
"tipo": "cc_co|"ce_co"|"nit_co"|"ti_co"|"pasaporte"|"otro"",
"numero": "34798572"
}
},
{
"name": "Carlos Serrano Perez",
"role": "Suplente",
"limitaciones": [],
"identificacion": {
"tipo": "cc_co|"ce_co"|"nit_co"|"ti_co"|"pasaporte"|"otro"",
"numero": "19431657"
}
}
]
}
}
}
```