Pular para o conteúdo principal

Réguas de cobrança

A régua em si: a sequência de etapas que dispara mensagens, tarefas, negativação ou protesto conforme a cobrança se aproxima do vencimento e envelhece. As etapas são gerenciadas em steps, cada uma com o gatilho (before_due, on_due, after_due + dias), a ação e os canais.

ComandoHTTPDescrição
collection-rules listGET /v1/collection-rulesListar réguas
collection-rules createPOST /v1/collection-rulesCriar régua
collection-rules getGET /v1/collection-rules/{id}Consultar régua
collection-rules updatePUT /v1/collection-rules/{id}Atualizar régua
collection-rules deleteDELETE /v1/collection-rules/{id}Excluir régua
collection-rules steps getGET /v1/collection-rules/{id}/stepsListar etapas da régua
collection-rules steps createPOST /v1/collection-rules/{id}/stepsCriar etapa
collection-rules steps updatePUT /v1/collection-rules/{id}/steps/{stepId}Atualizar etapa
collection-rules steps deleteDELETE /v1/collection-rules/{id}/steps/{stepId}Excluir etapa

Exemplos​

--params carrega parâmetros de query, de caminho e de cabeçalho (id, página, filtros, X-Workspace-Id); --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 réguas
kobana dunning collection-rules list --fields "id,name,classification_id,is_default,activated_at"

# Criar régua
kobana dunning collection-rules create \
--json '{"name": "Régua padrão", "is_default": true}'

# Listar as etapas de uma régua
kobana dunning collection-rules steps get --params '{"id": "RULE_ID"}'

# Adicionar etapa: e-mail 3 dias antes do vencimento
kobana dunning collection-rules steps create \
--params '{"id": "RULE_ID"}' \
--json '{"name": "Lembrete D-3", "trigger_type": "before_due", "trigger_days": 3, "action_type": "notification", "channels": ["email"]}'

# Excluir etapa
kobana dunning collection-rules steps delete --params '{"id": "RULE_ID", "stepId": "STEP_ID"}' --dry-run

Próximos passos​