Integração Sites

Integração Office Web:

• Via FTP
• Arquivo XML

Exporta:

• Produtos > Imagens

Importa:

• Pedidos > parcelas (somente no pedido)
• Clientes

___________________________________________________________________________________________________________________________________________

Integração Dooca:

• Via SFTP
• Arquivo JSON

Exporta:

• Atualiza o Estoque dos Produtos (necessário vincular o código do e-commerce no nosso código e-commerce manualmente)

Importa:

• Pedidos > Clientes

___________________________________________________________________________________________________________________________________________

Integração Dooca2:

• Via API
• Arquivo JSON

Exporta (opcionais):

• Produtos (campos opcionais):
  1. Nome
  2. Preço (opção para tabela de preços)
  3. Descrição
  4. Descrição Curta
  5. Quantidade Mínima
  6. Peso
  7. Profundidade
  8. Largura
  9. Altura
  10. Inativo
  11. Grades (somente Inserção):
      1. Cor
      2. Tamanho
      3. Código de Barras

• Estoque
• Cores (somente Inserção)
• Tamanhos (somente Inserção)
• Notas Fiscais (venda)

Importa (opcionais):

• Pedidos (insere o Pedido e depois somente altera os Status e Pagamentos):
  1. Status
  2. Status Financeiro
  3. Cliente
  4. Nome Cliente
  5. Data
  6. Hora
  7. Valor Total
  8. Valor Frete
  9. Data Entrega
  10. Observação: contém nome de Pagamento, nro de Parcelas e o valor de cada
  11. Produtos:
      1. Quantidade
      2. Valor Unitário
      3. Valor de Desconto
      4. Valor Total
      5. Grades
  12. Parcelas:
      1. Data + 30 dias subsequentemente
      2. Valor (valor total do Pedido / nro de parcelas)

• • Clientes:
    1. Nome
    2. CPF
    3. CNPJ
    4. Data de Nascimento
    5. Inscrição Estadual
    6. Telefone
    7. Data ficha
    8. Email
    9. Endereço:
       1. Endereço
       2. Número
       3. Bairro
       4. Complemento
       5. CEP
       6. Estado
       7. Cidade

• Cores (somente Inserção)
• Tamanhos (somente Inserção)

___________________________________________________________________________________________________________________________________________

Integração EBranvo:

• Via API
• Arquivo JSON

Exporta:

• Produtos (ao atualizar envia somente o Estoque e Preço)
• Marcas (somente inserção)
• Grupos e Subgrupos (somente inserção).

Importa:

• Pedidos > Clientes (> endereços)

___________________________________________________________________________________________________________________________________________

Integração EcomDC:

• Via API
• Arquivo JSON

Exporta:

• Produtos (ao atualizar envia somente Preço de Venda/Custo e Estoque)
  1. Nome (Cadastro ou Descrição do e-commerce)
  2. Código Interno
  3. Descrição (Referencia técnica ou Nome)
  4. Grupo
  5. Subgrupo
  6. Marca
  7. Profundidade (É enviado como comprimento)
  8. Largura
  9. Altura
  10. Peso (Bruto)
  11. Cubagem
  12. Garantia
  13. Modelo
  14. Código de Barras
  15. Estoque (uma única loja)
  16. Preço de venda
  17. Preço de custo (Preço de custo ou Preço de custo 2)

Importa:

• Pedidos > Clientes

___________________________________________________________________________________________________________________________________________

Integração EMacro:

• Via API
• Arquivo JSON

Exporta:

• Tamanhos = variações
• Grupos e Subgrupos
• Produtos > Grades = variações do Produto
• Imagens dos Produtos

Importa:

• Pedidos (os itens possuem grades (variações))
• Clientes > Endereços

___________________________________________________________________________________________________________________________________________

Integração Gluk:

• Via API
• Arquivo JSON

Exporta:

• Produtos

Importa:

• Pedidos > Clientes (> endereços)

___________________________________________________________________________________________________________________________________________

Integração Magento:

• Via API
• Arquivo JSON

Exporta (inseri e atualiza):

• Produtos:
  1. Nome (dados ecommerce)
  2. Preço
  3. Código interno
  4. Inativo
  5. Peso bruto
  6. Saldo estoque (opcional)
  7. Referência técnica
  8. Nome
  9. Opção de marketplace
  10. Código de barras
  11. Voltagem
  12. Profundidade
  13. Altura
  14. Largura
  15. Atraso expedição
  16. Grupo e subgrupo (importa todas categorias do ecommerce para então verificar se o nome é igual e utilizar o código)
  17. Imagens

