Anda di halaman 1dari 39

Manual Tcnico

Integrao TOTVS
Backoffice RM x PDV Protheus




Data da reviso Responsvel Descrio da reviso
19/10/2010 rica Brando
Nunzio Autorino Junior
Verso inicial
24/11/2010 rica Brando Reviso do item Limitaes/Restries
28/12/2010 rica Brando Acrescentei notas ao item Arquitetura.
Acrescentei uma introduo ao item Adapter (EAI) RM e descrevi os itens Agente de Envio e
Agente de Recebimento.

Manual Tcnico - RM x PDV Protheus 2

Contedo
1 Introduo........................................................................................................................................ 4
1.1 Consideraes ..................................................................................................................................................... 4
1.2 Premissas ............................................................................................................................................................. 4
1.3 Controle de Verso .............................................................................................................................................. 4
1.4 Suporte ................................................................................................................................................................ 4
2 Arquitetura ...................................................................................................................................... 5
2.1 Mensagem Assncrona ........................................................................................................................................ 6
2.2 Mensagem Sncrona ............................................................................................................................................ 6
2.3 Fila (Channel) ....................................................................................................................................................... 7
2.4 Mensagem ........................................................................................................................................................... 7
2.5 Data e Hora ......................................................................................................................................................... 7
2.6 Envelope das mensagens .................................................................................................................................... 7
2.6.1 Envelope RM ................................................................................................................................................... 7
2.6.2 Envelope Protheus .......................................................................................................................................... 8
3 Pr-requisitos ................................................................................................................................... 9
3.1 Clientes ativos da base ........................................................................................................................................ 9
3.2 Clientes novos ..................................................................................................................................................... 9
3.3 Todos os clientes ............................................................................................................................................... 10
4 Contexto de negcio ...................................................................................................................... 11
5 Escopo e Finalidade ...................................................................................................................... 11
6 Transaes/Entidades .................................................................................................................... 13
7 Fluxo das informaes .................................................................................................................. 13
8 Limitaes/Restries ................................................................................................................... 14
9 Instalao / Atualizao ................................................................................................................ 15
9.1 ESB ..................................................................................................................................................................... 15
9.1.1 Pr-requisitos ................................................................................................................................................ 15
9.1.2 Instalao ...................................................................................................................................................... 15
9.1.3 Arquivos adicionais (Identificadores, Mapas e XSD) ..................................................................................... 15
9.1.4 Config | Open (Configurar Mapas)................................................................................................................ 16
9.1.5 Config | Edit Properties (Configurar o ByYou ESB) ....................................................................................... 19
9.1.6 Servio do ESB ............................................................................................................................................... 22
Manual Tcnico - RM x PDV Protheus 3
9.1.7 Monitor do ESB ............................................................................................................................................. 23
9.1.8 Arquivos de log do ESB ................................................................................................................................. 24
9.2 Adapter (EAI) Protheus ...................................................................................................................................... 24
9.2.1 Pr-Requisitos ............................................................................................................................................... 24
9.2.2 Parmetros.................................................................................................................................................... 24
9.2.3 Agent ............................................................................................................................................................. 25
9.2.4 Agendamentos .............................................................................................................................................. 26
9.2.5 Schedule ........................................................................................................................................................ 26
9.2.6 WebService de Recebimento ........................................................................................................................ 27
9.3 Protheus ............................................................................................................................................................ 28
9.3.1 Parmetros.................................................................................................................................................... 28
9.3.2 Menus ........................................................................................................................................................... 28
9.3.3 Configuraes ............................................................................................................................................... 29
9.4 Adapter (EAI) RM ............................................................................................................................................... 32
9.4.1 Pr-requisitos ................................................................................................................................................ 32
9.4.2 Instalao ...................................................................................................................................................... 32
9.4.3 Parmetros.................................................................................................................................................... 33
9.4.4 Configurao ................................................................................................................................................. 34
9.4.5 Monitor da Fila de Integrao ....................................................................................................................... 34
9.4.6 Agente de Envio ............................................................................................................................................ 35
9.4.7 Agente de Recebimento ............................................................................................................................... 36
9.5 RM ..................................................................................................................................................................... 36
9.5.1 FAQ ............................................................................................................................................................... 37

Manual Tcnico - RM x PDV Protheus 4
1 Introduo
Este documento tem por objetivo reunir todas as informaes relevantes sobre a Integrao do Backoffice RM x PDV
Protheus (SigaLoja + FrontLoja).
As informaes contidas neste documento foram revisadas tendo como referncia a verso 11.20 das linhas RM e
Protheus e a verso 5.1.123 do ByYou ESB.
1.1 Consideraes
Este pacote de integrao utiliza o produto TOTVS By You ESB como ESB e considera o desenvolvimento de adapters
em cada um dos produtos de software integrados.
O que ESB? ESB significa Enterprise Service Bus, ou em portugus, um barramento de servios corporativos. No ESB
criado um canal de comunicao entre sistemas heterogneos, eliminando a rigidez e fragilidade de uma integrao
ponto a ponto. Ele tambm faz controles de acesso de sistemas externos e permite configurar segurana das
mensagens. Como ele possvel fazer validaes e roteamento de mensagens baseado no contedo da mensagem, por
exemplo.
O desenvolvimento dos adapters est a cargo de cada uma das equipes de desenvolvimento dos produtos de software
e os dados que sero transacionados devero ser discutidos a cada atualizao deste projeto.
O que EAI? EAI significa Enterprise Application Integration, uma referncia aos princpios de arquitetura de sistemas
utilizados no processo de integrao de aplicaes corporativas. Neste projeto tambm comum nos referirmos aos
adapters de cada linha atravs da expresso EAI.
1.2 Premissas
Esta soluo deve primar pela simplicidade e facilidade de uso.
Facilidade de manuteno e facilidade de atualizao.
Deve respeitar os sistemas operacionais utilizados pelas solues software das marcas: WINDOWNS e LINUX.
Deve respeitar os bancos de dados utilizados pelas solues ERP das marcas: SQL SERVER, ORACLE, DB2,
MYSQL, DB2400, POSTGRES.
1.3 Controle de Verso
O grupo TOTVS representado por suas marcas ir administrar as demandas de evoluo dos layouts e demais ajustes,
acordando junto aos solicitantes o prazo de liberao de release.
Todas as evolues programadas devero ser discutidas e aprovadas pelas marcas antes do incio do desenvolvimento e
somente sero desenvolvidas em caso de concordncia das marcas e alinhamento com as diretivas definidas pelo
Comit de Integrao TOTVS.
1.4 Suporte
O suporte aos recursos da Integrao ser de responsabilidade de todas as marcas, porm o suporte nvel 1 (primeira
anlise) ser oferecido pela TOTVS BH, equipe RM Nucleus.
Manual Tcnico - RM x PDV Protheus 5
2 Arquitetura
Independente da transao que ser realizada entre os produtos de software, cada um deles dever ter um adapter
para enviar a transao para o ESB e um adapter para receber a transao de retorno, conforme o caso.
O adapter de envio consiste em uma rotina/programa que recebe uma determinada informao, envelopa em um
container XML padro
1
e entrega este XML ao ESB.
O ESB por sua vez, processa a mensagem, realiza a transformao
2
dos dados e entrega ao adapter destinatrio, em
qualquer um dos protocolos que o ESB suportar.
O adapter destinatrio ir processar a transao e encerrar o processo.

1
o formato do XML definido em um arquivo XSD
2
a transformao definida em um arquivo XSL

