Boletim Tcnico

Integrao Microsiga Protheus x SIAC

Produto Chamado Pas(es) Aplicabilidade : : : Microsiga Protheus Controle de Lojas verso 11 TGYHOJ Brasil Template de Drogaria Data da publicao Banco(s) de Dados : : 02/04/13 Todos

Esta melhoria depende de execuo do update de base para Implementao.

UPDINTSIAC, conforme Procedimentos

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 Empresas 01 02 Cdigo Filial EEUUFFFF 01010001 01010001 Instncia SIAC A B

Loja SIAC 11 21

IP Web Services 192.168.0.1:8080 192.168.0.2:8080 1

SIGALOJA Integrao Microsiga Protheus x SIAC

Boletim Tcnico

Observe que temos dois grupos de empresas, ou seja, temos duas instncias SIAC. Grupo de Empresas 01 01 Cdigo Filial EEUUFFFF 01010001 01010002 Instnci a SIAC A A Loja SIAC 11 12 IP Web Services 192.168.0.1:8080 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 PLUProdutos PLUCdigos PLUProdutoAssociado PLUProdutosLoja PLUPreoLoja Abrangncia Instncia Instncia Instncia Loja Loja Descrio Informaes Gerais do Produto Cdigos de Barra (EAN-13) Produtos Associados Tributao, permisso para desconto, digitao de preo Preos e Datas de Vigncia aplicao de

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.

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

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:

SIGALOJA Integrao Microsiga Protheus x SIAC

Boletim Tcnico

1. 2. 3.

No Controle de Lojas (SIGALOJA) acesse Atualizaes / Atendimento / Venda Assistida (LOJA701). No campo Cliente (L1_CLIENTE), informe um cliente que possua uma NCC pendente. Clique na opo Detalhes e selecione a opo Pagamentos (F7). O Sistema apresenta uma janela com as NCC disponveis para o cliente.

4. 5.

Selecione as NCC marcando o checkbox. 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

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.

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

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 .

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

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. 3. Clique em Ok para continuar. 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 . Ao confirmar exibida uma mensagem de advertncia sobre o backup e a necessidade de sua execuo em modo exclusivo. Clique em Processar para iniciar o processamento. O primeiro passo da execuo a preparao dos arquivos, conforme mensagem explicativa apresentada na tela. 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. Clique em Gravar para salvar o histrico (log) apresentado. Clique em Ok para encerrar o processamento.

4.

5.

6.

7. 8.

ATUALIZAES DO COMPATIBILIZADOR
1. Criao de Perguntas no arquivo SX1 Cadastro de Perguntes: Pergunte Grupo Ordem Tipo Tamanho Objeto Consulta Padro Do Produto LJTELASIAC 01 C 15 Edit Produto

Pergunte Grupo Ordem Tipo Tamanho Objeto Consulta Padro

At o Produto LJTELASIAC 02 C 15 Edit Produto

12

SIGALOJA Integrao Microsiga Protheus x SIAC

Boletim Tcnico

Pergunte Grupo Ordem Tipo Tamanho Objeto Item 1 Item 2 2.

Importar LJTELASIAC 03 N 1 Combo Produto Preo

Criao de Tabelas no arquivo SX2 Tabelas Chave Descrio Modo X2_Unico ModoEmp ModoUn MBK Log Exp. Produtos (SIAC) E MBK_FILIAL+MBK_IDLOTE+MBK_CHAVE E E

Chave Descrio Modo X2_Unico ModoEmp ModoUn 3.

MBM DePara EmpFil x Loja (SIAC) C MBM_FILIAL+MBM_CODEMP+MBM_CODFIL C C

Criao de Campos no arquivo SX3 Campos: Tabela MBK Log Exportao SIAC Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Grupo SXG Filial Filial do Sistema 0 033 SIGALOJA Integrao Microsiga Protheus x SIAC 13 MBK_FILIAL C FwSizeFilial() 0

Boletim Tcnico

Campo Tipo Tamanho Decimal Formato Contexto Visualizar Ttulo Descrio Nvel Usado Obrigatrio Browse Help

