Boletim Tcnico

Integrao Microsiga Protheus x SIAC

Produto : Microsiga Protheus Controle de Lojas verso 11

Chamado : TGYHOJ Data da publicao : 02/04/13

Pas(es) : Brasil Banco(s) de Dados : Todos

Aplicabilidade Template de Drogaria

Esta melhoria depende de execuo do update de base UPDINTSIAC, conforme Procedimentos

para Implementao.

Implementada melhoria no mdulo Controle de Lojas (SIGALOJA) com a disponibilizao da Integrao do Microsiga
Protheus com o SIAC - Sistemas Itautec de Automao Comercial, permitindo que Sistema Microsiga Protheus seja
responsvel por toda a gesto de retaguarda (controle de estoque, financeiro, contabilidade, emisso de notas fiscais,
oramentos) e o SIAC responsvel por toda gesto de PDVs. Essa integrao tem como foco o business de farmcias e
drogarias.

Para viabilizar a integrao do Microsiga Protheus X SIAC, disponibilizou-se as rotinas:

DP EmpFil x Lojax Loja SIAC (LJSIACDPLJ)

Para que a integrao do Microsiga Protheus x SIAC seja realizada como multi-empresa, disponibilizou-se a tabela De/Para,
que armazena o Cdigo do Grupo de Empresa, Cdigo da Filial, Loja SIAC e IP Web Services da instncia SIAC. O SIAC Store
no possui o conceito de multi empresa, ou seja, cada instalao representa uma nica empresa, sendo que cada instalao
suporta vrias lojas. Essa funcionalidade atende tanto o modelo Gesto de Empresa como o Clssico.

Para cada combinao de Grupo de Empresa + Empresa + Unidade de Negcio, temos uma nova instncia do SIAC. Cada
instncia do SIAC representa uma instalao nica, onde cada instncia possui seu prprio banco de dados, logo um nico
cadastro de produtos que utilizado por todas as lojas abaixo dessa instncia. Sendo assim, cada instncia possui um
endereo IP de Web Services, que ser usado pelo Microsiga Protheus para exportao do cadastro de Produtos.

Comparando as estruturas, uma empresa Protheus equivalente a uma instncia SIAC, logo as filiais so equivalentes s
lojas do SIAC. Portanto se tivermos um Grupo de Empresa Protheus, teremos uma instncia SIAC e consequentemente um
nico endereo IP de Web Services.

Os cdigos de loja SIAC podem se repetir, lembrando que cada instncia tratada de forma independente, ou seja, a Loja 1
da instncia A diferente da Loja 1 da instncia B.

Grupo de Cdigo Filial Instncia

Loja SIAC IP Web Services
Empresas EEUUFFFF SIAC

01 01010001 A 11 192.168.0.1:8080

02 01010001 B 21 192.168.0.2:8080

SIGALOJA Integrao Microsiga Protheus x SIAC 1

 Boletim Tcnico

Observe que temos dois grupos de empresas, ou seja, temos duas instncias SIAC.

Cdigo Filial Instnci Loja

Grupo de Empresas IP Web Services
EEUUFFFF a SIAC SIAC

01 01010001 A 11 192.168.0.1:8080

01 01010002 A 12 192.168.0.1:8080

Observe que houve alterao somente nos dgitos da filial, portanto se trata de lojas diferentes, onde no ser necessrio
um novo endereo de Web Services, pois as lojas esto abaixo de uma mesma instncia SIAC.

Exportao Produtos (LJTELASIAC)

Esta rotina permite exportar o Cadastro de Produtos e/ou a Tabela de Preos para o SIAC, para que posteriormente sejam
distribudos aos PDVs.

Os registros so enviados em lote, onde cada lote pode conter vrios produtos. Essa configurao permite controlar a
quantidade de dados que so enviados em uma transmisso, evitando problemas de timeout de Web Services ou at
mesmo sobrecarga de rede.

possvel que em uma nica exportao, seja exportado mais de um lote. Exemplo: cada lote formado por 10 produtos e
na rotina de exportao foram escolhidos 100 produto, nesse caso a rotina forma 10 lotes, cada um contendo 10 produtos.

Para o SIAC, o produto dividido em cinco estruturas:

Estrutura Abrangncia Descrio

PLUProdutos Instncia Informaes Gerais do Produto

PLUCdigos Instncia Cdigos de Barra (EAN-13)

PLUProdutoAssociado Instncia Produtos Associados

Tributao, permisso para aplicao de

PLUProdutosLoja Loja
desconto, digitao de preo

PLUPreoLoja Loja Preos e Datas de Vigncia

Por esse motivo temos duas opes de exportao:

Produto: So enviadas as cinco estruturas citadas acima.

Preo: So enviadas somente as estruturas PLUProdutosLoja e PLUPreosLoja, que so informaes distintas por loja.

Essa separao faz com que os recursos de sistema sejam aproveitados ao mximo, pois caso necessite atualizar os dados
que se referem a uma nica loja, no h necessidade de reenviar os dados referentes instncia, diminuindo o trfego de
rede e tambm o I/O de banco de dados.

Como demonstrado acima, existem estruturas que abrangem a instncia do SIAC e outras que abrangem somente a loja.
Portanto, o destino da exportao de produtos determinado pelo cadastro DePara EmpFil x Loja SIAC, onde cada
instncia e loja SIAC ser relacionado com um Grupo de Empresa e Filial Protheus.

Caso algum produto no seja validado ou ocorra alguma inconsistncia durante a exportao de produtos, a rotina ser
abortada e o lote corrente ser descartado, porm os lotes j exportados no sero descartados.

2 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Log Exp. Produtos (LJLOGSIACP)

Essa rotina permite visualizar todos os lotes, produtos contidos em cada lote e o status de exportao de cada lote.

As informaes recebidas so:

Cdigo Retorno: Cdigo numrico que representa o status da importao. Esse status referente gravao dos
produtos nas tabelas de integrao do SIAC, portanto no se trata da importao completa, pois para a importao
completa, o SIAC realiza outro processo, o qual o Microsiga Protheus no tem o resultado, sendo necessrio consultar
o status de importao diretamente no Sistema SIAC, atravs do ID Processo.
ID Processo: Cdigo que identifica a importao no Sistema SIAC, o mesmo relacionado com o nmero do lote. O ID
Processo s retornado quando a exportao bem sucedida. atravs do ID Processo que possibilita consultar o
Sistema SIAC, status da importao at a ltima etapa.

Fluxograma de Implantao

Os processos demonstrados no fluxograma, so necessrios para que a implantao seja realizada com sucesso. Lembrando
que o fluxograma foca nos processos realizados no Microsiga Protheus.

SIGALOJA Integrao Microsiga Protheus x SIAC 3

 Boletim Tcnico

Web Services responsveis pela recepo de consultas

consultaCliente
consultaPreVenda
executarBaixaPreVenda

Consulta Cliente

Na Integrao Protheus x SIAC, o Cadastro de Clientes ser mantido somente na retaguarda (Protheus).

Quando um ponto de venda solicitar informaes de um cliente, o mesmo solicita esses dados atravs de uma consulta
Web Service. A chave utilizada para consulta ser o CPF/CNPJ do cliente.

Caso o cliente seja localizado, a retaguarda envia todas as informaes requisitadas, caso contrrio informa ao ponto de
venda que o cliente no foi encontrado, ficando ao critrio do operador continuar a venda ou no.

Consulta Pr Venda (Oramento) :

Na integrao Protheus x SIAC, ser possvel realizar a consulta de oramentos feitos na retaguarda (Protheus). A chave
para consulta o nmero do oramento.

Seguem algumas particularidades referentes pr-venda.

Os descontos somente podem ser aplicados nos itens.