Notas:
O adapter pode ser chamado tambm de EAI.
A origem pode ser, por exemplo, o Backoffice RM; neste caso o Adapter de Origem o TOTVS Business Connect
(TBC) tambm conhecido por RM Conector. O RM Conector um produto da linha RM usado para qualquer
pacote de integrao da linha RM com demais produtos da linha TOTVS ou com terceiros. No meio do caminho
temos o ByYou ESB. No destino temos o PDV Siga Loja Protheus, que tambm possui um adapter (ou EAI)
porm o EAI Protheus considerado uma funo do produto padro e no tem um nome de produto.
Manual Tcnico - RM x PDV Protheus 6
2.1 Mensagem Assncrona

A Aplicao Origem disponibiliza uma mensagem XML via Adapter de Envio para uma Fila.
A Fila ser lida por um Agente que enviar a mensagem para o WebService no ESB.
O ESB recebe a mensagem (XML), transforma e envia no formato esperado a um WS no destino.
A mensagem ser armazenada em uma Fila (Banco de Dados) no Destino.
O Agente de Recebimento l a mensagem da Fila e entrega ao Adapter de Recebimento (Destino).
O Adapter de Recebimento processa os dados na Aplicao Destino.
2.2 Mensagem Sncrona

A Aplicao Origem envia uma mensagem XML via Adapter de Envio para o Web Service (WS) no ESB.
O ESB recebe a mensagem (XML), transforma no formato esperado pelo destinatrio e envia a um WS no
destinatrio, aguardando retorno que deve ser devolvido origem.
Manual Tcnico - RM x PDV Protheus 7
2.3 Fila (Channel)
A fila o repositrio utilizado para troca de mensagens numa arquitetura de transmisso de mensagem (Messaging).
Ela acessada pelas aplicaes que a usam como repositrio onde as mensagens so guardadas para depois serem
transmitidas ou recebidas por outro aplicativo.
2.4 Mensagem
A mensagem a unidade que transportada entre sistemas e indica uma transao em um dos sistemas.
Na integrao TOTVS as mensagens sero transmitidas no formato XML. A especificao do documento XML adotada
a recomendao W3C para XML 1.0, disponvel em www.w3.org/TR/REC-xml e a codificao dos caracteres ser em
UTF-8, assim todos os documentos XML sero iniciados com a seguinte declarao:
<?xml version="1.0" encoding="UTF-8"?>
Lembrando que cada arquivo XML deve conter uma nica declarao.
2.5 Data e Hora
O campo do tipo DateTime do envelope deve ser enviado no formato YYYY-MM-DDThh:mm:ss.sTZD, onde:
YYYY = ano com 4 dgitos
MM = ms com 2 dgitos (01=Janeiro etc)
DD = dia do ms com 2 dgitos (01 at 31)
hh = hora com 2 dgitos (00 at 23) (am/pm no aceito)
mm = minutes com 2 dgitos (00 at 59)
ss = segundos com 2 dgitos (00 at 59)
s = milisegundos com um ou mais dgitos
TZD = time zone (Z ou +hh:mm ou -hh:mm)
Exemplo: 23 de abril de 2009, 12:00h, horrio de Braslia, pode ser representado nas formas:
2009-04-23T12:00:00.0000000-03:00
2009-04-23T15:00:00.0000000Z
Nota: veja http://www.w3.org/TR/NOTE-datetime, para mais informaes.
2.6 Envelope das mensagens
Toda mensagem enviada ou recebida na integrao ser transportada dentro de um envelope (XML).
2.6.1 Envelope RM
Todas as mensagens enviadas pela RM tero o mesmo formato. E todas as mensagens recebidas devero ser
convertidas para este formato:
<?xml version="1.0" encoding="utf-8"?>
<TOTVSMessage>
<GlobalProduct/>
<GlobalDocumentFunctionCode/>
<GlobalDocFunctionDescription/>
<DocVersion/>
<DocDateTime/>
<DocIdentifier/>
<DocCompany/>
<DocBranch/>
<DocName/>
<DocFederalID/>
<DocType/>
<OperationType/>
<QueueType/>
<QueueDataServer/>
Manual Tcnico - RM x PDV Protheus 8
<QueueRefs/>
<QueueStatus/>
<QueueProcessDateTime/>
<QueueAttempt/>
<QueueError/>
<Message/>
</TOTVSMessage>
A RM utiliza os mesmos elementos do XML da mensagem como campos da fila de integrao (tabela
HFILAINTEGRACAO):
Campo Descrio Tipo (SQLServer) Aceita nulo
GlobalProduct Nome do produto, ou seja, RM varchar(20) sim
GlobalDocumentFunctionCode
Nome da Entidade. Haver uma lista pr-definida
para cada projeto de Integrao.
varchar(20) no
GlobalDocFunctionDescription Descrio da entidade varchar(60) no
DocVersion Verso varchar(4) sim
DocDateTime Data e hora de incluso na fila datetime no
DocIdentifier
Identificador UUID (Universal Unique Identifier) ver
http://www.ietf.org/rfc/rfc4122.txt
varchar(40) no
DocCompany Coligada (Empresa) int sim
DocBranch Filial int sim
DocName Nome Fantasia da Empresa varchar(60) sim
DocFederalID CGC da Empresa varchar(20) sim
DocType Tipo de processamento: 1 (Sncrono); 2 (Assncrono) varchar(1) no
OperationType
Tipo de operao: I(Incluso); A(Alterao);
E(Excluso)
varchar(1) no
QueueType Sentido: 1(Sada); 2(Entrada) int no
QueueDataServer Data Server varchar(40) no
QueueRefs Valores que identificam a instncia varchar(255) sim
QueueStatus
Status: 0(no processado); 1(processado com
sucesso) e outros valores erro.
int no
QueueProcessDateTime Data e hora de processamento datetime sim
QueueAttempt Nmero de tentativas de processamento int no
QueueError Mensagem de erro de processamento varchar(max) sim
Message Mensagem no formato XML varchar(max) no

No RM cada entidade ser identificada conforme tabela a seguir

Processo / Entidade GlobalDocumentFunctionCode GlobalDocumentFunctionDescription QueueDataServer
Cliente CLIENTE Cadastro de Cliente FinCFODataBR
Produto PRODUTO Cadastro de Produto EstPrdDataBR
Crdito de Devoluo CREDITO Crdito de Devoluo ConVendaData
Estao PDV ESTACAOPDV Estao PDV ConPontoVendaData
Vendedor VENDEDOR Cadastro de Vendedores ConVendedorData
Venda CUPOMFISCAL Cupom Fiscal ConVendaData
Venda Cancelada ITENSCFCANCELADO Itens do cupom fiscal cancelado durante a venda ConVendaData
Sangria SANGRIA Sangria de Caixa ConVendaData
Suprimento SUPRIMENTO Fundo de Troco ConVendaData
Mapa Resumo (ReduoZ) REDUCAOZ Mapa Resumo Reduo Z ConVendaData
2.6.2 Envelope Protheus
De forma semelhante todas as mensagens enviadas pelo Protheus tero um formato nico. E todas as mensagens
recebidas devero ser convertidas para este formato, ligeiramente diferente do formato RM, como segue:
<?xml version="1.0" encoding="utf-8"?>
<TOTVSIntegrator>
<GlobalProduct/>
<GlobalFunctionCode/>
<GlobalDocumentFunctionCode/>
Manual Tcnico - RM x PDV Protheus 9
<GlobalDocumentFunctionDescription/>
<DocVersion/>
<DocDateTime/>
<DocIdentifier/>
<DocCompany/>
<DocBranch/>
<DocName/>
<DocFederalID/>
<DocType/>
<Message>
<Layouts>
<Identifier/>
<Version/>
<FunctionCode/>
<Content/>
</Layouts>
</Message>
</TOTVSIntegrator>