MBK_IDLOTE C 6 0 999999 Real Visualizar ID Lote Cdigo Ident. Lote 0 Sim No Sim Cdigo de Identificao do Lote.

Campo Tipo Tamanho Decimal Formato Contexto Visualizar Ttulo Descrio Nvel Usado Obrigatrio Browse Help

MBK_CHAVE C 40 0 @! Real Visualizar Chave Item do Lote (Fil+Cod) 0 Sim No Sim Item do Lote. Composto por Filial + Codigo do Produto.

Campo Tipo Tamanho Decimal

MBK_CODRET C 3 0

14

SIGALOJA Integrao Microsiga Protheus x SIAC

Boletim Tcnico

Formato Contexto Visualizar Ttulo Descrio Nvel Usado Obrigatrio Browse Help Campo Tipo Tamanho Decimal Formato Contexto Visualizar Ttulo Descrio Nvel Usado Obrigatrio Browse Help

999 Real Visualizar Cd. Retorno Cdigo de Retorno 0 Sim No Sim Cdigo de Status da exportao retornado pelo SIAC. MBK_IDPROC C 10 0 9999999999 Real Visualizar ID Processo Cod ident. Processo 0 Sim No Sim Cdigo de Identificao da Importao retornado pelo SIAC.

Campo Tipo Tamanho Decimal Formato Contexto Visualizar Ttulo Descrio

MBK_LJDEST C 4 0 9999 Real Visualizar Loja Destino Loja Destino Exp Produtos SIGALOJA Integrao Microsiga Protheus x SIAC 15

Boletim Tcnico

Nvel Usado Obrigatrio Browse Help

0 Sim No Sim Cdigo da Loja SIAC a qual os produtos sero enviados

Tabela MBM DePara EmpFil x Loja (SIAC) Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Grupo SXG Filial Filial do Sistema 0 033 MBM_FILIAL C FwSizeFilial() 0

Campo Tipo Tamanho Decimal Formato Contexto Visualizar Ttulo Descrio Nvel Usado Obrigatrio Browse Relao Val. Sistema Help

MBM_CODEMP C 2 0 @! Real Alterar Cod Grp Emp Codigo Grupo Empresa 0 Sim Sim Sim CEMPANT Ascan( FwLoadSM0(), {|x| x[1] == M->MBM_CODEMP} ) > 0 Informe o cdigo do Grupo de Empresa do Protheus.

16

SIGALOJA Integrao Microsiga Protheus x SIAC

Boletim Tcnico

Campo Tipo Tamanho Decimal Formato Contexto Propriedade Ttulo Descrio Nvel Usado Obrigatrio Browse Relao Inic. Browse Help

MBM_DSCEMP C 13 0 @! Virtual Visualizar Dsc Grp Emp Descrio Grupo Empresa 0 Sim No Sim FwGrpName(M->MBM_CODEMP) FwGrpName(MBM->MBM_CODEMP) Descrio do Grupo de Empresa. Informao retirada do sigamat.emp.

Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Relao Val. Sistema Grupo SXG Help Campo Tipo

MBM_CODFIL C FwSizeFilial() 0 @! Cd. Filial Cdigo Filial 0 Sim Sim Sim CFILANT FwFilExist(M->MBM_CODEMP, M->MBM_CODFIL) 033 Informe o cdigo da Filal do Protheus. MBM_DSCFIL C

SIGALOJA Integrao Microsiga Protheus x SIAC

17

Boletim Tcnico

Tamanho Decimal Formato Contexto Propriedade Ttulo Descrio Nvel Usado Obrigatrio Browse Relao Inic. Browse Help

15 0 @! Virtual Visualizar Desc. Filial Descrio da Filial 0 Sim No Sim FwFilialName(M->MBM_CODEMP, M->MBM_CODFIL) FwFilialName(MBM->MBM_CODEMP, MBM->MBM_CODFIL) Nome da Filial do Protheus. Informao retirada do sigamat.emp.

Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help Campo Tipo Tamanho Decimal Formato Ttulo Descrio