Vendas com Notas de Crdito (NCC) s podem ser realizadas atravs de oramentos.
No possvel escolher a forma de pagamento referente a cooperado, quando a venda for realizada atravs de um
oramento.
Quando um oramento for importado pelo PDV, no ser possvel adicionar mais itens.
Divergncia entre preos entre retaguarda e PDV:

Se o preo da retaguarda for menor que o preo do PDV, o PDV aplica um desconto automaticamente.
Se o preo da retaguarda for maior que o preo do PDV, o PDV no permite que a venda seja realizada.

Validaes:

Ao receber uma requisio, antes de retornar o oramento ao PDV, necessrio realizar as seguintes validaes:

Dt. Validade (L1_DTLIM) igual a data do dia (ddatabase).

Se os campos Srie (L1_SERIE) + Nota Fiscal (L1_DOC) + Nmero PDV (L1_PDV) esto vazios

Caso o oramento no seja validado, ao invs de retornar os dados do oramento, retornada uma mensagem de
inconsistncia.

Oramentos com Notas de Crdito ao Consumidor (NCC)

A integrao Protheus x SIAC permite utilizar NCC como forma de pagamento, porm obrigatrio o uso de um oramento.

Se a Integrao Protheus x SIAC estiver ativa (MV_SCINTEG), no momento de salvar um oramento, o Sistema permite que
uma NCC seja vinculada a ele. Para isso, devemos:

4 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

1. No Controle de Lojas (SIGALOJA) acesse Atualizaes / Atendimento / Venda Assistida (LOJA701).

2. No campo Cliente (L1_CLIENTE), informe um cliente que possua uma NCC pendente.

3. Clique na opo Detalhes e selecione a opo Pagamentos (F7).

O Sistema apresenta uma janela com as NCC disponveis para o cliente.

4. Selecione as NCC marcando o checkbox.

5. Pressione a tecla [F4] para salvar o oramento.

O vnculo entre oramento e NCC ser realizado atravs das tabelas: NCC Pendente (MDJ) e Itens da NCC Pendente (MDK).

A compensao da NCC realizada no momento que a venda for enviada a retaguarda;

Para o SIAC, a forma de pagamento equivalente a NCC chamada de Vale Troca;
Ao utilizar uma NCC como forma de pagamento, o valor utilizado da NCC dever ser o mesmo valor digitado pelo
operador;
Quando uma NCC for compensada, apagaremos os registros referentes a ela das tabelas MDJ e MDK.

Executar Baixa Pr-Venda (Oramento)

Quando um oramento for finalizado no PDV, o SIAC envia uma requisio em tempo real de modo que o mesmo no fique
disponvel para nenhum PDV, at que a venda do mesmo seja enviada a retaguarda. Se houver uma consulta pr-venda e
por algum motivo o cliente no finalizar o oramento, no alteramos o oramento.

Quando um oramento finalizado, alterado os seguintes campos:

Tipo Venda (L1_TIPO) = V

Srie (L1_SERIE) = TMP
Nota Fiscal (L1_DOC) = Contador de Ordem de Operao (COO)
Cd. Estao (L1_ESTACAO) = Nmero do Terminal SIAC
Emisso NF (L1_EMISNF) = Data de Emisso do Cupom Fiscal

Quando um oramento marcado como finalizado pelo PDV SIAC, na legenda da rotina Atendimento (LOJA701), ele ser
apresentado como finalizado. Portanto, este oramento no deve ser utilizado, sendo necessrio aguardar o SIAC enviar os
dados referentes a finalizao da venda.

SIGALOJA Integrao Microsiga Protheus x SIAC 5

 Boletim Tcnico

Fluxograma de uma venda realizada por oramento:

Web Services responsveis pela recepo de movimentos:

Os servios abaixo possuem o mesmo modelo de funcionamento:

enviarVenda
enviarRecebimento
enviarEstornoRecebimento
enviarRecargaCelular
enviarEntradaNumerario
enviarSangria
enviarReducaoZ

Caractersticas Comuns:

Os dados so enviados de forma assncrona. O SIAC Store possui um servio que ser responsvel pelo envio dos
movimentos a cada intervalo de tempo. O intervalo de tempo parametrizado no SIAC Store.
A cada requisio, ser enviado um lote de determinado movimento. Cada lote possui uma quantidade de
movimentos. A quantidade de mxima de movimentos por lote parametrizada no SIAC Store.
Cada lote pertencer a uma nica Loja SIAC, que relacionada a um Grupo de Empresa e Filial.
Pode haver situaes, onde determinado movimento precisar ser enviado retaguarda imediatamente, nesse caso o
movimento poder ser enviado manualmente atravs da aplicao.

6 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Fluxograma dos movimentos citados acima:

Enviar Venda

Esse mtodo responsvel pela recepo dos movimentos referentes s vendas realizadas no SIAC. Os movimentos
referentes as venda so:

Vendas Diretas Vendas realizadas diretamente no PDV, sem o uso de um oramento.

Vendas realizadas atravs de oramentos (pr-vendas) Oramentos finalizados no PDV, posteriormente so
enviados a retaguarda como uma venda. Para que a retaguarda possa finalizar a venda sobre um oramento,
necessrio que o mtodo ExecutarBaixaPreVenda tenha alterado o oramento, pois identificamos o oramento
atravs da chave.
Cancelamento Os cancelamentos so enviados a retaguarda atravs desse mtodo, a diferena entre uma venda e
um cancelamento o valor de um atributo.

SIGALOJA Integrao Microsiga Protheus x SIAC 7

 Boletim Tcnico

Fluxograma macro do mtodo enviar Venda:

Enviar Recebimento

Esse mtodo responsvel pela recepo dos movimentos referentes a recebimentos de correspondentes bancrios.
Seguem algumas premissas quanto aos recebimentos:

Somente recebimentos de ttulos de CORBAN (Correspondentes Bancrios) esto previstos na integrao.

A Integrao preparada para um nico recebimento por cupom, mesmo o SIAC permitindo dois ou mais recebimentos.

Para a retaguarda, um recebimento somente ir gerar um ttulo a receber j compensado. A natureza do ttulo gerado ser
FI. A identificao de um recebimento pode ser feito pelo campo Histrico (E1_HIST) = CORBAN .

Enviar Recarga Celular

Esse mtodo responsvel pela recepo dos movimentos referentes recarga de celulares. Abaixo seguem algumas
premissas quanto recarga de celulares.

Para a retaguarda, um recebimento somente ir gerar um ttulo a receber j compensado. A natureza do ttulo gerado ser
FI. A identificao de um recebimento pode ser feito pelo campo Histrico (E1_HIST) = RECCEL .

8 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

O fluxograma abaixo usado pelas rotinas enviarRecebimento e enviarRecargaCelular:

Enviar Estorno Recebimento

Diferentemente da venda, o estorno de recebimento possui seu mtodo prprio. A chave utilizada para estorno do
recebimento bancrio o valor do campo NSU-SiTef (E1_DOCTEF).

Para as formas de pagamento que geram novos ttulos financeiros (carto de crdito por exemplo), o Sistema utiliza as
tabelas Log de Ttulos Baixados (MDM) e Log de Ttulos Gerados (MDN) para localizar os ttulos a serem excludos e
estornados.

Enviar Entrada Numerrio

Esse mtodo responsvel pela recepo dos movimentos referentes Fundo de Troco e Reforos. A retaguarda somente
controla a movimentao financeira, ou seja, todo o controle de abertura e fechamento de caixas dever ser realizado
atravs do SIAC Store.

Entrada de Troco Quando um operador SIAC realiza uma abertura de caixa em um determinado PDV e efetua uma
entrada de troco, o SIAC envia essa informao.

SIGALOJA Integrao Microsiga Protheus x SIAC 9

 Boletim Tcnico

