Integração Sites

De Office System
Ir para navegação Ir para pesquisar

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:

  • 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 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