O que é

Mercos é uma plataforma de força de vendas e e-commerce B2B. O ambiente Mercos agiliza e organiza os pedidos dos clientes, permitindo sua integração com o Uniplus.

Como funciona no Uniplus?

Para configurar a integração com o Mercos e-Commerce, acesse o menu Ferramentas → E-commerce → Configurações:

Em seguida, clique no botão [Incluir (F2)] e preencha os campos conforme a descrição abaixo:

O E-commerce Mercos possui algumas regras que devem ser seguidas para o correto funcionamento. Da tela de configuração, destacamos alguns campos fundamentais:

• App Key: Também conhecida como Company Token, será enviada pela Mercos diretamente para o e-mail da revenda.

• Última sincronização dos pedidos: quando o Uniplus for buscar os pedidos, sempre deve ser considerado a partir do último pedido sincronizado em diante. Caso precise sincronizar um pedido anterior novamente, será necessário voltar a data ou horário do campo “Última sincronização dos pedidos” na configuração do e-commerce;

• Última sincronização dos clientes: a mesma regra do campo comentado no item acima, porém sendo aplicada aos Clientes;

• Ambiente: indique se está trabalhando em homologação ou em produção. Dependendo do que for configurado neste campo, o sistema vai considerar a 

• URL de Integração Mercos

A URL de homologação ou a URL de produção devem ser obtidas pela revenda diretamente com a Mercos, e configuradas nos respectivos campos da tela de integração (conforme figura acima).

• URL de Produção:
  https://app.mercos.com/api

• URL de Homologação:
  https://sandbox.mercos.com/api
  

Atenção: Utilize a URL correta conforme o ambiente de operação (produção ou homologação), para garantir o funcionamento adequado da integração.

2 – Na aba “Produto” faça as seguinte configurações:

Enviar nome no e-commerce:
Selecione esta opção se deseja enviar o nome do produto para o e-commerce.

• Enviar imagens:
  Selecione esta opção se deseja enviar imagens do produto para o e-commerce.

• Enviar categoria:
  Selecione esta opção se deseja enviar a categoria do produto para o e-commerce.

• Enviar saldo previsto:
  Selecione esta opção se deseja enviar o saldo previsto do produto para o e-commerce.

• Cadastrar novas variações:
  Selecione esta opção se deseja cadastrar automaticamente novas variações do produto no e-commerce.

• Pauta de preço para venda:
  Selecione a pauta de preço que deseja utilizar para envio dos preços ao e-commerce.

• Filial:
  Informe a filial da qual o sistema irá considerar o saldo de estoque do produto para envio ao e-commerce.

• Utilizar Grade nova:
  A Mercos possuía inicialmente duas formas de trabalhar com grade de produtos.

Entretanto, a forma inicial foi descontinuada.

Atualmente, a plataforma opera exclusivamente com a grade nova, que deve ser utilizada em todas as configurações e integrações.

Quando a opção não está marcada, o sistema envia a grade no formato antigo da Mercos.

Nesse modelo, a Mercos recebe apenas os atributos separados de Cor e Tamanho, por exemplo:

• Cor: Azul, Vermelho, Verde, Branco

• Tamanho: G, GG, M, P, PP

Com essas informações, a própria Mercos é responsável por montar a grade de combinações.

Importante:
Como a Mercos gera todas as combinações possíveis entre Cor e Tamanho, podem ser criadas variações que não existem no cadastro original do cliente.

• Limites de produtos na sincronização:

Esse campo foi implementado para auxiliar ambientes com grande volume de produtos e alto fluxo de sincronização.
Quando há muitos itens para sincronizar de uma só vez, pode ocorrer gargalo no processo, impactando o desempenho e gerando lentidão no sistema.

Para evitar isso, o campo permite definir um limite máximo de produtos que serão sincronizados por ciclo.

Exemplo: Se o valor configurado for 100, o sistema irá sincronizar 100 produtos por vez.
Caso existam mais itens pendentes, eles serão sincronizados nas próximas execuções, garantindo maior estabilidade no processo.

3 – Na aba “Pedido” faça as seguintes configurações:

Geral

Financeiro

Transação Financeira:

• Identificador: Informe o identificador.

• Descrição: Insira uma descrição.

• Entidade: Selecione a entidade.

• Meio de pagamento: Informe o meio de pagamento.

• Carteira digital: Informe a carteira digital.

• Condição de pagamento: Informe a condição de pagamento. (Este campo só é utilizado quando o campo "Entidade" for igual a "Próprio" ou "Outros").

• Tipo de documento financeiro: Selecione o tipo de documento fiscal.

• Condição de Pagamento:Se a condição de pagamento for sempre a mesma, você pode defini-la neste campo para evitar preenchimento manual em cada transação.A condição informada aqui será aplicada automaticamente em todas as movimentações financeiras vinculadas a entidades do tipo “Própria” ou “Outros”.

