Integracao Backoffice Protheus x Bridge POS

Integrao Backoffice Protheus x Bridge POS

Dezembro/2014

Backoffice Protheus x Bridge POS

2 Integrao 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



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.



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.

ERP Microsiga

Protheus

Bridge Manager

Synthesis

Bridge POS

Synthesis

Cadastros

Movimentos



Integrao TOTVS Protheus x Synthesis Bridge Cadastros Rev. 1.5

TOTVS Protheus Bridge Manager Bridge POS

Clientes

Formas de Pagto.

BaseBridge POS

Base Bridge Manager

DE-PARA

Fornecedor

Codigo de Barras

Produtos

Unidade de Medida

Tipos de Produtos

Impostos Variveis

Tabela de Preos

Usurios/Caixas

Permisses

Estao/PDV

Vendedor

Regras de impostos

Parmetros de loja/

PDV

Regras de formas de

pagto.

Regras de Venda

PROMO (Promo

es)

PARTY

Categorias de

Produtos

Clientes

Clientes

Admin. Financiera

Estao

Caixas / Bancos

Grade de Produtos

Empresa/Filial

Moedas/Taxas

Usurios / Senha

Armazm

Produtos similares/complem.



Ttulo do documento

Integrao TOTVS Protheus x Synthesis Bridge Movimentos Rev. 1.5

TOTVS Protheus Bridge Manager Bridge POS

Vendas

Devolues

Entrada de troco

Sangria

Reduo Z

Base de dados Bridge

Manager

Base de dados Protheus SigaLoja

DE-PARA

Descontos

Pagamentos

Impostos

Abertura/Fechamento

de Caixa

Pr-venda

Nota de Crdito (NCC)

Reserva Produtos

ConsultaNCC

Consulta estoque

Cliente

Fechamento/ConsultaPr-Venda

Acumulado Dirio

XML - IXRetail

Consulta estoque

EstoqueEstoque (offline)

Estoque (offline)



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



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 pr-venda 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.

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



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. As adequaes fiscais de ambos os sistemas abrangem o mercado argentino. 2. No faz parte da integrao o produto VTOL. 3. No ser realizada integrao direta entre Protheus e Bridge com o ambiente de Compras. 4. 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:



Ttulo do documento

o Impressoras Fiscais. o Impressoras No Fiscais (Laser). o Leitor de Cdigos de Barras. o Leitor de tarja magntica. o Balanas (leitor de peso). o Gaveta de dinheiro. o Display de PDV. o 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.

http://www.synthesis-rs.com/http://tdn.totvs.com/pages/viewpage.action?pageId=181963082http://tdn.totvs.com/pages/viewpage.action?pageId=181963082

Documents

Integracao Backoffice Protheus x Bridge POS