Importa:

• Pedidos:
  1. Cliente
  2. Nome cliente
  3. Data
  4. Hora
  5. Status
  6. Status financeiro
  7. Frete
  8. Tipo frete
  9. Valor total
  10. Observação: informações de pagamento
  11. Itens:
      1. Quantidade
      2. Valor unitário
      3. Valor frete
      4. Percentual de desconto
      5. Valor de desconto
      6. Valor total

• • Clientes:
    1. Nome
    2. CPF
    3. CNPJ
    4. Data de Nascimento
    5. Inscrição Estadual
    6. Telefone
    7. Data ficha
    8. Email
    9. Endereço principal e múltiplos endereços:
       1. Endereço
       2. Número
       3. Bairro
       4. Complemento
       5. CEP
       6. Estado
       7. Cidade

___________________________________________________________________________________________________________________________________________

Integração Mercado Livre:

• Via API
• Arquivo JSON

Exporta:

• Anúncios (tela específica criada no MasterKey) > Produtos (> imagens)

Importa:

• Pedidos > Clientes / Contas a Receber
• Categorias Mercado Livre (tabela específica criada no MasterKey)

___________________________________________________________________________________________________________________________________________

Integração Tray:

• Via API
• Arquivo JSON

Exporta:

• Categorias eCommerce
• Produtos opção de seleção em separado do que Incluiu ou Atualiza
  1. Código de Barras
  2. Nome
  3. Código Interno
  4. Altura
  5. Largura
  6. Comprimento
  7. Data lançamento
  8. Disponivel
  9. Estoque (uma ou mais lojas)
  10. Preço Promocional
  11. Inicio/fim promoção
  12. Marca
  13. modelo
  14. Observação
  15. Opções de Pagamento
  16. Peso Bruto
  17. Preço de Custo
  18. Preço de Venda (Cadastro ou Tabela)

• Variações (Produtos similares no master key)
  1. Código Interno
  2. Produto Pai
  3. Tipo
  4. Variação
  5. Altura
  6. Lagura
  7. Comprimento
  8. Preço de Venda
  9. Preço Promocional
  10. Inicio/Fim promoção
  11. Peso Bruto

• Dados do Faturamento
  1. Nro da Nota
  2. Data Emissão Nf
  3. Chave Nfe

Importa:

• Cliente
• Pedidos

___________________________________________________________________________________________________________________________________________

Integração Magazord:

• Via API
• Arquivo JSON

Obs: Não tem como fazer para não enviar o tamanho "Único", da problema no envio de imagens

Exporta:

• Categorias Ecommerce

• Marcas

• Derivações (Grades - Tamanho e Cor)

• Imagens

• Produtos (Incluiu e Atualiza)
  1. Nome (Dos dados Ecommerce se tiver caso contrario do Produto)
  2. Cód.Barra
  3. Peso
  4. Altura (Dados Ecommerce)
  5. Largura (Dados Ecommerce)
  6. Profundidade (Dados Ecommerce)
  7. Modelo (Dados Ecommerce)
  8. Garantia (Envia fixo o id 1)
  9. NCM
  10. CEST
  11. Unidade
  12. Categoria Ecommerce (Dados Ecommerce)
  13. Acompanha (É o campo Observação do cadastro do produto do Master Key)
  14. Imagens

• Derivações (Grades no master key)
  1. Nome/Identificação
  2. Cod.Barra

• Preços (opção de selecionar a tabela)

• Estoque (opção de selecionar a loja)
  1. produto e grade

Importa:

• Cliente
• Pedidos

Possíveis erros

(NFe) Nota não encontrada:

Este erro acontece pois o integrador não consegue encontrar a nota dentro do banco do MASTER-NFE para enviar. Acontece geralmente quando o cliente tem sincroniza, pois fazem notas em outros "servidores" e acaba não conseguindo sincronizar. Se o cliente não quer a nota no site, basta rodar este comando para ignorar a sincronização desta nota:

DELETE FROM campos c
WHERE c.cp_tabela = 'PedidoVenda'
AND c.cp_idinterno = :codigo_do_pedido