MBM_LJSIAC C 4 0 9999 Loja SIAC Codigo Loja SIAC 0 Sim Sim Sim Cdigo da Loja SIAC. Preencher sem utilizar 0(zero) a esquerda. MBM_IPWS C 21 0 @! IP WS SIAC IP Web Services SIAC

18

SIGALOJA Integrao Microsiga Protheus x SIAC

Boletim Tcnico

Nvel Usado Obrigatrio Browse Help

0 Sim Sim Sim Informe o IP:Port do WebServices SIAC. Cada Grupo de Empresa/Empresa/Unidade de Negcio deve estar relacionada uma instncia do SIAC. Ex: 127.0.0.1:8080

Tabela SLG Estaes: Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help LG_CRO C 6 0 999999 CRO Cont. Renicio Operao 0 Sim No No Contador de Renicio de Operao do ECF

Tabela SL6 Reserva de Serie por Estao: Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help L6_CRO C 6 0 999999 CRO Cont. Renicio Operao 0 Sim No No Contador de Renicio de Operao do ECF

SIGALOJA Integrao Microsiga Protheus x SIAC

19

Boletim Tcnico

Tabela MDK Itens da Ncc Pendente Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help MDK_NUMORC C 6 0 999999 Oramento Num. do Oramento 0 Sim No No Nmero do Oramento

Tabela SLF Reserva de Serie por Estao: Campo Tipo Tamanho Decimal Formato Ttulo Descrio Nvel Usado Obrigatrio Browse Help LF_CODSIAC C 6 0 999999 Cd.Op. SIAC Cdigo Operador SIAC 0 Sim No No Cdigo de Operador SIAC. Deve ser cadastrado com 0(zero) a esquerda.

4.

Tabela de ndices no arquivo SIX ndices: ndice Ordem Chave Descrio Proprietrio MBK 1 MBK_FILIAL+MBK_IDLOTE+MBK_CHAVE Cdigo Ident. Lote + Item do Lote (Fil+Cod) S

20

SIGALOJA Integrao Microsiga Protheus x SIAC

Boletim Tcnico

ndice Ordem Chave Descrio Proprietrio

MBM 1 MBM_FILIAL+MBM_CODEMP+MBM_CODFIL Cod Grp Emp + Cod Filial S

ndice Ordem Chave Descrio Proprietrio

SL1 F L1_FILIAL+L1_ESTACAO+L1_DOC+DTOS(L1_EMISNF) Estao + Documento + Dt.Emisso NF S

ndice Ordem Chave Descrio Nickname Proprietrio

SL6 5 L6_FILIAL+L6_ESTACAO+L6_CRO Estacao + CRO SIAC_CRO S

ndice Ordem Chave Descrio Proprietrio

SLF 2 LF_FILIAL+LF_CODSIAC Cod. Op. SIAC S

ndice Ordem Chave Descrio Proprietrio

MDJ 3 MDJ_FILIAL+MDJ_NUMORC Num. do Oramento S

ndice Ordem Chave

MDK 2 MDK_FILIAL+MDK_NUMORC

SIGALOJA Integrao Microsiga Protheus x SIAC

21

Boletim Tcnico

Descrio Proprietrio

Num. do Oramento S

ndice Ordem Chave Descrio Proprietrio 5.

SE5 I E5_FILIAL+E5_PREFIXO+E5_NUMERO+E5_BANCO+E5_MOEDA Prefixo + Numero + Banco + Moeda S

Criao de Parmetros no arquivo SX6 Parmetros: Nome Tipo Cont.Por Descrio MV_SCINTEG L .F. Usado na Integrao Protheus x SIAC. Habilita a integrao Protheus x SIAC, quando seu valor Igual a .T.

Nome Tipo Valor Descrio

MV_SCPRDLT N 100 Usado na Integrao Protheus x SIAC. Determina a quantidade de produtos por lote na exportao de produtos.

Nome Tipo Valor Descrio

