Examples by country🇨🇴 Colombia

➕ Create a new account

In order to create a new colombian account, you will need to send both the colombian RUT FORM, and the test_set_id as an additional field, that you can get from the DIAN website. Remember to get the token from the /auth endpoint first.

The test_set_id is a string and the registration_form_rut must be a PDF file encoded as base 64. Example page to convert PDF to base64: https://base64.guru/converter/encode/pdf

Endpoint: https://api-billing.koywe.com/V1/accounts

  • Method: POST
  • Required headers:
    • Content-Type: application/json
    • Authorization: Bearer <token>
    • Accept: */*
1{
2    "country_id": 66,
3    "contact_name": "fernando rojas",
4    "contact_phone": "+579841055220",
5    "admin_email": "test@company.com",
6    "admin_password": "nuevaclave",
7    "registration_legal_name_company": "my company",
8    "registration_tax_id_code": "1707975798-1",
9    "registration_tax_id_type": "CO-NIT",
10    "registration_company_size": 1,
11    "registration_company_industry_sector": "1",
12    "registration_type_use": 1,
13    "registration_terms_of_use": 1,
14    "registration_additional_data": {
15        "registration_test_set_id": "AFAFDDSDFSFSAFADSFDSFDFSDA",
16        "registration_form_rut": "BRTR/V4fOjwxdWDl8YHT7/tP/4sua29LHlU86L9PcdPlrmoR/6YAF/0YkERyCg..."
17    }
18}

Notes: registration_test_set_id and registration_form_rut are just examples and don’t show a full valid test_set_id and PDF form.

API Reference POST /accounts

Detailed endpoint documentation