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.

E por mais que você faça o possível para que a sincronização seja bem sucedida algumas vezes podem ocorrer erros.

A nossa intenção é que isso seja fácil de resolver. Então, esse material visa ajudar você de forma rápida e fácil a identificar o erro, como é possível resolvê-lo e entender o motivo pelo qual ele ocorreu!

Caso você esbarre em um erro aí e ele não esteja aqui, nos avise, estamos em constante evolução!

Logs das Integrações Mercos

Para que você possa conferir que tipo de erro sua sincronização gerou, ou até mesmo conferir se ela foi bem sucedida utilize os Logs das Integrações.

Os logs das integrações com o Mercos está disponível ao usuário que possui acesso a vendas. Caso contrário a tela aparecerá sem registros.

Todas sincronizações serão listadas nos Logs das Integrações, tanto as acionadas manualmente, quanto as automáticas que ocorrem de 1 em 1 hora.

O log de erros estará disponível por 7 dias. Após esse prazo, ele será deletado, portanto não será mais possível verificar os erros anteriores à este período.

Caso as correções não sejam feitas, existe o risco de emitir notas para um cadastro desatualizado ou um ajuste de produto não estar coerente.

Erros comuns:

Dados inválidos, 'emails': No mínimo 1 e-mail é requerido

O campo e-mail está marcado como obrigatório no Mercos. O ajuste do e-mail deve ser feito onde o cliente foi cadastrado.

Dados inválidos, 'telefones': No mínimo 1 telefone é requerido

O campo telefone está marcado como obrigatório no Mercos. Basta preencher no cadastro do Fácil123.

Destinatário precisa ter uma cidade válida

O cliente que está no pedido está com alguma irregularidade na cidade. Pode ser que a UF não esteja preenchida.

Erro ao gerar as parcelas no Fácil123

A parcela digitada não é suportada pelo Fácil123.

IE:não é válido

A inscrição estadual do cliente não está válida. Caso o cliente não possua Inscrição, deixe em branco. Não preencha com ISENTO, por exemplo.

invoiceproducts:[prorateddiscount:deve ser maior ou igual a 0

O valor dos produtos está como zero reais. Isso não é possível. Todo produto deve ter pelo menos R$ 0,01 (um centavo).

Itens com total zero

O valor dos produtos está como zero reais. Isso não é possível. Todo produto deve ter pelo menos R$ 0,01 (um centavo).

O pedido não pode ser atualizado no Fácil123

A venda já foi transformada em NF-e ou já contém parcelas realizadas no financeiro.

O pedido não pode ser atualizado no Fácil123., A venda não foi sincronizada porque ela já foi movida de etapa no Fácil123. Por favor, faça as modificações necessárias manualmente nos dois sistemas.

A venda já foi transformada em NF-e ou já contém parcelas realizadas no financeiro. Ou simplesmente já saiu da etapa que permite edições de pedido.

Pedido não processado: Cliente não registrado

O cliente que participa deste pedido deve estar sem CPF ou CNPJ.

Pessoa não processada: pessoa sem CPF e CNPJ

Adicione o CPF ou CNPJ ao cadastro. O ajuste deve ser feito onde a pessoa foi cadastrada.

phoneareacode: não é válido (Área não é válido)

O telefone deve conter 10 ou 11 caracteres, sem espaços, traços, parênteses.

phone_number: é muito curto (mínimo: 8 caracteres)

O telefone deve conter 10 ou 11 caracteres, sem espaços, traços, parênteses.

Produto não processado: produto sem código

Adicione código ao cadastro do produto no Mercos.

Produto precisa ter um grupo de tributos válido

Adicione o grupo de tributos no cadastro do Fácil123. Lembre-se: O Fácil123 usa o campo NCM no Mercos para o grupo de tributos, para poder calcular a ST, quando necessário. Então, não deve ser preenchido nada no Mercos com relação à NCM.

Produto precisa ter um NCM para o cálculo da carga tributária

Adicione a NCM no cadastro do Fácil123. Essa informação não é sincronizada com o Mercos.

prorated_discount:deve ser maior ou igual a 0

O valor dos produtos está como zero reais. Isso não é possível. Todo produto deve ter pelo menos R$ 0,01 (um centavo).

Quando informado a Inscrição Estadual a Cidade e a UF não devem ficar em branco

Adicione cidade e UF no cadastro do cliente no Mercos.

Total de parcelas difere do total da venda

A edição do pedido alterou o valor das parcelas, mas elas não foram editadas no Mercos. Verifique as duas informações: Mercos + Fácil123.

Vendedor não encontrado

O vendedor do pedido não está cadastrado no Fácil123. Confira o nome dos usuários (no Mercos e no Fácil123) e verifique se estão iguais. Verifique o cadastro do usuário no Fácil123 e verifique se este usuário está marcado como "atua como vendedor".

Você não pode alterar as parcelas de uma venda com transações realizadas

A venda já foi transformada em NF-e ou já contém parcelas realizadas no financeiro.

Dados inválidos, 'cep': Este campo requer 8 dígitos

O CEP está com problemas.

CNPJ já está em uso ou Dados inválidos, 'cnpj': Este CNPJ já está cadastrado no sistema

Peça ajuda ao suporte. Ocorreu alguma alteração no cadastro que tinha vínculo com o CNPJ.

{"mensagem": "Cliente 19332626 não encontrado."}

Peça ajuda ao suporte. É provável que o vínculo com o cliente tenha sido quebrado. O cadastro foi excluído. E deve haver outro cadastro com o mesmo CNPJ. Informe o ID no Mercos no nome daquele cliente. (este ID não irá existir mais lá) O desenvolvimento deverá trocar o vínculo.

Dados inválidos, 'preco_tabela': Certifique-se de que não tenha mais de 8 dígitos no total

O preço do produto, está com mais de 8 casas decimais. Ajustar no Fácil.

["Produto não pode ficar em branco"]

Algum dos produtos (um ou mais de um) está com problema de cadastro. Existem algumas alternativas de erro mais comuns:

a. o vínculo entre o Fácil123 e o Mercos referente a este item foi quebrado. Ou ele foi deletado no Mercos e recadastrado, ou foi deletado no Fácil123 e recadastrado.

b. o cadastro foi feito no Mercos e pode estar incompleto no Fácil123. Para conferir:

• Verifique se todos os produtos do pedido contém unidade de medida no Mercos.
• se sim, verifique se o cadastro existe no Fácil123. Ele terá que ser complementado com a NCM e o grupo de tributos no Fácil123 antes de o pedido sincronizar.

Pedido cancelado no Mercos o Fácil não entende

Quando isso acontecer, peça ajuda ao suporte e passe o ID do pedido para o desenvolvimento corrigir.

Dados inválidos, * Segmento: Este campo é obrigatório

No Mercos existe o campo Segmento e está marcado como obrigatório. Para resolver é preciso desmarcar ele como obrigatório, editar o cadastro, e então sincronizar.