Integração com o Mercos

Sobre a sincronização entre os sistemas

Antes de iniciar a integração, é importante entender as regras de sincronização:

Clientes: Sincronização bilateral (Mercos <-> Fácil123). CPF/CNPJ é obrigatório; registros sem essa informação não serão sincronizados.

Produtos: Sincronização bilateral. Todos os produtos devem ter um código; duplicatas bloqueiam a sincronização. O Fácil123 envia apenas "produtos acabados" e "mercadorias para revenda" ao Mercos.

Vendas: Sincronização unidirecional (Mercos -> Fácil123 apenas). As vendas devem ser inseridas no Mercos; registros do Fácil123 não serão enviados ao Mercos.

Estoque: Não há sincronização.

Preparando a sincronização

Antes de habilitar a sincronização, realize auditorias completas nos catálogos de ambos os sistemas para evitar erros de faturamento e discrepâncias nos pedidos.

Conferindo os cadastros no Mercos

Clientes: - CPF/CNPJ obrigatório (registros inválidos criam duplicatas) - Telefone: 10-11 caracteres, sem espaços/traços/parênteses, DDD obrigatório, apenas um número - Cidade/Estado: se a cidade estiver preenchida, o estado se torna obrigatório - Validação de CEP ocorre no Fácil123 - IE: se preenchida, cidade/estado são obrigatórios; evite "Isento"

Produtos: - Todos os produtos precisam de códigos; verifique duplicatas - NCM preenchido no Fácil123 sobrescreve os dados do Mercos - Limite as unidades de medida às registradas no Fácil123

Conferindo os cadastros no Fácil123

Clientes: - CPF/CNPJ obrigatório - Complete todos os campos exigidos pelo Mercos - Bairro: máximo de 30 caracteres, se preenchido - Telefone: 10-11 caracteres com DDD - IE: sem designação "Isento"

Produtos: - Todos precisam de grupo de tributos ou padrão do sistema - NCM obrigatório

Vendedores: - Nomes devem corresponder exatamente aos do Mercos - Marcar como "Atua como vendedor" no Fácil123

Configurando o Mercos

Clientes

• Marque CPF/CNPJ como campo obrigatório
• Não marque "segmento" como obrigatório (bloqueia a sincronização)
• Não exija "Nome Fantasia" ou "Inscrição Estadual"
• Ative "Bloquear cadastro de mais de um cliente com o mesmo CPF/CNPJ"

Vendedores

• Deixe "Permitir alterar o pedido depois de gerado" desmarcado

Pedidos

Configure as condições de pagamento padrão conforme as regras do Fácil123. Apenas "boleto" ou "à vista" são permitidos como texto. Materiais de referência:

• Mercos: Cadastrar condições de pagamentos
• Fácil123: Gerando parcelas e boletos na venda

Exceção Fiscal

A nomenclatura exata é obrigatória:

• Revenda – Simples
• Revenda – Normal
• Consumo – Não contr
• Consumo – Contribuin
• Mat prima / Simples
• Mat prima / Normal

ST: Configure a tributação por estado em Produtos > Configurações > Tributações.

Plano de Pagamento

Para B2C: Acesse Minha Conta → Políticas comerciais → edite as condições de pagamento conforme os padrões do Fácil123.

Sobre a sincronização

Para sincronizar

Em Vendas, clique nos três pontinhos → "Sincronizar com o Mercos"

A sincronização automática ocorre a cada hora. Vendas canceladas no Mercos precisam ser canceladas manualmente no Fácil123. A configuração opcional de webhook notifica o Fácil123 sobre alterações nos pedidos. Veja a configuração do webhook.

A última alteração é a que vale

Edições bilaterais são sincronizadas automaticamente. A última fonte de modificação determina qual sistema atualiza o outro. Os dados modificados por último sempre prevalecem entre os sistemas.

Exclusão de dados

Exclusões não são sincronizadas. O Fácil123 impede a exclusão de registros vinculados a vendas. Para dados incorretos: corrija os erros antes da exclusão, depois exclua em ambos os sistemas. A inativação é recomendada.

Quando o pedido é sincronizado com o Fácil123

Os pedidos do Mercos iniciam como orçamentos. A sincronização ocorre após clicar em "Gerar pedido" com status "Concluído".

Após a sincronização, ele aparece como um orçamento no Fácil123.

Alteração no pedido

Edições são sincronizadas apenas do Mercos → Fácil123. Alterações no Fácil123 não chegam ao Mercos. Uma vez convertido em venda/NF-e, edições no orçamento param de sincronizar. Cancelamentos sempre exigem ação manual no Fácil123.

Exceção Fiscal e Natureza da Operação

Três métodos de definição da natureza da operação:

1. Exceção definida no registro do cliente no Mercos → sincroniza com a natureza correspondente no Fácil123
2. Natureza padrão do cliente aplicada se nenhuma exceção for especificada
3. Grupo de tributos padrão das configurações do usuário licenciado se não houver definição prévia

A natureza do Fácil123 é vinculada ao cliente após a confirmação da venda.

Cálculo da ST

Podem ocorrer discrepâncias de centavos entre o pedido do Mercos e a nota do Fácil123 devido a diferenças de arredondamento na ST. O cálculo do Fácil123 é o correto.

Garantindo um bom uso da sincronização

Cadastrando um produto

No Mercos: - Todos os produtos precisam de códigos - Informações de NCM sempre fluem apenas do Fácil123 → Mercos

No Fácil123: - Código obrigatório - Grupo de tributos válido obrigatório - NCM obrigatório

Cadastrando um cliente

No Mercos: - CPF/CNPJ obrigatório - Telefone: 10-11 caracteres sem caracteres especiais, DDD incluso - Cidade exige preenchimento do estado - IE precisa de cidade/UF; evite "Isento" - Indicador de IE: deixe em branco ou classifique no Fácil123 (sem "Isento") - Endereço: ex., "Rua Nome da rua" - Número: ex., "01"

No Fácil123: - CPF/CNPJ obrigatório - Preencha todos os campos exigidos pelo Mercos (e-mail/telefone são comuns) - Telefone: mínimo/máximo de 10-11 caracteres, apenas números, sem caracteres especiais

Gerando pedidos no Mercos

Checklist: - Pagamento: siga as regras de parcelas do Fácil123; apenas "boleto" ou "à vista" - Valor do produto: mínimo R$ 0,01; sem totais zerados - Vendedor: deve existir no Fácil123 com nome correspondente, marcado como "atua como vendedor"

Perguntas e Respostas

1 – O que causa a criação de clientes duplicados? CPF/CNPJ preenchido no Mercos mas vazio no Fácil123 gera duplicação durante a sincronização.

2 – Por que incluir o e-mail do fornecedor no Mercos? Todas as pessoas são sincronizadas; os registros devem atender todas as regras.

3 – Para pedidos com desconto, usar Reais ou porcentagem no Mercos? Porcentagem. O Fácil123 converte para Reais durante a sincronização.

4 – Produtos inativos do Mercos integram com o Fácil123? Sim, tanto produtos ativos quanto inativos são integrados.

5 – Dados de transportadora sincronizam das vendas do Mercos para o Fácil123? Não. Transportadora/modo de transporte/placa do veículo não sincronizam. Insira no Fácil123 se necessário.

6 – Como funciona a bonificação no Mercos? Insira como Bonificação no Mercos → sincroniza com o Fácil123 como venda normal → altere a natureza da operação no Fácil123.

7 – É possível importar frete na integração com o Mercos? Sim, é possível.