• Tipo de documento financeiro: Tipo de Documento Financeiro:
  Selecione o tipo de documento fiscal que será utilizado nas movimentações financeiras geradas pela integração.Se o tipo de documento for sempre o mesmo, você pode defini-lo neste campo para evitar o preenchimento manual em cada transação.

Transportadora

• Tipo de Frete:Selecione qual será o tipo de frete utilizado nas vendas realizadas através do e-commerce.

Contratação do Frete por conta do Emitente (CIF):
O frete é contratado e pago por quem está emitindo a nota fiscal (remetente). O custo do frete geralmente já está incluso no valor da mercadoria.

Contratação do Frete por conta do Destinatário (FOB):
O frete é de responsabilidade do destinatário. Ou seja, quem compra é quem paga e cuida do transporte.

Contratação do Frete por conta de Terceiros:
O frete é contratado por um terceiro, que não é nem o emitente nem o destinatário. Pode ser um intermediário ou outra empresa envolvida na operação.

Transporte Próprio por conta do Remetente:
O remetente realiza o transporte com veículos próprios ou contratados diretamente, sem envolver uma transportadora terceira.

Transporte Próprio por conta do Destinatário:
O destinatário é quem retira ou transporta a mercadoria com seus próprios meios.

Sem Ocorrência de Transporte:
Não há transporte a ser realizado. Usado, por exemplo, em operações onde o produto não se desloca fisicamente (como bonificações, brindes, transferências simbólicas, etc.).

• Transportadora: Caso o tipo de frete selecionado seja diferente de "Sem Ocorrência de Transporte", é necessário informar qual transportadora será responsável pela entrega.

Relacionamento de Transportadora

Permite relacionar transportadoras externas (do pedido de venda, e-commerce, marketplace, etc.) com as transportadoras cadastradas no sistema.
Esse vínculo garante que o pedido seja gerado automaticamente com a transportadora correta do seu sistema.

É possível lançar vários relacionamentos, conforme a necessidade.

Identificador: Selecione o identificador para esta regra de relacionamento.

Intermediadores/MarketPlaces

Intermediadores / Marketplaces

Para atender à legislação vigente, é necessário cadastrar a plataforma de e-commerce utilizada como intermediadora de pagamentos.

Siga o caminho abaixo para realizar o cadastro:

Cadastros → Outras → Notas Fiscais → Intermediadores/MarketPlaces

Em seguida:

1. Clique em [Incluir]

2. Selecione ou informe o parceiro correspondente ao seu e-commerce/marketplace

3. Preencha os dados solicitados conforme a plataforma intermediadora

4. Finalize o cadastro e grave as informações
   

Esse registro garante o correto tratamento fiscal das operações mediadas pelo e-commerce no momento da emissão da nota fiscal.

Configurar o produto para uso no E-commerce

1 No cadastro do produto, selecione o item que deseja configurar e clique em E-commerce.

E-commerce:
Informe o nome do e-commerce previamente cadastrado.

Código no e-commerce:
Caso o produto já esteja cadastrado na plataforma de e-commerce, informe o SKU correspondente para que ele seja vinculado ao produto no Uniplus.
Se for um produto novo, deixe esse campo em branco.

OK:

Clique em "OK" para confirmar a inclusão do e-commerce no item.

Após clicar em "OK", clique em "Configuração" para acessar a tela de configuração dos dados do anúncio do produto que será enviado ao e-commerce.

Na Aba geral vamos ter os campos abaixo. 

• Nome no e-commerce: Informe está opção para enviar o nome ao e-commerce;

• Descrição do produto no e-commerce: Informe a descrição que será exibida na página do produto no e-commerce. Essa descrição é visível para o cliente final

• Enviar Fixo/Estoque:
  Ao marcar essa opção, o sistema irá considerar um estoque fixo para o produto no e-commerce.
  Ou seja, não será considerado o estoque real com base nas movimentações do produto no Uniplus.
  O valor que será enviado ao e-commerce será sempre o informado no campo "Quantidade", de forma fixa.

Atenção: Use essa opção com cautela, principalmente se o controle de estoque for essencial para o seu negócio.

• Enviar Preço Fixo:
  Ao marcar essa opção, o sistema irá considerar um preço fixo para o produto no e-commerce.
  Ou seja, não será considerado o preço definido via precificação no Uniplus, mesmo que haja alterações futuras baseadas em movimentações ou políticas internas.

O valor enviado ao e-commerce será sempre o informado    diretamente no campo de preço fixo, ignorando qualquer atualização automática de preço.

Dica: Útil para manter um preço estável em marketplaces, independentemente da política interna de precificação.

Informações de características da grade/embalagem