Para pegar o código do pedido, basta ir no integrador, dar dois cliques no erro e pegar o código.
___________________________________________________________________________________________________________________________________________

Integração Site Mercado:

• Via API

Observações:

• É necessário no mínimo 200 produtos cadastrados para ter uma carga completa de dados
• Produtos devem ter no mínimo Status e Nome Ecommerce.

Primeiros passos:

• Cliente entrar em contato com o SiteMercado informando ter o sistema da Officesystem que já foi feito a homologação via API e deseja utiliza-lo;
• Solicitar ClienID e Client Secret;
• Enviado a primeira carga de dados pelo nosso sistema;
• Entrar em contato novamente com SiteMercado e solicitar o Link de testes;
• Utilizar o Link fazendo a verificação se esta tudo funcionando corretamente;
• Solicitar liberação do modo produção;

Exporta:

• Produtos opção de seleção em separado do que Incluiu ou Atualiza
  1. Código de Barras
  2. Nome
  3. Código Interno
  4. Altura
  5. Largura
  6. Comprimento
  7. Data lançamento
  8. Disponível
  9. Estoque (uma ou mais lojas)
  10. Preço Promocional
  11. Inicio/fim promoção
  12. Marca
  13. modelo
  14. Observação
  15. Opções de Pagamento
  16. Peso Bruto
  17. Preço de Custo
  18. Preço de Venda (Cadastro ou Tabela)

Importa:

• Cliente
• Pedidos

___________________________________________________________________________________________________________________________________________

Integração VTEX

• Via API

___________________________________________________________________________________________________________________________________________

Integração Loja Integrada

Observações:

• O integrador apenas envia imagens dos produtos. Ele não remove e nem altera a ordenação das imagens. É necessário realizar manualmente pelo site.
• Não é possível alterar se o produto é lançamento ou não. Isso é realizado automaticamente pela LojaIntegrada.

Enviar similares (na Loja Integrada fica como grade/variação):

• Depois que um produto for enviado sem similar, não é possível atualizar e enviar com similar pro site. É necessario excluir o mesmo da Loja Integrada e reenviar com o similar já cadastrado.
• O produto "pai" que vai ter os similares no MKey, não vai mais ser possível vender na Loja Integrada, apenas os similares

• Depois de cadastrado um produto similar, não é possível alterar e nem excluir a variação. Pelo site da Loja Integrada é possível alterar e excluir.
• Os produtos similares não aceitam imagens, então foi atualizado para enviar para o produto pai as imagens do produto filho.
• Na LI as variações ficam dentro do cadastro de grades, em uma grade chamada "Variações".
• Ao cadastrar um similiar no Mkey, NÃO adicionar o produto "pai" como similar do "filho" ou de outro produto.

Exemplo de cadastro de similares no MKey:

• Saco Golden Carne (Pai)
  • Saco Golden Carne 15 kg (Similar)
  • Saco Golden Carne 20kg (Similar)

Erros e Soluções:

Erro: {"error": {"produto": {"grades": ["Grades só podem ser enviadas caso o tipo do produto seja atributo"]}}, "error_message": "Um ou mais campos não são válidos."}

Acontece quando é adicionado um produto similar em um produto que já foi enviado para a Loja Integrada

Solução: Para resolver tem que excluir os PRODUTOS e as GRADES (Similares) da LI, executar o relatório configurado com os códigos dos produtos no MK4 e reenviar para a LI com os similares já informados.

Caso queira executar pelo Ibexpert, pode executar os seguintes comandos, informando os códigos dos produtos:

• DELETE FROM campos c WHERE c.cp_integracao = 'IntegraLojaIntegrada' AND c.cp_idinterno IN (código dos produtos aqui)
• DELETE FROM campos c WHERE c.cp_integracao = 'IntegraLojaIntegrada' AND c.cp_idinterno IN (SELECT p.pr_nome FROM produtos p WHERE p.pr_codigo IN (código dos produtos aqui))

• UPDATE prodecom p SET p.ec_hratlz = current_time WHERE p.ec_produto in (código dos produtos aqui)
• UPDATE produtos pr SET pr.pr_hratlz = current_time WHERE pr.pr_codigo in (código dos produtos aqui)

Exporta:

• Produtos
  1. Código Interno
  2. Nome
  3. Descrição Completa
  4. Ativo
  5. Destaque
  6. NCM
  7. Peso
  8. Altura
  9. Largura
  10. Profundidade
  11. Marca
  12. GTIN
  13. Categoria
  14. Imagens
  15. Similares (Ler observações)

