Ejemplos por país

➕ Crear una cuenta

Para crear una nueva cuenta colombiana, deberá enviar tanto el formulario RUT colombiano como el test_set_id como campo adicional, que puede obtener desde el sitio web de la DIAN. Recuerde obtener primero el token desde el endpoint /auth.

El test_set_id es una cadena de texto y el registration_form_rut debe ser un archivo PDF codificado en base 64. Página de ejemplo para convertir PDF a base64: https://base64.guru/converter/encode/pdf

El campo company_logo solo admite formato PNG y debe cargarse en base64.

Crear cuenta

• Endpoint: https://api-billing.koywe.com/V1/accounts
• Método: POST
• Encabezados requeridos:
  • Content-Type: application/json
  • Authorization: Bearer \<token>
  • Accept: */*

{
    "country_id": 66,
    "contact_name": "fernando rojas",
    "contact_phone": "+579841055220",
    "admin_email": "[email protected]",
    "admin_password": "nuevaclave",
    "registration_legal_name_company": "my company",
    "registration_tax_id_code": "1707975798-1",
    "registration_tax_id_type": "CO-NIT",
    "registration_company_size": 1,
    "registration_company_industry_sector": "1",
    "registration_type_use": 1,
    "registration_terms_of_use": 1,
    "registration_additional_data": {
        "registration_test_set_id": "AFAFDDSDFSFSAFADSFDSFDFSDA",
        "registration_form_rut": "BRTR/V4fOjwxdWDl8YHT7/tP/4sua29LHlU86L9PcdPlrmoR/6YAF/0YkERyCg...",
        "company_logo": "SOIFsDCCA5igAwIBAgIUMzAwMDEw..."
    }
}

Notas: registration_test_set_id y registration_form_rut son solo ejemplos y no muestran un test_set_id completo ni un formulario PDF válido.

Referencia de API POST /accounts

Documentación detallada del endpoint: /english/billing/api-reference/billing-api/🏢-accounts/create-a-new-account