Mercos

O que é ? 

Mercos é uma aplicação de força de vendas, comercializada e implantada pela Unidade da Ema  de São João da Boa Vista. Essa aplicação visa auxiliar nas vendas através de vendas externas. (Exemplo: WMW).

Informações iniciais

Dicas do Cliente

• Quando cadastra o cliente no Mercos e envia o primeiro pedido, este é importado para o ERP. O responsável, deve conferir o cadastro do cliente, principalmente as informações que impactam em tributos (cidade/uf, enquadramento) antes de conferir o  pedido enviado.
• Quando fazem alterações importantes de cadastros, é recomendado que façam a integração manualmente (clicando no botão da integração no painel do integrador).
• Parâmetros do integrador devem ser alterados apenas pela equipe da Comptask. Os parâmetros são definidos com o cliente no início da implantação do integrador e qualquer alteração de parâmetro deve ser muito cuidadosa, pois pode demandar nova integração geral dos cadastros impactados.
• A série do pedido será a que ficou estabelecida na configuração da transação de pedido
• O tipo de frete gravado no pedido será o que ficou estabelecido na configuração de
  transação de pedido

Mercos

Deve-se cadastrar os vendedores antes de qualquer sincronização (o vínculo dos vendedores do Mercos com o ERP é realizado  pelo e-mail do colaborador, portanto devem ser exatamente os mesmos cadastrados nos vendedores do ERP e no Mercos). Após o
cadastro das informações corretamente, basta clicar no botão “Vendedores” do painel do Integrador.

• Cadastros inativados não serão enviados ao Mercos.
• Grupos no Mercos tem no máximo 3 níveis (pai +2 subgrupos).
• Quantidade de saldo em estoque é enviado o valor disponível (Saldo - Reservado), caso o cliente não queira trabalhar com saldo reservado, deve desmarcar a reserva de estoque nas transações do sistema (integrador acompanha a regra de negócio do ERP).
• Se existir CNPJs duplicados de clientes e houver interesse em importá-los ao mercos, desmarcar o parâmetro “Bloquear o cadastro de mais de um cliente com o mesmo CPF /CNPJ” no Mercos.
• A retirada de itens da tabela de preço no ERP, não faz com o que seja retirado no Mercos, ou seja, um item que for retirado de uma tabela de preços, vai continuar no Mercos.
  •  Deve-se zerar o preço do item na tabela no ERP e fazer a sincronização para zerar o item da tabela de preços do Mercos e somente depois disso, excluir o item da tabela de preços do ERP.
•  É possível solicitar ao consultor Mercos para bloquear a opção de realizar novos cadastros (é possível cadastrar clientes) / edições / exclusões diretamente pelo site. A imagem abaixo exibe as permissões que podem ser bloqueadas no Mercos.

ERP

• O cálculo de IPI do Mercos é igual ao do ERP quando marcado parâmetro de IPI nos parâmetros gerais contábeis: Parâmetros Gerais -> Contábeis -> Impostos -> Abater desconto na base de cálculo de IPI.
• Usuários devem marcar o checkbox “Exporta para Web” de quais cadastros serão integrados (Itens, Métodos de pagamento, Condições de pagamento, Grupos etc.).

Integrador

• Endereço do Painel do Integrador: 127.0.0.1:8080/report (para acesso do servidor)
• O cliente do integrador deve manter backup do banco de dados do integrador. 
• Não é recomendado parar o serviço do integrador quando estiver realizando alguma
  integração

Parâmetros, seus significados e possíveis configurações

• ema.filialDefault: 1 = filial que integra histórico de pedidos.

Métodos e condições

• ema.ignoreIntegrationPaymentMethod
  • TRUE - seleciona o método de pagamento a partir do cadastro do Cliente no ERP.
  • FALSE - seleciona o método de pagamento escolhido no Mercos.
• ema.defaultPaymentMethodId.
  • Define o método padrão de pagamento.
    • Colocar o ID do método.
• ema.ignoreIntegrationPaymentCondition
  • TRUE: ignora e substitui a condição enviada pelo Mercos (seleciona condição do ERP)
  • FALSE: trás a condição selecionada no mercos