Descrio dos elementos do XML:
TOTVSIntegrator: Tag principal do XML.
GlobalProduct: Identificao do Produto gerador da mensagem.
GlobalFunctionCode: HardCode EAI.
GlobalDocumentFunctionCode: Identifica qual processo ser executado no diagrama do integrator.
GlobalDocumentFunctionDescription: Descrio do processo.
DocDateTime: Data da mensagem.
DocIdentifier: Identificador nico da mensagem.
DocCompany: Cdigo da empresa.
DocBranch: Cdigo da filial.
DocName: Nome da empresa.
DocFederalID: Identificao da empresa (CGC).
DocType: Tipo de processamento (1- Sncrono ; 2- Assncrono).
Message: Contedo da mensagem.
3 Pr-requisitos
3.1 Clientes ativos da base
Protheus (SigaLoja e FrontLoja): verso 10 Release 1.3 ou superior
RM (BibliotecaRM, TBC e RMNucleus): verso 11.20 (ultimo patch e especfica)
ByYou ESB: 5.1.120 ou superior
Base de dados RM na verso 11.20 no novo modelo de BackOffice
3.2 Clientes novos
Protheus (SigaLoja e FrontLoja): verso 10.0 Release 1.3 ou superior
RM (BibliotecaRM, TBC e RMNucleus): verso 11.20 (ultimo patch e especfica)
ByYou ESB: 5.1.123 ou superior
Base de dados RM na verso 11.20 no novo modelo de BackOffice
Observao: todos estes produtos utilizam o modelo de licenciamento TOTVS padro (Licence Server). Se o modelo de
licenciamento adotado pelo cliente no for o TOTVS Full ser necessria uma licena especfica (Licena Web) para os
WS do Protheus. As licenas (hard lock) devem ser providenciadas junto a TOTVS com a devida antecedncia.
Manual Tcnico - RM x PDV Protheus 10
3.3 Todos os clientes
Banco de dados homologados e demais requisitos ver documentao padro de cada linha de produto.
Se o cliente j possui base de dados implantada do RM ou do Microsiga ser responsabilidade da equipe de
implantao efetuar a carga inicial e/ou sincronismo dos cadastros. A integrao ir efetuar o sincronismo
automtico de novos registros ou alteraes posteriores ativao da integrao.
Observao: J existe um aplicativo no Protheus (EAI desta integrao) para carga inicial de Vendedores e
Estaes (PDV). O RM possui alguns scripts (triggers) que podem ser usados para enviar a carga de
produtos/cdigo de barras e clientes para a fila de integrao do EAI do RM. Consultar a GDP Integrao.
Manual Tcnico - RM x PDV Protheus 11
4 Contexto de negcio
O SigaLoja e o FrontLoja Protheus so os produtos TOTVS para gesto de vendas no varejo (emisso de cupom fiscal),
sendo necessria a integrao com o Backoffice RM para viabilizar a utilizao destes nos clientes do segmento de
varejo.
Existem parcerias da TOTVS com sistemas de terceiros para utilizao com a linha RM. Porm a TOTVS sugere a
substituio gradual destes pelo Protheus.
5 Escopo e Finalidade
A seguir uma breve descrio como devero ser tratados os principais processos dos clientes.

Recebimento de Mercadorias
Descrio do processo: Corresponde ao lanamento da NF de entrada de mercadoria no RM.
Implantao: Utilizar lanamento de movimento no RM Nucleus. Este processo no ser alterado devido integrao.

Pagamento de boletos
Descrio do processo: Processo que corresponde baixa de uma conta a pagar a favor de um fornecedor.
Implantao: Utilizar a baixa de lanamento financeiro no RM Fluxus. Este processo no ser alterado devido
integrao.

Troca
Descrio do processo: Processo de troca de mercadoria, na mesma loja onde foi adquirida, com retorno do item no
estoque e emisso de um crdito para o cliente. Este crdito utilizado total ou parcial como meio de pagamento em
uma nova compra, com emisso de novo cupom fiscal.
Implantao: A troca de mercadoria deve ser feita diretamente no RM Nucleus, atravs de um tipo de movimento
especfico com nome de Troca (item de cupom fiscal). Este movimento deve ser gerado pelo processo de cpia por
referncia do cupom fiscal/item/quantidade que est sendo trocado. O movimento de Troca far uma entrada de
mercadoria no estoque, no tem integrao financeira, nem contbil e nem fiscal. O prprio job de Envio da Integrao
TOTVS ir gerar a mensagem de crdito, registrar na fila de Integrao, e enviar para o Protheus. Este crdito poder
ser usado total ou parcialmente em outra compra (o meio de pagamento desta incluir vale-compra).

Pr-venda
Descrio do processo/ Implantao: Processo bsico do PDV Protheus. Este processo no ser alterado devido
integrao.

Encomenda
Descrio do processo: o cliente deseja adquirir um produto que no est no estoque, feita uma encomenda ao
fabricante e marcada a data de entrega para o cliente.
Implantao: Lanar um Pedido de Venda no RM Nucleus, em nome do cliente, gerando um adiantamento no RM
Fluxus e emitindo um comprovante/vale-compra (RM Gerador de relatrios).
Na chegada da mercadoria o usurio deve lanar a NF de entrada de mercadoria. Observao: o controle de reserva da
mercadoria deve ser manual (avaliar uso de saldos especficos).
Na retirada da mercadoria o cliente ir apresentar o pedido e o vale-compras. A condio de pagamento deve ser
Manual Tcnico - RM x PDV Protheus 12
especfica para venda com adiantamento, desta forma quando o cupom for includo no RM Nucleus, via Integrao
TOTVS, o lanamento financeiro no ser baixado automaticamente. No RM Nucleus relacionar Pedido de Venda e
Cupom Fiscal. E no RM Fluxus fazer a baixa relacionando o pagamento e adiantamento.

Nota Sobre Cupom
Descrio do processo: Emisso de NF sobre Cupom.
Implantao: No RM Nucleus o usurio deve localizar o Cupom Fiscal (j recebido via Integrao TOTVS) e gerar
movimento especfico a partir deste cupom. O movimento gerado deve ser previamente configurado para impresso
automtica da NF (gerador de relatrios), e no gera integrao financeira nem fiscal (j feito pelo cupom).

Reserva de mercadoria de outra empresa do grupo
Descrio do processo: quando uma mercadoria no est disponvel em uma loja a, mas est disponvel em uma loja
b do grupo. Considerando que cada loja uma empresa (coligada) independente, a mercadoria no pode
simplesmente ser transferida (isto somente poderia ocorrer entre Filiais). Por isso, deve ocorrer uma sada da
mercadoria da loja b e uma entrada da mercadoria na loja a. E s ento efetuada a venda, com emisso de cupom
fiscal, na loja a. Observao: movimentos devidamente acobertados de validade fiscal e financeira.
Implantao: No RM Nucleus cada loja/empresa ser cadastrada como um cliente/fornecedor. O usurio dever
acessar a coligada correspondente loja fornecedora, cadastrar um pedido de venda da mercadoria para o
cliente/loja destino. O pedido ser faturado e a mercadoria encaminhada loja destino. Cadastrar a entrada da
mercadoria na loja destino e efetuar a venda ao cliente normalmente pelo Front Loja.