MV_SCTMCOD N 7 Usado na Integrao Protheus x SIAC. Determina a qtd. de dgitos do Cod. Produtos. necessrio um valor fixo, pois o SIAC no utiliza 0 a esquerda.

Nome Tipo Valor Descrio

MV_SCUSR C admin Usado na Integrao Protheus x SIAC. Usurio para autenticao no Web Services SIAC.

Nome Tipo

MV_SCPAS C

22

SIGALOJA Integrao Microsiga Protheus x SIAC

Boletim Tcnico

Valor Descrio

admin Usado na Integrao Protheus x SIAC. Senha do usurio para autenticao no Web Services SIAC.

Nome Tipo Valor Descrio 6.

MV_SCLOG L .F. Usado na Integrao Protheus x SIAC. Habilita o Log de Processamento. O log ser salvo no caminho RoothPath\SIAC_LOG\.

Criao de Gatilhos no arquivo SX7 Gatilhos: Tabela MBM DePara EmpFil x Loja (SIAC): Campo Sequncia Regra Campo Domnio Tipo Proprietrio MBM_CODEMP 001 FwGrpName(M->MBM_CODEMP) MBM_DSCEMP P S

Campo Sequncia Regra Campo Domnio Tipo Proprietrio

MBM_CODFIL 001 FwFilialName(M->MBM_CODEMP, M->MBM_CODFIL) MBM_DSCFIL P 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 Submenu Nome da Rotina SIGALOJA Miscelnea / Protheus x SIAC Exportao Produtos

SIGALOJA Integrao Microsiga Protheus x SIAC

23

Boletim Tcnico

Programa Mdulo Tipo Tabelas

LJTELASIAC Controle de Lojas Funo Protheus MBK e MBM

Menu Submenu Nome da Rotina Programa Mdulo Tipo Tabelas

SIGALOJA Miscelnea / Protheus x SIAC Log Exp. Produtos LJLOGSIACP Controle de Lojas Funo Protheus MBK

Menu Submenu Nome da Rotina Programa Mdulo Tipo Tabelas

SIGALOJA Miscelnea / Protheus x SIAC DP EmpFil x Lojax Loja SIAC LJSIACDPLJ Controle de Lojas Funo Protheus 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. 2. 3. 4. Configurar o PDV SIAC e mdulo Integrador. Possuir Licena especfica para Integrao Protheus x SIAC. Possuir o Template de Drogaria. 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 parmetro no estiver ativo, nenhum servio do Web Services processa a requisio. Habilita a gravao do log de processamento. Todos os servios disponibilizados no web services e a rotina de exportao de produtos so registradas no log. Os logs so gravados na pasta RootPath\SIAC_LOG\ . Quantidade de produtos por lote. Usado na rotina de exportao de produtos. Quantidade de dgitos do cdigo de produto. Usurio SIAC usado na autenticao do Web Services SIAC. Atualmente no necessrio a autenticao. Senha do usurio SIAC usado na autenticao do Web Services SIAC. Atualmente no necessrio a autenticao.

MV_SCINTEG

.T.

MV_SCLOG

A decidir A decidir A decidir Em branco Em branco

MV_SCPRDLT MV_SCTMCOD MV_SCUSR

MV_SCPAS

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: 2. 3. 4. Realizar o preenchimento automtico dos campos Cod Grp Emp e Cod Filial? Caso positivo, Cadastrar todos os Grupos de Empresas ou somente o atual?

Caso utilize o preenchimento automtico, posicione o cursor no registro desejado e clique em Alterar. Preencha os campos: Loja SIAC e IP Web Services SIAC. 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 01 01 Cod Filial 01 02 Loja SIAC 11 12 IP WS SIAC 192.168.0.1:8080 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 01 02 Cod Filial 01 01 Loja SIAC 11 12 IP WS SIAC 192.168.0.1:8080 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 EEUUFF 010101 010102

Cod Grp Emp 01 01

Loja SIAC 1111 1112

IP WS SIAC 192.168.0.1:8080 192.168.0.1:8080

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

Cod Grp Emp 01 01

Loja SIAC 1111 1211

IP WS SIAC 192.168.0.1:8080 192.168.0.2:8080

