Integração Sankhya

Conteúdo em desenvolvimento...

ERP Sankhya

Configuração

Requisitos

Sankhya Om versão 4.32 ou superior;

Sankhya Om precisa ter o módulo de construtor de telas;

Acesso ao usuário SUP;

Esse acesso é utilizado pelo cliente para a realização das configurações iniciais. Nesse processo é criado um usuário exclusivo para a GoDeep;

Acesso ao banco de dados para execução dos scripts;

É necessário que o usuário tenha permissão para criação de triggers/procedures;

A execução dos scrips é feita pelo CLIENTE ou pela empresa responsável pelo banco de dados.

Passo-a-passo

Todo o fluxo da configuração inicial da integração é feita pelo time GoDeep junto com o cliente. De prefência em uma reunião.

Executar scripts no banco de dados

Para iniciar o processo de configuração, é necessário executar um script no banco de dados, para a criação de campos, views e triggers que serão utilizadas na integrações.

Temos 2 versões do script. Uma para banco de dados ORACLE e outra para MSSQL.

A pós o cliente informar para a GoDeep o banco de dados utilizado, o time de implantação irá enviar o arquivo .sql com o scripts que deverão ser executados.

A execução deve ser feita pelo CLIENTE ou pela empresa responsável pelo banco de dados.
O ideal que este processo seja feito em um reunião junto com o time de GoDeep, pois caso haja algum problema no script ele pode ser verificado de imediato.

Todos os demais passos abaixo devem ser executados imediatamente após a execução dos scripts, principalmente a reinicialização das unidades de dados.
Caso isso não seja feito, pode acabar travando alguns telas no Sankhya Om.

Reiniciar a unidade de dados de cada tabela

Acessar o SANKHYA OM e entrar na tela Dicionário de Dados, pesquisar por todas as tabelas que colocamos no banco TGFPRO, TGFGRU, TGFCAB, TGFTPV, TGFPAR ao pesquisar as tabelas, sempre analisar bem se a tabela corresponde a pesquisada, feito isto, clique na tabela correta, clique na seta ao lado de outras opções e terá REINICIAR ESTA UNIDADE DE DADOS, refaça o procedimento para todas as tabelas citadas acima.

OBS: fazer o passo 3 logo em seguida, porque durante este processo, os clientes estão sem acesso e por isto precisa ser limpado o cache para que possam ter acesso ao sistema novamente! caso o cliente reclame que parou de funcionar, fazer o passo 3 para que volte a funcionar corretamente

Descartar cache

Entrar em CACHE DO SERVIDOR, clicar no botão DESCARTAR CACHE AGORA.

Criação do META DADOS

Dentro do Construtor de Telas terá o campo OUTRAS OPÇÕES, selecione META DADOS e depois EXPORTAR METADADOS, depois abrir o arquivo exportado que acabamos de baixar, pegar o expoinfo do arquivo, depois acessar o metadados cópia que temos, localizar a tag metadata e abaixo dela colar a tag expoinfo que copiamos, lembrando que ao compactar novamente o arquivo xml, o nome do zip precisa ser "Metadados_LogIntegracaoEC.zip"

Criar lançador

Entrar em Construtor de Telas, clicar na seta ao lado de OUTRAS OPÇÕES, colocar o mouse em LANÇADOR e clicar em ADICIONAR LANÇADOR, selecionar COMERCIAL > CONSULTA e na opção DESCRIÇÃO logo acima, informar o nome padrão que será "Log Integração E-commerce" e clicar em CONCLUIR.

Criar usuário da GoDeep

Precisamos que seja criado um usuário, com os dados abaixo:

Usuário: GODEEP

Email: [O email será enviado pelo time de IMPLANTAÇÃO da GoDeep]

Senha: [A senha será enviado pelo time de IMPLANTAÇÃO da GoDeep]

Ele deve ter as seguintes permissões de acesso para consulta e edição:

Produtos

Grupos de Produtos / Serviços

Parceiros

Tipos de Operação

Tipos de Negociação

Portal de Vendas

Central de Vendas

DBExplorer

Preferências

Cache do Servidor

Dicionário de Dados

Configurações Gateway

Configurador de Layout da Nota

Acessos

Criar token do gateway

Acessar a tela de "Configurações de Gateway" e criar uma vinculação a aplicação da GoDeep (F1 Soluções)

Fazer configurações nas telas de Preferências

Acessar o menu "Preferência" e pesquisar por CODUSUEC e incluir o código do usuário da GoDeep (para para projeto o código do usuário da GoDeep vai mudar).

Acessar o menu "Preferência" e pesquisar por LOGTABOPER e habilitar o log.

Acessar o menu "Preferência" e pesquisar por LOGTABMAXAGE e configurar o log para 3 dias.

Validar campos utilizados pela GoDeep

Ajustar a tela de produto para exibir os novos campos relacionados ao e-commerce.

Ajustar a tela de categorias para exibir os novos campos relacionados ao e-commerce.

Ajustar a tela de cliente para exibir os novos campos relacionados ao e-commerce.