• Descrição para linha:
  É a descrição que representa a Linha da grade do produto, ou seja, o atributo que fica na orientação horizontal da grade.

• Descrição para coluna:
  É a descrição que representa a Coluna da grade do produto, ou seja, o atributo que fica na orientação vertical da grade. 

Aba Categoria

Categoria Principal:
Informe a categoria principal do produto, que será usada para organizar o produto no e-commerce.

Categoria:
Caso o produto pertença a mais de uma categoria, informe as categorias adicionais no campo “Outras categorias”.

Imagem do Produto para o E-commerce

Para definir a imagem do produto que será exibida no e-commerce, siga os passos abaixo:

1. Acesse a aba Imagem no cadastro do produto

2. Selecione o Tipo como E-commerce

3. (Opcional) Preencha o campo de Descrição, se desejar identificar a imagem

4. Clique em [Arquivo] e selecione a imagem desejada

5. Confirme em [Ok]

6. Finalize clicando em [Gravar (F10)]

Após salvar, a imagem será utilizada na sincronização com o e-commerce e exibida no catálogo do produto.

Observação:

Tamanho Máximo da Imagem - Por padrão, o sistema aceita imagens de até 100 KB para cadastro. Caso seja necessário utilizar arquivos maiores, é possível ajustar esse limite manualmente no sistema. Caminho para configuração: Ferramentas > Preferências do Sistema > Tamanho máximo (em KB) de imagem para cadastros do sistema Após alterar o valor, salve as configurações para que a nova capacidade seja aplicada. Por padrão, o sistema aceita imagens de até 100 KB para cadastro. Caso seja necessário utilizar arquivos maiores, é possível ajustar esse limite manualmente no sistema.

Dimensões e Peso do Produto:

Cadastro de Medidas e Peso do Produto

No cadastro do produto, acesse a aba Avançado e, no grupo Características Físicas, informe os seguintes campos:

• Peso líquido

• Altura

• Largura

• Comprimento

Essas informações são essenciais para algumas integrações de e-commerce, pois podem ser utilizadas no cálculo automático do frete durante o processo de venda online.

Embalagem:

Configuração de Embalagens de Venda

No Uniplus, a unidade de venda padrão do produto é definida como Unidade.
Entretanto, é possível cadastrar diferentes opções de embalagem para facilitar a comercialização, como pacotes de 5 unidades, 10 unidades ou outros formatos.

Dessa forma, no momento da compra, o cliente poderá escolher a embalagem desejada.

Exemplo prático:
Configuração de uma embalagem de 5 Unidades para determinado produto.

• Embalagem: 5 Unidades
  

• Valor da venda: R$ 90,00

Assim, ao selecionar essa opção, o cliente estará comprando o conjunto de 5 unidades pelo valor configurado.

KIT

Trabalho com Produtos KITs – Integração Uniplus x Mercos

Na Mercos é possível comercializar produtos no formato de KITs.
Já no Uniplus, o cadastro do produto KIT (denominado PAI) não atua diretamente como produto, mas sim como um agrupador. Dessa forma, o produto PAI é cadastrado e os produtos/itens filhos são vinculados a ele dentro do KIT.

• Kit PAI: conjunto principal, com preço definido menor ou igual à soma dos itens que o compõem.

• Produtos/Itens Filhos: itens que compõem o Kit PAI.

Para mais detalhes de configuração, consulte: Kits de Produtos – Intelidata

Integração com o E-commerce Mercos

• Se o produto já existir na plataforma, você deve atrelar o produto PAI ao produto correspondente no e-commerce.

• Caso o produto ainda não esteja cadastrado na plataforma, o cadastro deve ser feito utilizando o produto PAI.

Estoque e Cálculo Automático

O sistema realiza automaticamente o cálculo de estoque dos KITs:

1. Verifica os produtos filhos e as quantidades definidas para o KIT.

2. Calcula quantos KITs podem ser montados com o saldo atual dos produtos filhos.

3. Envia essa informação para o e-commerce Mercos.

Grade

Grade de Produtos – Integração com a Mercos

A Mercos possuía inicialmente duas formas de trabalhar com grade, porém a forma antiga foi descontinuada.
Atualmente, a plataforma opera exclusivamente com a grade nova.

Configuração da Grade no Uniplus

Para que a integração com a Mercos funcione corretamente, a grade deve estar configurada no Uniplus da seguinte forma:

• Linha: Cores

• Coluna: Tamanhos

Essa estrutura garante que as variações de produtos sejam corretamente identificadas e enviadas para a Mercos.

Importante sobre a configuração da Grade

A configuração inversa da grade (tamanho na linha e cor na coluna) pode gerar falhas na integração com o Mercado Livre, impedindo a publicação correta dos anúncios com variações.

Vinculação do Produto Grade no Uniplus com a Plataforma