010101 020101

Devido a alterao dos dgitos referentes a Empresa, temos mais uma instncia do SIAC. Cod Filial EEUUFF 010101 010201

Cod Grp Emp 01 01

Loja SIAC 1111 1121

IP WS SIAC 192.168.0.1:8080 192.168.0.2:8080

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

Cod Grp Emp 01 02

Loja SIAC 1111 2111

IP WS SIAC 192.168.0.1:8080 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. 2. No Controle de Lojas (SIGALOJA) acesse Atualizaes / Cadastros / Produtos (LOJA110). 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. 2. No Controle de Lojas (SIGALOJA), acesse Atualizaes/Cadastros/Cdigos de Barras (LOJA210). 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 0000001 0000002 Para cadastrar um produto associado: 1. 2. No Call Center (SIGATMK), acesse Atualizaes / Televendas / Acessrios (TMKA030). Clique em Incluir e preencha os campos: 3. Produto (UG_PRODUTO) : Informe o cdigo do produto principal. Acessrio (U1_ACESSOR): Informe o cdigo do produto que ser associado ao produto principal. Descrio Aplicao de injeo intravenosa Seringa descartvel com agulha 5ml Tipo Principal Associado

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 0000001 Preo Venda 1 R$ 1,00 Promoo 1 01/01/2011

Caso tenha um preo cadastrado Preo Venda (B0_PRVX) e no tenha uma data cadastrada Promoo (B0_DATAX) ou viceversa, 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 TS Padro Aliq. ICMS Aliq. ISS Solid. Sada Solid. Entr. Campo da tabela SB1 B1_TS B1_PICM B1_ALIQISS B1_PICMRET B1_PICMENT Campo da tabela SBZ BZ_TS BZ_PICM BZ_ALIQISS BZ_PICMRET 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. 2. 3. 4. 5. No Faturamento (SIGAFAT) acesse Atualizaes / Cadastros / Indicadores de Produtos (MATA018). Clique em Incluir. No campo Cdigo (BZ_COD), digite o cdigo de um produto que j esteja cadastrado. Preencha os campos citados no tpico acima, conforme orientao dos helps de campo. 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 0000001 TES 501 Situao Tributria (descritivo) ICMS Integral Loja SIAC 1 Alquota 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 1.501 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 01 02 Filial 01 01 Loja SIAC 11 21 IP Web Service SIAC 192.168.0.1:8080 192.168.0.2:8080 percImposto 18 idTributacao 1

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. 2. No Controle de Lojas (SIGALOJA) acesse Atualizaes / Miscelnea / Protheus x SIAC / Exportao de Produtos: Clique em Parmetros e configure-os conforme as opes: 3. 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).

Confira dos dados e confirme.

Log Exp. Produtos (LJLOGSIACP):

Pr-Requisito para Log de Exportao de Produtos: 1. Ter executado pelo menos uma vez a rotina Exportao Produtos.

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

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

Mensagem Importado com Sucesso Erro de Web Services

Descrio Exportao realizada com sucesso Ocorreu algum problema na execuo do Web Services responsvel pela recepo dos produtos Ocorreu um erro no banco de dados do mdulo de integrao ao tentar gravar a exportao.

10

Erro de Banco de Dados

SIGALOJA Integrao Microsiga Protheus x SIAC

33

Boletim Tcnico

21

codTributacao Externa no encontrada

O registro com o cdigo da loja e TES (codTributacaoExterna) no foi encontrado na tabela DPTributacaoProtheus Verificar se a alquota (percImposto) referente ao codTributacaoExterna est cadastrada na tabela DPTributacaoProtheus Cdigo do Grupo de Empresa e/ou cdigo da Filial no correspondem ao cdigo da Loja SIAC, cadastrada na tabela DPLojaFilialProtheus Verifique se o Web Services do SIAC Store est online e se o IP e Porta configurado na tabela MBM est correto.

23

percImposto no confere

24

Grp.Emp. e/ou Cd.Filial invlida

999

No foi possvel estabelecer conexo com o WS

