Home

CO - Registration

Registration - Rues and Cámara de Comercio

Here is an example of how you POST a new RUES and Cámara de Comercio request:

Parameters

legalid: _string

Tax id of the Business. Send it without the verification code.
Example: 901549584

maxdays: _integer

Maximum number of days since the data was issued for it to be valid in your processes. 0 if you want that the RUES is scrapped right now. A 90 value would mean you are ok with data from the last 3 months.
Example: 60

metadata: JSON Object

Any JSON object you want to associate to the Business Registration request. This object will not affect the API response. You can use it to send information you need later to associate the Trebol response on your internal workflows.
Example: {"key1":"value1"}

{
  "max_days": 0,
  "legal_id": 901549584,
  "metadata": {"purpose":"QA"}
}

Once you POST a new registration request, Trébol will immediately return you a request_id that you can use later to GET the information of the Business. We will send you a webhook as soon as the extraction process is finished. This process takes around 1 minute to complete.

How to GET the extracted data?

To get the data of a Registration extraction, you can use the GET registration endpoint.

How does Trébol reports data from these documents?

Trébol will return a Registration Object that has the next fields:

The Registration Object

Attributes

taxid_number: _string

Tax id of the Business. Refers to the field NIT in the RUES.
Example: 901549584

taxid_verfication_code: _string

Tax id verification code of the Business. Refers to the verification code of the NIT in the RUES.
Example: 5

legalname: _string

Legal name of the Business. Refers to the field Razón Social ó Nombre in the RUES.
Example: ACME S.A.

countryregistration: _string

Country where the Business is registered. In this case, always is COLOMBIA.
Example: COLOMBIA

stateregistration: _string

State (or Departamento) where the Company is registered. Refers to the field Dpto in the RUES.
Example: BOGOTA

cityregistration: _string

City where the Company is registered. Refers to the field Ciudad in the RUES.
Example: BOGOTA, D.C.

registrationcategory: _string

Registration category of the Business. Refers to the field Categoria de la Matricula in the RUES.
Example: SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL

registrationstatus: _string

Registration status of the Business. Refers to the field Estado de la matricula in the RUES.
Example: ACTIVA

registrationcity_chamber: _string

Registration city chamber of the Business. Refers to the field Cámara de comercio in the RUES.
Example: BOGOTA

registrationid: _string

Registration id of the Business. Refers to the field Numero de Matricula in the RUES.
Example: 12345

renewaldate: _string

Registration renewal date of the Business. Refers to the field Fecha de Renovacion in the RUES. Reported with ISO 8601 format (YYYY-MM-DD).
Example: 2022-03-17

registrationdate: _string

Date on which the Business was registered. Refers to the field Fecha de Matricula in the RUES. Reported with ISO 8601 format (YYYY-MM-DD).
Example: 2022-12-17

registryend_date: _string

End date of the Business if it has a limited life. Usually, in Colombia, Businesses have undefined life, so the reported value is Indefinida. Refers to the field Fecha de Vigencia in the RUES. Reported with ISO 8601 format (YYYY-MM-DD).
Example: Indefinida

societytype: _string

Society type of the Business. Refers to the field Tipo de Sociedad in the RUES.
Example: SOCIEDAD COMERCIAL

organizationtype: _string

Organization type of the Business. Refers to the field Tipo de Organización in the RUES.
Example: SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS

businessactivites: _array of objects

Economic Activities of the business. Each object contains:

  • clase (integer): CIIU code of the economic activity.
  • descripcion_colombia (string): Description of the CIIU code according to the Colombian standard.

Example: 

"business_activites": [
        {
          "clase": 6201,
          "descripcion_colombia": "Actividades de desarrollo de sistemas informáticos (planificación, análisis, diseño, programación, pruebas)"
        },
        {
          "clase": 6312,
          "descripcion_colombia": "Portales web"
        },
        {
          "clase": 6202,
          "descripcion_colombia": "Actividades de consultoría informática y actividades de administración de instalaciones informáticas"
        }
      ]

signatorypowers_text: _string

Text that describes the Business' signatories' powers. Refers to the field Representantes Legales in the RUES.
Example: "La administración de la Sociedad será ejercida por dos (2) gerentes generales (los "Gerentes Generales")...El gobierno, administración y representación legal de la Sociedad estará a cargo de los Gerentes Generales, con las limitaciones establecidas en estos estatutos, quiénes individualmente y de manera particular tendrán las siguientes funciones: A) Representar a la Sociedad frente a los accionistas, ante terceros y ante cualquier autoridad administrativa o jurisdiccional ... "

legalemail: _string

Registered legal email of the Business. Only available when the scope is complete.
Example: [email protected]

phone: string

Registered phone of the Business.Only available when the scope is complete.
Example: 6048765432

organizationtype: _string

Organization type of the Business. Refers to the field Tipo de Organización in the RUES.
Example: SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS

signatories: array Object

Array of people Object that contains the information about each signatory. Each people Object contains:

  • name: string Name of the signatory. Example: Juana Perez
  • idtype: _string Id type of the signatory. Example: CC
  • id: string Id value of the signatory. Example: 7654321
  • role: string Role of the signatory. Example: Representante Legal Suplente

boardmembers: _array Object

Array of people Object that contains the information about each board member. Each people Object contains:

  • name: string Name of the signatory. Example: Maria Zuleta
  • idtype: _string Id type of the signatory. Example: CC
  • id: string Id value of the signatory. Example: 1234567
  • role: string Role of the signatory. Example: Miembro de Junta

taxauditors: _array Object

