Documente Academic
Documente Profesional
Documente Cultură
Dezembro/2014
Ttulo do documento
Sumrio
1. Contexto de negcio (Introduo) .............................................................................................................. 3
2. Sistemas Envolvidos .................................................................................................................................. 3
3. Integrao .................................................................................................................................................. 3
4. Escopo ....................................................................................................................................................... 4
4.1. Fluxo ....................................................................................................................................................... 4
4.2. Cadastros e movimentos......................................................................................................................... 7
4.3. Servios da integrao ............................................................................................................................ 10
4.4. Premissas e restries ............................................................................................................................ 11
5. Pr-requisitos instalao/implantao/utilizao ........................................................................................ 12
6. Instalao/Atualizao ............................................................................................................................... 12
7. Fluxo das Informaes ............................................................................................................................... 12
8. Anexos ....................................................................................................................................................... 12
2. Sistemas Envolvidos
Os 2 sistermas envolvidos nesta integrao so formados por:
Sistema/Mdulo Vertical Bridge POS e Bridge Manager (Retaguarda do PDV), que compe a soluo Bridge Suite
Verso 2 da empresa Synthesis, localizada na Argentina.
BackOffice(s) ERP Protheus Release 11.80, segmento Varejo da empresa TOTVS, localizada no Brasil.
3. Integrao
O escopo da integrao consiste no envio das informaes pelo ERP Protheus relacionadas a produtos, clientes, tabelas de
preo, caixas, formas de pagamento entre outros para que o Bridge POS envie as movimentaes de vendas, fechamentos de
caixa, entrada e sada de troco. Desta forma, possvel ter uma soluo robusta e flexvel que atenda a legislao local e tenha
funcionalidades que sejam aderentes as regras de negcio do Varejo.
A principal rea impactada da empresa a operao da loja que passar a ter o Bridge POS como frente de loja e o Protheus
na retaguarda com os controles de Estoques, Financeiro, Faturamento, Compras, Fiscal, Contbil.
A integrao dos sistemas feita basicamente atravs de servios, que so consumidos de acordo com as estruturas de dados para
a troca de informaes entre o Protheus e o Bridge POS.
Os cadastros so realizados no ERP Microsiga Protheus.
Os Jobs de controle executam a verificao da base de dados para identificar registros que precisam ser exportados ao Bridge
Manager, considerando os includos, alterados e desabilitados desde a ltima exportao, alm realizarem a transferncia dos
dados para uma tabela intermediria.
As movimentaes de venda, pr-venda, confirmao de pagamento, devoluo, entrada de troco, sangria, reduo Z,
abertura/fechamento de caixa e incluso de clientes so realizadas no Synthesis Bridge Pos.
No possvel acessar as rotinas de transferncia/importao. Tudo executado automaticamente em background pelo Job, dentro
de um intervalo configurvel de tempo.
Para visar flexibilidade e praticidade na integrao dos cadastros e movimentos com o Bridge, disponibilizou-se um motor de
integrao entre os Sistemas. Este motor utilizado para suporte do controle da integrao, que contm tabelas auxiliares para
configurao e gravao dos dados, processos automticos para exportao e/ou importao ao Protheus e log de erros para
anlises.
Nos casos de exportao dos cadastros (produtos, unidades de medida, tabela de preos, entre outros) o Protheus o client da
integrao, ou seja, realiza a chamada de um WebService disponibilizado pelo Bridge.
Nos casos de importaes dos movimentos (venda, consulta estoque, reduo Z, entre outros) o Protheus o server da
integrao, que disponibiliza um WebService para o Bridge acessar.
Ttulo do documento
Os arquivos de cadastros que permitem desabilitar registros, uma vez gravados nos sistemas, so:
Fornecedores
Categoria de produtos
Unidades de medida
Impostos
Produtos
Tabela de preos (atravs da data de vigncia)
Formas de pagamento
Parmetros de terminal
Prefixos
Clientes
4.
Escopo
4.1. Fluxo
Abaixo o fluxo base da integrao dos cadastros e movimentos para dar a viso das entidades integradas entre os 2 sistemas.
Cadastros
ERP Microsiga
Protheus
Bridge Manager
Synthesis
Bridge POS
Synthesis
Movimentos
Rev. 1.5
Bridge Manager
Produtos
Bridge POS
Regras de
impostos
Codigo
de Barras
Parmetros
de loja/
PDV
Categorias
de
Produtos
Regras de
formas de
pagto.
Tipos de
Produtos
Unidade
de Medida
Regras de
Venda
Fornecedor
Impostos
Variveis
PARTY
Tabela de
Preos
PROMO
(Promo
es)
Base
Bridge POS
Clientes
Clientes
Formas de
Pagto.
Clientes
Vendedor
Admin.
Financiera
Base Bridge
Manager
Grade de
Produtos
DEPARA
Caixas /
Bancos
Estao
Usurios/
Caixas
Usurios /
Senha
Moedas/
Taxas
Estao/
PDV
Empresa/
Filial
Permisses
Armazm
Produtos
similares/
complem.
Ttulo do documento
Integrao TOTVS Protheus x Synthesis Bridge Movimentos
TOTVS Protheus
Bridge Manager
Rev. 1.5
Bridge POS
Vendas
Acumulado
Dirio
Descontos
Pagamentos
Impostos
Devolues
Entrada de
troco
Sangria
XML - IXRetail
Base de dados
Protheus
SigaLoja
DEPARA
Reduo Z
Base de dados
Bridge
Manager
Abertura/
Fechamento
de Caixa
Cliente
Consulta
estoque
Consulta
estoque
Fechamento
/Consulta
Pr-Venda
Pr-venda
Consulta
NCC
Reserva
Produtos
Nota de
Crdito
(NCC)
Estoque
Estoque
(offline)
Estoque
(offline)
Tabela de preos
Tanto o Protheus quanto o Bridge tratam preos regulares com datas definidas de vigncia. Para as operaes de vendas,
o Bridge determina o preo de venda com base na data de incio da operao. Se no houver um preo na data correspondente
ser o utilizado o preo regular. possvel definir uma tabela de preo por cliente ou grupos de clientes.
Formas de pagamento
As formas de pagamento so cadastradas na tabela SX5, entretanto, a Synthesis possui uma necessidade diferenciada para
o tratamento das formas de pagamento, ou seja, as formas de pagamento com carto so cadastradas na tabela de
Administradora Financeira (SAE). Para a Synthesis as formas de pagamento com carto tem o mesmo conceito de
Administradora Financeira no Protheus.
Grupos das Formas de Pagamento:
Os grupos de forma de pagamento pr-definidos na integrao so:
o Cash
o Check
o Coupon
o Card
o Cash on delivery
o Nota de crdito
o Crdito
Ttulo do documento
As Notas de Crdito sero emitidas no Bridge e enviadas junto com os dados da venda. Para utilizar essas notas de crdito
como forma de pagamento para compensar em vendas futuras, o Protheus disponibiliza um servio para pesquisar os
documentos e enviar ao Bridge.
Cotao de moedas estrangeiras
As cotaes so enviadas diariamente do Protheus ao Bridge.
Clientes
O Protheus carrega os registros de clientes nas diferentes lojas com os dados pessoais e as configuraes fiscais. Da
mesma forma, ser permitido enviar o registro de um novo cliente partir do Bridge ao Protheus para os casos em que
o cliente cadastrado na prpria loja.
Vendas/devolues
As informaes de vendas e devolues so enviadas em um intervalo de tempo do Bridge Manager, aps processar as
diversas operaes feitas no POS. Esta informao contm todas as informaes detalhadas dos atributos das transaes,
como: dados da transao, dados do comprovante fiscal, dados de clientes, produtos, descontos, impostos, formas de
pagamento entre outros.
Movimentos de controle
As transaes de entradas de troco, sangrias, abertura e fechamento de caixa so enviadas de forma similar as vendas logo
aps serem processadas pelo Bridge Manager.
Conciliao de Caixa
Possibilidade de emisso da Reduo Z via impressora fiscal em cada Bridge POS e integrao da conciliao de Caixa para
o seu fechamento para controlar o fluxo de numerrios nas lojas. Por Caixa, possvel informar o montante total de entrada
de troco, sangrias, vendas por formas de pagamento e devolues.
Pr-venda
A pr-venda ingressada no Bridge e, aps o seu processamento pelo Bridge Manager, enviada ao Protheus para que
possa ser importada para a finalizao no PDV. Caso no encontre no Protheus em funo do tempo de processamento a prvenda considerada do prprio Bridge e depois enviada j finalizada ao Protheus.
O registro da pr-venda sempre realizado no Bridge que posteriormente exportada ao Protheus.
Consulta de estoque
Esta consulta se realiza de forma online a partir de uma solicitao do Bridge ao Protheus mostrando a quantidade disponvel
de todos os armazns e filiais. Ao serem includos em uma transao de venda os itens so reservados para que no sejam
vendidos por outro PDV. permitido realizar a reserva de outra filial para que o consumidor possa comprar em uma loja e
retirar em outra que esteja disponvel.
Promoo (Promo)
A integrao da promoo consiste no envio do cdigo da promoo aplicada no item da venda e enviada ao Protheus.
Impostos
Para realizar a incluso dos impostos no cadastros de Impostos Variveis (SFB) necessria ateno ao preenchimento dos
campos Clasif.(FB_CLASSIF) e Clase Imp.(FB_CLASSE). Tambm foram disponibilizados campos exclusivos para
integrao Synthesis neste cadastro. Os campos disponveis so: Categoria de Impostos, Uso Item, Categoria Item, Codigo
Regra, Valor Bruto, Tipo Imposto e Forma de Calculo.
O preenchimento destes campos fundamental para integrao deste cadastro ao Sistema Bridge e no influenciam nas
rotinas de clculo de impostos no Protheus. Para isso, no Fiscal acesse Atualizaes/Arquivos/Impostos Variav.
Tabelas Auxiliares Impostos SX5
Disponibilizadas as tabelas auxiliares com contedos pr-definidos para o cadastro de impostos. Estas tabelas so
armazenadas no arquivo SX5. As tabelas auxiliares disponveis para completar o cadastro de impostos para integrao com
Bridge so:
ZA - Categoria de Impostos.
ZB - Tipos de Impostos por Jurisdio.
ZC - Categoria de Itens para Impostos.
ZD - Uso do Item.
ZE - Classe de Imposto.
ZF - Regras de Impostos.
Tipos de Impostos:
Impostos Variveis - Percepes de IIBB ou IVA
Para efetuar a integrao do cadastro de Impostos Variveis (SFB), alm do preenchimento dos campos chave para
cadastro do imposto, fundamental o preenchimento dos campos:
O campo Clasif.(FB_CLASSIF) deve ser preenchido com o contedo 1 = Ingresos Brutos para percepes de IB(IIBB)
ou com o contedo 3 = IVA para percepces de IVA (VAT).
O campo Clase Imp.(FB_CLASSE) de ser preenchido com o contudo P = Percepcion.
No Fiscal, acesse Atualizaes/Arquivos/Impostos Variav.
Impostos Internos Itens
Para efetuar a integrao do cadastro de Impostos Internos(SFB), alm do preenchimento dos campos chave para cadastro
do imposto, fundamental o preenchimento dos campos abaixo:
O campo Clasif.(FB_CLASSIF) deve ser preenchido com o contedo 2 = Internos.
O campo clase Imp.(FB_CLASSE) de ser preenchido com o contudo I = Impuestos.
No Fiscal, acesse Atualizaes/Arquivos/Impostos Variav.
Ttulo do documento
Impostos IVA dos produtos
Para efetuar a integrao do cadastro de Impostos IVA dos Produtos (SFB) alm do preenchimento dos campos chave
para cadastro do imposto, fundamental o preenchimento dos campos abaixo:
O campo Clasif.(FB_CLASSIF) deve ser preenchido com o contedo 3 = IVA.
O campo clase Imp.(FB_CLASSE) de ser preenchido com o contudo I = Impuesto.
No Fiscal, acesse Atualizaes/Arquivos/Impostos Variav.
Clientes: este servio tem como objetivo permitir a importao do cadastro de clientes registrados no Protheus, tanto
para pessoas fsicas quanto jurdicas, com a finalidade de emitir os documentos fiscais correspondentes.
J os servios Protheus responsveis por permitir o envio das movimentaes feitas no produto Bridge so:
Preo
Desconto
IVA e Impostos calculados
Vendedor
Informao de pr-vendas
11
Ttulo do documento
o
o
o
o
o
o
o
o
Impressoras Fiscais.
Impressoras No Fiscais (Laser).
Leitor de Cdigos de Barras.
Leitor de tarja magntica.
Balanas (leitor de peso).
Gaveta de dinheiro.
Display de PDV.
Monitor Touch Screen.
5. Pr-requisitos instalao/implantao/utilizao
1. Para realizar a instalao da integrao, o ERP Protheus deve estar executando no mnimo a Release 11.80 e o ambiente
deve estar configurado para Argentina, enquanto que o Bridge deve ser instalado partir da Verso 2.
2. necessrio efetuar a configurao do Web Services para realizar a comunicao, dos jobs de integrao para o envio dos
dados ao Bridge, popular as tabelas do motor de integrao e as tabelas DE-PARA, criadas em funo das diferenas de
estrutura de dados entre os dois Sistemas.
3. As premissas de Hardware e Sistema Operacional no ambiente Protheus, devem seguir as especificaes padres definidas
pela TOTVS.
4. A documentao da Synthesis utilizada para a realizao da integrao, o Manual de usurio Bridge Core Client Library
Verso 1.41 e que deve ser solicitado empresa Synthesis atravs do contato pelo site http://www.synthesis-rs.com/.
6. Instalao/Atualizao
Para realizar a implantao da integrao, necessrio executar os updates UPDLO114 e UPDLO143 e realizar os
procedimentos de configurao do boletim tcnico Integrao Protheus X Bridge POS Synthesis.
8. Anexos
O documento anexo contm informaes mais detalhadas sobre a arquitetura e funcionamento do sistema Protheus:
12