Suprimentos Durante o perodo que um caixa estiver aberto, podem ser realizados diversos suprimentos. Nesse
caso, os suprimentos no so enviados a retaguarda separadamente, ao invs disso, eles so aglutinados e somente
no fechamento do caixa que ele ser enviado.
O caixa de origem configurado atravs do parmetro MV_CXLOJA.

Enviar Sangria

Esse mtodo responsvel pela recepo dos movimentos referentes Sangria (Fechamento do Caixa). Assim como o
mtodo EnviarEntradaNumerrio, a retaguarda somente controla a movimentao financeira, ou seja, todo o controle de
abertura e fechamento de caixas deve ser realizado atravs do SIAC Store.

O caixa de destino configurado atravs do parmetro MV_CXLOJA.

Enviar ReducaoZ

Esse mtodo responsvel pela recepo dos movimentos referentes Reduo Z. Diferentemente do Protheus, o SIAC se
baseia nos dados do movimento do dia e no nos dados que so retornados pelo ECF (Emissor de Cupom Fiscal). Por esse
motivo, pode ser que em uma determinada situao, um registro de reduo Z que j tenha sido enviado retaguarda,
necessite de uma correo. Quando a correo for realizada, o registro deve ser enviado retaguarda, que apaga o registro
anterior e grava o registro corrigido.

Registro de Log

Para a Integrao Protheus x SIAC, existem dois logs:

Processamento: Habilitado atravs do parmetro MV_SCLOG. Esse log registra todo o processamento executado nas
rotinas. O nome do arquivo composto por siac_ddmmaaaa.log e armazenado em RootPath\SIAC_LOG\.
Esse log til para identificao de no conformidades que ocorrem no processamento.

XML: Para toda requisio enviada ao Protheus atravs dos servios disponibilizados pelo Web Services, gravada um
arquivo XML com os dados da requisio. Esse arquivo armazenado na pasta RootPath\SIAC_XML\. O nome do
arquivo XML composto por nome_do_mtodo_ddmmaaaa.xml. Esse log til para analisar os dados que foram
enviados em determinada requisio.

PROCEDIMENTOS PARA IMPLEMENTAO

Antes de executar o UPDINTSIAC imprescindvel:

a) Realizar o backup da base de dados do produto que ser executado o UPDINTSIAC (diretrio
\PROTHEUS11_DATA\DATA) e dos dicionrios de dados SXs (diretrio \PROTHEUS11_DATA\SYSTEM).
b) Os diretrios acima mencionados correspondem instalao padro do Protheus, portanto, devem ser alterados
conforme o produto instalado na empresa.
c) Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usurio deve estar utilizando o sistema.

10 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

d) Se os dicionrios de dados possurem ndices personalizados (criados pelo usurio), antes de executar o
compatibilizador, certifique-se de que esto identificados pelo nickname. Caso o compatibilizador necessite criar
ndices, ir adicion-los a partir da ordem original instalada pelo Protheus, o que poder sobrescrever ndices
personalizados, caso no estejam identificados pelo nickname.
e) O compatibilizador deve ser executado com a Integridade Referencial desativada*.

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 estar(ro) 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 Smart Client, digite U_UPDINTSIAC no campo Programa Inicial.

Para a correta atualizao do dicionrio de dados, certifique-se que a data do UPDINTSIAC seja igual ou superior
a 30/11/12.

SIGALOJA Integrao Microsiga Protheus x SIAC 11

 Boletim Tcnico

Ao aplicar o update UPDINTSIAC, o sistema verifica a estrutura das tabelas MBK e MBM.
Se as tabelas no estiverem com as estruturas atualizadas, o sistema informa que elas sero removidas, para que
o update possa cri-las novamente com base na nova estrutura.
Caso haja dados nessas tabelas, recomendamos que seja feito uma cpia, pois elas sero excludas do banco de
dados. A cpia no poder ser restaurada nessas tabelas, j que as suas estruturas foram alteradas.
2. Clique em Ok para continuar.

3. Aps a confirmao exibida uma tela para a seleo da empresa em que o dicionrio de dados ser modificado.
Selecione a empresa desejada e confirme .

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,
conforme mensagem explicativa apresentada na tela.

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

7. Clique em Gravar para salvar o histrico (log) apresentado.

8. Clique em Ok para encerrar o processamento.

ATUALIZAES DO COMPATIBILIZADOR
1. Criao de Perguntas no arquivo SX1 Cadastro de Perguntes:

Pergunte Do Produto

Grupo LJTELASIAC

Ordem 01

Tipo C

Tamanho 15

Objeto Edit

Consulta Padro Produto

Pergunte At o Produto

Grupo LJTELASIAC

Ordem 02

Tipo C

Tamanho 15

Objeto Edit

Consulta Padro Produto

12 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Pergunte Importar

Grupo LJTELASIAC

Ordem 03

Tipo N

Tamanho 1

Objeto Combo

Item 1 Produto

Item 2 Preo

2. Criao de Tabelas no arquivo SX2 Tabelas

Chave MBK

Descrio Log Exp. Produtos (SIAC)

Modo E

X2_Unico MBK_FILIAL+MBK_IDLOTE+MBK_CHAVE

ModoEmp E

ModoUn E

Chave MBM

Descrio DePara EmpFil x Loja (SIAC)

Modo C

X2_Unico MBM_FILIAL+MBM_CODEMP+MBM_CODFIL

ModoEmp C

ModoUn C

3. Criao de Campos no arquivo SX3 Campos:

Tabela MBK Log Exportao SIAC

Campo MBK_FILIAL

Tipo C

Tamanho FwSizeFilial()

Decimal 0

Formato

Ttulo Filial

Descrio Filial do Sistema

Nvel 0

Grupo SXG 033

SIGALOJA Integrao Microsiga Protheus x SIAC 13

 Boletim Tcnico

Campo MBK_IDLOTE

Tipo C

Tamanho 6

Decimal 0

Formato 999999

Contexto Real

Visualizar Visualizar

Ttulo ID Lote

Descrio Cdigo Ident. Lote

Nvel 0

Usado Sim

Obrigatrio No

Browse Sim

Help Cdigo de Identificao do Lote.

Campo MBK_CHAVE

Tipo C

Tamanho 40

Decimal 0

Formato @!

Contexto Real

Visualizar Visualizar

Ttulo Chave

Descrio Item do Lote (Fil+Cod)

Nvel 0

Usado Sim

Obrigatrio No

Browse Sim

Help Item do Lote. Composto por Filial + Codigo do Produto.

Campo MBK_CODRET

Tipo C

Tamanho 3

Decimal 0

14 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Formato 999

Contexto Real

Visualizar Visualizar

Ttulo Cd. Retorno

Descrio Cdigo de Retorno

Nvel 0

Usado Sim

Obrigatrio No

Browse Sim

Help Cdigo de Status da exportao retornado pelo SIAC.

Campo MBK_IDPROC

Tipo C

Tamanho 10

Decimal 0

Formato 9999999999

Contexto Real

Visualizar Visualizar

Ttulo ID Processo

Descrio Cod ident. Processo

Nvel 0

Usado Sim

Obrigatrio No

Browse Sim

Help Cdigo de Identificao da Importao retornado pelo SIAC.

Campo MBK_LJDEST

Tipo C

Tamanho 4

Decimal 0

Formato 9999

Contexto Real

Visualizar Visualizar

Ttulo Loja Destino

Descrio Loja Destino Exp Produtos

SIGALOJA Integrao Microsiga Protheus x SIAC 15

 Boletim Tcnico

Nvel 0

Usado Sim

Obrigatrio No

Browse Sim

Help Cdigo da Loja SIAC a qual os produtos sero enviados

Tabela MBM DePara EmpFil x Loja (SIAC)

Campo MBM_FILIAL

Tipo C

Tamanho FwSizeFilial()

Decimal 0

Formato

Ttulo Filial

