Items de consultas públicas — KYB Colombia

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.

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.

`rues` — Consulta RUES

Consulta de NIT en el Registro Único Empresarial y Social (RUES).

Estructura de respuesta

{
  "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.

`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

{
  "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.

`public_address_cc_co` — Dirección pública Cámara de Comercio

Estructura de respuesta

{
  "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.

`cc_co_ops` — Certificado CC (ops)

Estructura de respuesta

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

Intro al API de Trébol

Guías por caso de uso

Items de consultas públicas — KYB Colombia

Tabla resumen

`rues` — Consulta RUES

Estructura de respuesta

`public_rut_co` — Consulta de NIT en la DIAN

Estructura de respuesta

`public_address_cc_co` — Dirección pública Cámara de Comercio

Estructura de respuesta

`cc_co_ops` — Certificado CC (ops)

Estructura de respuesta

​Tabla resumen

​rues — Consulta RUES

​Estructura de respuesta

​public_rut_co — Consulta de NIT en la DIAN

​Estructura de respuesta

​public_address_cc_co — Dirección pública Cámara de Comercio

​Estructura de respuesta

​cc_co_ops — Certificado CC (ops)

​Estructura de respuesta

Tabla resumen

`rues` — Consulta RUES

Estructura de respuesta

`public_rut_co` — Consulta de NIT en la DIAN

Estructura de respuesta

`public_address_cc_co` — Dirección pública Cámara de Comercio

Estructura de respuesta

`cc_co_ops` — Certificado CC (ops)

Estructura de respuesta