• ema.defaultPaymentConditionId
  • Define condição de pagamento padrão (clientes cadastrados no ERP)
• ema.limitPaymentConditionsByCliente
  • TRUE - utiliza a condição de pagamento que está no cadastro do cliente.
  • FALSE - disponibiliza todas as condições de pagamentos disponíveis.

Vendedores e Transportadora

• ema.ignoreIntegrationSeller (Apenas em casos de B2B)
  • TRUE - seleciona o vendedor que está no cadastro do Cliente no ERP.
  • FALSE - seleciona o vendedor do Mercos.
•  ema.ignoreIntegrationShippingCompany
  • OBS: atualmente não integramos transportadoras, manter TRUE a menos que passemos a integrar
  •  TRUE - utiliza a transportadora do ERP
  •  FALSE - ignora a transportadora escolhida no Mercos.

Tabelas de preços

• ema.ignoreClientsWithoutPriceTable
  • TRUE: Não envia clientes da tabela 0, APENAS as tabelas selecionadas
  • FALSE: Envia os clientes da tabela 0 mais os das tabelas selecionadas
• Ema.allowAllPriceTables
  • Liberar ou não tabelas de vendas para os seus vendedores
    • TRUE - não haverá restrição na escolhas das tabelas
    • FALSE - o vendedor só poderá escolher a tabela do cliente.
• ema.syncPriceTableIds
  • informa quais das tabelas de preço devem ser sincronizadas com o Mercos. Ex: ema.syncPriceTableIds= 1,2,149

Produtos e Estoque

• Ema.inactivateOutOfStock
  • TRUE - Inativa produtos sem estoque, não envia produtos com estoque zerado/negativado para o estoque.
  • FALSE - envia os produtos mesmo com estoque zerado/negativado para o Mercos.
•  ema.onlyStockFromDepositId
  • se “= ” (vazio) todos os depósitos da filial serão selecionados
  • se colocar um número maior que 0 será selecionado o depósito com esse número

OBS: Apenas um depósito pode ser selecionado

• Ema.onlyItemsMarkedAsExport
  • TRUE - Envia somente os itens com o parâmetro marcado “exporta para terceiros”.
  • FALSE - Envia todos os itens para o Mercos, incluindo os que não estão marcados para
    serem exportados.

 OBS: Para clientes que utilizam histórico de pedidos deve-se deixar esse parâmetro ativado.

• ema.referenceStrategy
• Define qual campo será enviado como código descritivo do produto
  • 1 - Código Interno
  • 2 - Referência
• Ema.descriptionStrategy
  • Qual campo vai será enviado para o Mercos como descrição(nome) do produto:
    • 1 - Descrição .
    • 2 - Complemento.

Pedidos

• Ema.addExtraFieldsToObs
  • TRUE - Concatena todos os campos extras do pedido (Mercos) nas observações do pedido (ERP).
  • FALSE - Não concatena os campos extras.
• ema.orderTransactionId
  • Id da transação padrão do Pedido de Vendas

AVISO: Recomendado não usar transações utilizadas para pedidos internos no ERP.

• Ema.orderTypeTransactionIdMap
  • Usado para igualar os códigos de transações entre os dois sistemas, para vender com a mesma transação  conforme padrão TIPOPEDIDOMERCOS : IDPEDIDOERP. EX: numeroMercos:idTransação, 12154:'24', 13134 : '12'
• Ema.priceAlterationToDiscount
  • TRUE, o valor da venda será registrado com desconto, EX: item custa R$10, foi vendido por R$8, essa venda será registrada como uma venda de um item de R$10 com 20% de desconto.
  • FALSE, apenas o valor da venda será registrado, EX: o item custa R$10, foi vendido por R$8, essa venda será registrada como uma venda de um item de R$8.
  • Ema.idPedidoStrategy
    • Todo os pedidos feitos no Mercos vão para a tabela PALMTOP_PEDIDO no campo IDPEDIDOPDA
      • 1 - idpedidopda = idpedidoimportacao.
      • 2 - idpedido é ao número do pedido no Mercos.

Clientes

