Erros de integração – Mercos

Sabemos que existem algumas regras para que a sincronização entre o Fácil123 e Mercos aconteça de maneira descomplicada. Mesmo assim, erros podem ocorrer. Este recurso ajuda a identificar, resolver e entender os erros de integração rapidamente.

Logs das integrações Mercos

Usuários com acesso a vendas podem revisar os logs de sincronização, mostrando sincronizações manuais e automáticas (que ocorrem de hora em hora). Os logs de erros ficam disponíveis por 7 dias antes de serem excluídos. Recomendamos estabelecer uma rotina para revisar os erros com frequência e fazer os ajustes necessários, evitando emitir notas fiscais com informações desatualizadas ou ajustes de produtos inconsistentes.

Erros comuns e soluções

E-mail/Telefone obrigatório

• "Dados inválidos, 'emails': No mínimo 1 e-mail é requerido" – O e-mail é obrigatório no Mercos; atualize no cadastro do cliente
• "Dados inválidos, 'telefones': No mínimo 1 telefone é requerido" – O telefone é obrigatório; adicione ao cadastro no Fácil123

Endereço

• Cidade de destino inválida – O cliente tem irregularidades de cidade; a UF pode estar faltando
• Validação de CEP – "Dados inválidos, 'cep': Este campo requer 8 dígitos"
• "Quando informado a Inscrição Estadual a Cidade e a UF não devem ficar em branco" – Adicione cidade e UF ao cadastro do cliente no Mercos

Cadastro fiscal

• "IE:não é válido" – Inscrição estadual inválida; deixe em branco se não disponível
• Problemas com CNPJ – "CNPJ já está em uso ou Dados inválidos, 'cnpj': Este CNPJ já está cadastrado" requer suporte

Preços de produtos

• "invoiceproducts:[prorateddiscount:deve ser maior ou igual a 0" – Produtos não podem ter valor zero; mínimo R$ 0,01
• "Itens com total zero" – Mesma situação; todos os produtos precisam de valor mínimo
• "prorated_discount:deve ser maior ou igual a 0" – O valor do produto não pode ser zero
• "Dados inválidos, 'preco_tabela': Certifique-se de que não tenha mais de 8 dígitos no total" – O preço tem casas decimais em excesso

Grupo de tributos/NCM

• "Produto precisa ter um grupo de tributos válido" – Adicione o grupo de tributos no Fácil123
• "Produto precisa ter um NCM para o cálculo da carga tributária" – Adicione o NCM no Fácil123 (não é sincronizado do Mercos)

Parcelas de NF-e/Pagamento

• "Erro ao gerar as parcelas no Fácil123" – Formato de parcelamento não suportado
• "Total de parcelas difere do total da venda" – Valores do pedido editados não batem com os totais das parcelas
• "Você não pode alterar as parcelas de uma venda com transações realizadas" – NF-e ou pagamentos concluídos impedem alterações

Status do pedido

• "O pedido não pode ser atualizado no Fácil123" – Pedido convertido em NF-e ou com pagamentos concluídos
• "O pedido não pode ser atualizado no Fácil123., A venda não foi sincronizada porque ela já foi movida de etapa..." – Pedido movido além das etapas editáveis

Cadastro do cliente

• "Pedido não processado: Cliente não registrado" – Cliente sem CPF/CNPJ
• "Pessoa não processada: pessoa sem CPF e CNPJ" – Adicione CPF ou CNPJ ao cadastro
• "Vendedor não encontrado" – Vendedor não está no Fácil123; verifique os nomes correspondentes e o status "atua como vendedor"

Formato de telefone

• "phoneareacode: não é válido" – O telefone requer 10-11 caracteres sem espaços/traços
• "phone_number: é muito curto" – Mínimo de 8 caracteres obrigatório

Problemas com produto

• "Produto não processado: produto sem código" – Adicione código ao produto no Mercos
• "["Produto não pode ficar em branco"]" – Produto sem unidade de medida no Mercos ou cadastro incompleto no Fácil123

Outros erros

• "{"mensagem": "Cliente 19332626 não encontrado."}" – Vínculo do cliente quebrado; requer suporte
• "Pedido cancelado no Mercos o Fácil não entende" – Entre em contato com o suporte informando o ID do pedido
• "Dados inválidos, * Segmento: Este campo é obrigatório" – Desmarque Segmento como obrigatório no Mercos