¶ Integração Conta a Pagar - Santander
Através da Integração de Contas a Pagar com o Santander será possível realizar o pagamento das suas contas através do sistema Hubsoft.
Antes de iniciarmos a configuração da integração, é interessante verificarmos se o usuário possui todas as permissões de acesso necessárias. Caso haja permissões faltantes, solicite ao seu gestor que as adicione.
Para visualizar o módulo de integrações e as integrações que possui ativas, navegue por Barra Lateral > Configuração > Integrações e clique no módulo de Conta a Pagar.
¶ Adicionando integração
Para adicionarmos uma nova integração com o Santander, clique em Adicionar, preencha os campos e parâmetros abaixo e clique em salvar:
¶ Campos
- Descrição: Descrição/Nome que deseja estabelecer para a integração.
- Banco/Gateway: Selecione 033 - BANCO SANTANDER (BRASIL) S.A..
- Empresa: Neste campo definimos as empresas que poderão ter suas contas pagas por esta integração.
- Tipo de Pagamento: Tipo de pagamento que poderá ser realizado pela integração, podendo ser por PIX, Boleto ou Ambos (Boleto e PIX).
- Validar Fluxo de Aprovação: Define se, para realizar o pagamento por integração, a conta a pagar precisa obrigatoriamente possuir um Fluxo de Aprovação.
¶ Parâmetros
- client_id: Client ID fornecido pelo portal Santander Developer.
- client_secret: Client Secret fornecido pelo portal Santander Developer.
- numero_agencia: Número da agência da conta debitante (sem dígito verificador).
- numero_conta: Número da conta corrente debitante (sem dígito verificador).
- certificado: Dados da chave pública (.PEM) + chave privada (.KEY) do certificado digital A1 válido da empresa (OBS: Lembrar de alterar essa chave pública quando o certificado for renovado)
- cpf_cnpj_portador: (Obrigatório para boleto) CPF ou CNPJ do titular da conta pagadora.
- nome_portador: (Obrigatório para boleto) Nome completo do titular da conta pagadora.
- tipo_documento_portador: (Obrigatório para boleto) Tipo do documento do pagador. Valores aceitos: CPF | CNPJ.
Após realizar o preenchimento de todos os campos, podemos clicar em Salvar, finalizando o cadastro da integração.
¶ Realizar pagamento Conta a Pagar
Para realizarmos o pagamento de uma conta a pagar utilizando a integração, precisamos primeiro identificar se a integração que possuímos cadastrada no sistema Hubsoft utiliza um fluxo de aprovação ou não. Para isso, podemos seguir um destes dois fluxos abaixo:
¶ Pagamento com Fluxo de Aprovação
Para realizarmos o pagamento, é necessário identificarmos uma conta a pagar que pertença a uma das Empresas definidas no Fluxo de Aprovação e na Integração, e que também contenha o campo Código de Barras (para pagamento via Boleto) e/ou QR Code (Copia e Cola) (para pagamentos via PIX). Após isso, vamos navegar até o botão de Ações > Pagar Conta.
Em seguida, o sistema irá nos exibir um modal onde iremos preencher os dados para realizar o pagamento, como Caixa, Data Pagamento e Valor Pago, e clicar em Salvar.
Dados como Data de Pagamento, Valor Pago, Desconto e Juros são preenchidos manualmente apenas no início do pagamento, mas são efetivamente definidos pelo banco. Após a confirmação do pagamento pela API bancária, o sistema sobrescreve esses dados com os valores retornados pelo banco, garantindo que a conta reflita exatamente o que foi processado.
E logo após, o sistema nos exibe um segundo modal onde poderemos definir a forma de pagamento, no qual informamos a integração que desejamos utilizar e clicamos em Pagar com Integração.
Por medidas de segurança, no momento em que o usuário for realizar o pagamento de uma conta a pagar, o sistema exigirá o preenchimento do 2FA do usuário.
Como a conta a pagar também se encaixa nas regras do Fluxo de Aprovação cadastrado, o sistema move a conta a pagar para o status Aguardando Aprovações, sendo necessária a aprovação de um dos aprovadores definidos no cadastro do Fluxo de Aprovação.
Somente após a aprovação da conta é que a requisição de pagamento será disparada para o banco, mantendo a conta no status Aguardando Processamento até que o pagamento seja efetivado pelo banco e o sistema altere seu status para Pago via Integração. É nesse momento que os dados de Data de Pagamento, Valor Pago, Desconto e Juros são atualizados com os valores retornados pela API bancária.
Após o pagamento ter sido registrado, também podemos visualizar os dados de transmissão para o banco acessando o botão Ações > Gerenciar Transmissão.
¶ Pagamento sem Fluxo de Aprovação
Para realizarmos o pagamento, é necessário identificarmos uma conta a pagar que pertença a uma das Empresas definidas na Integração e que também contenha o campo Código de Barras (para pagamento via Boleto) e/ou QR Code (Copia e Cola) (para pagamentos via PIX). Após isso, vamos navegar até o botão de Ações > Pagar Conta.
Em seguida, o sistema irá nos exibir um modal onde iremos preencher os dados para realizar o pagamento, como Caixa, Data Pagamento e Valor Pago, e clicar em Salvar.
Dados como Data de Pagamento, Valor Pago, Desconto e Juros são preenchidos manualmente apenas no início do pagamento, mas são efetivamente definidos pelo banco. Após a confirmação do pagamento pela API bancária, o sistema sobrescreve esses dados com os valores retornados pelo banco, garantindo que a conta reflita exatamente o que foi processado.
E logo após, o sistema nos exibe um segundo modal onde poderemos definir a forma de pagamento, no qual informamos a integração que desejamos utilizar e clicamos em Pagar com Integração.
Por medidas de segurança, no momento em que o usuário for realizar o pagamento de uma conta a pagar, o sistema exigirá o preenchimento do 2FA do usuário.
Como a integração utilizada não possui um Fluxo de Aprovação vinculado, a requisição de pagamento é disparada diretamente para o banco, sem a etapa de aprovação. A conta a pagar assume o status Aguardando Processamento até que o pagamento seja efetivado pelo banco e o sistema altere seu status para Pago via Integração. É nesse momento que os dados de Data de Pagamento, Valor Pago, Desconto e Juros são atualizados com os valores retornados pela API bancária.
Após o pagamento ter sido registrado, também podemos visualizar os dados de transmissão para o banco acessando o botão Ações > Gerenciar Transmissão.