Disparo de Pagamentos via Kobana

O Financeiro Inteligente integra com o Gateway Bancário para enviar pagamentos automaticamente. Uma vez configurada a integração Kobana, contas a pagar elegíveis podem ser agendadas e disparadas sem intervenção manual.

Pré-requisitos

1. Integração Kobana conectada e ativa.
2. Conta a pagar com operation_kind definido (payment ou transfer).
3. Coordenadas de pagamento preenchidas (código de barras, chave PIX, dados bancários, etc.).
4. Beneficiário (beneficiary_name e beneficiary_document) preenchido.

Fluxo de Disparo

Conta a pagar (pending)
    │
    ▼
Agendar disparo ──► scheduled_to (data/hora)
    │
    ▼
Worker enfileira lote Kobana
    │
    ▼
Kobana aprova lote ──► kobana_batch_uid gravado
    │
    ▼
Worker monitora status ──► kobana_status atualizado
    │
    ├──► "approved" ──► liquidar automaticamente
    └──► "cancelled" / "failed" ──► notificar

Agendamento

No formulário de conta a pagar, preencha o campo Agendar para (scheduled_to) com a data e hora desejada. O worker de disparo processa lotes periodicamente e envia os pagamentos elegíveis ao Kobana.

Status Kobana

O campo kobana_status espelha o estado do pagamento na plataforma Kobana:

Status	Descrição
pending	Aguardando aprovação do lote
approved	Aprovado — será processado
processing	Em processamento
settled	Liquidado com sucesso
cancelled	Cancelado no Kobana
failed	Falhou no processamento

Cancelar Envio

É possível cancelar um disparo agendado antes que o lote seja aprovado. Use a ação Cancelar envio no detalhe da conta a pagar. Isso limpa scheduled_to, kobana_batch_uid e kobana_status e retorna o documento ao estado pending normal.

Liquidação Automática

Quando o Kobana confirma a liquidação (settled), o worker cria automaticamente uma transação de débito na conta financeira vinculada e marca a conta a pagar como paid.