Descrio Filial do Sistema

Nvel 0

Grupo SXG 033

Campo MBM_CODEMP

Tipo C

Tamanho 2

Decimal 0

Formato @!

Contexto Real

Visualizar Alterar

Ttulo Cod Grp Emp

Descrio Codigo Grupo Empresa

Nvel 0

Usado Sim

Obrigatrio Sim

Browse Sim

Relao CEMPANT

Val. Sistema Ascan( FwLoadSM0(), {|x| x[1] == M->MBM_CODEMP} ) > 0

Help Informe o cdigo do Grupo de Empresa do Protheus.

16 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Campo MBM_DSCEMP

Tipo C

Tamanho 13

Decimal 0

Formato @!

Contexto Virtual

Propriedade Visualizar

Ttulo Dsc Grp Emp

Descrio Descrio Grupo Empresa

Nvel 0

Usado Sim

Obrigatrio No

Browse Sim

Relao FwGrpName(M->MBM_CODEMP)

Inic. Browse FwGrpName(MBM->MBM_CODEMP)

Help Descrio do Grupo de Empresa. Informao retirada do sigamat.emp.

Campo MBM_CODFIL

Tipo C

Tamanho FwSizeFilial()

Decimal 0

Formato @!

Ttulo Cd. Filial

Descrio Cdigo Filial

Nvel 0

Usado Sim

Obrigatrio Sim

Browse Sim

Relao CFILANT

Val. Sistema FwFilExist(M->MBM_CODEMP, M->MBM_CODFIL)

Grupo SXG 033

Help Informe o cdigo da Filal do Protheus.

Campo MBM_DSCFIL

Tipo C

SIGALOJA Integrao Microsiga Protheus x SIAC 17

 Boletim Tcnico

Tamanho 15

Decimal 0

Formato @!

Contexto Virtual

Propriedade Visualizar

Ttulo Desc. Filial

Descrio Descrio da Filial

Nvel 0

Usado Sim

Obrigatrio No

Browse Sim

Relao FwFilialName(M->MBM_CODEMP, M->MBM_CODFIL)

Inic. Browse FwFilialName(MBM->MBM_CODEMP, MBM->MBM_CODFIL)

Help Nome da Filial do Protheus. Informao retirada do sigamat.emp.

Campo MBM_LJSIAC

Tipo C

Tamanho 4

Decimal 0

Formato 9999

Ttulo Loja SIAC

Descrio Codigo Loja SIAC

Nvel 0

Usado Sim

Obrigatrio Sim

Browse Sim

Help Cdigo da Loja SIAC. Preencher sem utilizar 0(zero) a esquerda.

Campo MBM_IPWS

Tipo C

Tamanho 21

Decimal 0

Formato @!

Ttulo IP WS SIAC

Descrio IP Web Services SIAC

18 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Nvel 0

Usado Sim

Obrigatrio Sim

Browse Sim

Informe o IP:Port do WebServices SIAC. Cada Grupo de

Help Empresa/Empresa/Unidade de Negcio deve estar relacionada uma
instncia do SIAC. Ex: 127.0.0.1:8080

Tabela SLG Estaes:

Campo LG_CRO

Tipo C

Tamanho 6

Decimal 0

Formato 999999

Ttulo CRO

Descrio Cont. Renicio Operao

Nvel 0

Usado Sim

Obrigatrio No

Browse No

Help Contador de Renicio de Operao do ECF

Tabela SL6 Reserva de Serie por Estao:

Campo L6_CRO

Tipo C

Tamanho 6

Decimal 0

Formato 999999

Ttulo CRO

Descrio Cont. Renicio Operao

Nvel 0

Usado Sim

Obrigatrio No

Browse No

Help Contador de Renicio de Operao do ECF

SIGALOJA Integrao Microsiga Protheus x SIAC 19

 Boletim Tcnico

Tabela MDK Itens da Ncc Pendente

Campo MDK_NUMORC

Tipo C

Tamanho 6

Decimal 0

Formato 999999

Ttulo Oramento

Descrio Num. do Oramento

Nvel 0

Usado Sim

Obrigatrio No

Browse No

Help Nmero do Oramento

Tabela SLF Reserva de Serie por Estao:

Campo LF_CODSIAC

Tipo C

Tamanho 6

Decimal 0

Formato 999999

Ttulo Cd.Op. SIAC

Descrio Cdigo Operador SIAC

Nvel 0

Usado Sim

Obrigatrio No

Browse No

Help Cdigo de Operador SIAC. Deve ser cadastrado com 0(zero) a esquerda.

4. Tabela de ndices no arquivo SIX ndices:

ndice MBK

Ordem 1

Chave MBK_FILIAL+MBK_IDLOTE+MBK_CHAVE

Descrio Cdigo Ident. Lote + Item do Lote (Fil+Cod)

Proprietrio S

20 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

ndice MBM

Ordem 1

Chave MBM_FILIAL+MBM_CODEMP+MBM_CODFIL

Descrio Cod Grp Emp + Cod Filial

Proprietrio S

ndice SL1

Ordem F

Chave L1_FILIAL+L1_ESTACAO+L1_DOC+DTOS(L1_EMISNF)

Descrio Estao + Documento + Dt.Emisso NF

Proprietrio S

ndice SL6

Ordem 5

Chave L6_FILIAL+L6_ESTACAO+L6_CRO

Descrio Estacao + CRO

Nickname SIAC_CRO

Proprietrio S

ndice SLF

Ordem 2

Chave LF_FILIAL+LF_CODSIAC

Descrio Cod. Op. SIAC

Proprietrio S

ndice MDJ

Ordem 3

Chave MDJ_FILIAL+MDJ_NUMORC

Descrio Num. do Oramento

Proprietrio S

ndice MDK

Ordem 2

Chave MDK_FILIAL+MDK_NUMORC

SIGALOJA Integrao Microsiga Protheus x SIAC 21

 Boletim Tcnico

Descrio Num. do Oramento

Proprietrio S

ndice SE5

Ordem I

Chave E5_FILIAL+E5_PREFIXO+E5_NUMERO+E5_BANCO+E5_MOEDA

Descrio Prefixo + Numero + Banco + Moeda

Proprietrio S

5. Criao de Parmetros no arquivo SX6 Parmetros:

Nome MV_SCINTEG

Tipo L

Cont.Por .F.

Usado na Integrao Protheus x SIAC. Habilita a integrao Protheus

Descrio
x SIAC, quando seu valor Igual a .T.

Nome MV_SCPRDLT

Tipo N

Valor 100

Usado na Integrao Protheus x SIAC. Determina a quantidade de

Descrio
produtos por lote na exportao de produtos.

Nome MV_SCTMCOD

Tipo N

Valor 7

Usado na Integrao Protheus x SIAC. Determina a qtd. de dgitos do

Descrio Cod. Produtos. necessrio um valor fixo, pois o SIAC no utiliza 0 a
esquerda.

Nome MV_SCUSR

Tipo C

Valor admin

Usado na Integrao Protheus x SIAC. Usurio para autenticao no

Descrio
Web Services SIAC.

Nome MV_SCPAS

Tipo C

22 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Valor admin

Usado na Integrao Protheus x SIAC. Senha do usurio para

Descrio
autenticao no Web Services SIAC.

Nome MV_SCLOG

Tipo L

Valor .F.

Usado na Integrao Protheus x SIAC. Habilita o Log de

Descrio
Processamento. O log ser salvo no caminho RoothPath\SIAC_LOG\.

6. Criao de Gatilhos no arquivo SX7 Gatilhos:

Tabela MBM DePara EmpFil x Loja (SIAC):

Campo MBM_CODEMP

Sequncia 001

Regra FwGrpName(M->MBM_CODEMP)

Campo Domnio MBM_DSCEMP

Tipo P