Cadastros para utilizao do Web Services Integration Protheus SIAC

1. 2. No Controle de Lojas (SIGALOJA), acesse a rotina Atualizaes/Cadastros/Clientes (MATA030). Clique em Incluir e preencha os campos abaixo: Para a Integrao Protheus x SIAC, imprescindvel o preenchimento dos campos abaixo: Titulo CNPJ/CPF Bairro CEP Fsica/Jurid. Ins. Estad. Tip. Convnio Empresa Conv. 3. Confira dos dados e confirme. Campo A1_CGC A1_BAIRRO A1_CEP A1_PESSOA A1_INSCR A1_TPCONVE A1_EMPCONV Somente se Tip.Convnio (A1_TPCONVE) = 3 Somente se Fsica/Jurid (A1_PESSOA) = J Observao

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. 2. 3. No Controle de Lojas (SIGALOJA), acesse a rotina Atualizaes/Cadastros/Clientes (MATA030). Clique em Incluir. Cadastre um cliente representando uma empresa: Tip. Convnio (A1_TPCONVE) = 4 Empresa.

34

SIGALOJA Integrao Microsiga Protheus x SIAC

Boletim Tcnico

4. 5.

Clique em Confirmar. Clique em Incluir novamente, para cadastrar um novo cliente, s que dessa vez, representando um funcionrio da empresa. 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).

6.

7.

Confira os dados e confirme.

Configurar um tipo de ttulo que ser usado para controle de limite de crdito secundrio. 1. 2. No Financeiro (SIGAFIN) acesse Atualizaes / Cadastro / Tipos de Ttulo (FINA015). Clique em Incluir e preencha os campos: 3. Tipo Orig. (ES_TIPORIG) = FI Tipo (ES_TIPO) = FI Atu. Saldup (ES_SALDUP) = 2 Secundrio

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. 2. 3. No Controle de Lojas (SIGALOJA), acesse Atualizaes / Ponto de Venda / Estao (LOJA121). Clique em Incluir e preencha o campos: Estao e Nome. 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. 2. No Controle de Lojas (SIGALOJA), acesse Atualizaes / Cadastros/Vendedores (MATA040). Clique em Incluir.

SIGALOJA Integrao Microsiga Protheus x SIAC

35

Boletim Tcnico

3. 4.

Preencha os dados conforme orientao dos helps de campo. 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. 2. 3. 4. 5. 6. 7. No Controle de Lojas (SIGALOJA), acesse Atualizaes / Ponto de Venda / Estao (LOJA121). Clique em Incluir. Preencha o campo Estao e Nome. Clique em Ok. Acesse a rotina Atualizaes / Ponto de Venda / Gera Srie PDV (LOJA130). Clique em Parmetros Preencha o campo Cdigo da Estao, com o cdigo cadastrado anteriormente e o campo Quantidade com a quantidade de sries que devem ser geradas. Clique em Ok. Acesse a rotina Atualizaes / Consultas / Genrico.

8. 9.

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. 2. Desativa a srie atual na tabela Reserva de Srie por Estao (SL6). 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. 4.

Procura por uma nova srie disponvel para a estao 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. 2. 3. No Controle de Lojas (SIGALOJA), acesse Atualizaes / Ponto de Venda / Caixa (LOJA120). Clique sobre o caixa a ser relacionado com o operador SIAC e clique na opo Alterar. Preencha o campo Cd.Op.SIAC (LF_CODSIAC) com o cdigo do Operador SIAC.

Exemplo: Cdigo Caixa C02 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 R$ CH CC CD FI CO Decreto Dinheiro Cheque Carto de Crdito Carto de Dbito Financiado Convnio Utilizadas em pagamentos de cooperado (SIAC) / convnio (Microsiga Protheus) Utilizados em pagamentos de PBM. O SIAC utiliza duas formas de PBM, so elas: PBM e PBMS. Observao Nome Caixa Joo da Silva Cd.Op.SIAC 111111

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
Tabelas Utilizadas MBK Log de Exportao de Produtos SIAC 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