Configuração da conta DDA

A conta DDA liga um CNPJ ao DDA. Ela guarda os dados da empresa e os assinantes do termo de adesão ao DDA (a carta de adesão), que a Kobana gera e envia para assinatura digital. A conexão com o provedor de DDA é feita pela Kobana: não há nada a configurar nessa parte.

Onde fica no painel

Pagamentos > DDA. A tela Contas DDA lista as contas com as colunas CNPJ, Nome, Situação Geral e Ativa (Ativa ou Inativa). Para cadastrar, clique no ícone + ao lado do título Contas DDA. Sem nenhuma conta, a tela mostra o passo a passo e o atalho Cadastrar Conta DDA.

Cadastrar a conta DDA

A tela Configurar Conta DDA tem o formulário à esquerda e, à direita, os quadros Assinantes e Status e Preview do Termo de Adesão.

Dados da empresa

Campo	Obrigatório	Descrição
CNPJ	Sim	CNPJ que vai receber os boletos. Ao digitar, a Kobana tenta preencher razão social, telefone e endereço. Não pode ser alterado depois de criado.
Nome da Carta	Não	Nome que identifica a conta e a carta.

Informações de Contato

Dados usados no termo de adesão. Todos são opcionais: Razão Social, Telefone, CEP, Logradouro, Número, Complemento, Bairro, Cidade e UF. O CEP preenche o endereço.

Assinantes

O formulário aceita de 1 a 3 assinantes. O Assinante 1 é obrigatório; Adicionar assinante abre os outros dois, e Remover assinante os retira.

Campo	Obrigatório	Descrição
Nome completo	Sim	Nome do assinante.
CPF	Sim	CPF do assinante.
E-mail	Sim	Endereço que recebe o link de assinatura.
Papel	Não	Sócio, Testemunha, Representante Legal, Procurador, Responsável Financeiro, Diretor ou Representante.

Clique em Configurar. O painel mostra Conta DDA configurada com sucesso!

Carta de adesão e assinaturas

Depois do cadastro, a Kobana gera o PDF do termo de adesão e o envia para assinatura digital. Cada assinante recebe um e-mail com o link para assinar. O quadro Assinantes e Status e o preview do termo se atualizam sozinhos na tela.

O quadro mostra três situações:

Campo	Situações
Situação da Carta	Não criada, Gerando, Criada, Falhou
Situação de Assinatura	Aguardando assinaturas, Assinada, Falhou
Situação Geral	Pendente, Aguardando aprovação, Aprovada, Assinatura rejeitada

E a tabela de assinantes, com Nome, Papel e Assinou (marcado quando o assinante já assinou).

Situação Geral:
Pendente ──(todos assinaram)──► Aguardando aprovação ──► Aprovada
                                        │
                                        └──► Assinatura rejeitada

• Quando todos os assinantes assinam, a carta fica Assinada e a conta, Aguardando aprovação.
• A equipe Kobana valida as assinaturas. Aprovada, a conta mostra a Data de Aprovação e passa a Ativa quando o cadastro no provedor de DDA é concluído.
• Se as assinaturas forem recusadas, a conta fica Assinatura rejeitada e o quadro mostra a Data de Rejeição e o Motivo.
• O quadro também mostra Habilitada em e Desabilitada em quando a conta foi habilitada ou desabilitada.

Enquanto a conta está Pendente, a tela avisa: A aprovação da conta só será efetivada após a confirmação e validação das assinaturas do termo de adesão.

Editar a conta DDA

Altere os campos e clique em Atualizar. O painel mostra Configurações da conta DDA atualizadas com sucesso!

Regras:

• O CNPJ não muda depois do cadastro.
• Alterar o nome ou os dados de contato gera uma nova carta.
• Com a Situação da Carta em Falhou, salvar o formulário de novo, mesmo sem alterações, tenta gerar a carta outra vez.
• Trocar assinantes enquanto a carta aguarda assinaturas atualiza o processo de assinatura sem gerar uma nova carta.
• Depois que a carta é assinada, os assinantes não podem ser alterados.
• Conta Aprovada não pode ser editada: o formulário fica bloqueado com o aviso Esta configuração não pode mais ser editada porque a carta já foi aprovada.
• Uma conta com mais de 3 assinantes (cadastrados pela API) não pode ser editada pelo painel; use a API.

Eventos de webhook

Evento	Quando
payment.dda.account.db.created	Conta DDA criada.
payment.dda.account.db.updated	Conta DDA alterada.
payment.dda.account.letter.pending	Carta gerada e enviada para assinatura.
payment.dda.account.letter.waiting_signatures	Carta aguardando assinaturas.
payment.dda.account.letter.signed	Carta assinada por todos os assinantes.
payment.dda.account.letter.failed	Falha no processo de assinatura da carta.
payment.dda.account.confirmed	Conta DDA aprovada.
payment.dda.account.rejected	Conta DDA rejeitada.
payment.dda.account.enabled / payment.dda.account.disabled	Conta DDA habilitada ou desabilitada.

Lista completa em Eventos de webhook.

Permissões

Módulo Pagamento, produto Configuração de Conta DDA: Ações Básicas para ver, Criar para cadastrar e Alterar para editar.

Pela API

Referência em API v2. Habilitar e desabilitar a conta DDA só pela API.