Proprietrio S

Campo MBM_CODFIL

Sequncia 001

Regra FwFilialName(M->MBM_CODEMP, M->MBM_CODFIL)

Campo Domnio MBM_DSCFIL

Tipo P

Proprietrio S

O tamanho dos campos que possuem grupo podem variar conforme ambiente em uso.

PROCEDIMENTOS PARA CONFIGURAO

1. No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Informe as novas opes de menu do Controle de
Lojas, conforme instrues a seguir:

Menu SIGALOJA

Submenu Miscelnea / Protheus x SIAC

Nome da Rotina Exportao Produtos

SIGALOJA Integrao Microsiga Protheus x SIAC 23

 Boletim Tcnico

Programa LJTELASIAC

Mdulo Controle de Lojas

Tipo Funo Protheus

Tabelas MBK e MBM

Menu SIGALOJA

Submenu Miscelnea / Protheus x SIAC

Nome da Rotina Log Exp. Produtos

Programa LJLOGSIACP

Mdulo Controle de Lojas

Tipo Funo Protheus

Tabelas MBK

Menu SIGALOJA

Submenu Miscelnea / Protheus x SIAC

Nome da Rotina DP EmpFil x Lojax Loja SIAC

Programa LJSIACDPLJ

Mdulo Controle de Lojas

Tipo Funo Protheus

Tabelas MBM

PROCEDIMENTOS PARA UTILIZAO

Para efetuar a configurao do PDV SIAC e mdulo Integrador, necessrio contatar a equipe de suporte da Itautec
referente Automao Comercial (suporteatc@itautec.com.br).

Pr-requisitos para Integrao Protheus x SIAC:

1. Configurar o PDV SIAC e mdulo Integrador.

2. Possuir Licena especfica para Integrao Protheus x SIAC.

3. Possuir o Template de Drogaria.

4. No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Configure os parmetros conforme as

instrues:

24 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Parmetro Valor Descrio

Habilita a integrao Protheus x SIAC. Se esse

MV_SCINTEG .T. parmetro no estiver ativo, nenhum servio do Web
Services processa a requisio.

Habilita a gravao do log de processamento. Todos os

A servios disponibilizados no web services e a rotina de
MV_SCLOG
decidir exportao de produtos so registradas no log. Os logs
so gravados na pasta RootPath\SIAC_LOG\ .
A Quantidade de produtos por lote. Usado na rotina de
MV_SCPRDLT
decidir exportao de produtos.

A
MV_SCTMCOD Quantidade de dgitos do cdigo de produto.
decidir

Em Usurio SIAC usado na autenticao do Web Services

MV_SCUSR
branco SIAC. Atualmente no necessrio a autenticao.
Senha do usurio SIAC usado na autenticao do Web
Em
MV_SCPAS Services SIAC. Atualmente no necessrio a
branco
autenticao.

DP EmpFil x Lojax Loja SIAC (LJSIACDPLJ):

1. No Controle de Lojas (SIGALOJA) acesse Atualizaes/Miscelnea/Protheus x SIAC/DP EmpFil x Lojax Loja SIAC
(LJSIACDPLJ).

Caso a tabela MBM esteja vazia, o Sistema apresenta as perguntas:

Realizar o preenchimento automtico dos campos Cod Grp Emp e Cod Filial?
Caso positivo, Cadastrar todos os Grupos de Empresas ou somente o atual?

2. Caso utilize o preenchimento automtico, posicione o cursor no registro desejado e clique em Alterar.

3. Preencha os campos: Loja SIAC e IP Web Services SIAC.

4. Caso contrrio, clique em Incluir e preencha os campos:

Cdigo Grupo de Empresa (MBK_CODEMP) - Caso a tabela no seja compartilhada para o Grupo de Empresas, temos
o mesmo cdigo de grupo de empresa para toda a tabela. O contedo desse campo deve ser igual ao campo
M0_CODIGO.
Cdigo Filial (MBM_CODFIL) No preenchimento desse campo, necessrio considerar todos os espaos em branco,
esse contedo deve ser igual ao do campo M0_CODFIL. Caso utilize Gesto de Empresa, necessrio preencher esse
campo com o layout completo. Ex: EEUUFFFF 01010001.
Loja SIAC (MBM_LJSIAC) Informe a Loja SIAC que corresponde ao Grupo de Empresa e Filial do Microsiga
Protheus.
IP Web Services SIAC (MBM_IPWS) Informe o IP e porta do Web Services SIAC que corresponde ao Grupo de
Empresa e Filial do Microsiga Protheus.

5. Confira os dados e confirme.

SIGALOJA Integrao Microsiga Protheus x SIAC 25

 Boletim Tcnico

Validaes efetuadas pelo sistema:

Cdigo Grupo de Empresa - Verifica se o Grupo de Empresas existe no Cadastro de Empresas (SIGAMAT).

Cdigo Filial - Verifica se a Filial pertence ao Grupo de Empresas informado.

Confirmao de Incluso ou Alterao - Verifica se os valores dos campos Cdigo Grupo de Empresa e Cdigo Filial,
no existem na tabela

Regras de preenchimento:

O campo Loja SIAC deve ser preenchido sem zeros a esquerda.

Legendas:

Amarelo - No Configurado: Os campos Loja SIAC ou IP WS SIAC no foram preenchidos.

Verde - Configurado: Todos os campos foram preenchidos.

Preenchimento Automtico:

Para facilitar o cadastro da tabela De/Para, disponibilizou-se uma forma automtica para preenchimento, sendo que somente
os campos Loja SIAC e IP Web Services devem ser preenchidos manualmente. Com isso basta selecionar o registro e alter-lo
para complementar as informaes.

Premissa: Para que seja realizado o preenchimento automtico, necessrio estar vazia ao acessar a rotina.

Dessa forma o Sistema realiza as seguintes perguntas:

Realizar o preenchimento automtico dos campos Cod Grp Emp e Cod Filial?

Caso positivo, Utilizar todos os Grupos de Empresas ou somente o atual?

Caso queira que o Sistema preencha a tabela, porm existem registros na mesma, faa um backup da tabela e depois a drope,
aps isso, acesse a rotina e responda as perguntas feitas acima.

Seguem alguns exemplos de preenchimento com diversas situaes, desde o modelo Clssico at o modelo Gesto de
Empresas:

Clssico:

Cod Grp Emp Cod Filial Loja SIAC IP WS SIAC

01 01 11 192.168.0.1:8080

01 02 12 192.168.0.1:8080

Observe que temos um grupo de empresa e duas filiais, logo teremos duas lojas SIAC e um nico
IP Web Services SIAC, pois o grupo de empresa o mesmo.

Cod Grp Emp Cod Filial Loja SIAC IP WS SIAC

01 01 11 192.168.0.1:8080

02 01 12 192.168.0.2:8080

26 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Agora temos dois grupos de empresas, observe que temos dois IP Web Services distintos, cada um representa uma
instncia do SIAC.

Gesto de Empresa:

Cod Filial
Cod Grp Emp Loja SIAC IP WS SIAC
EEUUFF

01 010101 1111 192.168.0.1:8080

01 010102 1112 192.168.0.1:8080

Devido a alterao dos dgitos referentes a Filial, temos uma nica instncia do SIAC.

Cod Filial
Cod Grp Emp Loja SIAC IP WS SIAC
EEUUFF

01 010101 1111 192.168.0.1:8080

01 020101 1211 192.168.0.2:8080

Devido a alterao dos dgitos referentes a Empresa, temos mais uma instncia do SIAC.

Cod Filial
Cod Grp Emp Loja SIAC IP WS SIAC
EEUUFF

01 010101 1111 192.168.0.1:8080

01 010201 1121 192.168.0.2:8080

Alterando somente os dgitos referentes a Unidade de Negcio, temos uma nova instncia do SIAC.