Desconto
Descrio do processo/ Implantao: processo bsico do PDV Protheus.

Alterar o oramento no caixa
Descrio do processo/ Implantao: processo bsico do PDV Protheus.

Conciliador TEF
Descrio do processo: Processo que corresponde conciliao de ttulos referentes TEF, com efeito de baixa dos
lanamentos financeiros correspondentes.
Implantao: A RM no possui tal funcionalidade hoje. A RM tem planos para acrescentar esta funo ao produto RM
Fluxus padro, porm o estudo de viabilidade ocorrer na primeira quinzena de Agosto/09. Somente aps esta data
que poderemos afirmar se ser feito, como ser feito e quando estar disponvel para o cliente. Assim, caso o cliente
no tenha interesse em aguardar esta informao poder solicitar uma proposta de customizao com a TOTVS.
Manual Tcnico - RM x PDV Protheus 13
6 Transaes/Entidades
A Integrao do Backoffice RM com o PDV Microsiga Protheus contempla a sincronizao automtica das seguintes
entidades:
De RM para Protheus De Protheus para RM
PRODUTO ESTAO PDV
CLIENTE VENDEDOR
CRDITO DE TROCA CUPOMFISCAL
CUPOM FISCAL CANCELADO
SANGRIA
SUPRIMENTO
REDUCAOZ
7 Fluxo das informaes
Entidade Restries
Coligada/Empresa
Cadastrar manualmente dos dois lados. No h sincronismo desta entidade via Integrao TOTVS.
O cdigo de coligada (GCOLIGADA.CODCOLIGADA) no RM deve ser igual ao cdigo de empresa no Protheus.
Filial
Cadastrar manualmente dos dois lados. No h sincronismo desta entidade via Integrao TOTVS.
O cdigo de filial (GFILIAL.CODFILIAL) no RM deve ser igual ao cdigo de filial no Protheus.
Srie
Cadastrar manualmente dos dois lados (ao menos as sries relacionadas aos tipos de movimento de Cupom
Fiscal, que tambm so relacionadas ao cdigo do ECF, ou seja, PONTOVENDA na TPONTOVENDA).
Tributos
O cadastro dos Tributos deve ser feito no RM (DTRIBUTO) e sero referenciados no cadastro da Tributao
ECF.
Tributao ECF
O cadastro da Tributao ECF deve ser feito no RM (TTRIBUTACAOECF) e sincronizado para o Protheus, junto
com o cadastro de produto, via Integrao TOTVS. Sendo: Tributado: TIPO=zero e CODTRB=ICMS; Servio:
TIPO=zero e CODTRB=ISS; No Tributado: TIPO=3; Substitudo: TIPO=2; Isento: TIPO=1

Veja mais detalhes em x.
Tipo de Documento
Deve ser feito cadastro de tipo de documento no RM, definir obrigatoriamente os parmetros Gera Numero
do Documento e Cdigo do Modelo do Documento ('37','2B','2C','2D' ...). No h sincronismo desta entidade,
ela necessria para o cadastro de Tipo de Movimento.
Tipo de Movimento
Devero ser configurados no RM os Tipos de Movimento necessrios integrao (Cupom Fiscal, Sangria,
Suprimento, Troca etc). Lembrando que necessrio atribuir as devidas permisses de acesso a estes TMV.
O cadastro do Tipo de Movimento de Devoluo no deve editar Natureza e deve copiar o cliente do Cupom.
O cadastro do Tipo de Movimento de Cupom Fiscal deve ter o parmetro Gerar Escrituracao marcado e
informar o Tipo de Documento obrigatoriamente. Garantir que a frmula de valor lquido considera os
descontos e acrscimos possveis.
Estao PDV
O cadastro deve ser feito no Protheus e sincronizado para o RM via Integrao TOTVS.
O cdigo do ponto de venda no RM (TPONTOVENDA.PONTOVENDA) deve ser igual ao cdigo do ECF no
Protheus (SLG.LG_PDV).
Como os TMV so definidos no cadastro de ponto de venda do RM, vamos atribuir valores fixos para estes
campos no XSL. Caso seja necessrio alterar o TMV no Ponto de Venda isto deve ser feito tambm no XSL.
Obs: No RM cada Ponto de Venda deve ser relacionado a um Grupo de Venda, mas no ser necessrio
cadastrar o Grupo de Venda, pois o prprio DataServer usado para incluir o Ponto de Venda ir resolver isto,
relacionando cada ponto de venda includo a um Grupo existente ou cadastrando um grupo 001.
Todos os registros na TPONTOVENDA devem ser TIPO=1, seno ocorrer um erro (cria movimento, mas no
cria o cupom fiscal).
No permitir incluir Estao/Ponto de Venda no RM.
Condio de Pagamento
( Vista, 2x etc)
Cadastrar manualmente dos dois lados. O cdigo da Condio de Pagamento no RM (TCPG.CODCPG) deve ser
igual ao cdigo no Protheus (SE4.E4_CODIGO).
Cadastrar no RM a condio de pagamento CN (Condio Negociada). Este pode ser utilizado pelo Protheus
mesmo sem estar cadastrado na base de dados, pois fixo no cdigo fonte.
Forma de Pagamento (Dinheiro,
Cheque etc)
Cadastrar manualmente dos dois lados. O cdigo da forma de pagamento no RM
(TFORMAPAGTO.CODFORMAPAGTO ) deve ser igual ao cdigo no Protheus (SX5.X5CHAVE).
Obs: alguns cdigos no Protheus so pr-cadastrados e NO podem ser alterados ou excludos (ex: CC = Carto
Manual Tcnico - RM x PDV Protheus 14
de Crdito, CH = Cheque, R$ = Dinheiro, CR = Crdito*) e devem existir no RM.
*Cadastrar CR como tipo Vale
Unidades de Medida
Cadastrar manualmente dos dois lados. O cdigo da Unidade de Medida no RM (TUND.CODUND) deve ser
igual ao cdigo no Protheus, inclusive escritas de forma idntica, letras maiscula so consideradas diferentes
de letras minsculas. Nota: este cadastro no possui sincronizao automtica.
Obs: o cdigo da unidade deve ter no mximo 2 caracteres.
Deve ser cadastrada a unidade padro UN.
Produtos, Preo e Cdigos de
Barras
O cadastro deve ser feito no RM e sincronizado para o Protheus via Integrao TOTVS. O cdigo do Produto no
RM (TPRD.CODIGOPRD) deve ser igual ao cdigo no Protheus (SB1.B1_COD).
Obs: O cdigo deve ter no mximo 15 caracteres. Caso existam produtos ativos com cdigo superior ser
necessrio ajustar o estoque para zero (inventrio), criar novo produto com saldo correspondente e inativar o
anterior.
Nome fantasia mximo de 30 caracteres.
Configurar o parmetro para utilizar preo com apenas 2 casas decimais. O preo do produto dever ser
atualizado no RM nos campos de preo da tabela de produto (PRECO1 a PRECO5).
O cdigo de barras de produto deve possuir no mximo 15 caracteres.
Deve ser cadastrado o produto 9999999991, padro para Sangria, Suprimento etc.
Informe o tributo ECF do produto
Vendedores
O cadastro deve ser feito no Protheus e sincronizado para o RM via Integrao TOTVS.
O Protheus possui um Vendedor Padro que deve existir no RM. No permitir incluir/alterar Vendedor no
RM.
Clientes
O cadastro deve ser feito no RM e sincronizado para o Protheus via Integrao TOTVS.
O cdigo de cliente no RM deve ser automtico e a mscara deve ser a mesma no RM e no Protheus.
Quando houver mais de uma coligada, o cadastro de Clientes no RM deve ser sempre GLOBAL (coligada=0).
Habilitar o parmetro cliente global.
O Protheus possui um Cliente Padro que deve existir no RM.
Outras restries para cadastro no RM: campo NOME mximo de 40 caracteres; NOMEFANTASIA mximo de
20 caracteres; CIDADE mximo de 15 caracteres; FAX mximo de 8 dgitos numricos; CONTATO mximo de 15
caracteres;
RUA + NUMERO + COMPLEMENTO mximo de 40 caracteres (idem para endereo de entrega e de cobrana);
No perfil de usurio devemos tornar obrigatrio o preenchimento dos campos NOME e NOMEFANTASIA,
CODETD e CIDADE, pois quando estes no forem informados ocorrer um erro na importao deste cliente
pelo Protheus. Obs: Para isto, no dilogo do Cliente tem que marcar a opo Preenchimento Obrigatrio.
Parametrizar o RM para que o CPF/CNPJ sejam obrigatrios e nicos.
Cupom Fiscal O processo ocorre apenas no Protheus e sincronizado para o RM via Integrao TOTVS.
Sangria e Suprimento
O processo ocorre apenas no Protheus e sincronizado para o RM via Integrao TOTVS.
Sero usados alguns valores default, que devem ser previamente cadastrados:
Produto 9999999991 Sangria; Produto 9999999992 Suprimento; Forma de pagamento R$ - Dinheiro.
Deve tambm ser cadastrado o Meio de Pagamento com os seguintes cdigos:
TFORMAPAGTO.IDFORMAPAGTO = 91 Sangria / TFORMAPAGTO.IDFORMAPAGTO = 92 Suprimento.
Troca / Crdito
O processo de Troca ocorre apenas no RM Nucleus, com envio de um crdito para ser usado como meio de
pagamento no Protheus.
***Pendente: explicar a utilizao das extenses nos arquivos XSD.
8 Limitaes/Restries
O pacote de integrao foi homologado tendo o FrontLoja como mdulo de frente de loja. E o SigaLoja como
retaguarda. As mensagens de integrao so enviadas ao EAI Protheus e processadas para o SigaLoja .
Como j ocorre na implantao do RM padro, ser responsabilidade do usurio supervisor (e do consultor de
implantao) realizar ajustes no cadastro de segurana do Backoffice
Por uma particularidade do RM Nucleus ser necessrio setar um parmetro na tabela TFParametro INSERT
INTO TFPARAMETRO VALUES (1, 'SANGRIASUPRIMENTO', 'Gerao de movimento de sangria & suprimento',
0,0,'1', getdate())
Como somente haver sincronizao automtica do que for includo ou alterado aps a implantao da
integrao, se houverem registros anteriores ser responsabilidade do consultor de implantao efetuar
sincronismo manual, conforme o caso.
Manual Tcnico - RM x PDV Protheus 15
9 Instalao / Atualizao
9.1 ESB
O ByYou ESB ser responsvel receber, transformar e entregar as mensagens XML atravs de WebServices.
No escopo deste documento detalhar o funcionamento do ByYou ESB, iremos descrever apenas as configuraes
que devem ser revisadas pelos consultores de implantao neste projeto de integrao.
Para mais informaes consultar os treinamentos disponveis sobre este produto.
9.1.1 Pr-requisitos
O ESB pode utilizar diferentes bancos de dados, mas recomenda-se optar pelo SQL Server. Ao optar pelo SQL Server
deve-se criar um banco de dados (vazio) no SQL Server. Sugerimos usar uma instncia nomeada do SQLServer e chamar
o banco pelo nome ESB.
9.1.2 Instalao
A instalao do ByYou ESB simples, basta seguir as orientaes do assistente de instalao. Para mais detalhes
consulte o Guia de Instalao do ByYou ESB.
Dica: No marque a opo iniciar os servios automaticamente, pois antes voc precisa configurar o ESB.
9.1.3 Arquivos adicionais (Identificadores, Mapas e XSD)
Para este projeto de integrao ser distribudo um pacote de arquivos adicionais, ou um Template para integrao do
Backoffice RM com o PDV Protheus. Copiar estes arquivos para o diretrio de instalao do ESB, ficando como segue:

Pasta Mapas: contm os arquivos *.xsl, ou seja, arquivos de transformao de XMLs.
Pasta Identificadores: contm arquivos *.std, que so arquivos criados no prprio ESB para identificar campos
especficos dentro das mensagens XML para poder referenciar seu contedo no Diagrama ou no Monitor do
ESB.
Pasta XSD: arquivos *.xsd para fins de documentao.
Manual Tcnico - RM x PDV Protheus 16
Arquivo esb-config.xml: o Diagrama do ESB, formato de workflow. Neste projeto define, por exemplo, que a
mensagem passar por uma transformao e ser enviada a um WebService especfico.
Nota: no basta copiar este arquivo, ser necessrio abrir os diagramas no aplicativo ESB Editor, como ser
descrito neste documento.
9.1.4 Config | Open (Configurar Mapas)
Aps a instalao, localize e abra o ESB Editor.
Acesse o menu Config | Open, e abra o arquivo esb-config.xml (parte do pacote de arquivos especficos desta
integrao). Na janela principal do ESB sero mostrados 2 diagramas:

No recomendamos alterar estes diagramas, ajustar apenas os dados para conexo com os WebServices.
9.1.4.1 ProtheusReceiver
O Protheus deve ser configurado para enviar as mensagens de integrao para o diagrama ProtheusReceiver, que ir
identificar o assunto da mensagem, fazer a transformao para o formato esperado pelo RM e enviar para o
WebService RM.

D um duplo clique no componente WSSenderToRM e ajuste o parmetro WSDL Path com o servidor e porta
correspondentes ao WS do RM. Nota: a porta 8050, padro, no precisa ser informada.
Manual Tcnico - RM x PDV Protheus 17

O boto List Operations somente carregar a lista Operation se o endereo do WS for vlido. Use este boto para
testar a sua configurao.
Manual Tcnico - RM x PDV Protheus 18
Dica
Para conferir o endereo do WS RM: aps a instalao do TBC acesse o IIS, localize a aplicao TOTVS Business Connect
e escolha Browse.

Ser apresentada a pgina principal do TBC, com todos os WebServices disponveis, inclusive o wsTOTVSMessage que
usado neste projeto de integrao:

Clique no link wsTOTVSMessage.asmx?wsdl

Copie o endereo do navegador, no exemplo: http://localhost/TOTVSBusinessConnect/wsTOTVSMessage.asmx?wsdl

Escolha o Operation ReceberArquivo, este mtodo responsvel pelo recebimento das mensagens no RM.
Manual Tcnico - RM x PDV Protheus 19
O WS RM usa autenticao TOKEN e precisa que seja informado tambm um usurio e senha vlidos no RM.

9.1.4.2 RMReceiver
O RM deve ser configurado para enviar as mensagens de integrao para o diagrama RMReceiver, que ir identificar o
assunto da mensagem, fazer a transformao para o formato esperado pelo Protheus e enviar para o WebService
Protheus.

