Aprenda a identificar e corrigir as principais falhas retornadas pela Conta Azul: Bad Request, campos vazios, limite de caracteres e problemas de estoque.
Criou uma automatização com a Conta Azul e recebeu uma mensagem de falha? Este artigo ensina como identificar e corrigir os erros mais comuns retornados pela plataforma.
Principais falhas da Conta Azul e como corrigi-las
As falhas mais frequentes retornadas pela Conta Azul são:
1. Bad Request - Erro de autenticação
Os erros relacionados a Bad Request, em sua maioria, significam que a sua conta da Conta Azul está desconectada na Pluga.
Info
Temos um artigo completo que vai te ajudar a verificar se o problema é a conexão da sua conta e como corrigir: Como reconectar a conta da sua ferramenta autenticada
No caso da Conta Azul, é importante saber que ela puxa automaticamente os dados de login da conta que você está logado.
Caso você tenha acesso a mais de uma conta da Conta Azul, recomendamos fazer essa reconexão em uma aba anônima para certificar qual conta você está integrando.
Não basta o acesso de contador através do CA+. Você precisa ter um usuário de acesso na conta que deseja conectar na automatização.
2. Campos vazios - Informações obrigatórias ausentes
Quando a Conta Azul retorna uma falha no modelo Erro: Campo Nome (name) está vazio, é importante verificar se o seu mapeamento está configurado para enviar a informação correta e se a ferramenta de origem foi preenchida adequadamente.
Vamos usar como exemplo o campo Nome da automatização A cada nova linha adicionada no Google Sheets, criar ou atualizar cliente na Conta Azul, mas vale para qualquer campo ou automatização.
O primeiro passo é conferir se você preencheu o seu mapeamento corretamente:
Aqui no exemplo, o campo Nome da Conta Azul está configurado para receber dados da coluna A Nome do Google Sheets.
Info
Algumas ferramentas possuem atributos com nomes muito parecidos, e por isso é importante se atentar qual atributo está sendo preenchido. Veja este exemplo dos campos de valor do Asaas:
Por isso é importante verificar se o atributo que você mapeou é o mesmo que está recebendo as informações que você deseja enviar para a Conta Azul.
Depois de conferir o atributo, o próximo passo é verificar se esse campo foi preenchido na ferramenta de origem:
Como podemos ver, o campo de nome não foi preenchido na linha 4. Nesse caso, é preciso preencher manualmente no Histórico Log da automatização, seguindo este passo a passo:
-
Acesse a página Minhas automatizações e depois Histórico (Log);
-
Encontre o evento com falha e clique em Corrigir;
-
Preencha corretamente o campo obrigatório que retornou a falha;
-
Clique em Salvar dados e reenviar no final da página.
3. Número de caracteres - Limite máximo excedido
Alguns campos da Conta Azul possuem um limite de caracteres para o envio de dados via API. Essa falha pode aparecer em dois modelos:
Info
[address.number] O número do endereço foi preenchido com mais de 10 caracteres. Só é permitido até 10 para esse campo
Esse modelo é mais direto e mostra o nome do campo seguido da descrição da falha em português.
Info
{"Create customer":{"code":"UNPROCESSABLE_ENTITY","message":"The contact's name cannot be bigger than 40 characters","errors":[{"field":"name","message":"The contact's name cannot be bigger than 40 characters"}]}}
Esse modelo é mais descritivo, mostrando a ação que deveria ter sido executada (Create customer), o campo com falha (name) e a mensagem de erro The contact's name cannot be bigger than 40 characters (O nome do contato não pode ter mais de 40 caracteres).
Para corrigir essa falha, basta seguir o passo a passo para alterar o campo que passou o limite aceito:
- Acesse a página Minhas automatizações e, em seguida, o Histórico (Log) da sua automatização;
- Encontre o evento com falha e clique em Corrigir;
- Verifique o tamanho da informação do campo que retornou a falha;
- Edite para caber no limite de caracteres;
- Clique em Salvar e reenviar no final da página.
Se esse tipo de falha for frequente nos seus eventos, vale considerar trocar o atributo da ferramenta de origem relacionado àquele campo da Conta Azul.
4. Produto sem quantidade disponível no estoque
Se sua falha é no modelo Não foi possível efetuar a integração: Produto X sem quantidade disponível no estoque!, isso significa que o problema é a quantidade do produto no seu estoque da Conta Azul.
Temos um artigo específico sobre essa falha: Conta Azul: Produto sem quantidade disponível no estoque
Nele você encontra duas maneiras simples de resolver esse erro.
Dúvidas?
Caso ainda tenha dúvidas, é só solicitar um atendimento que nosso time de suporte entrará em contato dentro de algumas horas ;)