Cod Filial
Cod Grp Emp Loja SIAC IP WS SIAC
EEUUFF

01 010101 1111 192.168.0.1:8080

02 010101 2111 192.168.0.2:8080

Ao alterar o Grupo de Empresa, temos mais uma instncia do SIAC.

Exportao Produtos (LJTELASIAC)

Pr-Requisitos para Exportao de Produtos:

1. No Configurador (SIGACFG) acesse Ambientes/Cadastro/Menu (CFGX013). Configure os parmetros conforme as

instrues:

MV_SCPRDLT
MV_SCTMCOD
MV_SCUSR
MV_SCPAS

SIGALOJA Integrao Microsiga Protheus x SIAC 27

 Boletim Tcnico

Cadastro de Produtos:

1. No Controle de Lojas (SIGALOJA) acesse Atualizaes / Cadastros / Produtos (LOJA110).

2. Clique em Incluir e cadastre um produto, preenchendo os campos abaixo.

Todos os campos citados, se tornam necessrios para a Integrao Protheus x SIAC.

Cdigo (B1_COD)
Somente dgitos numricos devem ser usados, pois o cdigo de produto para o SIAC numrico, ou seja, o cdigo de
produto 0000001 equivale a 1.
A quantidade de dgitos deve ser igual ao valor do parmetro MV_SCTMCOD.
Setor (B1_SETOR)
Obter os cdigos no cadastro de estrutura mercadolgica do SIAC.
Cadastrar os cdigos na tabela SX5/75.
Somente nmeros podem ser usados.
Descrio (B1_DESC)
Descrio Embalagem: 11 primeiros dgitos do campo Descrio.
Descrio Resumida: 20 primeiros dgitos do campo Descrio.
Descrio Produto: 40 primeiros dgitos do campo Descrio.
Unidade (B1_UM)
A unidade de medida deve ser cadastrada no SIAC Store.
Cod. Barras (B1_CODBAR)
Vazio ou com cdigo EAN-13 vlido.
Preo Venda 1 (B0_PRV1)
possvel utilizar Preo Venda 1 at Preo Venda 9. Verificar o tpico Tabela de Preos x Preo e Data de Vigncia.
Promoo 1 (B0_DATA1)
possvel utilizar Promoo 1 at Promoo 9.
Verifique o tpico Tabela de Preos x Preo e Data de Vigncia.

Preencha os campos abaixo conforme orientao dos helps de campo:

Aliq. Reduo (B0_ALIQRED)

Prop. ou Terc . (B1_IPPT)

Perc. PIS (B1_PPIS)

Perc. Cofins (B1_PCOFINS)

Origem (B1_ORIGEM)

Pos. IPI/NCM (B1_POSIPI)

Bloq. de Tela (B1_MSBLQL)

28 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

3. Confira os dados e Confirme.

Cdigos de Barra:

Se o produto utilizar cdigos de barra, certifique-se que o mesmo um cdigo EAN-13 vlido. Isso porque o SIAC valida o
cdigo de barras ao importar o produto. Se o produto possuir somente um cdigo de barra, o mesmo deve ser cadastrado
na tabela SB1 Descrio Genrica do Produto, campo Cd.Barras (B1_CODBAR). J se o produto possuir mais de um
cdigo de barras, os demais cdigos devem ser cadastrados em:

1. No Controle de Lojas (SIGALOJA), acesse Atualizaes/Cadastros/Cdigos de Barras (LOJA210).

2. Clique em Incluir e preencha os campos:

Cdigo Barra (LK_CODBAR): Informe o cdigo EAN-13 do produto.

Produto (LK_CODIGO): informe o cdigo do produto.
Quantidade (LK_QUANT) : No precisa ser informado.

3. Confira dos dados e confirme.

Produtos Associados:

So produtos que so vendidos em conjunto. Segue abaixo suas caractersticas:

Vendidos somente em par;

Ambos os produtos no podem ser vendidos separadamente;
O produto principal pode estar associado somente a um produto;
O produto associado no pode ser um produto que j possua uma associao;
Somente o produto principal deve ser utilizado em um oramento, pois quando o SIAC realizar a importao, ele
identificar que o produto em questo, possui um produto associado, sendo assim, ele o lanar automaticamente.

Exemplo:
Cdigo Descrio Tipo

0000001 Aplicao de injeo intravenosa Principal

0000002 Seringa descartvel com agulha 5ml Associado

Para cadastrar um produto associado:

1. No Call Center (SIGATMK), acesse Atualizaes / Televendas / Acessrios (TMKA030).

2. Clique em Incluir e preencha os campos:

Produto (UG_PRODUTO) : Informe o cdigo do produto principal.

Acessrio (U1_ACESSOR): Informe o cdigo do produto que ser associado ao produto principal.

3. Confira dos dados e confirme.

O valor do parmetro MV_LOJKIT deve ser .F.

SIGALOJA Integrao Microsiga Protheus x SIAC 29

 Boletim Tcnico

Tabela de Preos x Preo e Data de Vigncia

Para a Integrao Protheus x SIAC, necessrio utilizar a tabela (SB0) como tabela de preos. Na exportao do produto,
deve ser enviado os pares de campo Preo Venda (B0_PRVx) e Promocox (B0_DATAx), onde x um valor entre 1 e 9. O
SIAC trabalha com o conceito de Preo e Data de Vigncia, onde o preo enviado (B0_PRVx) entra em vigncia a partir da
data (B0_DATAx).

Exemplo:
Cdigo Preo Venda 1 Promoo 1

0000001 R$ 1,00 01/01/2011

Caso tenha um preo cadastrado Preo Venda (B0_PRVX) e no tenha uma data cadastrada Promoo (B0_DATAX) ou vice-
versa, ambos os valores no so enviados.
Os campos Preo Venda1 (B0_PRV1) e Promoo1 (B0_DATA1) so obrigatrios para que o produto seja exportado.

Informaes distintas por filial:

Se as informaes abaixo forem distintas por filial, ser necessrio utilizar a rotina Indicador Produtos (MATA018), para
complementar o cadastro de produtos, utilizando a tabela Indicador de Produtos (SBZ). A tabela SBZ deve estar em modo
exclusivo.

Ttulo Campo da tabela SB1 Campo da tabela SBZ

TS Padro B1_TS BZ_TS

Aliq. ICMS B1_PICM BZ_PICM

Aliq. ISS B1_ALIQISS BZ_ALIQISS

Solid. Sada B1_PICMRET BZ_PICMRET

Solid. Entr. B1_PICMENT BZ_PICMENT

As informaes citadas acima so utilizadas para obteno da situao tributria e alquota utilizada pelo produto.

Para que o Sistema obtenha esses dados da tabela Indicadores de Produtos (SBZ), o campo TS_Padro (BZ_TS) deve estar
preenchido. Se TS_Padro (BZ_TS) no estiver preenchido, ele passa a utilizar os dados da tabela Descrio Genrica do
Produto (SB1). Se o campo TS_Padro (B1_TS) no estiver preenchido, a TES utilizada ser o valor do parmetro
MV_TESSAI.

Para cadastrar o produto, usando Indicador de Produto:

1. No Faturamento (SIGAFAT) acesse Atualizaes / Cadastros / Indicadores de Produtos (MATA018).

2. Clique em Incluir.

3. No campo Cdigo (BZ_COD), digite o cdigo de um produto que j esteja cadastrado.

4. Preencha os campos citados no tpico acima, conforme orientao dos helps de campo.

5. Confira os dados e confirme.

30 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Tributao e Alquotas

Para definio da Situao Tributria e Alquota do produto, o Sistema utiliza o fluxograma abaixo. Sendo que alm da
configurao do TES e do produto, necessrio que se configure a tabela DPTributacaoProtheus do banco de dados do
mdulo de Integrao.

