GoDeep - Documentação
HomeB2BB2CHUBAplicativoAPIs
HomeB2BB2CHUBAplicativoAPIs
  1. ERPs
  • GoDeep
    • Quem Somos
    • Meios de pagamento - B2C
  • ERPs
    • Integração Sankhya
    • ERPs integrados com a GoDeep
  • Documentação Funcional
    • Deep B2B
      • Fretes
      • Configurações gerais
      • Promoções
        • Cupons de Desconto
      • Pedidos
        • Cobrança de taxa em cima do valor do pedido
      • Meios de Pagamento
        • Itaú
    • Deep B2C
      • Produtos
        • Marcas
        • Seletor Mix
        • Importador manual de listas de preço
      • Pedidos
        • Pedidos - Status
        • Endpoint Compras por WhatsApp
      • Fretes
        • Fretes
        • Correios
        • Data Frete
        • Dedalog
        • Frenet
        • Melhor Envio
        • TransPaulo
        • Total Express
        • Intelipost
        • Jadlog
        • Jamef
      • Meios de Pagamento
        • Itaú
      • Promoções
        • Cupons de Desconto
      • Institucionais
        • Páginas institucionais
      • Configurações gerais
        • Importação manual de produtos
    • Deep HUB
      • Marketplaces
        • Marketplace F1
        • Amazon
        • Mercado Livre
      • Configurações gerais
        • Erro ao criar produto no Mercado Livre – B2C
    • Deep Sales
      • Aplicativo Deep Sales
  • APIs
    • Deep B2B
      • Produtos
        • Informações sobre o endpoint
        • cadastrar produtos e relacionamentos (completo)
        • cadastrar produto
        • cadastrar produto kit
        • cadastrar produto com garantia extendida
        • atualizar produto
        • atualizar estoque do produto
        • atualizar listas de preço do produto
        • listar produtos
        • listar identificadores dos produtos
        • obter produto
        • listagem simples (codigo produto e dados de estoque)
      • Produtos Relacionados
        • obter produtos relacionados
        • obter produtos similares
        • obter produtos complementares
        • cadastrar produtos similares
        • cadastrar produtos complementares
        • cadastrar produtos relacionados
      • PRODUTOS CONCEITOS
        • cadastrar conceito
        • atualizar conceito
        • listar conceitos
        • obter conceito
      • PRODUTOS PREÇO
        • Informações sobre o endpoint
        • cadastrar preco para um produto existente
        • atualizar preco de um produto existente
        • listar precos de um produto existente
        • obter o preco de um produto existente por segmentacao
        • atualizar precos por lista de preco
        • consultar processos de atualizacao de lista
      • PRODUTOS ESTOQUE
        • cadastrar estoque para um produto existente
        • atualizar estoque de um produto existente
        • deletar o estoque de um produto existente por segmentacao (Não Usar)
        • listar os estoques de um produto existente
        • obter o estoque de um produto existente por segmentacao
      • PRODUTOS ATRIBUTOS
        • cadastrar atributo
        • atualizar atributo
        • deletar atributo (Não Usar)
        • deletar atributo de uma classe existente (Não Usar)
        • listar atributos
        • obter atributo
      • PRODUTOS VALORES DE ATRIBUTOS
        • cadastrar valor de atributo para um produto existente
        • cadastrar multiplos atributos para um produto existente
        • cadastrar multiplos valores para um atributo especifico e um produto existente
        • atualizar valor de atributo de um produto existente
        • deletar o valor do atributo de um produto existente (Não Usar)
      • PRODUTOS CATEGORIA
        • cadastrar categoria
        • cadastrar vinculo cliente e categoria
        • atualizar categoria
        • deletar categoria (Não Usar)
        • listar categorias
        • obter categoria
      • PRODUTOS CLASSE
        • cadastrar classe
        • cadastrar classe com classe pai
        • cadastrar atributo para uma classe existente
        • cadastrar multiplos atributos para uma classe existente
        • atualizar classe
        • deletar classe (Não Usar)
        • listar classes
        • obter classe
      • PRODUTOS RESERVA DE ESTOQUE
        • consultar reservas de estoque
      • IMPOSTOS REGIME TRIBUTÁRIO
        • cadastrar regime tributario
        • atualizar regime tributario
        • deletar regime tributario (Não Usar)
        • listar regime tributario
        • obter regime tributario
      • IMPOSTOS MATRIZ TRIBUTÁRIA
        • Informações sobre o endpoint
        • cadastrar ou atualizar matriz tributaria
        • listar matriz tributaria
        • obter matriz tributaria
      • IMPOSTOS (IPI) MATRIZ TRIBUTÁRIA DE IPI
        • cadastrar matriz tributaria IPI
        • listar matriz tributaria IPI
        • obter matriz tributaria IPI
      • VENDEDORES / REPRESENTANTES
        • Informações sobre o endpoint
        • cadastar vendedores
        • atualizar vendedores
        • listar vendedores
        • obter vendedores
        • remover vendedor (Não Usar)
      • CARTEIRAS
        • Informações sobre o endpoint
        • cadastrar carteira
        • atualizar carteira
        • obter carteira
        • listar carteiras
        • remover carteira (Não Usar)
      • CLIENTES
        • Informações sobre o endpoint
        • cadastrar cliente
        • atualizar cliente
        • obter cliente
        • listar cliente
        • remover cliente (Não Usar)
      • CLIENTES SEGMENTOS
        • listar segmentos
        • obter segmento
        • cadastrar segmentos
        • atualizar segmentos
      • CLIENTES CONTATOS
        • listar crm contatos
        • cadastrar crm contatos
        • obter crm contatos
        • atualizar crm contatos
        • remover crm contato (Não Usar)
      • PEDIDOS
        • listar pedidos
        • obter pedido
        • atualizar pedido
        • atualizar pedido com cancelamento parcial de itens
      • PEDIDOS NOTAS
        • Informações sobre o endpoint de notas
        • cadastrar notas
        • listar notas
        • obter nota
        • atualizar nota
        • remover nota (Não Usar)
      • CHECAGEM DE EXISTÊNCIA
        • CRM
        • not existing data entities
      • ARQUIVOS
        • cadastrar arquivo
      • DESCONTO PROGRESSIVO
        • listar
        • obter
        • atualizar
        • cadastrar
        • remover (Não Usar)
      • RELATÓRIOS COMISSÕES
        • Informações sobre o endpoint de comissões
        • Listar Comissões
        • Cadastrar
      • CONDIÇÕES DE PAGAMENTO
        • Informações sobre o endpoint de condições de pagamento
        • listar
        • obter
        • cadastrar
        • atualizar
        • remover (Não Usar)
      • PEDIDOS EXTERNOS
        • cadastrar
        • atualizar
        • obter
      • CONSULTA PRODUTOS (LOJA)
        • Informações sobre o endpoint de consulta de produtos na loja
        • Consulta Produtos Geral
        • Consulta Produtos por Código
  1. ERPs

Integração Sankhya

Conteúdo em desenvolvimento...
ERP Sankhya
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.

1.
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.

2.
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

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

4.
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"

5.
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.

6.
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

7.
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)

8.
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.

9.
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#

Fluxo geral da consulta de dados

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.
RotinaTempo
Produtoa cada XX minutos
Preçoa cada XX minutos
Estoquea cada XX minutos
Clientesa cada XX minutos
Categoriasa cada XX minutos
Pedidosa cada XX 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 B2BGoDeep DataIn B2CID no SankhyaNome no SankhyaObservação
codeTGFPRO.CODPRODCódigo:
codeTGFPRO.CODPRODCódigo:
codeTGFPRO.CODPRODCódigo:
codeTGFPRO.CODPRODCódigo:
codeTGFPRO.CODPRODCódigo:
codeTGFPRO.CODPRODCódigo:

Clientes (Parceiros)#

Seguimentos (Perfil)#

Listas de Preço#

Categorias (Grupos de Produtos / Serviços)#

Modificado em 2025-07-02 18:29:57
Página anterior
Meios de pagamento - B2C
Próxima página
ERPs integrados com a GoDeep
Built with