Configuracao Servico Terceiros Asaas

De Touch ERP
Ir para a navegação Ir para a procura

Esta página descreve como parametrizar a integração **Integração Asaas** no recurso **Configuração Serviços Terceiros (1809)**. A configuração correta garante a geração de links de pagamento, autenticação segura, associação às empresas autorizadas, definição da conta de recebimento e o comportamento de notificações de clientes.

Objetivo

Orientar a equipe financeira/tecnologia a preencher corretamente cada item da integração Asaas, entendendo o propósito de cada campo e como ele impacta o funcionamento do **Link de Pagamento (2049)** e da baixa automática.

Pré-requisitos

  • Permissão para acessar o menu **Configuração Serviços Terceiros (1809)**.
  • Serviço **“Integração Asaas”** cadastrado e ativo produção(https://www.asaas.com/) ou homologação(https://sandbox.asaas.com/).
  • Saber quais **empresas** utilizarão essa integração.
  • Ter definida a **Conta Valor** que receberá as baixas automáticas provenientes dos pagamentos.

Onde configurar

Acesse o recurso **Configuração Serviços Terceiros (1809)**, selecione a chave de serviço **“Integração Asaas”** e preencha os itens exibidos na lista de parametrização.

Itens de Configuração da Integração Asaas

A tabela abaixo descreve cada item e sua função dentro do processo de geração, atualização e baixa de cobranças via Asaas.

Item (chave) O que é O que informar Por que é necessário
chave_acesso Chave da API do Asaas API Key válida da conta, saiba mais em https://docs.asaas.com/docs/chaves-de-api Autentica todas as requisições da integração.
producao Define o ambiente utilizado 1 = Produção / 0 = Sandbox Controla qual URL a integração irá utilizar, permitindo testes seguros.
id_empresas Lista de empresas autorizadas IDs separados por ponto e vírgula (ex.: 3;5;12) Restringe o uso da integração somente às empresas parametrizadas.
desabilitar_envio_notificacoes_cliente_cadastrado Controle de notificações automáticas 1 = Desabilita / 0 = Habilita Define se o Asaas deve enviar mensagens automáticas ao cliente ao criar/alterar o customer.
id_conta_valor Conta Valor para baixa automática Identificador de uma conta valor ativa Necessária para registrar corretamente a baixa financeira após o recebimento.
utilizar_token_autenticacao_web_hook Utilizar Token Autenticação Web Hook 0 para não utilizar autenticação por token no web hook, 1 para utilizar, recomendado utilizar para maior segurança Ativo garante maior segurança
token_autenticacao_web_hook Token Autenticação Web Hook token de autenticação, quando aplicavel para autenticar web-hook na API do Touch ERP Segurança

Lembretes Importantes

  • A conta valor deve estar **ativa**.
  • Caso a empresa do usuário não esteja em **id_empresas**, a geração do link será bloqueada.
  • Notificações do Asaas ao cliente dependerão do valor configurado em
 **desabilitar_envio_notificacoes_cliente_cadastrado**.
  • O campo **producao** é crítico: use **0** em testes e **1** somente em produção.

Como o Link de Pagamento usa essa configuração

  • **Autenticação**: usa *chave_acesso* + *producao* para conectar ao Asaas.
  • **Validação da empresa**: verifica se a empresa atual está em *id_empresas*.
  • **Criação/consulta de Customer**: aplica a política de notificações conforme *desabilitar_envio_notificacoes_cliente_cadastrado*.
  • **Baixa automática**: utiliza *id_conta_valor* como conta destino para registrar a baixa.
  • **Sincronização via Webhook**: os eventos recebidos atualizam status, valores e geram/excluem baixas conforme o tipo de evento.

Como configurar o Webhook no Asaas

A configuração correta do webhook garante que o ERP receba automaticamente as atualizações de pagamento.

Sobre Webhooks Asaas: https://docs.asaas.com/docs/sobre-os-webhooks

Como criar um Webhook: https://docs.asaas.com/docs/criar-novo-webhook-pela-aplicacao-web

  • versão da API: selecione a ultima versão disponível (3 no momento)
  • Token de autenticação: se parametrizado utilizar_token_autenticacao_web_hook = 1, informe o token parametrizado em token_autenticacao_web_hook (opcionalmente pode se gerar um token aleatório pelo próprio Asaas e informar na configuração do Touch ERP).
  • e-mail, seu e-mail para ser notificado em caso de falha da API
  • URL do Webhook: informe o endereço da API do seu sistema Touch Comp ERP, versão WEB (ENDERECO_API), sendo (ENDERECO_API/noauth/webhooks/asaas)
    • recomendamos fortemente o uso de HTTPS para um tráfego seguro, por padrão aceitamos requisições apenas dos IP's públicos do Asaas neste endpoint por questão de segurança.
  • Fila de sincronização: ative para gerar uma fila de sincronização, se a API Touch falhar, é necessário reativar a fila conforme https://docs.asaas.com/docs/sobre-os-webhooks
  • Ative o Web Hook
  • Tipo de envio: informe sequencial ou não sequencial.
    • No envio sequencial, os eventos seguem a ordem de ocorrência. No envio não sequencial, os eventos fluirão melhor pois são enviados simultaneamente sem ordem específica.

Endereço do Webhook no ERP

Defina o endpoint (POST) do ERP responsável por receber as notificações:

  • ENDERECO_API/noauth/webhooks/asaas

Eventos que devem ser enviados

O Asaas deve enviar todos os seguintes eventos:

  • PAYMENT_RECEIVED
  • PAYMENT_CONFIRMED
  • PAYMENT_OVERDUE
  • PAYMENT_DELETED
  • PAYMENT_UPDATED
  • PAYMENT_REFUNDED
  • PAYMENT_PARTIALLY_REFUNDED

Cada evento atualiza os dados da cobrança e, quando aplicável, faz a baixa automática do título. Então, deve se liberar as permissões destes eventos no cadastro do web hook, na dúvida, em "Adicionar Eventos" -> "Cobranças", masque "Selecionar todos"(https://docs.asaas.com/docs/criar-novo-webhook-pela-aplicacao-web)

Problemas e Soluções

Problema Solução
O sistema informa que a empresa não está autorizada Verifique se o ID da empresa está incluído em *id_empresas*.
Link não gera devido a erro de autenticação Confira se *chave_acesso* está correta e ativa.
Webhook não atualiza o status no ERP Valide a URL configurada, os IPs autorizados e se o ERP está respondendo 2xx.
Baixa não foi criada após pagamento Confirme a configuração de *id_conta_valor* e se o evento recebido foi PAYMENT_RECEIVED.

Exemplos de Configuração

Ambiente de Homologação

  • chave_acesso = (API KEY Sandbox)
  • producao = 0
  • id_empresas = 5;12
  • desabilitar_envio_notificacoes_cliente_cadastrado = 1
  • id_conta_valor = 33

Ambiente de Produção

  • chave_acesso = (API KEY Produção)
  • producao = 1
  • id_empresas = 1;3;7
  • desabilitar_envio_notificacoes_cliente_cadastrado = 0
  • id_conta_valor = 14

Observações Gerais

  • Todos os itens da integração Asaas são obrigatórios para o funcionamento completo do Link de Pagamento.
  • Utilize sempre ambiente Sandbox para testar geração de link e webhook.
  • Mantenha a API Key em local seguro.
  • Revisar periodicamente as chaves e parâmetros para evitar falhas na integração.

Links Relacionados

Obtida de "https://touchcomp.mywikis.wiki/w139/index.php?title=Configuracao_Servico_Terceiros_Asaas&oldid=8275"