Array of people Object that contains the information about each tax auditor (revisor fiscal). Each people Object contains:

  • name: string Name of the signatory. Example: Rodrigo Casas
  • idtype: _string Id type of the signatory. Example: CC
  • id: string Id value of the signatory. Example: 987654
  • role: string Role of the signatory. Example: Revisor Fiscal

documentmetadata: _Object

Object that contains the main properties about the official document. The data it contains is:

  • verificationcode: _string Verification code included on the document to validate that the document is official. Example: B22755993BA2DF
  • url: string URL where the file is stored and available to consult and download. Example: drive.gotrebol.com/linkToTheFile
  • expeditiondate: _string Expedition date of the document. Issued under ISO 8601 format. Example: 2022-12-17.

equity: Object

Object that contains the information about the registered equity of the business. It contains the authorized, subscribed and paid equity of the Business. For each type of equity, it includes value, number of shares, and nominal value per share.
Example:

"equity": {
        "authorized": {
          "value": 4000000000,
          "number_of_shares": 4000000,
          "nominal_value": 1000
        },
        "subscribed": {
          "value": 2134310000,
          "number_of_shares": 2134310,
          "nominal_value": 1000
        },
        "paid": {
          "value": 2087499000,
          "number_of_shares": 2087499,
          "nominal_value": 1000
        }
}

legaladdress: _Address Object

Object that contains the main properties of the legal address of the Business. Only available when the scope is complete. The data it includes is:

  • addressline_1: _string Address of the business. Example: Av Siempre Viva 742, Suite 3.
  • city: string City where the business is registered. Example: Manizales
  • state: string State where the business si registered. Example: Caldas.
  • zipcode: _string If available, the zip code of the legal address of the Business. Example: 110212.

businessaddress: _Address Object

Object that contains the main properties of the business, or commercial address of the Business. Only available when the scope is complete. The data it includes is:

  • addressline_1: _string Address of the business. Example: Av Siempre Viva 742, Suite 3.
  • city: string City where the business is registered. Example: Manizales
  • state: string State where the business si registered. Example: Caldas.
  • zipcode: _string If available, the zip code of the legal address of the Business. Example: 110212.

Registration Object example

{
      "created_at": 1656630432068,
      "tax_id_number": "901549584",
      "tax_id_verfication_code": "5",
      "company_legal_name": "TREBOL COLOMBIA OPCO S.A.S.",
      "country_registration": "COLOMBIA",
      "state_registration": "BOGOTA",
      "city_registration": "BOGOTA, D.C.",
      "registration_category": "SOCIEDAD ó PERSONA JURIDICA PRINCIPAL ó ESAL",
      "registration_status": "ACTIVA",
      "registration_city_chamber": "BOGOTA",
      "registration_id": "3463326",
      "renewal_date": "2022-02-27",
      "registration_date": "2021-12-17",
      "registry_end_date": "Indefinida",
      "society_type": "SOCIEDAD COMERCIAL",
      "organization_type": "SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS",
      "business_activites": [
        {
          "clase": 6201,
          "descripcion_colombia": "Actividades de desarrollo de sistemas informáticos (planificación, análisis, diseño, programación, pruebas)"
        },
        {
          "clase": 6202,
          "descripcion_colombia": "Actividades de consultoría informática y actividades de administración de instalaciones informáticas"
        }
      ],
      "signatory_powers": [
        "La administración de la Sociedad será ejercida por dos (2) gerentes generales (los \"Gerentes Generales\").\nPor  Documento  Privado  del  17  de  diciembre de 2021, de Accionista\nÚnico,  ..."
      ],
      "company_id": 342,
      "corporate_purpose": "La Sociedad tendrá por objeto proveer servicios tecnológicos para instituciones financieras, dentro de los que se encuentran la consultoría en procesos tecnológicos, los servicios de software para realizar conexiones de datos de empresas y personas naturales, hacer alianzas de ventas sobre otros servicios tecnológicos, el procesamiento de datos de empresas y personas naturales a nombre de los clientes de la Sociedad, entre otros y (II) Desarrollar cualquier actividad lícita.",
      "phone": "3007654321",
      "legal_email": "[email protected]",
      "request_id": "uuid",
      "status": "CONNECTED",
      "signatories": [
        {
          "name": "Jhon Doe",
          "id_type": "CC",
          "id": "1234567",
          "role": "Gerente General"
        },
        {
          "name": "Maria Perez",
          "id_type": "CC",
          "id": "654321",
          "role": "Gerente General"
        }
      ],
      "legal_address": {
        "address_line_1": "Address line 1",
        "address_line_2": "",
        "city": "Bogotá D.C. ",
        "state": "Bogotá D.C. ",
        "country": "COLOMBIA",
        "zip_code": ""
      },
      "business_address": {
        "address_line_1": "Address line 2",
        "address_line_2": "",
        "city": "Bogotá D.C. ",
        "state": "Bogotá D.C. ",
        "country": "COLOMBIA",
        "zip_code": ""
      },
      "equity": {
        "authorized": {
          "value": 1000000,
          "number_of_shares": 1000000,
          "nominal_value": 1
        },
        "subscribed": {
          "value": 1000000,
          "number_of_shares": 1000000,
          "nominal_value": 1
        },
        "paid": {
          "value": 1000000,
          "number_of_shares": 1000000,
          "nominal_value": 1
        }
      },
      "board_members": [],
      "tax_auditors": [],
      "document_metadata": {
        "verification_code": "A2224201760290",
        "url": "https://drive.google.com/file/d/1pwECEKrGpG4JBDCRmFx_uHJi9g5FM3fu/view?usp=sharing",
        "expedition_date": "2022-02-28"
      }
    }