Produto
Chamado
THKMYK
Data da publicao
: 05/07/13
Pas(es)
Banco(s) de Dados
: Top Connect
A criao da rotina Relatrio Produtos x Tributao, permite que se verifique se os campos obrigatrios
do cadastro de Produtos referente Integrao Protheus x SIAC esto preenchidos corretamente.
Alm disso, o relatrio agrupa os produtos por situao tributria e alquota. Com essa opo, facilitamos
o preenchimento da tabela DPTributacaoProtheus do banco de dados SIAC, j que ele j exibe os
valores dos campos codTributacaoExterna e PercImposto que devem ser preenchidos, restando
preencher o campo idTributacao.
Por ltimo, ele tambm valida se o cdigo de barras um cdigo EAN-13 vlido, atravs do campo
EAN13 do relatrio. Se o cdigo digitado e um cdigo vlido (S) ou no (N).
Boletim Tcnico
Consulte o Guia Rpido para preenchimento das tabelas DePara do mdulo Integrador, localizado neste
boletim.
a)
b)
c)
d)
necessrio que o ambiente j esteja configurado conforme o Boletim Tcnico Boletim Tcnico
Integrao ProtheusxSiac
Boletim Tcnico
e)
O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de
Banco de Dados (DBA) ou equivalente!
A ativao indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre
tabelas no banco de dados. Portanto, antes de utiliz-la, observe atentamente os procedimentos a
seguir:
i. No Configurador (SIGACFG), veja se a empresa utiliza Integridade Referencial, selecionando a
opo Integridade/Verificao (APCFG60A).
ii. Se no h Integridade Referencial ativa, so relacionadas em uma nova janela todas as
empresas e filiais cadastradas para o sistema e nenhuma delas estar selecionada. Neste caso,
E SOMENTE NESTE, no necessrio qualquer outro procedimento de ativao ou
desativao de integridade, basta finalizar a verificao e aplicar normalmente o
compatibilizador, conforme instrues.
iii. Se h Integridade Referencial ativa em todas as empresas e filiais, exibida uma mensagem
na janela Verificao de relacionamento entre tabelas. Confirme a mensagem para que a
verificao seja concluda, ou;
iv. Se h Integridade Referencial ativa em uma ou mais empresas, que no na sua totalidade, so
relacionadas em uma nova janela todas as empresas e filiais cadastradas para o sistema e,
somente, a(s) que possui(em) integridade est(aro) selecionada(s). Anote qual(is) empresa(s)
e/ou filial(is) possui(em) a integridade ativada e reserve esta anotao para posterior consulta
na reativao (ou ainda, contate nosso Help Desk Framework para informaes quanto a um
arquivo que contm essa informao).
v. Nestes casos descritos nos itens iii ou iv, E SOMENTE NESTES CASOS, necessrio
desativar tal integridade, selecionando a opo Integridade/ Desativar (APCFG60D).
vi. Quando desativada a Integridade Referencial, execute o compatibilizador, conforme
instrues.
vii. Aplicado o compatibilizador, a Integridade Referencial deve ser reativada, SE E SOMENTE SE
tiver sido desativada, atravs da opo Integridade/Ativar (APCFG60). Para isso, tenha em
mos as informaes da(s) empresa(s) e/ou filial(is) que possua(m) ativao da integridade,
selecione-a(s) novamente e confirme a ativao.
Contate o Help Desk Framework EM CASO DE DVIDAS!
1.
Em Microsiga Protheus ByYou Smart Client, digite U_UPDINTSIAC no campo Programa Inicial.
Boletim Tcnico
Para a correta atualizao do dicionrio de dados, certifique-se que a data do compatibilizador seja igual
ou superior a 12/06/2013. Alm disso, verifique o passo 6 antes de continuar.
2.
3.
Aps a confirmao exibida uma tela para a seleo da empresa em que o dicionrio de dados ser
modificado.
4.
Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo
em modo exclusivo.
5.
Clique em Processar para iniciar o processamento. O primeiro passo da execuo a preparao dos
arquivos.
apresentada uma mensagem explicativa na tela.
6.
Se o UPDINTSIAC j tiver sido aplicado, quando surgir a pergunta referente a Diferena de Contedo
SX6, clique em No p/ Todos, pois seno o sistema redefine o contedo de todos os parmetros
referentes a Integrao Protheus x SIAC.
7.
Em seguida, exibida a janela Atualizao concluda com o histrico (log) de todas as atualizaes
processadas. Nesse log de atualizao so apresentados somente os campos atualizados pelo
programa. O compatibilizador cria os campos que ainda no existem no dicionrio de dados.
8.
9.
Atualizaes do Compatibilizador
1. Criao de Parmetros no arquivo SX6 Parmetros:
Nome da Varivel
MV_SCCSPRC
Tipo
Lgico
Descrio
Valor Padro
.F.
2.
Campo
LR_QUANT
Val. Sistema
Boletim Tcnico
O tamanho dos campos que possuem grupo podem variar conforme ambiente em uso
SIGALOJA
Submenu
Nome da Rotina
Programa
LJSCR001
Mdulo
SIGALOJA
Tipo
Funo Protheus
Contedo
MV_SCINTEG
.T.
MV_SCCSPRC
.T.
Boletim Tcnico
Procedimentos da Integrao:
1. Em Configurador (SIGACFG), acesse Base de Dados / Base de Dados.
2.
Inclua o campo reservado Ident.Exp.Dados (B0_MSEXP) na tabela SB0 (Dados Adicionais Loja).
Como nenhum produto foi exportado desde a criao do campo Ident.Exp.Dados (B0_MSEXP), o valor
da pergunta Tipo no far diferena, pois todos os produtos esto com o status de alterado.
4. Confira os dados e confirme.
Se os produtos foram exportados com sucesso, o valor do campo Ident.Ex.Dados (B0_MSEXP0) ser a
Data Atual (DDATABASE) do sistema.
5. Acesse Atualizaes / Miscelnea / Protheus x SIAC / Log Exportao (LJLOGSIACPLU).
6. Verifique se ambos os produtos foram exportados com sucesso.
7. Acesse Atualizaes/Cadastros/Produtos (LOJA110),
8. Selecione um dos produtos que foram exportados e altere qualquer informao.
Como o produto foi alterado, o campo Ident.Ex.Dados fica vazio.
9. Acesse Atualizaes / Miscelnea / Protheus x SIAC / Exportao de Produtos (LJTELASIAC).
10. Mantenha as opes selecionadas anteriormente, exceto o valor da pergunta Tipo que dever ser
Diferencial.
11. Confira os dados e confirme.
Acesse Atualizaes / Miscelnea / Protheus x SIAC / Log Exportao (LJLOGSIACPLU) e verifique que
somente o produto alterado foi exportado.
Para que o produto fique com o status alterado, necessrio alter-lo atravs da rotina Produtos
(LOJA110), presente no mdulo Controle de Lojas (SIGALOJA).
Boletim Tcnico
4. Clique em Parmetros e configure os valores o qual a rotina utilizar para ser executada.
Quando a rotina for executada via Schedule, os parmetros utilizados para executao da rotina sero
apresentados no console do servidor de aplicao (appserver) do Protheus e no log de processamento,
se o mesmo estiver habilitado.
5. Para os outros campos, configure-os conforme orientao de help de campo.
6. Confira os dados e confirme.
A partir de agora, a rotina de exportao de produtos ser executada conforme a recorrncia
cadastrada.
Mesmo que a rotina de exportao de produtos seja executada via Schedule, se o parmetro
MV_SCLOG estiver habilitado, o log de processamento ser gravado normalmente.
Consulta Preo no SIAC Store
Pr-requisitos:
O cdigo do grupo deve ser numrico e ter o valor mximo de 9999 (completando os dgitos restantes
com zeros esquerda), pois o Grupo de Clientes do Protheus ser relacionado Categoria de Clientes
do SIAC Store, que utiliza 4 dgitos numricos para o cdigo.
3. Em Controle de Lojas (SIGALOJA), acesse Atualizaes / Cadastro / Cliente (LOJA110). Inclue ou altere um
cliente, porm o campo Grp.Vendas (A1_GRPVEN) deve ser preenchido com o cdigo do grupo de clientes
Boletim Tcnico
cadastrado anteriormente. Para mais informaes referente aos campos a serem preenchidos, consulte o
Boletim Tcnico Integrao Protheus x SIAC.
4. Em Controle de Lojas (SIGALOJA), acesse Miscelnea / Protheus x SIAC / DPEmpFilxLj (LJSIACDPLJ), verifique
se os campos Loja SIAC (MBM_LJSIAC) e IP WS SIAC (MBM_IPWS), esto preenchidos para o Grupo de
Empresa e Filial, onde a consulta ser realizada.
5. Exporte um produto para o SIAC.
Possuir uma Categoria de Cliente cadastrada no SIAC, com o mesmo cdigo do Grupo de Clientes do
Protheus.
O produto exportado deve ter o mesmo preo em ambos os sistemas, ou seja, o preo do produto no
Protheus deve ser igual ao preo em vigncia no SIAC.
No SIAC, o produto exportado deve estar cadastrado em uma promoo, que deve ser baseada na
Categoria de Cliente.
Procedimentos da Integrao:
Mensagem
Produto no cadastrado
-1
Erro
-2
O cdigo de retorno de cada consulta est presente no Log de Processamento, porm necessrio
habilit-lo: (MV_SCLOG = .T.) .
Boletim Tcnico
Para cancelar o desconto, basta atribuir o valor 0 (zero) ao campo Desconto (LR_DESC) ou Valor Desc
(LR_VALDESC).
Se ocorrer uma inconsistncia na Web Services, o Protheus no voltar a consultar o SIAC at que o
usurio saia da rotina Venda Assistida e acesse-a novamente.
Para melhor performance, os resultados das consultas sero armazenados em uma memria
temporria, portanto se o usurio selecionar um cliente e produto j consultado, utilizaremos os dados
presentes na memria, evitando que uma nova consulta seja realizada. A memria ser apagada
quando o usurio sair da rotina Venda Assistida.
Guia rpido para preenchimento das Tabelas De Para do Mdulo Integrador (SIAC)
Abaixo listaremos quais as tabelas DePara utilizadas na Integrao Protheus x SIAC e suas respectivas
funcionalidades. No abordaremos detalhes, pois essas tabelas no fazem parte do banco de dados
utilizado pelo Protheus. Atualmente no h uma interface grfica para manipular dessas tabelas,
portanto essas tabelas devero ser preenchidas atravs de comandos da linguagem SQL.
9
Boletim Tcnico
O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de
Banco de Dados (DBA) ou equivalente!
DPLojaFilialProtheus
Relaciona o grupo de empresa e filial a uma loja do SIAC.
Nome do Campo
Tipo
Descrio
codGrupoEmpresaProtheus
Caracter
codFilialProtheus
Caracter
CodLojaSIAC
Numrico
Se o cdigo da Filial Protheus tiver espaos no nicio e/ou no fim, esses espaos devem ser levados em
considerao ao preencher o campo codFilialProtheus .
Exemplo de preenchimento:
INSERT INTO DPLojaFilialProtheus
(codGrupoEmpresaProtheus , codFilialProtheus , codLojaSiac)
VALUES
('99', '01', 1)
DPTributacaoProtheus
Relaciona um TES e uma alquota do Protheus a um cdigo de tributao do SIAC.
Nome do Campo
Tipo
Descrio
codTributacaoExterna
Caracter
PercImposto
Numrico
idTributacaoExterna
Numrico
O campo codTributacaoExterna '1.501', onde 1 o cdigo da loja SIAC e 501 a TES referente a
tributao integral de ICMS. obrigatrio separar as duas informaes com um ponto.
Os campos idTributacao e PercImposto devem ser iguais aos campos idTributacao e
valor2PercAliquota de um registro da tabela ParTributacao.
Exemplo de preenchimento:
INSERT INTO DPTributacaoProtheus
(codTributacaoExterna, PercImposto, IdTributacao)
SIGALOJA Novas Funcionalidades
Integrao Protheus x SIAC
10
Boletim Tcnico
VALUES
('1.501', 7.00, 5)
DPFormaPagamentoProtheus
Relaciona uma Forma de Pagamento Protheus com um cdigo de finalizao SIAC.
Nome do Campo
Tipo
Descrio
codFinalizacao
Numrico
codFinalizIntegracao
Caracter
codAdministradoraIntegracao
Caracter
O valor do campo codFinalizacao deve ser igual ao campo idParFinalizao de um registro na tabela
ParFinalizacao.
O campo codAdministradoraIntegracao somente deve ser utilizado quando a forma de pagamento for
FI (Financiado - utilizado para Cooperado) e CO (Convnio - utilizado para PBM e PBMS), caso contrrio
deve ser igual a NULL.
Exemplo de preenchimento:
INSERT INTO DPFormaPagamentoProtheus
(codFinalizacao, codFinalizIntegracao)
VALUES
(1, 'R$')
DPAdministracaoProtheus
Relaciona uma Administradora Financeira do Protheus a uma Rede e Bandeira do Servidor Scope.
Nome do Campo
Tipo
Descrio
codBandeiraScope
Numrico
Cdigo da Bandeira
codRedeScope
Numrico
Cdigo da Rede
codAdministradoraIntegracao
Caracter
qtdeparcde
Numrico
qtdeparcate
Numrico
At a quantidade de parcelas
As informaes dos campos codBandeiraScope e codRedeScope podem ser encontradas nos campos
Bandeira e Rede respectivamente, do mdulo Administrador do Scope.
Dependendo do nmero de parcelas, a administradora financeira pode cobrar taxas diferentes. Por esse
motivo pode ser necessrio cadastrar mais de uma vez a mesma administradora no Protheus, porm
com taxas diferentes. Nesse caso, os campos qtdeparcde e qtdeparcate devem ser usados para indicar
qual a administradora financeira dever ser utilizada.
11
Boletim Tcnico
Exemplo de preenchimento:
INSERT INTO DPAdministracaoProtheus
(codBandeiraScope, codRedeScope, codAdministradoraIntegracao, qtdeparcde, qtdeparcate)
VALUES
(1, 102, '004', 1, 3)
Informaes Tcnicas
Funes Envolvidas
Sistemas Operacionais
Windows/Linux
12