Clicar com o boto direito no componente WSSenderToProtheus e selecionar a opo Properties. Ajustar o parmetro
WSDL Path com o servidor e porta correspondentes ao WS do Protheus. Veja o formato desta URL no item Adapter
(EAI) Protheus | Parmetros, neste mesmo documento.

O boto List Operations somente carregar a lista Operation se o endereo do WS for vlido. Use este boto para
testar a sua configurao.
Escolha o Operation SENDMESSAGE, este mtodo responsvel pelo recebimento das mensagens no Protheus.
9.1.5 Config | Edit Properties (Configurar o ByYou ESB)
Acessar o menu Config | Edit Properties e verificar as configuraes, como segue:
Manual Tcnico - RM x PDV Protheus 20
Configuration | System Properties | General: Configure as portas para o servio principal do ESB e para o
servio do Monitor do ESB.


Em Database Configuration | ESB escolha o servidor de banco de dados SQLServer. Informe a URL (string de
conexo) alm de um usurio e a senha para conexo com o banco criado previamente.
Use o boto Test Connection para verificar se as suas configuraes esto corretas.

Dica
Para no errar o nmero da porta utilizada quando estiver usando instncia nomeada no SQLServer, abra o
aplicativo SQL Server Configuration Manager | Protocols for [nome da instncia] | TCP/IP | Properties. E
localize a propriedade TCP Dynamics Ports.


Manual Tcnico - RM x PDV Protheus 21
Em Internal HTTP Server informe a porta utilizada pelo WebService do ESB.


Dica
O RM e o Protheus precisaro conhecer o endereo do WS do ESB. Para no errar copie a URL definida no
parmetro Internal HTTP Server | Services | WSChannel | WebServices (Use=Literal e Style=RPC):

Retire a string ?wsdl no final.
Substitua [server] pelo nome do servidor do ESB e [port] pelo parmetro Internal HTTP Server | Port.

Exemplo: http://localhost:9874/ws/totvsesb/wsdl11/literal/rpc

Manual Tcnico - RM x PDV Protheus 22
Em License Configuration configure a forma de Licenciamento. Normalmente usada a Categoria Hard Lock
(modelo padro TOTVS License Server).



Dica
Nota: o ByYou ESB necessida de uma licena especfica, vendida separadamente (licena de tecnologia) no
est includa em nenhum outro pacote, nem no TOTVS Full.
Mas se voc possui um certificado vlido (modelo antigo de licenciamento do ESB, arquivo .certs) ainda
poder utiliz-lo. Para isto copie o seu arquivo para o diretrio de instalao do ESB e no ESB Editor | License
Category informe dados invlidos. Exemplo: Hostname = lixo; LS Port = 0000; Client Port = 0000


Nota: toda vez que alterar a configurao do ESB no se esquea de Salvar as alteraes antes de iniciar (ou re-iniciar) o
servio do ESB. Somente assim ele passar a tratar as alteraes.

9.1.6 Servio do ESB
Quando o servio do ESB for iniciado pela primeira vez o banco de dados ser criado automaticamente. As informaes
no console podem variar, dependendo do nvel de detalhamento do log. Se no ocorrer nenhum erro, ser escrita uma
linha semelhante a Started SelectChannelConnector... quando as inicializaes terminarem e o ESB j poder ser
utilizado.
Manual Tcnico - RM x PDV Protheus 23

A partir da o servio pode ser configurado para iniciar automaticamente no services.msc.

9.1.7 Monitor do ESB
Uma vez iniciado o servio principal do ESB, voc precisa iniciar o servido do Monitor (Monitor Server Startup):
Nota: o ByYou ESB escrito em Java e utiliza o Tomcat para hospedar seu WebService.



O Monitor do ByYou ESB permite ao usurio supervisor gerenciar as
mensagens recebidas ou enviadas pelo ESB.
Digite o endereo HTTP://[server]:[port]/esb/monitor/monitor.html no
seu navegador.
Dica: Verifique a porta nos parmetros do ESB (Config | Edit Properties |
Configuration | System Properties | General | Monitor Port).

Manual Tcnico - RM x PDV Protheus 24
9.1.8 Arquivos de log do ESB

O ESB gera arquivos de log, no formato texto, na pasta \Log (a partir do
diretrio de instalao do ESB) e eventualmente estes arquivos podero
ser solicitados pela equipe de suporte.
O nvel de detalhamento deste arquivo est definido por um parmetro
no ESB Editor (Config | Edit Properties | Configuration | Log4j | Level of
Log).
9.2 Adapter (EAI) Protheus
responsvel por armazenar as mensagens de envio e recebimento da integrao na tabela XX3.
9.2.1 Pr-Requisitos
Instalar TOTVS DBAccess 4.2 (antigo TOPConnect)
Configurar o Data Source ODBC
9.2.2 Parmetros

Acesse o aplicativo TOTVSSmartClient.exe. Selecione o mdulo SIGACFG
(Configurador). Acesse o menu Ambiente | Cadastro | Parmetros.
MV_LJGRINT (Habilita integrao Backoffice RM x PDV Protheus): informar T
MV_EAIURL (Endereo do WS do ESB)
Dica: Acesse o aplicativo ESB Editor. Copie a URL definida no parmetro Internal HTTP Server | Services |
WSChannel | WebServices (Use=Literal e Style=RPC).



Retire a string ?wsdl no final. Substitua [server] pelo nome do servidor do ESB e [port] pelo parmetro
Internal HTTP Server | Port.
Manual Tcnico - RM x PDV Protheus 25


Exemplo: http://localhost:9874/ws/totvsesb/wsdl11/literal/rpc

MV_EAIPORT (Nome do diagrama do ESB que dever receber as mensagens do Protheus)
Dica: Acesse o aplicativo ESB Editor. Copie o nome do diagrama correspondente.

Exemplo: ProtheusReceiver
9.2.3 Agent
responsvel por gerenciar as execues e distribuir as tarefas.
Acesse o aplicativo TOTVSSmartClient.exe. Selecione o mdulo SIGACFG (Configurador). Acesse o menu Ambiente |
Schedule | Schedule.
Ser necessrio cadastrar pelo menos um Agent para cada empresa disponvel, conforme figura abaixo.

Manual Tcnico - RM x PDV Protheus 26
9.2.4 Agendamentos
responsvel por fazer o agendamento das tarefas que sero executadas. Conforme figura abaixo.

Na opo RECORRNCIA possvel configurar a freqncia em que as tarefas sero executadas.

9.2.5 Schedule
responsvel por iniciar os servios para execuo das tarefas. Conforme figura abaixo.

Rotina FWEAI.
Recorrncia
Inicia os servios.
Manual Tcnico - RM x PDV Protheus 27
9.2.6 WebService de Recebimento
responsvel por receber as mensagens e grav-las na fila do EAI.
Configurar o WS do Protheus e verificar se o servio FWWSEAI esta ativo, conforme figura abaixo.


Clique em FWWSEAI para visualizar o WSDL do servio do Protheus, em seguida, clique em FWWSEAI.apw?WSDL.

Abaixo voc poder visualizar o endereo WSDL que dever ser configurado no componente WSSENDER do TOTVS-ESB.