SIGALOJA Integrao Microsiga Protheus x SIAC 31

 Boletim Tcnico

Aps efetuar o cadastro dos TES e dos produtos, necessrio que verifique todas as situaes tributrias e alquotas
envolvidas, pois essas informaes devem estar cadastradas na tabela DPTributacaoProtheus do banco de dados do
mdulo de Integrao, antes que a exportao seja realizada.

Exemplo:
Cdigo Produto TES Situao Tributria (descritivo) Loja SIAC Alquota

0000001 501 ICMS Integral 1 18

No exemplo acima, o codTributacaoExterna enviado ao SIAC : Loja SIAC.TES que resulta em 1.501 e o percImposto
18. Na tabela DPTributacaoProtheus, necessrio que exista um registro com essas informaes para que seja relacionado
ao atributo idTributacao, que cdigo utilizado pelo SIAC para controle da parte tributria.

Exemplo de um registro da tabela DPTributacaoProtheus:

codTributacaoExterna percImposto idTributacao

1.501 18 1

Destino da Exportao:

Com o cadastro DePara EmpFil x Loja(SIAC) preenchido adequadamente, possvel determinar o destino da exportao.
Para isso, deve-se estar logado no Grupo de Empresa e Filial correspondente a Loja SIAC.

Exemplo:
Grupo de Empresa Filial Loja SIAC IP Web Service SIAC

01 01 11 192.168.0.1:8080

02 01 21 192.168.0.2:8080

Para exportar para a loja 11, necessrio que o logon seja feito no Grupo de Empresa 99 / Filial 01.

32 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

Para exportar para a loja 21, necessrio que o logon seja feito no Grupo de Empresa 99 / Filial 02.

Exportao de Produtos (LJTELASIAC):

Aps efetuar os procedimentos de todos os pr-requisitos, necessrio efetuar a exportao de produtos para o SIAC:

1. No Controle de Lojas (SIGALOJA) acesse Atualizaes / Miscelnea / Protheus x SIAC / Exportao de Produtos:

2. Clique em Parmetros e configure-os conforme as opes:

Do Produto: Define o primeiro produto da faixa a ser exportado.

At Produto: Define o ultimo produto da faixa a ser exportado.
Importar: Define a opo de exportao (Produto ou Preo).

3. Confira dos dados e confirme.

Log Exp. Produtos (LJLOGSIACP):

Pr-Requisito para Log de Exportao de Produtos:

Ter executado pelo menos uma vez a rotina Exportao Produtos.

1. No Controle de Lojas (SIGALOJA) acesse Atualizaes/Miscelnea/Protheus x SIAC/Log Exp. Produtos (LJLOGSIACP).

O Sistema apresenta um mBrowse com as seguintes informaes:

ID Lote (MBK_IDLOTE) - Cdigo da Identificao do Lote.

Chave (MBK_CHAVE) - Valor de Filial + Produto de cada produto.
Cd. Retorno (MBK_CODRET) - Cdigo de Status retornado pelo mdulo integrador.
ID Processo (MBK_IDPROC) - Cdigo de Importao retornado pelo mdulo integrador.
Loja Destino (MBK_LJDEST) - Cdigo da Loja a qual os produtos foram enviados.

2. Confira dos dados e confirme.

Segue abaixo os possveis cdigos de status da exportao e as possveis solues: retornados pelo Web Services SIAC e
valores do campo Cd.Retorno (MBK_CODRET).

Cdigo
Mensagem Descrio
Status

0 Importado com Sucesso Exportao realizada com sucesso

Ocorreu algum problema na execuo do

5 Erro de Web Services Web Services responsvel pela recepo dos
produtos

Ocorreu um erro no banco de dados do

10 Erro de Banco de Dados mdulo de integrao ao tentar gravar a
exportao.

SIGALOJA Integrao Microsiga Protheus x SIAC 33

 Boletim Tcnico

O registro com o cdigo da loja e TES

codTributacao Externa no
21 (codTributacaoExterna) no foi encontrado
encontrada
na tabela DPTributacaoProtheus

Verificar se a alquota (percImposto)

23 percImposto no confere referente ao codTributacaoExterna est
cadastrada na tabela DPTributacaoProtheus

Cdigo do Grupo de Empresa e/ou cdigo da

Grp.Emp. e/ou Cd.Filial Filial no correspondem ao cdigo da Loja
24
invlida SIAC, cadastrada na tabela
DPLojaFilialProtheus

Verifique se o Web Services do SIAC Store

No foi possvel estabelecer
999 est online e se o IP e Porta configurado na
conexo com o WS
tabela MBM est correto.

Cadastros para utilizao do Web Services Integration Protheus SIAC

1. No Controle de Lojas (SIGALOJA), acesse a rotina Atualizaes/Cadastros/Clientes (MATA030).

2. Clique em Incluir e preencha os campos abaixo:

Para a Integrao Protheus x SIAC, imprescindvel o preenchimento dos campos abaixo:

Titulo Campo Observao

CNPJ/CPF A1_CGC

Bairro A1_BAIRRO

CEP A1_CEP

Fsica/Jurid. A1_PESSOA

Ins. Estad. A1_INSCR Somente se Fsica/Jurid (A1_PESSOA) = J

Tip. Convnio A1_TPCONVE

Empresa Conv. A1_EMPCONV Somente se Tip.Convnio (A1_TPCONVE) = 3

3. Confira dos dados e confirme.

Conveniados (Protheus) x Clientes Cooperados (SIAC):

Uma empresa pode possuir um convnio com um estabelecimento, que disponibiliza uma lista de seus funcionrios
juntamente com um limite de crdito para cada um. Quando o funcionrio realiza uma compra utilizando a forma de
pagamento Financiado ele consome esse limite de crdito, sendo que a cada venda, ser gerado um ttulo financeiro, onde
em uma determinada data o estabelecimento aglutina todos esses ttulos, gerando um nico ttulo contra a empresa.

Para configurar tal cenrio necessrio:

1. No Controle de Lojas (SIGALOJA), acesse a rotina Atualizaes/Cadastros/Clientes (MATA030).

2. Clique em Incluir.

3. Cadastre um cliente representando uma empresa: Tip. Convnio (A1_TPCONVE) = 4 Empresa.

34 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

4. Clique em Confirmar.

5. Clique em Incluir novamente, para cadastrar um novo cliente, s que dessa vez, representando um funcionrio da
empresa.

6. Preencha os seguintes campos:

Tip. Convnio (A1_TPCONVE) = 3 - Conveniado.

Empresa Conv. (A1_EMPCONV) = cdigo do cliente (A1_COD) que representa a empresa.
Lim Crd Sec (A1_LCFIN) = Valor do limite de crdito do cliente.
Saldo LC Sec (A1_SALFIN) = Atualizado automaticamente quando uma venda utilizar uma forma de pagamento que
esteja cadastrada como um tipo de ttulo (mais detalhes no passo 3).

7. Confira os dados e confirme.

Configurar um tipo de ttulo que ser usado para controle de limite de crdito secundrio.

1. No Financeiro (SIGAFIN) acesse Atualizaes / Cadastro / Tipos de Ttulo (FINA015).

2. Clique em Incluir e preencha os campos:

Tipo Orig. (ES_TIPORIG) = FI

Tipo (ES_TIPO) = FI
Atu. Saldup (ES_SALDUP) = 2 Secundrio

3. Confira dos dados e confirme.

Com esse cenrio configurado, quando o PDV realizar uma consulta e o cliente for identificado como
cooperado/conveniado, a retaguarda tambm envia os dados referentes ao limite de crdito. Sendo que se o cliente
escolher a forma de pagamento equivalente a FI, o PDV ser responsvel em avaliar se a venda pode ou no prosseguir.

Estao (Protheus) x Terminal (SIAC)

