
Manual do Usuário
Integração Mercos / Protheus
1. Menu Principal da Integração
O menu da integração está localizado no módulo Faturamento e reúne todos os cadastros, vínculos e processos necessários para configuração e manutenção da integração Mercos/Protheus.
2. Contas
O cadastro de Contas é o núcleo da integração. Cada conta representa uma empresa e pode possuir configurações independentes.
2.1 Aba Cadastral

Armazena informações básicas da conta para controle interno.
2.2 Configuração da Integração

- URL: Ambiente SandBox (teste) ou Produção.
- App Token: Código único da ferramenta de integração (Partners RL).
- Company Token: Código único que identifica a empresa na Mercos.
2.3 Importação de Clientes

- Define informações padrão para clientes importados (campos obrigatórios no Protheus que não existem na Mercos).
2.4 Padrões da Integração

Configurações gerais:
- Tipo de Produto (Define quais tipos de produto serão integrados. Deve-se informar os tipos separados por ponto e vírgula ';').
- Local de Estoque Padrão.
- Dias de vencimento para títulos.
- Tabela de Preço Padrão.
- TES / Tipo de Operação Padrão.
- Transportadora Padrão.
- Condição de Pagamento Padrão.
2.5 Auditoria

- A auditoria é um processo muito importante, pois possibilita o monitoramento da integração via e-mail, avisando aos responsáveis por esta, caso ocorra qualquer problema. Basta preencher os campos com o E-Mail do responsável por cada assunto.
2.6 Licenciamento

- Controle de uso da integração baseado no CNPJ da empresa.
2.7 Rotas da Integração

- Define se deverão ser integrados títulos vencidos.
- Define se serão usados produtos específicos.
- Define se deverão ser integradas categorias de produtos.
- Define se deverão ser integradas as informações de estoques dos produtos.
- Define se será selecionado a transportadora.
- Se deve integrar condição de pagamento.
- Define se irá integrar itens de tabela de preço.
- Define se irá integrar segmento de clientes.
- Define se deverão ser integrados grupos de clientes específicos.
- Define se deverão ser integrados tags de clientes.
- Define se deverão ser integrados pedidos base.
⚠ Importante: O ajuste correto das opções acima irá impactar diretamente na integração ou não das parametrizações a seguir.
2.8 Outras Configurações

- Define o status da conta como Ativo/Inativo.
- Define se deverão ser integrados os pedidos de orçamento.
- Série 3 descontinuada, sempre "T".
- Se libera todas as tabelas de preço ao cliente ou não (Caso não haja vinculo de tabela aos clientes).
- Define se deve integrar clientes com o código do Protheus junto ao nome fantasia.
- Define se irá gravar os logs de integração nas entidades de saída e entrada (Utilizado para monitoramento).
- Define a ordem dos itens dos pedidos a serem integrados.
- FIltro de integração de pedido da base.
- FIltro de integração de pedido da base.
- Define se irá informar os descontos concedidos na NF.
- Define se irá integrar os contatos do cliente no Protheus.
- Define se utilizara os horários de corte dos itens 13 e 14.
- Somente irão integrar pedidos realizados dentro do horário definido.
- Somente irão integrar pedidos realizados dentro do horário definido.
- Define se irá integrar os arquivos da NF.
- Define se deverão ser integrados grades de produtos.
- Caso ativado, irá deixar de buscar as informações da Mercos e aguardar o evido do Webhook ao Protheus.