Obs: Para ter uma viso mais detalhado de como configurar o EAI, favor, verificar o Boletim do Schedule (FNC:
000000079122008).
Manual Tcnico - RM x PDV Protheus 28
9.3 Protheus
Rodar o UPDATE U_UPDLOJ35, este ir efetuar as configuraes para a integrao entre Protheus
(FrontLoja/SigaLoja) x RM Nucleus. Para maiores detalhes, consultar o Boletim Tcnico do Chamado: SCJUVS - FNC:
00000002126/2010
9.3.1 Parmetros
Identificar e cadastrar, na tabela SFI, todas as alquotas que a empresa for utilizar. Exemplo: 17% - criar FI_BAS17. A
integrao contempla as alquotas (7%, 12%, 17%, 18% e 25%) desde que os campos estejam criados.
9.3.2 Menus
Agora, na opo Ambientes/Cadastro/Menu (CFGX013), inclua a nova opo de menu do SigaLoja, conforme
instrues a seguir:

Menu Controle de Lojas
Submenu Atualizaes/Integrao
Nome da rotina Cadastro de Processos
Programa LOJA2140
Mdulo SigaLoja
Tipo Funo Protheus
Tabelas MDO

Menu Controle de Lojas
Submenu Atualizaes/Integrao
Nome da rotina Cadastro de Processos x Tabelas
Programa LOJA2141
Mdulo SigaLoja
Tipo Funo Protheus
Tabelas MDO e MDP

Menu Controle de Lojas
Submenu Atualizaes/Integrao
Nome da rotina Cadastro de Parmetros da Integrao
Programa LOJA2142
Mdulo SigaLoja
Tipo Funo Protheus
Manual Tcnico - RM x PDV Protheus 29
Tabelas MDQ

Menu Controle de Lojas
Submenu Atualizaes/Integrao
Nome da rotina Wizard Integrao
Programa LJCARGAINI
Mdulo SigaLoja
Tipo Funo Protheus
9.3.3 Configuraes
Agora, na opo SigaLoja/Atualizaes/Integrao/Wizard Integrao (LJCARGAINI) configure a integrao atravs
do Wizard de Configurao e Carga Inicial da integrao, conforme instrues a seguir:


Selecione a integrao com RM Nucleus e clique em Avanar.

Clique em configurar para que seja configurada a integrao com o RM Nucleus (Processos, Processos x Tabelas e
parmetros).
Manual Tcnico - RM x PDV Protheus 30


Visualize as configuraes que foram feitas atravs do assistente e clique em Avanar.

Clique em validar para visualizar se todas as configuraes que foram executadas para o funcionamento da integrao.


Quando alguma configurao no estiver de acordo, ir aparecer a mensagem em vermelho No OK, conforme
abaixo, em seguida clique em avanar:
Manual Tcnico - RM x PDV Protheus 31

Clique em Iniciar Carga para que a carga inicial seja gerada e em seguida clique em Avanar.

Observao:

Na carga inicial do Protheus para o RM Nucleus, sero geradas as mensagens para todos os
registros da tabelas SA3 (Vendedores) e SLG (Cadastro de estao).

Veja o resumo do assistente e clique em Finalizar.

Agora, na opo Atualizaes/Integrao/ Cadastro de Parmetros da Integrao (LOJA2142) configure a TES
correspondente para cada tipo de produto.

Manual Tcnico - RM x PDV Protheus 32


9.4 Adapter (EAI) RM
Uma vez instalado e configurado o Backoffice RM, o implantador precisa voltar sua ateno aos ajustes necessrios
para utilizar este integrado ao PDV Protheus, passando pelo ByYou ESB. Neste item do documento voc encontrar
todas as informaes relevantes sobre o EAI RM e ser capaz de executar os seguintes passos:
Instalar
Configurar
Agendar envio e recebimento de mensagens
Vamos comear descrevendo o EAI RM: O adapter para integrao da Linha RM com as demais linhas o produto
TOTVS Business Connect (TBC).
Conhea mais sobre este e demais produtos RM no endereo web http://wikihelp.totvs.com.br/wikihelp/default.aspx.
9.4.1 Pr-requisitos
Microsoft .NET Framework 3.5
Internet Information Services (IIS)
Banco de Dados SQL Server 2005 ou Oracle 10g
Notas:
Veja as verses homologadas no documento de portabilidade da linha RM.
A TOTVS disponibiliza um backup da base de dados RM vazia que pode ser utilizada para novos clientes.
Para clientes que j possuem verso anterior utilizar o Conversor RM para atualizar o banco de dados para a verso 11.0.
9.4.2 Instalao
Para instalar qualquer mdulo da linha RM o primeiro passo instalar a Biblioteca RM, pacote que contm a maioria
dos arquivos necessrios para o funcionamento de todos os mdulos, inclusive do TBC.
Manual Tcnico - RM x PDV Protheus 33

Primeiro passo BibliotecaRM [verso].msi
Instale o pacote BibliotecaRM e patchs disponveis, se
houver.
Veja COMO FAZER - TBC - Instalar BibliotecaRM.doc
O segundo (e ltimo) passo da instalao executar o pacote TOTVS Business Connect, que instala os arquivos
necessrios para a utilizao dos WebServices hospedados no IIS.

Segundo passo - TOTVS Business Connect [verso].msi
Instale este pacote especfico para os WebServices do TBC.
Veja COMO FAZER - TBC - Instalar WS do TBC.doc


9.4.3 Parmetros
O TBC possui uma interface de parametrizao especfica para cada pacote de integrao. A parametrizao servir
para ativar/desativar a integrao e para o usurio devidamente autorizado informar os parmetros necessrios para o
seu funcionamento.
Logar no RM.exe, acessar o segmento Integrao, Ferramentas | Parmetros. Ser exibida tela a seguir:

Manual Tcnico - RM x PDV Protheus 34
Veja COMO FAZER - TBC - Parmetros - RM x PDV Protheus.doc
9.4.4 Configurao
TBC possui ainda uma interface de configurao especfica para cada pacote de integrao. A configurao servir para
criar no banco de dados os gatilhos (triggers) utilizados nesta integrao especfica.
Logar no RM.exe, acessar o segmento Integrao, aba Ferramentas | boto Configurar. Ser exibida tela a seguir:

Veja COMO FAZER - TBC - Configurar - RM x PDV Protheus.doc
9.4.5 Monitor da Fila de Integrao
O TBC possui ainda uma interface para o Administrador do sistema monitorar todas as transaes (processadas,
pendentes ou com erro).
Mensagens na situao de erro podero ser re-processadas (menu Processos).O monitor de Integrao do RM permite
ainda: filtro por usurio, localizao rpida, funo selecionar colunas (para o usurio personalizar a viso), funo de
exportar (CSV, XSL, PDF, XPS), impresso e anexos globais (Grficos, Consultas SQL etc).

Viso do Monitor de Integrao no RM Conector
Manual Tcnico - RM x PDV Protheus 35

Mensagem XML em detalhe (dois cliques no registro)
9.4.6 Agente de Envio
O Agente de Envio um servio tpico da Linha RM. Ele permite encaminhar as mensagens pendentes no Monitor da
Fila de Integrao para o ByYou ESB, com uma determinada periodicidade.
As mensagens enviadas com sucesso tm seu status alterado para SUCESSO (1) . As que apresentam erro ficam com o
status ERRO (99) e podem ser re-processadas posteriormente.


Acesse RM.exe | Segmento Integrao | Agente de Envio.