Os nmeros das estaes devem ser cadastradas nos dois Sistemas, ou seja, se realizar o cadastro no terminal 1 no SIAC,
necessrio cadastrar o terminal 001 no Microsiga Protheus.

Para realizar o controle de numerao, necessrio realizar os procedimentos:

1. No Controle de Lojas (SIGALOJA), acesse Atualizaes / Ponto de Venda / Estao (LOJA121).

2. Clique em Incluir e preencha o campos: Estao e Nome.

3. Confira dos dados e confirme.

Vendedor (Protheus) x Vendedor (SIAC)

Os vendedores devem ser cadastrados nos dois Sistemas, ou seja, se cadastrar o vendedor 1 no SIAC, necessrio cadastrar
o vendedor 000001 no Microsiga Protheus.

1. No Controle de Lojas (SIGALOJA), acesse Atualizaes / Cadastros/Vendedores (MATA040).

2. Clique em Incluir.

SIGALOJA Integrao Microsiga Protheus x SIAC 35

 Boletim Tcnico

3. Preencha os dados conforme orientao dos helps de campo.

4. Confira os dados e confirme.

Srie (Protheus) x Contador Reinicio de Operao (SIAC)

O SIAC controla a numerao do cupom utilizando o CRO (Contador de Reinicio de Operao), diferentemente do
Microsiga Protheus que utiliza a Srie. Para isso, ser relacionado os dois atributos, de modo que quando o CRO
alterado, o Microsiga Protheus realiza a troca da srie automaticamente.

Para que tenha o controle de numerao, necessrio efetuar os procedimentos abaixo:

1. No Controle de Lojas (SIGALOJA), acesse Atualizaes / Ponto de Venda / Estao (LOJA121).

2. Clique em Incluir.

3. Preencha o campo Estao e Nome.

4. Clique em Ok.

5. Acesse a rotina Atualizaes / Ponto de Venda / Gera Srie PDV (LOJA130).

6. Clique em Parmetros

7. Preencha o campo Cdigo da Estao, com o cdigo cadastrado anteriormente e o campo Quantidade com a
quantidade de sries que devem ser geradas.

8. Clique em Ok.

9. Acesse a rotina Atualizaes / Consultas / Genrico.

10. Pesquise pela tabela SL6 (Reserva de Srie por Estao).

11. D um duplo clique sobre o registro.

O Sistema apresenta uma tela com todos os registros da tabela.

6. Procure por um registro referente ao cdigo da estao criado anteriormente e anote o valor do campo Srie
(L6_SERIE).

12. Acesse novamente a rotina Atualizaes / Ponto de Venda / Estao (LOJA121).

13. Selecione a estao cadastrada anteriormente e clique em Alterar.

14. Preencha o campo Srie com o valor anotado anteriormente.

Com isso, aps a primeira venda, ser atribudo ao campo CRO (LG_CRO) o contador de reinicio de operao, para que seja
relacionado ao Cod. Srie (LG_SERIE) em uso.

Quando um CRO for alterado, o Sistema realiza as seguintes aes:

1. Desativa a srie atual na tabela Reserva de Srie por Estao (SL6).

2. Grava o contador de reinicio de operao anterior no campo CRO (L6_CRO), a fim de manter histrico.

36 SIGALOJA Integrao Microsiga Protheus x SIAC

 Boletim Tcnico

3. Procura por uma nova srie disponvel para a estao

4. Grava os campos Cd. Srie (LG_SERIE) com a nova srie disponvel e o campo CRO (LG_CRO) com o valor do contador
de reinicio de operao.

Caixa (Protheus) x Cdigo de Operador (SIAC)

Os caixas/operadores devem ser cadastrados nos dois Sistemas. Sendo que o relacionamento ser realizado atravs do
campo Cd.Op.SIAC (LF_CODSIAC).

Se o cdigo do SIAC for menor que 6 caracteres, deve-se completar com zeros a esquerda.

1. No Controle de Lojas (SIGALOJA), acesse Atualizaes / Ponto de Venda / Caixa (LOJA120).

2. Clique sobre o caixa a ser relacionado com o operador SIAC e clique na opo Alterar.

3. Preencha o campo Cd.Op.SIAC (LF_CODSIAC) com o cdigo do Operador SIAC.

Exemplo:
Cdigo Caixa Nome Caixa Cd.Op.SIAC

C02 Joo da Silva 111111

Formas de Pagamento

Nem todas as formas de pagamento utilizadas no Microsiga Protheus so usadas na Integrao Protheus x SIAC. As formas
utilizadas na integrao so:

Forma de Pagamento Decreto Observao

R$ Dinheiro

CH Cheque

CC Carto de Crdito

CD Carto de Dbito
Utilizadas em pagamentos de cooperado (SIAC) /
FI Financiado
convnio (Microsiga Protheus)
Utilizados em pagamentos de PBM. O SIAC utiliza duas
CO Convnio
formas de PBM, so elas: PBM e PBMS.

Todas as formas de pagamento demonstradas acima, devem ser cadastradas na tabela DPFormaPagamentoProtheus.

Administradoras Financeiras

necessrio cadastrar as administradoras financeiras para as formas de pagamento: CC, CD, FI e CO. Alm disso, ser
necessrio cadastrar as administradoras financeiras na tabela DPAdministracaoProtheus.

Pagamento com Carto de Crdito

Se a taxa administrativa de uma determinada bandeira variar conforme a quantidade de parcelas, ser necessrio cadastrar
uma administradora financeira diferente para cada valor de taxa, mesmo que a bandeira seja a mesma. Em uma venda
parcelada com carto de crdito, o SIAC no envia o valor e a data de vencimento de cada parcela. Como a retaguarda
necessita dessas informaes, ser gerado esses valores com base no valor total e na quantidade de parcelas.

SIGALOJA Integrao Microsiga Protheus x SIAC 37

 Boletim Tcnico

Tabela DePara do Banco de Dados do Mdulo Integrador (SIAC)

As tabelas abaixo existem no banco de dados utilizado pelo mdulo integrador. Antes de utilizar as rotinas Exportao de
Produto (LJTELASIAC) ou qualquer mtodo disponibilizado pelo Web Services do Protheus, necessrio que essas tabelas
estejam configuradas.

DPLojaFilialProtheus Relaciona Grupo de Empresa e Filial que relacionado ao cdigo da Loja SIAC, pois todos os
mtodos disponibilizados pelo Web Services necessitam dessas duas informaes.
DPFormaDePagamentoProtheus Relaciona as formas de pagamento Microsiga Protheus com as formas de
pagamento SIAC.
DPAdministracaoProtheus Relaciona as administradoras financeiras Microsiga Protheus com os cdigos das
bandeiras utilizadas pelo Scope (Gerenciador TEF utilizado pelo SIAC Store).
DPTributacaoProtheus Relaciona TES e alquota do Microsiga Protheus com um identificador de tributao utilizado
pelo SIAC.

INFORMAES TCNICAS

MBK Log de Exportao de Produtos SIAC

Tabelas Utilizadas
MBM DP EmpFil x Lojax Loja

INTEGRATION_PROTHEUS_SIAC - Web Services Integrao Protheus x

SIAC;
LJSIACDPLJ - Cadastro De Para Empresa/Filial x Loja SIAC;
LJTELASIAC - Exportao de Produtos;
LJLOGSIACP - Log Exp. Produtos;
FRTA050 Funo Interna;
Funes Envolvidas FRTA060 - Funo Interna;
LOJA120 Caixa;
LOJA121 Estao;
LOJA160 Reduo Z;
LOJA701 Venda Assistida;
LOJA701C - Funo Interna;
WSFRTNCC - Funo Interna.

Sistemas Operacionais Windows/Linux.

38 SIGALOJA Integrao Microsiga Protheus x SIAC