Registrar empresa

Completa los datos de tu empresa y el certificado digital para comenzar a operar.

¿Qué es el Certificado Digital?
El Certificado Digital (CD) o firma digital simple valida tu identidad permitiendo emitir documentos de facturación electrónica cumpliendo con normas del SII.

SI tengo certificado digital NO tengo certificado digital

Carga el archivo del certificado digital

Contraseña del certificado digital

📄 MIPYME Documents

Create a new company branch

POST

URL del endpoint https://api-billing.koywe.com/V1/company_branches

Requiere autenticación

Autenticación

Envía la cabecera Authorization: Bearer <token> (obtenido en POST /auth) en los endpoints protegidos.

Parámetros

Sin parámetros.

Cuerpo de la solicitud — campos

Campo	Tipo	Obligatoriedad	Descripción
`account_id`	integer	Siempre obligatorio	ID of the associated account
`is_headquarters`	integer	Opcional	Indicates whether the location is the company's headquarters. If the value is 1, it means this branch is the main office.
`branch_type`	integer	Opcional	Defines the type of branch. If the value is 1, it is a physical (real) branch. If the value is 2, it is a virtual branch.
`name`	string	Siempre obligatorio	Name of the company branch.
`address`	string	Opcional	Address of the company branch.
`district`	string	Opcional	District of the company branch.
`city`	string	Opcional	City of the company branch.
`phone`	string	Opcional	Phone of the company branch.
`company_branch_tax_code`	string	Opcional	Tax code assigned to the company branch for fiscal and accounting purposes.
`company_branch_internal_code`	string	Opcional	Internal code assigned to the company branch for identification within the system.
`parent_company_branch_id`	integer	Opcional	ID of the parent company branch.

Ejemplo JSON del cuerpo

{
    "account_id": 0,
    "is_headquarters": 0,
    "branch_type": 0,
    "name": "string",
    "address": "string",
    "district": "string",
    "city": "string",
    "phone": "string",
    "company_branch_tax_code": "string",
    "company_branch_internal_code": "string",
    "parent_company_branch_id": 0
}

Respuestas

Company branch successfully generated

Petición POST /company_branches

curl -X POST \
  "https://api-billing.koywe.com/V1/company_branches" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"..."}'

Respuesta

{
    "account_id": 0,
    "company_branch_id": "string",
    "is_headquarters": 0,
    "branch_type": 0,
    "name": "string",
    "address": "string",
    "district": "string",
    "city": "string",
    "phone": "string",
    "company_branch_tax_code": "string",
    "company_branch_internal_code": "string",
    "parent_company_branch_id": 0,
    "user_permissions": [
        {
            "user_id": "string",
            "user_name": "string",
            "has_branch_permission": 0
        }
    ]
}

{
    "error": "invalid input or validation error"
}

{
    "error": "Invalid or expired token"
}

{
    "error": "Internal server error"
}