Integrao Backoffice Protheus x Bridge POS

Dezembro/2014

Backoffice Protheus x Bridge POS

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

Integrao Backoffice Protheus X Bridge POS

Backoffice Protheus x Bridge POS

1. Contexto de negcio (Introduo)

Este projeto permite oferecer maior competitividade para varejistas de pequeno e mdio porte de lojas de departamentos,
supermercados, lojas de convenincia, lojas especializadas ou mercadorias em geral e vesturio, atendendo s necessidades
especficas desses segmentos para o mercado argentino.

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.

Integrao Backoffice Protheus X Bridge POS

Backoffice Protheus x Bridge POS

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

Integrao Backoffice Protheus X Bridge POS

Backoffice Protheus x Bridge POS

Integrao TOTVS Protheus x Synthesis Bridge Cadastros

TOTVS Protheus

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.

Integrao Backoffice Protheus X Bridge POS

Backoffice Protheus x Bridge POS

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)

Integrao Backoffice Protheus X Bridge POS

Backoffice Protheus x Bridge POS

4.2. Cadastros e Movimentos

Na sequncia sero listados os cadastros e movimentos envolvidos na integrao e suas definies.
Produtos
Alm da prpria estrutura de produtos, a integrao disponibiliza os seguintes recursos:
Itens similares ou equivalentes
Itens complementares
Grade de Produtos
Venda por cdigo de recolhimento/SKU
Venda de unidades de medida com possibilidade de converter a UM
Campos de controle que definem o comportamento do processo de venda:
o Venda em perodo restrito (bebidas alcoolicas)
o Permite devoluo
o Requer autorizao do Supervisor
o Permite quantidade fracionada
o Requer quantidade
o Requer preo
o Requer nmero de srie

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

Integrao Backoffice Protheus X Bridge POS

Backoffice Protheus x Bridge POS

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.

Integrao Backoffice Protheus X Bridge POS

Backoffice Protheus x Bridge POS

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.

Integrao Backoffice Protheus X Bridge POS

Backoffice Protheus x Bridge POS

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.

4.3. Servios da Integrao

Os servios Bridge que permitem o envio dos cadastros a partir da retaguarda ao PDV so:

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.

Cadastros relacionados com produtos:

Unidades de Medida
Tipos de produto
Nveis de hierarquia
Categorias de produtos
Cdigos de barra (captura)
Produtos
Fornecedores
Produtos similares
Produtos complementares
Tabela de preos por data de vigncia
Depsito (armazm)
Usurios
Pontos de venda
Dados da loja
Formas de pagamento
o Configurao de formas de pagamento
o Administradora Financeira de Protheus (Visa, Master, Amex)
Impostos
o IVA
o Impostos internos
o Percepes / Retenes
Configuraes e parmetros do sistema

J os servios Protheus responsveis por permitir o envio das movimentaes feitas no produto Bridge so:

Informao sobre os comprovantes de vendas/devolues

o Dados do cabealho da transao
o Dados fiscais da transao
o Dados da transao original (apenas para devolues)
o Detalhe dos produtos
Cdigo do produto
Cdigo de captura
Quantidade associada a unidade de medida
10

Integrao Backoffice Protheus X Bridge POS

Backoffice Protheus x Bridge POS

Preo
Desconto
IVA e Impostos calculados
Vendedor

o Detalhe de impostos da transao

Percepes/Retenes calculadas durante a transao
o Formas de pagamento
Tipo de pagamento
Data de vencimento
Valor pago
o Troco
o Totais da transao
Valor bruto positivo
Valor lquido
Total de descontos
Total de impostos

Informao de pr-vendas

Informao de outras movimentaes

o Tipo de transao: Entrada de troco/Sangria
o Formas de pagamento envolvidos:
Tipo de pagamento
Valor da transao
Reduo Z
Abertura e Fechamento de Caixa
Consulta de estoque
o Consulta de estoque por armazm
Reserva de estoque
Subida de clientes a partir do PDV
Consulta de Nota de Crdito
Consulta de pr-venda para ser finalizada no PDV.

4.4. Premissas e restries

1.
2.
3.
4.

As adequaes fiscais de ambos os sistemas abrangem o mercado argentino.

No faz parte da integrao o produto VTOL.
No ser realizada integrao direta entre Protheus e Bridge com o ambiente de Compras.
Os impostos cobrem cenrios com emisso de comprovantes fiscais de ticket ao consumidor final, ticket fatura (A/B),
notas de crdito (A/B) e emisso de faturas que correspondam quando os limites fiscais impedem a emisso de
ticket fatura.
5. As regras de desconto no esto integradas e sero aplicadas no PDV a partir da configurao no prprio Sistema
da Bridge.
6. No contemplada a consulta de estoque e nem a venda considerando o lote (rastreabilidade).
7. O produto Bridge POS suporta:
Plataformas: Windows e dispositivos que suportem JavaPOS, Bases de Dados SQL Express, Server
2008.
Hardware: PCs
Dispositivos suportados:

Integrao Backoffice Protheus X Bridge POS

11

Backoffice Protheus x Bridge POS

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.

7. Fluxo das Informaes

O detalhamento dos fluxos das informaes, esto mencionados no boletim tcnico mencionado na sesso anterior.

8. Anexos
O documento anexo contm informaes mais detalhadas sobre a arquitetura e funcionamento do sistema Protheus:

Boletim Tcnico: Integrao Protheus x Bridge POS.

12

Integrao Backoffice Protheus X Bridge POS