Mudanças entre as edições de "Integração Sites"

De Office System
Ir para navegação Ir para pesquisar
Linha 628: Linha 628:
 
<br />
 
<br />
 
[[Arquivo:Integração Shopify Token 5.png|esquerda|miniaturadaimagem|640x640px|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]]
 
[[Arquivo:Integração Shopify Token 5.png|esquerda|miniaturadaimagem|640x640px|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]]
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
  
  

Edição das 13h28min de 23 de maio de 2024

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
































___________________________________________________________________________________________________________________________________________

Disponível em “https://wiki.officesystem.com.br/index.php?title=Integração_Sites&oldid=2152”