• ema.filialIds
  • Id das filiais que serão integradas para financeiro.
    •  separar com vírgulas. Ex: 1,3,4
  • Ema.syncClientsTaxTypeIds
    • Seleciona o(s) enquadramento(s) do(s) cliente(s) que devem ser importados para o Mercos, EX: 1,3,7 (id do sistema).
• ema.syncClientsUfs = SC
  • Estados nos quais os clientes devem ser sincronizados, UF's separados por vírgula, EX:1,2,3

OBS.: Deixar vazio caso queira sincronizar todos

Impostos

• ema.stTaxTypeIds
  • Define quais dos enquadramentos (de cliente) selecionados tem ST, ids devem ser separados por vírgulas EX:2,7
• ema.taxIdAsNcm
  • (Seleciona de onde a configuração dos impostos vem)
  • Sistema EMA trabalha com vários impostos, colocando como TRUE esse parâmetro ele coloca o imposto no IPI do Mercos, já que o Mercos não trabalha com os impostos de forma separada.
• ema.filialUF
  • selecionar que UF's irão usar as duas alíquotas como intraestadual. Ex: SP,SE,PR
• ema.applyInternalIcmsStCreditDiscount
  • TRUE: desconta crédito do cálculo de ICMS-ST na filial
  • FALSE: não desconta crédito do cálculo de ICMS-ST na filial
• ema.internalIcmsStCreditDiscountPercent
  • Indica porcentagem de desconto
• ema.ignoreInternalIcmsStCreditDiscountInTaxIds
  • os impostos que forem incluídos nesse campo não serão considerados no cálculo do desconto de ICMS-ST

Configurações de IPI

• ema.getIpiFromTax
  • TRUE, utiliza as configurações do IPI de impostos
    •  ipiTaxTypeId, deve-se selecionar um dos enquadramentos, previamente selecionados que tenha ST.
      • estado, de qual estado o IPI deverá ser selecionado
    • FALSE, não utiliza as configurações do IPI de impostos
• ema.ipiTaxTypeId = 2
  • determina o enquadramento do IPI (usar um enquadramento dentre os listados para ICMS-ST)
• ema.ipiTaxState = SC
  • determina o estado dos quais pegar o IPI

Configuração de cadastro de cliente padrão, do Mercos para o ERP por venda

• ema.condicaoPagamentoDefault
  • informa a condição de pagamento padrão para o novo cliente cadastrado
• ema.metodoPgtoDefault
  • informa método de pagamento padrão para o novo cliente cadastrado
• ema.idfilialCliente
  •  informa qual a padrão filial em que os clientes serão cadastrados
• ema.separaClientePorFilial
  • TRUE - separa dos clientes por filialFALSE - não separa os clientes por filial Conta Contábil
• ema.createClientAccount
  • TRUE: cria conta contábil
  • FALSE: não cria conta contábil
• ema.clientAccountPrefix
  • Classificação para criação da conta contábil (o último componente, após o prefixo, será incrementado a partir do último registro encontrado)EX: ema.clientAccountPrefix = 1.1.03.01.

ERROS COMUNS

Produtos