Verificar se produtos, categorias e clientes já estão com o "Usado no E-commerce" ativo. Ativar pelo menos um de cada para validar a integração.

10.

Incluir campos da GoDeep no cabeçalho do pedido

É necessário exibir no cabeçalho do pedido os valores de status do pedido e id GoDeep. Para isso é necessário acessar a tela de "Configurador de Layout da Nota" e incluir os campos:

ID do pedido (e-commerce)

ID do sub-pedido (e-commerce)

ID do pedido HUB (e-commerce/marketplace)

Referência do pedido (e-commerce)

Status do pedido (e-commerce)

Cupom utilizado (e-commerce)

Autorização da Transação (e-commerce)

NSU da Transação (e-commerce)

Forma de Pgto (e-commerce)

Qtde de Parcelas (e-commerce)

Código de Rastreio (e-commerce)

URL de Rastreio (e-commerce)

Etiqueta (e-commerce)

11.

Validar se triggers antigas estão desativadas

Comando para desativas as triggers antigas e não são mais utilizadas. Essas triggers existem somente em lojas que vieram migradas da Sankhya para a GoDeep. Para novas integrações essas triggers não devem existir.

Lojas que são "tombamento" devem ser desativadas todas as triggers que tenha "_SITE".

Consulta para conferir se todas as triggers foram desativadas. TRIGGERS ANTIGAS E QUE NECESSITAM SER DESATIVADAS.

12.

Validar se triggers novas estão ativas

CONSULTA PARA SABER O STATUS DAS TRIGGERS QUE UTILIZAMOS NA INTEGRAÇÃO

13.

Configurações para utilização do endereço de entrega do parceiro

https://ajuda.sankhya.com.br/hc/pt-br/articles/360043674553-%C3%89-obrigat%C3%B3rio-informar-o-contato-do-parceiro-para-entrega

https://ajuda.sankhya.com.br/hc/pt-br/articles/360044573334-Destacar-endere%C3%A7o-de-entrega-diferente-do-endere%C3%A7o-principal-do-parceiro

https://ajuda.sankhya.com.br/hc/pt-br/articles/20140086062487-Como-configurar-o-sistema-para-considerar-o-endere%C3%A7o-de-entrega-do-parceiro-no-c%C3%A1lculo-dos-impostos-em-notas-de-vendas

Integração

Requisitos

Além de todos os passos citados acima, para iniciar a integração, o cliente deve enviar para a GoDeep os seguintes dados:

Código da Empresa

Código da Natureza

Código Centro de Resultado

Código da TOP (pedido de venda)

Código Vendedor

Depósitos (Locais)

Código da Empresa (Locais)

Lista para Preço DE

Lista para Preço POR

Parceiros de Frete

Caso haja regras específicas, devem ser alinhadas entre o time de implantação e o cliente, antes de passar o projeto para o time de integração.

Exemplos:

Pedidos normais da plataforma devem integrar no sankhyan utilizando a TOP 1 e Vendedor 44.

Para pedidos vindos do marketplace Amazon devem utilizar a TOP 2, vendedor 12 e parceiro de frete 56.

Rotinas de atualização de dados

Segue abaixo os tempos padrões da execução de cada rotina. Esse tempo pode variar a cada projeto.

Rotina	Tempo
Produto	a cada 10 minutos
Preço	a cada 60 minutos
Estoque	a cada 10 minutos
Clientes	a cada 60 minutos
Categorias	a cada 10 minutos
Pedidos	a cada 5 minutos

Produtos

Para a integração de produtos, temos alguns campos que são utilizamos exclusivamente para GoDeep. Esses campos já foram criados na execução do scripts durante a etapa de configuração inicial.

Por padrão, a GoDeep só consulta os dados do produtos, ou seja, nenhuma alteração no produto feita no painel admin da GoDeep irá refletir no Sankhya. Caso seja feita a alyteração de um campo que está indo integrado,

De-Para padrão de campos

GoDeep DataIn B2B	ID no Sankhya	Nome no Sankhya
code	TGFPRO.CODPROD	Código:
code	TGFPRO.CODPROD	Código:
code	TGFPRO.CODPROD	Código:
code	TGFPRO.CODPROD	Código:
code	TGFPRO.CODPROD	Código:
code	TGFPRO.CODPROD	Código:

Configuração

Requisitos

Passo-a-passo

Integração

Requisitos

Rotinas de atualização de dados

Produtos

De-Para padrão de campos

Clientes (Parceiros)

Seguimentos (Perfil)

Listas de Preço

Categorias (Grupos de Produtos / Serviços)

Integração Sankhya

Configuração#

Requisitos#

Passo-a-passo#

Integração#

Requisitos#

Rotinas de atualização de dados#

Produtos#

De-Para padrão de campos#

Clientes (Parceiros)#

Seguimentos (Perfil)#

Listas de Preço#

Categorias (Grupos de Produtos / Serviços)#

Configuração

Requisitos

Passo-a-passo

Integração

Requisitos

Rotinas de atualização de dados

Produtos

De-Para padrão de campos

Clientes (Parceiros)

Seguimentos (Perfil)

Listas de Preço

Categorias (Grupos de Produtos / Serviços)