Empresas

Las empresas emisoras — quién cobra. Llevan el perfil fiscal usado en la emisión de nota, y una de ellas es la predeterminada.

Comando	HTTP	Descripción
companies list	GET /v1/companies	Listar empresas
companies create	POST /v1/companies	Crear empresa
companies get	GET /v1/companies/{id}	Obtener empresa por ID
companies update	PATCH /v1/companies/{id}	Actualizar empresa
companies delete	DELETE /v1/companies/{id}	Eliminar empresa
companies deactivate	POST /v1/companies/{id}/deactivate	Desactivar empresa (POST /deactivate)
companies reactivate	POST /v1/companies/{id}/reactivate	Reactivar empresa
companies set-default	POST /v1/companies/{id}/set-default	Definir empresa predeterminada
companies fiscal get	GET /v1/companies/{id}/fiscal	Obtener el perfil fiscal
companies fiscal update	PATCH /v1/companies/{id}/fiscal	Actualizar el perfil fiscal
companies fiscal-profile get	GET /v1/companies/{id}/fiscal-profile	Obtener el perfil fiscal (alias)
companies fiscal-profile update	PATCH /v1/companies/{id}/fiscal-profile	Actualizar el perfil fiscal (alias)
companies matriz list	GET /v1/companies/matriz	Listar matrices

Ejemplos

--params lleva parámetros de query y de ruta (id, página, filtros); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.

# Listar empresas
kobana billing companies list \
  --fields "id,public_id,external_id,organization_id,person_id"

# Obtener empresa por ID
kobana billing companies get --params '{"id": "COMPANIE_ID"}'

# Crear empresa
kobana billing companies create \
  --json '{"name": "NAME", "document_type": "cpf", "document_number": "DOCUMENT_NUMBER", "email": "EMAIL"}'

# Actualizar empresa
kobana billing companies update \
  --params '{"id": "COMPANIE_ID"}' \
  --json '{"name": "NAME", "external_id": "EXTERNAL_ID", "legal_name": "LEGAL_NAME"}'

# Desactivar empresa (POST /deactivate)
kobana billing companies deactivate --params '{"id": "COMPANIE_ID"}'

# Eliminar empresa
kobana billing companies delete --params '{"id": "COMPANIE_ID"}' --dry-run

Próximos pasos

• Organización
• Introspección de schema — todos los parámetros que este recurso acepta.