CONTEÚDO

1. Visão Geral
2. Regras de utilização no Totvs Ipass
3. Regras de utilização do ERP
4. Tela XXX
   1. Outras Ações / Ações relacionadas
      
5. Tela XXX
   1. Principais Campos e Parâmetros
      
6. Tabelas utilizadas

01. VISÃO GERAL

Esta documentação tem como objetivo descrever como funciona o envio de SKU do ERP TOTVS Varejo Supermercados para a plataforma de E-commerce Shopify utilizando a plataforma TOTVS iPaaS como middleware de comunicação.
O SKU ou Unidade de Manutenção de Estoque, é utilizado como forma de identificação e rastreio de cada produto pertencente ao estoque de uma empresa, que por sua vez, tem como objetivo facilitar o controle e gestão de cada produto, sendo, atribuído com base em suas características, das quais podem ser destacadas:

• Peso
• Tamanho
• Embalagem
• Quantidade
• Código ou descrição do Produto
  Além de outras informações, das quais também podem ser incluídas com o objetivo de identificar e facilitar o controle do produto no sistema, distinguindo variações, similaridades, e informações de cada produto. 
   

02. REGRAS DE UTILIZAÇÃO NO TOTVS IPASS

O IPAAS consulta os SKUs referente aos produtos no ERP através do endpoint: GET SmPedidoVenda/api/v1/Cadastros/ProdutoSku.


Especificações e configurações para envio da carga de SKU do ERP para o Shopify:

• DtaHorAlteracao - O iPaaS faz o controle por data e hora do envio das cargas, dessa forma, consegue gerenciar para obter as alterações ou inclusões à respeito do SKU. De modo que, a definição de à partir de qual data e hora de inclusão ou alterações, é controlada no IPASS, através do HubeEcommerce( Integration Backoffice (totvs.app) ), em Aba de Configurações > SyncControl > SyncControl por Matriz > Campo: SKU. Desta forma, este campo, será configurado à partir de qual data e hora serão enviadas as cargas que sofreram alterações ou criações acerca de SKUs, neste período.
  
• Page - A paginação é realizada e controlada no IPASS, através do HubeEcommerce( Integration Backoffice (totvs.app) ), em Aba de Configurações > SyncControl > SyncControl por Matriz > SKU > Campo: Página, nela será possível a escolha da página ao qual quer fazer a busca das informações no ERP.

• Nrosegmento - Utilizada para obtenção do segmento em que será utilizado para busca do SKU no ERP, ao qual será enviado ao Shopify (variável no Ipass: nrosegmento)
• NroDivisao - Utilizada para obter a divisão do segmento em que será utilizado para busca do SKU no ERP, ao qual será enviado ao Shopify (variável no Ipass: nro_divisao)
• PageSize - Utilizada para definir o número máximo de registros que poderão ser retornados por página em uma requisição para retorno das informações de SKU do ERP, as quais serão enviadas ao Shopify (variável no Ipass: sku_pagesize)
• Versão da API do Shopify - A configuração de qual versão da Api de integração do Shopify está sendo utilizada, é definido através das variáveis de projeto no Ipass, representada pela variável shopify_api_version. Importante ressaltar que a variável deve ser alterada apenas pela Totvs, pois, uma alteração sem aviso prévio poderá ocasionar problemas na integração com a plataforma Shopify
  
  Para alterar variáveis de projeto no Ipass, basta, no aplicativo Totvs Ipass, ir à barra de navegação na lateral esquerda e selecionar a opção Integrações. Após esse passo, selecione o projeto no qual está localizada a integração com o Shopify e clique na opção Configurar Projeto, localizada na parte superior da tela. Feito isso, aparecerá a seção de Variáveis, na qual será possível alterar cada variável conforme a necessidade de configuração da integração.
   
  Detalhamento do fluxo de configuração de variáveis
     Menu Integrações
       
     Configurações do Projeto
     
     Variáveis do Projeto
     
  
  

03. REGRAS DE UTILIZAÇÃO DO ERP

• O status da embalagem, deve estar ativo na família . (Map_Famembalagem.Status)
  
  
• O status de venda do produto de acordo com sua embalagem, deve estar ativo no cadastro de produto (Mrl_Prodempseg.Statusvenda)
  
• A integração de produto com o E-Commerce, deve estar ativo no cadastro de produto. (Map_Produto.Indintegraecommerce)
  

04. DICIONÁRIO DE CAMPOS

Campos utilizados na integração do endpoint GET SmPedidoVenda/api/v1/Cadastros/ProdutoSku, e suas respectivas referências no ERP e na plataforma Shopify

CompanyId

05. TABELAS UTILIZADAS

Coloque o link das tabelas relacionadas