Períodos fiscais

As competências fiscais que agrupam as notas emitidas.

Comando	HTTP	Descrição
tax-periods list	GET /v1/tax_periods	Listar períodos tributários
tax-periods create	POST /v1/tax_periods	Processar período tributário mensal
tax-periods get	GET /v1/tax_periods/{id}	Obter período tributário
tax-periods update	PATCH /v1/tax_periods/{id}	Executar ação no período tributário
tax-periods delete	DELETE /v1/tax_periods/{id}	Excluir período tributário

Exemplos

--params carrega parâmetros de query e de caminho (id, página, filtros); --json carrega o corpo da requisição; --fields limita os campos que voltam — vale a pena em todo list/get, para economizar contexto. Veja Flags globais para a referência completa.

# Listar períodos tributários
kobana billing tax-periods list \
  --fields "id,public_id,external_id,company_id,period_type"

# Obter período tributário
kobana billing tax-periods get --params '{"id": "TAX_PERIOD_ID"}'

# Processar período tributário mensal
kobana billing tax-periods create --json '{"year": 2026, "month": 6}'

# Executar ação no período tributário
kobana billing tax-periods update \
  --params '{"id": "TAX_PERIOD_ID"}' \
  --json '{"action": "recalculate"}'

# Excluir período tributário
kobana billing tax-periods delete --params '{"id": "TAX_PERIOD_ID"}' --dry-run

Próximos passos

• Certificados digitais
• Introspecção de schema — todos os parâmetros que este recurso aceita.