Na aba Código de Barras do cadastro do produto, é obrigatório:

• Cadastrar um código de barras para cada variação.

• Garantir que esse código de barras esteja configurado como o SKU da variação do produto correspondente na plataforma.

E se a grade já estiver configurada incorretamente?

• Sem movimentações (estoque, vendas, etc.):
  Basta ajustar a configuração da grade atual para o formato correto (cores na linha e tamanhos na coluna).

• Com movimentações:

  1. Cadastrar um novo produto.

  2. Associar a grade corretamente (cores na linha e tamanhos na coluna).

Promoção

Processo de Integração de Promoções com o E-commerce e Mercos

O módulo de e-commerce trabalha com promoções configuradas diretamente no sistema. Para que uma promoção seja aplicada corretamente na Mercos, siga o fluxo abaixo:

1. Criação da promoção

   • Cadastre a promoção no sistema, configurando os itens e condições conforme necessidade.

2. Sincronização dos produtos

   • Ao realizar a sincronização, o sistema identifica automaticamente que os produtos estão vinculados a uma promoção ativa.

3. Envio da promoção para a Mercos

   • Durante a sincronização, a promoção é reconhecida e transmitida para a Mercos junto com os produtos, garantindo que os valores promocionais sejam refletidos na plataforma.

4. Vinculação da promoção

   • Na tela de promoções no retaguarda, a promoção aparecerá vinculada ao e-commerce, evidenciando o relacionamento entre a campanha criada e a integração.

Exemplo de como fica a promoção no e-commerce

Sincronização Produtos

Formas de Sincronização de Pedidos

A sincronização de pedidos pode ser realizada de quatro maneiras: três opções manuais e uma automática. Cada método está detalhado abaixo, com sua respectiva localização no sistema.

 Sincronização Manual

Você pode acionar a sincronização manualmente pelos seguintes caminhos:

1. Via Cadastro de Produtos

Menu: Cadastros > Produtos > Mais opções > Sincronizar com E-commerce
Utilizado quando você está realizando ajustes diretamente no cadastro de produtos.

2. Via Menu Principal do E-commerce

Menu: E-commerce > Sincronizar Produtos
Recomendado quando deseja forçar uma sincronização geral dos itens.

3. Via Configurações do E-commerce

Menu: E-commerce > Configurações > selecionar o e-commerce configurado > Sincronizar pedidos
Opção utilizada para sincronizar pedidos especificamente a partir da configuração da integração.

 Sincronização Automática

4. Sincronização via tarefa agendada no YODA
A sincronização é realizada automaticamente em horários programados pela tarefa configurada no YODA, garantindo atualização periódica sem intervenção manual.

Caso algum produto não sincronize, você pode verificar isso no relatório de Inconsistências de Produtos.

O caminho é: Menu E-commerce > Configurações > selecione o e-commerce > Inconsistências.

Sincronização Pedidos

Formas de Sincronização de Pedidos

A sincronização de pedidos pode ser realizada de quatro formas: três manuais e uma automática.
Diferente da sincronização de produtos, não existe opção de sincronizar pedidos dentro do cadastro de produtos.

Sincronização Manual

As opções manuais estão disponíveis nos menus do módulo de e-commerce e na tela de pedidos:

1. Via Menu Principal do E-commerce

Menu: E-commerce > Sincronizar Pedidos
Utilizado para buscar pedidos realizados no e-commerce e importar para o sistema.

2. Via Configurações do E-commerce

Menu: E-commerce > Configurações > selecionar o e-commerce configurado > Sincronizar pedidos
Indicado para sincronizar pedidos diretamente pelo ambiente de configuração da integração.

3. Via Tela de Pedidos

Menu: Vendas > Pedido de Faturamento > Outras opções > Sincronizar Pedidos E-commerce
Permite sincronizar pedidos diretamente pela tela de faturamento, facilitando o fluxo operacional.

Sincronização Automática

4. Tarefa agendada no YODA
A sincronização também ocorre automaticamente de acordo com a tarefa configurada no YODA, garantindo atualização periódica sem ação manual.

Status dos Pedidos do E-commerce

Após a importação, cada pedido passa por etapas que podem ser acompanhadas pelos campos:

• Status do pedido (no Uniplus)

• Status do pedido no e-commerce (na plataforma)

A tabela abaixo descreve o comportamento de cada etapa do processo:

Faturamento de Pedidos Recebidos do e-commerce

Após a sincronização dos pedidos do e-commerce com o sistema, o faturamento é realizado diretamente pela tela de pedidos.

Para faturar:

1. Localize o pedido recebido do e-commerce

2. Selecione o pedido desejado

3. Acesse Outras opções → Faturar pedido de e-commerce
   

Saiba mais

• Veja as respostas para perguntas comuns sobre integrações.

_