• Preços
  1. Preço de venda
  2. Preço de custo
  3. Preço promocional

• Marcas
  1. Nome
  2. Apelido
  3. Descrição
  4. Ativo
• Categorias
  1. Nome
  2. Descrição
  3. Categoria Pai
• Estoque
  1. Quantidade em estoques

Importa:

• Cliente
• Pedidos

___________________________________________________________________________________________________________________________________________

Integração MK Shops

___________________________________________________________________________________________________________________________________________

Integração Shopify

• Via API

Observações:

• O status do pedido só é atualizado se for cancelado no MKey e se o mesmo não estiver com status de pago na Shopify
• Ao gerar NF dos pedidos, os mesmos tem que ter seu status atualizado na shopify
• Shopify não aceita envio de NF
• Cada grade aceita apenas uma imagem de "capa", mas as outras também são cadastradas no produto

Exporta:

• Produtos
  1. Nome
  2. Descrição Completa
  3. Ativo
  4. Peso
  5. Altura
  6. Categoria
  7. Imagens
  8. Grades

• Preços
  1. Preço de venda
• Estoque
  1. Quantidade em estoque

Importa:

• Cliente
• Pedidos

Configurações:

URL: https://{usuario}.myshopify.com/admin/api

Substituir {usuario} pelo usuario do cliente na Shopify. Pode ser obtido pelo link de acesso da plataforma admin (é o que vem depois de "store/")

Obs: geralmente não é o mesmo do url de dominio da loja.

Token:

Passo a passo para gerar o token da Shopify:

Acessar "Configurações da Shopify" -> "Apps e canais de venda" -> "Desenvolver apps"

Informar o nome da Integração. Pode ser qualquer coisa

Na aba "Configuração" é necessário configurar a integração. Em "Escopos de acesso à API Admin" pode marcar tudo e em "Assinaturas do webhook" selecionar "2024-04"

Instalar o app para gerar o token

Pronto, só copiar o token e inserir no integrador. Só é possível visualizar uma vez o token, se ele se perder é necessário realizar o passo a passo novamente

___________________________________________________________________________________________________________________________________________

Integração Mercos

(Manual em Desenvolvimento) Normalmente usado em substituição ao MK Mobile. Porem pode ser usado também para integração com Sites. Precisa de Categorias eCommerce e envia os que estiverem disponiveis nos Dados eCommerce.

• Via API

Exporta:

• Produtos
  1. Nome
  2. Descrição Completa
  3. Ativo
  4. Peso
  5. Altura
  6. Categoria eCommerce
  7. Imagens

• Preços
  1. Preço de venda
  2. Tabelas de Preço
• Estoque
  1. Quantidade em estoque

Importa:

• Cliente
• Pedidos

___________________________________________________________________________________________________________________________________________

Integração NuvemShop:

• Via API
• Arquivo JSON

Instalação:

Para adicionar o aplicativo no cliente é preciso pegar o link de admin do site e adicionar: "/admin/apps/14811/authorize". Vai aparecer uma requisição que tem que ser feita e vai retornar o USER_ID e o ACCESS_TOKEN.

No integrador:

• URL: https://api.nuvemshop.com.br/v1/{user_id}
• API Key: {ACCESS_TOKEN}

Exporta:

• Categorias Ecommerce

• Marcas

• Derivações (Grades - Tamanho e Cor)

• Imagens (Envia imagens do produto e grade junto, só da para editar qual é a imagem de cada grade pelo site)

• Produtos (Incluiu e Atualiza)
  1. Nome (Dos dados Ecommerce se tiver caso contrario do Produto)
  2. Cód.Barra
  3. Peso
  4. Altura (Dados Ecommerce)
  5. Largura (Dados Ecommerce)
  6. Profundidade (Dados Ecommerce)
  7. Unidade
  8. Categoria Ecommerce (Dados Ecommerce)
  9. Acompanha (É o campo Observação do cadastro do produto do Master Key)
  10. Imagens

• Derivações (Grades no master key)
  1. Nome/Identificação
  2. Cod.Barra

• Preços (opção de selecionar a tabela)

• Estoque (opção de selecionar a loja)
  1. produto e grade

Importa:

• Cliente
• Pedidos