A aparncia da tela que ser exibida depende do parmetro JobServer3Camadas, definido no arquivo
RM.Host.Service.Exe.Config ou RM.Host.Exe.Config, conforme o caso.
Manual Tcnico - RM x PDV Protheus 36
Quando habilitado a tela apresentada permitir configurar quando o servio ser executado:
Hora de execuo (1 execuo)
Agora
Executa o processo uma nica vez e imediatamente na data corrente.
Executar em
Executa o processo uma nica vez e na data e hora especificada. Essa opo possui como padro a data corrente do dia
sendo possvel alter-la.
Sob demanda
Executa o processo de acordo com o recebimento dos e-mails.

Repetir a execuo

Deve ser utilizada quando houver a necessidade de executar o processo de forma recorrente. Ela apresenta as
seguintes opes:
Semanal
Todas as semanas no mesmo horrio e no(s) dia(s) de acordo com o definido.
Mensal
Todos os meses, no mesmo horrio e no(s) dia(s) de acordo com o definido.
Dirio
Diariamente, a cada intervalo (em horas) de acordo com o definido
9.4.7 Agente de Recebimento
O Agente de Recebimento funciona da mesma maneira que o Agente de Envio. Porm ele le as mensagens que foram
recebidas do ESB e que aguardam na Fila de Integrao para serem processadas e envia cada uma ao mdulo
responsvel dentro do Backoffice RM. Por exemplo, cupons fiscais, sangria, suprimento e reduo Z so enviados para o
RM Nucleus processar.
9.5 RM
No escopo deste documento descrever a instalao do BackOffice RM nem a sua configurao. Destacamos que os
parmetros necessrios para estabelecer a comunicao com o EBS so feitos no TBC e no no Backoffice.
At a verso 11.0 do RM Nucleus, para processar os movimentos gerados pelo Ponto de Venda era utilizado o Modo
Server, mas a partir da verso 11.20 o Modo Server foi descontinuado e o processamento efetuado diretamente por
um servio do RM Nucleus ativado pelo Agente de Recebimento do TBC.







Manual Tcnico - RM x PDV Protheus 37
9.5.1 FAQ
9.5.1.1 Configurao do TMV para Cupom Fiscal
O TMV para cupom fiscal deve possuir algumas caractersticas especficas.
Fis Dados | Outros Documentos Fiscais: marcar Emite Cupom Fiscal e informar se usa CTRC.

9.5.1.2 Ao tentar receber arquivos (Agente de Recebimento) apresentado erro Erro ao criar: - Erro ao registrar
server sob demanda: (...) - Could not connect to net.tcp://(...)/RMSBrokerServer/IRMSBrokerServer. The
connection attempt lasted for a time span of 00:00:00. TCP error code 10061: Nenhuma conexo pde ser
feita porque a mquina de destino as recusou ativamente (...)
Uma das causas possveis para este erro o parmetro JobServer3Camadas ser diferente no Web.config e no
RM.Host.exe.config (ou RM.Host.Services.Config). Lembrando que o JobServer3Camadas sempre deve ser igual no
client e no Server (neste caso o cliente o WS e o server o RMHost).
9.5.1.3 Produto no sincronizado se no houver tributao ECF relacionada.
RM
Cadastre os tributos e os produtos normalmente, observe:
Tributos
O cadastro dos Tributos deve ser feito no RM (DTRIBUTO) e sero referenciados no cadastro da
Tributao ECF.
Tributao ECF
O cadastro da Tributao ECF deve ser feito no RM (TTRIBUTACAOECF) e sincronizado para o Protheus,
junto com o cadastro de produto, via Integrao TOTVS. Sendo: Tributado: TIPO=zero e
CODTRB=ICMS; Servio: TIPO=zero e CODTRB=ISS; No Tributado: TIPO=3; Substitudo: TIPO=2;
Isento: TIPO=1
Nota: este cadastro ainda no est disponvel no RM.exe, use o RMNucleus.exe
Produtos O cadastro deve ser feito no RM e sincronizado para o Protheus via Integrao TOTVS.
Manual Tcnico - RM x PDV Protheus 38
Informe o tributo ECF do produto
Se integrao ativa, quando usurio cadastra o produto (INCLUI) gerado uma mensagem de integrao na
fila.
Ver no monitor da fila de integrao, duplo clique para ver o XML. Deve existir algo semelhante a isto:
<Message>
<TPrd>
<CODCOLIGADA>1</CODCOLIGADA>
<IDPRD>807</IDPRD>
<CODIGOPRD>00806</CODIGOPRD>
<TRIBUTACAOECF>01</TRIBUTACAOECF>
(...)
</TPrd>
<TTRIBUTACAOECF>
<CODCOLIGADA>1</CODCOLIGADA>
<TRIBUTACAOECF>01</TRIBUTACAOECF>
<TIPO>0</TIPO>
<CODTRB>ICMS</CODTRB>
<ALIQUOTA>17.00</ALIQUOTA>
</TTRIBUTACAOECF>
</Message>
Se o job de envio do RM estiver ativo, ou se o usurio executar manualmente o processo Agente de Envio a
mensagem ser enviada ao ESB.
ESB
O ESB foi configurado para transformar este XML formato RM no XML formato Protheus.
Veja o trecho a seguir, retirado do arquivo de transformao:
<xsl:if test="TOTVSMessage/Message/TTRIBUTACAOECF">
<B1_TIPTRIB>
<xsl:attribute name="order">1</xsl:attribute>
<xsl:choose>
<xsl:when test="TOTVSMessage/Message/TTRIBUTACAOECF/TIPO = '0' and TOTVSMessage/Message/TTRIBUTACAOECF/CODTRB =
'ICMS'">
<value>T</value>
</xsl:when>
<xsl:when test="TOTVSMessage/Message/TTRIBUTACAOECF/TIPO = '0' and TOTVSMessage/Message/TTRIBUTACAOECF/CODTRB =
'ISS'">
<value>S</value>
</xsl:when>
<xsl:when test="TOTVSMessage/Message/TTRIBUTACAOECF/TIPO = '1'">
<value>I</value>
</xsl:when>
<xsl:when test="TOTVSMessage/Message/TTRIBUTACAOECF/TIPO = '2'">
<value>F</value>
</xsl:when>
<xsl:when test="TOTVSMessage/Message/TTRIBUTACAOECF/TIPO = '3'">
<value>N</value>
</xsl:when>
</xsl:choose>
</B1_TIPTRIB>
</xsl:if>
(...)
<!-- Quando o produto for de substituio tributria, alimentar o campo B1_PICMRET igual a 1 para que o protheus possa vender
este produto como substituido no ECF -->
<xsl:if test="TOTVSMessage/Message/TTRIBUTACAOECF/TIPO = '2'">
<B1_PICMRET>
<xsl:attribute name="order">1</xsl:attribute>
<value>1</value>
</B1_PICMRET>
</xsl:if>
(...)
<xsl:if test="TOTVSMessage/Message/TTRIBUTACAOECF/TIPO = 0">
<B1_PICM>
<xsl:attribute name="order">1</xsl:attribute>
<value>
<xsl:value-of select="format-number(TOTVSMessage/Message/TTRIBUTACAOECF/ALIQUOTA,'00.00')"/>
</value>
</B1_PICM>
</xsl:if>
Ou seja, neste exemplo, o Protheus receberia:
B1_TIPTRIB=T
B1_PICM=17.00
Manual Tcnico - RM x PDV Protheus 39
E assim saberia que este produto tributado por ICMS a 17%
O Protheus j deve possuir um cadastro das tributaes implantado e a venda se dar corretamente. Alm da
TES acredito que deve haver outros cadastros envolvidos, mas independem da integrao.