• PRECONDITION FAILED: {“mensagem”:”Dados inválidos”,”erros”:”Já existe em uma configuração de ICMS-ST cadastrada com NCM = \”38\”, exceção fiscal = \”2\” e estado=\”PB\””}]}
  • Já existe um cadastro do NCM 38, exceção fiscal 2 e UF PB no Mercos e o integrador está tentando enviar novamente (provavelmente por alguma interrupção na integração ou erro de retorno do Mercos sobre o cadastro.
• NCM = idimposto
  • Como Resolver:
    • Confira bem com o erro os dados abaixo, antes de excluir

• • • Ir na tela acima, pesquisar o NCM do erro Ex: 38
    • ir na classificação fiscal do erro Ex: 2
    • Do estado Ex: PB
    • Clicar no lápis e excluir e Reprocessar o erro no painel do integrador

Grupos

• Não é possível inativar um grupo que possua produtos vinculados.
  • O integrador vai enviar mesmo os grupos inativos.
    • caso esteja marcado como “exportar”.
    • Como Resolver:
      • Verificar o grupo de itens e itens desse grupo está inativo.
        • Caso esteja.
          • Ir no banco de dados EMA, e tirar o grupo do item.
          • Ir no banco de dados.
• GRUPO_DE_PARA
  • Ir no grupo que deu o erro, pegar pelo ID que está no erro.
  • Campo “invativo” colocar 0

Cliente

• • PRECONDITION FAILED: {"mensagem": "Dados inválidos", "erros": [{"campo": "cep","mensagem": "Este campo requer 8 dígitos"}, {"campo": "estado", "mensagem": "Faça uma escolha válida. EX não é uma das escolhas disponíveis."}]} (Mercos não aceita o EX (venda para o exterior))
  • PRECONDITION FAILED: {"mensagem": "Dados inválidos", "erros": [{"campo": "cep", "mensagem": "Este campo requer 8 dígitos"}]} (O cep está errado).
    • Conversar com o cliente para verificar e validar o cep.
    • Mostrar o campo ID para o cliente facilitando a busca por cliente que está com erro.
• SYNC GENERAL ERROR: I/O error on POST request for "https://sandbox.mercos.com/api/v1/clientes/": Read timed out; nested exception is java.net.SocketTimeoutException: Read timed out
  • Apenas reprocessar, provavelmente deu algum erro de conexão no momento da integração.
• PRECONDITION FAILED: {"mensagem": "Dados inválidos", "erros": [{"campo": "cnpj", "mensagem": "Este CNPJ já está cadastrado no sistema."}]}
  • O CNPJ já foi cadastrado no sistema.
  • Resolução:

• PRECONDITION FAILED: {"mensagem": "Dados inválidos", "erros": [{"campo":"emails.email", "mensagem": "Informe um endereço de email válido."}]}
  • email invalido, pedir para cliente corrigir informações erradas no cadastro
• SYNC GENERAL ERROR: null
  • alguma informação importante presente no cadastro do cliente ou no mercos pode ocorrer em tabela de preço, vendedor, condição pagt e método pagt padrão. EX: a tabela de preço cadastrada no cliente não foi sincronizada com o mercos

Títulos

• PRECONDITION FAILED: {"mensagem": "Dados inválidos", "erros": [{"campo":"numero_documento", "mensagem": "Este cliente já possui um título vencido com este número de documento."}]}
  • número do documento está igual
    • resolução
      • basta alterar o número do documento
      • EX: número anterior: documento divida/ 01, adequação do número 01 - documento divida/ 01
      • OBS: existe um limite de 13 caracteres no mercos, deve-se colocar a numeração de identificação no início

Erros SQL

• SYNC GENERAL ERROR: StatementCallBack;bad SQL grammar [INSER INTO nome da tabela(informações da tabela)]
  • para a resolução deste tipo de erro recomenda-se pegar todo o SQL do log para analisá-lo e localizar seu problema para que possa ser resolvido
  • em sua maioria o erro surge devido a um apóstrofe, mas pode ocorrer por outros motivos

“Erro” de unidade no app do mercos

• caso o cliente esteja com a configuração de “fraciona na venda” para sua unidade de medida o app do Mercos terá um comportamento diferente, adicionando 0,01 ao em vez de 1 ao clicar no “+”

• para solucionar esse comportamento basta desmarcar a opção fraciona na venda no “ERP estoque > Unidades de medidas > selecione a unidade utilizada > desmarcar fraciona na venda”

Importando informações do Mercos

• pedidos importados
• Onde estão os pedidos importados?
  • pedidos importados de terceiros estarão localizados em: vendas > extensões > pedidos importados.
  • na tela de pedidos importados, ao clicar na opção gerar pedidos estes serão transferidos para a tela de pedidos do ERP OBS: em alguns casos esse processo é automatizado
• importação de cliente
  • no cadastro do cliente, a Exceção Fiscal é o enquadramento do cliente no ERP
  • Na área de contato, apenas nome e telefone podem ser cadastrados (cadastrado no campo “nome contato” na aba adicionais no ERP)
  • o campo cidade pode não ser preenchido corretamente pela importação, nesse caso a cidade aparecerá no campo observação da aba adicionais do cadastro dos clientes