> For the complete documentation index, see [llms.txt](https://ajuda.consistem.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/comercial/mercos.md). # Mercos ### Visão geral A integração entre o Mercos (uma plataforma de força de vendas) e o Consistem ERP foi criada com o objetivo principal de simplificar, automatizar e otimizar o fluxo de trabalho de empresas que buscam um controle mais eficaz de suas operações comerciais. Essa conexão permite que informações cruciais sobre o dia a dia comercial sejam atualizadas automaticamente, eliminando a digitação manual de dados e reduzindo drasticamente a margem de erros operacionais. A arquitetura foi desenvolvida utilizando 100% dos endpoints do sistema padrão do Consistem ERP, garantindo estabilidade e conformidade com as regras de negócio da Consistem.
Consistem ERPMercos

Compatibilidade: 7.5 ou superiores do Consistem ERP.

Módulo: Comercial.

Componente: Consistem API ativa e liberada.

Licença: Aquisição de licença MERC ativa junto à Consistem.


Orientamos o acompanhamento da nossa equipe de consultores.

Aquisição de licença e implantação deve ser verificada com a empresa fornecedora.
Saiba mais
### Configuração da integração #### No Consistem ERP: 1. **Configuração de Eventos:** Acesse o programa [Evento de Sincronização (CSWMEN170)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/evento-de-sincronizacao.md) para parametrizar e configurar os eventos disparadores das tabelas de banco de dados vinculadas aos cadastros da carga ([Representantes](/cadastros-gerais/manuais-de-telas/representantes/cadastro-de-representante.md), [Clientes](/cadastros-gerais/manuais-de-telas/clientes/cadastro-de-cliente.md), [Transportadoras](/cadastros-gerais/manuais-de-telas/cadastros-gerais/cadastro-de-transportadora.md), [Condições de Venda](/comercial/manuais-de-telas/comercial-faturamento/cadastros-de-faturamento/cadastro-de-condicao-de-venda.md) e [Tabelas de Preços](/comercial/manuais-de-telas/comercial-carteira-de-pedidos/tabela-de-precos/inclusao-da-tabela-de-precos.md)), além das tabelas de movimentações de Pedidos e Notas Fiscais.
2. **Geração de Ocorrências:** Esta configuração fará com que, a cada inclusão ou alteração realizada nos cadastros citados acima dentro do ERP, o sistema gere automaticamente uma ocorrência. Essa fila de ocorrências é o que viabiliza a sincronização incremental pelo Mercos. #### No Mercos: 1. **Autenticação:** Realize a parametrização de acesso e credenciais junto às APIs padrão do Consistem ERP, estabelecendo o vínculo de uma (1) empresa do Consistem para uma (1) base de dados no Mercos. 2. **Carga Inicial:** Dispare a rotina de carga inicial consumindo os endpoints de cadastros gerais para estruturar a base de dados mestre no Mercos antes de liberar a operação de campo. ### Como a integração funciona Diferente de comunicações de arquivo local, a integração do Mercos com o Consistem ERP se dá integralmente por meio de API, utilizando de forma nativa e 100% os endpoints do sistema padrão. Embora o fluxo de informações do negócio atenda a ambas as pontas (dados gerados no Consistem ERP e dados gerados em campo), a comunicação técnica é unilateral. Isso significa que o Mercos é o agente ativo que sempre realiza as requisições HTTP (consultas para buscar dados e envios para postar registros), consumindo ativamente as APIs disponibilizadas pelo Consistem ERP de forma automatizada. A arquitetura de microsserviços utiliza os seguintes conjuntos de APIs padrão da Consistem: * **API do Comercial / Cadastros Gerais:** Utilizada para a infraestrutura comercial e sincronização cadastral mestre. * **API de Entradas / Estoque:** Utilizada para a consulta e consistência de estoques físicos em tempo real. * **API Comercial / Comercial:** Utilizada para a orquestração e tráfego de documentos de vendas e saídas fiscais. ### Fluxo do processo O fluxo de trabalho e sincronização de dados é baseado em um modelo misto de Carga Inicial via API e Sincronização Incremental por Evento (Leiaute de Fila de Ocorrências) gerado pelo programa [Evento de Sincronização (CSWMEN170)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/evento-de-sincronizacao.md). #### 1. O que a Consistem envia (Consistem :arrow-right: Mercos) Neste fluxo, o ERP disponibiliza as informações mestres para manter o sistema de vendas externo devidamente alinhado. Após o Mercos realizar uma carga total inicial, o programa [Evento de Sincronização (CSWMEN170)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/evento-de-sincronizacao.md) passa a gerar uma conciliação com base nas modificações do ERP, disparando um registro de ocorrência para o Mercos buscar somente a informação alterada. * **Leiaute de Cadastros Gerais (API Comercial / Cadastros Gerais):** * *Endpoint Representante:* Retorna os representantes cadastrados no ERP para vinculação com vendedores no Mercos. * *Endpoint Clientes:* Fornece a listagem de clientes ativos e atualizados para a base do Mercos. * *Endpoint Transportadora:* Disponibiliza a listagem de transportadoras cadastradas. * *Endpoint Condição de Venda:* Disponibiliza a lista de condições de vendas, prazos e formas de cobrança cadastradas. * *Endpoint Tabela de Preços:* Retorna as tabelas de preços de produtos com seus respectivos valores vigentes. * *Produtos e Grades:* Atualização e envio das categorias, grupos, famílias e estrutura de produtos com grade (pais e filhos). * **Leiaute de Posição de Estoques (API de Entradas / Estoque):** * *Endpoints Posição de Estoque e Saldo Atual de Estoque:* O Mercos consome estes dados continuamente para garantir a sincronização precisa dos saldos físicos de estoque por local, evitando que os representantes vendam itens indisponíveis. * **Leiaute de Faturamento e Acompanhamento (API Comercial / Comercial):** * *Endpoint Nota Fiscal Saída:* Envia os dados das notas fiscais faturadas no ERP para que o Mercos possa apresentá-las e disponibilizá-las diretamente aos representantes em campo. * *Status e Contas a Receber:* Sincroniza o andamento das etapas dos pedidos e atualiza títulos financeiros vencidos para auxiliar o controle e gestão de cobrança do vendedor. #### 2. O que a Consistem recebe (Mercos :arrow-right: Consistem) Neste fluxo, o Mercos atua como a origem ativa das movimentações e transações coletadas externamente pelos vendedores em campo, fazendo a postagem dos dados diretamente para o ERP processar. * **Leiaute de Vendas e Manutenção (API Comercial / Comercial):** * *Endpoint Pedido de Venda:* O Consistem ERP recebe as requisições de Inclusão (novos pedidos criados no Mercos) e Alteração/Consulta (manutenção e gestão de cancelamento de pedidos diretamente em campo). * **Leiaute de Prospecção (API Comercial / Cadastros Gerais):** * *Endpoint Clientes:* O ERP recebe novos cadastros de clientes que foram abertos ou atualizados pelos vendedores em campo durante as visitas comerciais. Assim que o pedido é recebido e sofre faturamento ou alteração de status no ERP, o programa [Evento de Sincronização (CSWMEN170)](/componentes/manuais-de-telas/cadastros-gerais-de-componentes/evento-de-sincronizacao.md) atua novamente gerando uma nova ocorrência nas tabelas de pedidos e notas fiscais, atualizando o fluxo de envio para manter o Mercos atualizado em tempo real.

Esse conteúdo foi útil?

Sim Não

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ajuda.consistem.com.br/consistem-integracoes/areas-de-negocio/comercial/mercos.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.