Layout - Sakata - v1.2 - Novo Escopo
Layout - Sakata - v1.2 - Novo Escopo
Layout - Sakata - v1.2 - Novo Escopo
IMPLANTA - SAKATA
M ANUAL DE I NTEGRAÇÃO DE D ADOS DE ERP - P ILOTO
5 de novembro de 2020
Histórico de Revisões
Histórico de Revisões ii
1.1 Introdução
Este documento aborda os detalhes técnicos da implementação da integração de sistemas ERPs e o sistema Instant
Manager da SAKATA.
O objetivo do projeto é integrar os dados extraídos diretamente do sistema do canal, permitindo à SAKATA
apoia-lo de forma proativa, antecipar tendências e gerar ações de marketing mais efetivas.
O sistema possibilitará o acompanhamento mais assertivo das ações de marketing direcionadas e com resultados
dos programas da SAKATA.
Existem duas alternativas para a implementação desta integração, cada uma com vantagens e desvantagens para
o canal e para a empresa desenvolvedora do software ERP, conforme será abordado nas seções a seguir.
• O desenvolvimento é compartilhado entre a Implanta e a empresa fabricante do ERP; Esta última apenas ocupa
o tempo de um desenvolvedor/DBA para criar as views no formato apropriado para o extrator padrão, con-
forme regras especificadas neste documento;
• O tempo de implementação dos protocolos de segurança e autenticação dos dados necessários é aproveitado
com o uso do extrator padrão Implanta;
• A evolução do software extrator, para atender demandas da SAKATA ou para se ajustar a mudanças no soft-
ware ERP também é feita de forma compartilhada: o extrator é atualizado pela Implanta e demandas de atua-
lização das views são feitas para a empresa detentora do ERP mediante notificação ou solicitação de mudança
e podem acontecer a qualquer momento dentro do projeto;
• A auditoria e conferencia dos dados é feita por técnicos treinados da Implanta, que conhecem completamente a
demanda da SAKATA. Estes técnicos comparam os dados extraídos com relatórios do sistema ERP para garantir
a exatidão dos dados;
• A evolução do software extrator, para atender demandas da SAKATA ou para se ajustar a mudanças no soft-
ware ERP também é feita pela Implanta, mediante notificação ou solicitação de mudança;
O extrator Implanta utiliza um usuário somente leitura para se conectar ao banco de dados do ERP, para garantir
que as informações originais do ERP não serão de forma alguma modificadas pelo extrator.
• Dados do Distribuidor: razão social, nome fantasia, cnpj, código IBGE, telefones, latitude, longitude, email e
endereço;
• Dados do Inventário do Estoque de Produtos: fabricante, código do produto, descrição, unidade de venda,
código de barras (EAN/GTIN), lote, posição de estoques (físico, disponível, trânsito e bloqueado), data do
estoque;
• Dados de Vendas, Devoluções, Bonificações e outras Saídas/Entradas;
• Dados de Clientes: cpf/cnpj, nome, endereço, CEP, código IBGE do endereço, telefones, email, datas de manu-
tenção no banco de dados, data de nascimento;
• Dados de Fornecedor: cpf/cnpj, nome, endereço, CEP, código IBGE do endereço, telefones, email, datas de
manutenção no banco de dados;
Os dados devem ser enviados conforme estão cadastrados no ERP. Não é necessário transformar os dados para
o padrão utilizado pela SAKATA (e empresas associadas). Códigos e descrições dos produtos, Operações de Venda,
Nomes de culturas e outros serão, após o envio, analisados e configurações De-para serão feitas na própria ferramenta
de auditoria e configuração, chamada Instant Manager SAKATA, pela equipe responsável na Implanta.
Caso a revenda desligue os computadores no final do expediente, é preferível executar a extração nas primeiras
horas da manhã do dia seguinte, enviando o movimento do dia anterior.
O extrator não deve enviar movimentação parcial do dia, ou seja, enquanto o expediente ainda não estiver encer-
rado.
HTTP
• Porta: 80
• IP: 51.175.53.73
• URL: http://sakata.implantait.com/Areas/Integrator/ServicesExtractor3.asmx
HTTPS
• Porta: 443
• IP: 51.175.53.73
• URL: http://sakata.implantait.com/Areas/Integrator/ServicesExtractor3.asmx
MESSAGE QUEUE
• Porta: 8161
• IP: 200.231.112.163
• URL: http://messagequeue.implantait.com.br:8161
Para este projeto, views devem ser disponibilizadas para que o Extrator da Implanta importe os dados e os envie
para o servidor da SAKATA.
View é uma consulta armazenada no banco de dados, ou seja, a view é uma tabela virtual que possibilita apenas
a visualização das informações restritas a essa consulta. Ela permite somente a pesquisa otimizada dos dados, sem
alteração do conteúdo. Com o uso de views, os dados da empresa estão protegidos da gravação acidental e de acessos
não autorizados a outras informações do banco de dados.
Os campos necessários para executar o Extrator da Implanta estão descritos nos quadros deste capítulo.
Para a criação das views, todos os nomes, tanto das views quanto dos seus campos deverão ser obedecidos. Estas
devem ser criadas no banco de produção para que os dados estejam sempre disponíveis na extração diária sem que
haja interferência humana no processo.
Nesta view estão contidos os dados do cliente para o qual foi efetuada a venda/devolução/outras, com produtos da
SAKATA (e empresas associadas).
O nome da view deverá ser SAKATA_CLIENT.
cfop_ven varchar(4) Obrigatório Código fiscal da Operação da NFE na SEFAZ. Apenas nú-
meros, sem pontos ou outros caracteres especiais.
stat_ven varchar(1) Obrigatório Status da Venda (A = Ativa, C = Cancelada).
desc_opr varchar(60) Obrigatório Descrição da operação.
sina_opr varchar(1) Obrigatório Sinal da operação(E para entradas e S para saídas).
codi_cli varchar(20) Obrigatório Chave primária do cliente no ERP da revenda para join
com SAKATA_CLIENT.
codi_pro varchar(max) Obrigatório Código (chave primária) que identifica o produto SA-
KATA (e empresas associadas) no ERP da revenda. Caso
o produto seja semente, concatenar com o código do tipo
de tratamento utilizado quando houver. No caso de chave
composta, sugerimos concatenar os campos com separa-
dor "."
desc_pro varchar(60) Obrigatório Descrição completa do produto.
ncmp_pro varchar(8) Obrigatório Código NCM do produto.
unid_pro varchar(10) Obrigatório Unidade de venda do produto. CX, LT, KG, SC.
barr_pro varchar(14) Código de barras da embalagem do produto
(EAN/GTIN). Nulo se não houver.
lote_pro varchar(20) Obrigatório Lote do produto.
cind_pro varchar(15) Código oficial do produto na SAKATA (e empresas associ-
adas). Nulo se não houver.
cust_pro numeric(18,4) Obrigatório Custo/preço de aquisição do produto.
pcmv_ivn numeric(18,4) Obrigatório Custo da mercadoria vendida. Nulo se não houver
icms_ivn numeric(18,4) Obrigatório,>=0 Valor do ICMS.
iipi_ivn numeric(18,4) Obrigatório,>=0 Valor do IPI.
ipis_ivn numeric(18,4) Obrigatório,>=0 Valor do PIS.
icof_ivn numeric(18,4) Obrigatório,>=0 Valor do COFINS.
pbru_ivn numeric(18,4) Obrigatório,>0 Preço inicial da negociação realizada, capturado direta-
mente do item da NF, já com o desconto de item de nota
fiscal.
pliq_ivn numeric(18,4) Obrigatório,>0 Preço final da negociação realizada, ou seja, Faturamento
Bruto Inicial – Descontos, desconto de rodapé + frete rate-
ado por item.
qtde_ivn numeric(18,4) Obrigatório,>0 Quantidade vendida. Informar na mesma unidade que foi
enviado no estoque(SAKATA_PRODUCTSTOCK).
codi_ved varchar(20) Obrigatório * Código do vendedor no ERP da revenda. Nulo se não
houver controle na filial.
2.6 Observações
2.6.1 Processo de validação
Para verificar os dados fornecidos, a Implanta solicita alguns relatórios do ERP do cliente para confirmar se os dados
fornecidos nas views foram disponibilizados corretamente.
Para conferir as informações contidas na view SAKATA_PRODUCTSTOCK o cliente deverá fornecer um relatório
de estoque com a posição de estoque na data solicitada.
Para validar as informações contidas na view SAKATA_INVOICE_INVOICEITEM o cliente deverá fornecer um
relatório de movimentações (vendas, devoluções, compras, bonificações, amostras, complementos e outros).
É importante que as informações da view estejam semelhantes às informações contidas nos relatórios do software
de gestão (ERP), pois a validação consiste na comparação entre esses dados. As informações dos relatórios devem
estar de acordo com os valores do próprio sistema, não devendo ser adaptados ou ajustados para corresponder aos
valores nas views.
Durante o processo de validação podem ocorrer divergências entre os dados dos relatórios e os dados das views.
Se for constatado que as informações dos relatórios fornecidos, estão incorretas, o implantador solicitará um novo
relatório para conferência das informações. Se for constatado que o problema está na view, o implantador solicitará
sua correção.
O acesso ao XML da nota também será necessário para que as informações sejam validadas. O extrator acessará a
pasta onde os XMLs das notas emitidas e enviará as informações desses XMLs para o Instant Manager da SAKATA.