Crear empresa
POST/v1/companies
Crea una empresa (matriz o sucursal). Para crear una sucursal, informa parent_company_id — el CNPJ debe compartir el mismo prefijo que la matriz. Solo las empresas con CNPJ pueden tener sucursales. La primera empresa creada en la organización se marca como is_default automáticamente.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Empresa creada.
El cuerpo de la solicitud falló en la validación.
Token bearer ausente o inválido.
Token válido, pero sin permiso para esta operación. Con code insufficient_scope, details.required trae el único conjunto mínimo de scopes que, sumados a details.granted, dejaría pasar la solicitud: el scope del recurso (billing/{recurso}, o billing/all fuera del catálogo) y luego el verbo simple — por ejemplo ["billing/customers", "delete"].
Recurso no encontrado en la organización actual.
El cuerpo de la solicitud falló en la validación.
Límite de solicitudes excedido.
Error inesperado en el servidor.