INTEGRAO EGPxTSS

Manual de Integrao
TOTVS MARKERTPLACE

INTEGRAO EGPxTSS

NDICE
Viso Geral.............................................................................................................................................................................. 3
Fluxo de Integrao de Cadastros........................................................................................................................................... 4
Fluxo de Gesto de Pedidos com Cotao .............................................................................................................................. 5
Fluxo de Gesto de Pedidos Sem Cotao .............................................................................................................................. 6
Fluxo de Alteraes e Cancelamento...................................................................................................................................... 7
Pr-requisitos da Integrao dos Produtos............................................................................................................................. 8
Parametrizao da Integerao no Produto, Origem ............................................................................................................. 8
Parametrizao da Integrao no Produto, Destino ............................................................................................................... 8
Processos de Integrao ......................................................................................................................................................... 9
Processo de Integrao Cadastros ....................................................................................................................................... 9
Processo de Integrao Gesto de Pedidos com Cotao ................................................................................................. 11
Processo de Integrao Gesto de Pedidos sem Cotaes (com Contratos) ..................................................................... 15
Processo de Integrao Alteraes e Cancelamentos........................................................................................................ 16
Processo de Integrao Alterao de Pedido de Compra .................................................................................................. 16
Processo de Integrao Alterao de Ordem de Compra .................................................................................................. 17
Processo de Integrao Cancelamento de Pedido de Compra .......................................................................................... 17
Processo de Integrao Cancelamento de Ordem de Compra .......................................................................................... 18
Trasaes EAI para Integrao ERP x Portal de Compras Paradigma .................................................................................... 18
Trasaes EAI para Integrao ERP x Portal de Compras Paradigma Monitor de Integrao I .......................................... 20
Configuraes do ESB ........................................................................................................................................................... 21
Configuraes do ESB Criao do Projeto.......................................................................................................................... 21
Configuraes do ESB Configurao para Acesso aos Web Services da Paradigma........................................................... 23
Configuraes do ESB Configurao para Acesso ao Banco de Dados EAI......................................................................... 26
Configuraes do ESB Configurao para o Arquivo configurationsparadigma.xsl ........................................................ 27
Clculo de Preo Lquido....................................................................................................................................................... 28

INTEGRAO EGPxTSS

Viso Geral
Com a integrao entre o ERP 2 e o Portal de Compras Paradigma (WBC Web Business Center), que ser responsvel pela
cotao de itens com diversos fornecedores, possvel agregar volumes de compras para cotao de preo, dentre outras
vantagens. A integrao proporciona uma automao da rea de compras, pois todo o processo de respostas de cotaes
realizado pelos prprios fornecedores no portal de compras da Paradigma. A gerao de ordens de compra ser realizada no
ERP 2, e sero enviadas para o portal de acordo com a necessidade, para o tratamento pelo portal de compras. O processo de
cotao e escolha dos vencedores realizada no portal, sendo o pedido de compra gerado pelo ERP 2 e posteriormente enviado
para o portal de compras da Paradigma.
Existe ainda um segundo fluxo nesta integrao, onde o comprador pode realizar todo o processo at a gerao do pedido de
compra dentro do ERP e enviar ento o pedido para o portal.
Alm da integrao de transaes de negcio (ordens de compra, cotao e pedido) so integrados uma srie de cadastrados
para equalizar os dados utilizados entre os dois sistemas.

INTEGRAO EGPxTSS

Fluxo de Integrao de Cadastros

1.
2.
3.
4.
5.
6.

Usurio inclui ou altera um cadastro no ERP;

Dados do Cadastro includo ou alterado so enviados para a Paradigma;
Dados de retorno do processamento do cadastro na Paradigma (sucesso ou erro) so enviados ao ERP;
Busca o fornecedor do Clic business para a sua base de fornecedores;
Dados do fornecedor so envidas para o ERP;
Se o cadastro for executado com sucesso, o cdigo do fornecedor atualizado no portal.

INTEGRAO EGPxTSS

Fluxo de Gesto de Pedidos com Cotao

1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.

O requisitante gera uma solicitao de compra no ERP;

Aprovador aprova solicitao no ERP;
Comprador Gera Ordem de Compra;
Comprador seleciona as ordens de compra para tratamento no portal;
Dados da requisio no ERP so enviados para o portal;
Retorno do processamento da requisio no Portal enviada ao ERP;
Comprador cria e envia cotao a partir da requisio;
Fornecedores respondem a cotao;
Comprador Encerra o item de cotao ou a cotao;
Dados da resposta da cotao so enviados ao ERP;
Aprovador aprova ou recusa processo de compra;
Reabertura de item de cotao na Paradigma (no caso de recusa de processo);
Comprador gera pedido de compra no ERP;
Pedido passa pela aprovao interna do ERP;
Comprador seleciona pedidos para tratamento no portal;
Dados do pedido no ERP so enviados para o portal;
Retorno do processamento dos pedidos no Portal enviado ao ERP;
Fornecedor realiza Aceita/Recusa do pedido;

19. Dados do aceite do pedido no Portal so enviados ao ERP.

INTEGRAO EGPxTSS

Fluxo de Gesto de Pedidos Sem Cotao

1.
2.
3.
4.
5.
6.
7.

Criao do Pedido no ERP;

Aprovao do Pedido no ERP;
Comprador seleciona pedidos para tratamento no portal;
Dados do pedido no ERP so enviados para o Portal;
Retorno do processamento do pedido no Portal enviado ao ERP;
Fornecedor realiza Aceita/Recusa do pedido;
Dados do aceite do pedido no Portal so enviados ao ERP.

INTEGRAO EGPxTSS

Fluxo de Alteraes e Cancelamento

Alterao de Pedido de Compra
1.
2.
3.
4.
5.
6.

Comprador altera o pedido de compra no ERP;

Aprovador aprova o pedido no ERP;
Dados do Pedido no ERP so enviados para a Paradigma;
Retorno do processamento do pedido no portal enviado ao ERP;
Fornecedor aceita/recusa o pedido no Portal;
Dados do aceite do pedido no Portal so enviados ao ERP.

Alterao de Ordem de Compra

1.
2.
3.

Comprador altera a ordem de compra no ERP;

Dados da ordem de compra do ERP so enviados para a Paradigma;
Retorno do processamento da ordem de compra no portal enviada ao ERP.

Cancelamento de Pedido de Compra

1.
2.
3.

Comprador cancela/elimina o pedido de compra no ERP;

Dados para o cancelamento do pedido so enviados para o Portal;
Retorno do cancelamento do pedido no portal enviado ao ERP.

Cancelamento de Ordem de Compra

1.
2.

Comprador cancela/elimina a requisio no Portal;

Dados para eliminao da ordem de compra so enviados ao ERP.

INTEGRAO EGPxTSS

Pr-requisitos da Integrao dos Produtos

Contrato realizado com a Paradigma para utilizao do portal de compras (WBC Web Business Center).
Datasul EAI e TOTVS ESB instalados, configurados e ativos para a integrao com o portal da Paradigma.
Nota:
TOTVS | ESB Server 12.2.3 ou superior;
TOTVS | Developer Studio 11.1;
TOTVS | ESB Plugin 12.2.3 ou superior.

Parametrizao da Integerao no Produto, Origem

O ERP 2 deve ser parametrizado para utilizar os mdulos de Compras e Cotaes de Compras (CD0101);
A utilizao do Processo de Compra nos parmetros de cotao (OC0101) dever estar habilitada, campo Utiliza
Processo;
A funo referente a integrao ("PORTAL-PARADIGMA") do ERP 2 com o portal de compras Paradigma deve estar ativa
(CD7070);
Parmetro Integra com o Portal de compras ativado no programa CC0104 Manuteno de parmetros de compra;
A lista das transaes que devero ser implantadas para essa integrao no EAI podem ser visualizadas em Transaes
Integrao ERP x Portal de Compras Paradigma.
Caso seja utilizado o mdulo de MLA: cadastrar o programa lap/mla0301d.p como programa de aprovao no (MLA0101)
para os documentos que so utilizados e que possuem integrao com a Paradigma (pedido de compra, contrato e
cotao).

Configurar os diagramas no ESB conforme orientaes disponveis em configuraes do ESB.

Parametrizao da Integrao no Produto, Destino

Clculo do preo lquido
necessrio realizar as configuraes para o clculo do preo lquido na Paradigma.
Variveis envolvidas no clculo:

Percentual de desconto: informado na cotao;

Taxa financeira: informada na cotao;
Alquota IPI: informada na cotao;
Clculo do IPI pelo preo bruto ou lquido: pode mudar conforme o cliente, necessrio verificar no ERP (programa
Manuteno de Parmetros de Compra (CC0104)) como deve ser o clculo;
Condio de pagamento: nmeros de dias e percentual de pagamento das parcelas (condio de pagamento da cotao).

Pr-requisitos das taxas a serem informadas no Paradigma:

Taxa financeira: Somente pode estar habilitada ou aparecendo para informar a taxa se o cliente tiver parametrizado dessa
forma no ERP (Verificar no programa Manuteno de Parmetros de Compra (CC0104), o parmetro Utiliza Taxa Financ).
O controle para dizer se est ou no incluso no preo deve estar habilitado conforme o parmetro tambm;
Alquota IPI: Sempre visvel/habilitado. O controle para dizer se est ou no incluso no preo deve estar habilitado;
Alquota ICMS: Somente pode estar habilitada ou aparecendo para informar a taxa se o cliente tiver parametrizado dessa
forma no ERP (Verificar no programa Manuteno de Parmetros de Compra (CC0104), o parmetro Utiliza ICMS). O
controle para dizer se est ou no incluso no preo NO deve estar habilitado (neste caso deve considerar que sempre est
incluso no preo bruto);
8

INTEGRAO EGPxTSS

Alquota ISS: Somente pode estar habilitada ou aparecendo para informar a taxa se o cliente tiver parametrizado dessa
forma no ERP (Verificar no programa Manuteno de Parmetros de Compra (CC0104), o parmetro Utiliza ISS). O
controle para dizer se est ou no incluso no preo NO deve estar habilitado (neste caso deve considerar que sempre est
incluso no preo bruto).

Nota:
Para mais detalhes, veja o clculo do preo lquido.

Processos de Integrao
Abaixo so apresentados os dois fluxos de mensagens que so trocadas entre o EMS e o portal Paradigma: gesto de pedidos com
cotao e gesto de pedidos sem cotao. Alm disso, so apresentados os fluxos de mensagens de cadastros, alteraes e
cancelamentos de requisies (ordens de compra) e pedidos.
A Paradigma trata todas as suas transaes como sncrona, porm para no prejudicar a performance do sistema, atravs do TOTVS
ESB, as transaes so tratadas de forma assncrona. Ou seja, o retorno das mensagens ser tratado como uma nova mensagem no
EAI, onde se houverem erros, o usurio dever corrigir e integrar novamente o registro em questo.

Processo de Integrao Cadastros

1.

Usurio inclui ou altera um cadastro no ERP

Para equalizao dos dados cadastrais entre os dois sistemas (Datasul EMS 2 e Paradigma) ser realizada a integrao de alguns
cadastros. A integrao desses cadastros parte do ERP para a Paradigma, e ocorre quando h uma incluso ou alterao de um
registro. Eliminaes no so tratadas.
A integrao do sentido contrrio da Paradigma para o ERP ser realizada apenas para o cadastro de fornecedor. Apenas para o
cadastro de fornecedor, quando for buscado um fornecedor do Clic Business para a base na empresa. Os demais cadastros que
forem integrados devem ser bloqueados na Paradigma para que no haja incompatibilidade dos dados.
Nota:
Excees sero detalhadas na sequncia.
2.

Dados do Cadastro includo ou alterado so enviados para a Paradigma

Os cadastros que sero integrados so os seguintes:

Unidade de Medida (Transao UnitOfMeasure no EAI);

Item (Paradigma trata como Produto) - (Transao Item no EAI);
Moeda - (Transao Currency no EAI);
Condio de Pagamento: Ao enviar uma condio de pagamento para a Paradigma necessrio relacion-la a uma
empresa, como no ERP no existe este controle, a condio de pagamento deve estar disponvel para ser utilizada por
todas as empresas, sem restries - (Transao PaymentPlan no EAI);
Grupo de estoque (Paradigma trata como Categoria de Produto) - (Transao InventoryGroup no EAI);
Fornecedor (Paradigma trata como Empresa Vendedora) (Transao CustomerVendor no EAI) - Como no sero
tratadas importaes nesta primeira fase do projeto, somente fornecedores brasileiros sero enviados para a Paradigma;

Quando includo um fornecedor no ERP e integrado com o portal pela primeira vez, gerada uma senha para acesso no portal com o
usurio sendo o nmero do CNPJ do fornecedor. Quando o fornecedor acessar o portal pela primeira vez, solicitada a alterao da
senha.
Nota:
1. Como o EMS no obriga informar e-mail no cadastro, o portal ir realizar essa validao, e caso no esteja preenchido a
mensagem ser retornada com erro.
9

INTEGRAO EGPxTSS

2. O EMS possui opo de deixar o fornecedor inativo por um determinado perodo, no final deste perodo o fornecedor
considerado automaticamente ativo. O Portal no possui esse tipo de controle, portanto para ativar o fornecedor no portal ao final
do perodo, o cadastro dever ser alterado para envio da mensagem de alterao.
3. Somente sero integrados com o portal os fornecedores que forem parametrizados para esse fim, esse controle estar disponvel
para o usurio no Cadastro de Fornecedores do ERP (CD0401).
4. O cdigo do fornecedor na Paradigma ter a seguinte estrutura: for + <cdigo do fornecedor no ERP>

Estabelecimento (Paradigma trata como Empresa Compradora) (Transao Site no EAI) - Ficou definido que ao enviar
o estabelecimento para a Paradigma, ir sempre como Empresa Compradora, dessa forma nenhum registro do EMS
gerar uma Empresa Administradora na Paradigma.

Como no sero tratadas regras para outros pases, somente estabelecimentos brasileiros sero enviados para a Paradigma;
Nota:
O cdigo do estabelecimento na Paradigma ter a seguinte estrutura: est + <cdigo do estabelecimento no ERP>

Transportador (Paradigma trata como Empresa Transportadora) - (Transao Carrier no EAI) - Como no sero tratadas
importaes, somente transportadores brasileiros sero enviados para a Paradigma;

Nota:
O cdigo do transportador na Paradigma ter a seguinte estrutura: tra + <cdigo do transportador no ERP>

Item Fornecedor (Paradigma trata como Produto x Empresa) (Transao VendorItem no EAI) Ao enviar esse
relacionamento para a Paradigma, alm do relacionamento entre Produto e Empresa dever ser criado tambm o
relacionamento entre Categoria e Empresa;

Nota:
Somente sero enviados para o portal os relacionamentos de item x fornecedor de fornecedores que possurem integrao com o
portal de compras, configurado na funo Cadastro de Fornecedores do ERP (CD0401).

Usurio (Transao MaterialUser no EAI) Sero integrados os usurios de materiais que sejam compradores e/ou
requisitantes.

Como necessrio vincular o usurio a uma nica empresa ao enviar a integrao, esse cadastro dever ser habilitado para alterao
na Paradigma. Isso se faz necessrio para que seja possvel relacionar um usurio a mais de uma empresa.
Como no ERP no possui a obrigatoriedade de informar o e-mail no cadastro de usurio, essa validao ser realizada pela
Paradigma, sendo retornado um erro, caso no seja enviado o e-mail para o usurio.
Quando includo um usurio no ERP e integrado com o portal pela primeira vez, gerada uma senha para acesso no portal que
enviada por e-mail para o endereo informado no cadastro de usurio do ERP (por isso importante que essa informao esteja
correta). Quando o usurio acessar o portal pela primeira vez, solicitada a alterao da senha.
3.

Dados de retorno do processamento do cadastro na Paradigma (sucesso ou erro)

A Paradigma trata todas as suas transaes como sncrona, porm para no prejudicar a performance do sistema, atravs do TOTVS
ESB, o processo foi tornado assncrono. Ou seja, o retorno das mensagens ser tratado como uma nova mensagem no EAI (Transao
ReturnIntegrationErrors no EAI), onde se houverem erros, o usurio dever corrigir e integrar o cadastro novamente.
4.

Busca o fornecedor do Clic business para a sua base de fornecedores

Quando o usurio atualiza o fornecedor no portal que estava disponvel no Clic Business, esse fica pendente para integrar com o ERP.
5.

Dados do fornecedor na Paradigma

Fornecedor (Transao CustomerVendorParadigma no EAI) Quando Buscado o fornecedor do clic Business para o
portal e integrado no ERP pela primeira vez o mesmo vai ficar com a situao de Inativo. Ser necessrio que esse cadastro
seja revisado pelo usurio, atualizando os dados que no foram integrados pelo portal. Depois dessa reviso o fornecedor
poder ter sua situao alterada para ativo.
10

INTEGRAO EGPxTSS

6.

Atualiza cdigo fornecedor

No ocorrendo nenhum erro na integrao do fornecedor no ERP, o cdigo do ERP desse fornecedor atualizado no portal para
manter a integridade entre eles.

Processo de Integrao Gesto de Pedidos com Cotao

No fluxo de gesto de pedidos com cotaes, o processo de cotaes das ordens de compra e escolha do fornecedor vencedor
realizado no portal de compras da Paradigma.
Detalhamento do fluxo:
1.

O requisitante gera uma solicitao de compra no ERP.

Todo o processo de criao de requisio ou gerao de ordens de compra sero feitos no ERP, sem nenhuma integrao com o
portal de compras.
2.

Aprovador aprova solicitao no ERP.

A solicitao passa pela estratgia atual de aprovao interna no ERP (caso exista) e, uma vez aprovado, enviada para o comprador
fazer o tratamento necessrio.
3.

Comprador Gera Ordem de Compra.

O comprador analisa as solicitaes em aberto, agrupa por item se necessrio e gera a ordem de compra.
4.

Comprador seleciona as ordens de compra para tratamento no portal.

O comprador seleciona as ordens de compra que deseja trabalhar atravs do portal de Compras e as envia, atravs da rotina Envio
de Ordens para o portal (CC0324), que permite ao comprador selecionar as ordens que deseja enviar para o portal de compras.
Nota:
Podem ser enviadas ordens de compra que tenham sido originadas de requisies ou que foram criadas por outras rotinas no ERP.
Para que a ordem de compra possa ser enviada ao portal ela deve estar como No Confirmada, no deve pertencer a um pacote
de compra e no deve pertencer a um contrato. A ordem no precisa ter um comprador definido para ser enviado, ele poder ser
definido no portal. As parcelas da ordem de compra no devem ter datas de entrega menores que a data atual, caso contrrio
tambm no podem ser enviadas.
Nota:
Para ordens de compra que possuam mais de uma entrega (parcela), a cada entrega da ordem ser criada uma requisio
diferenciada na Paradigma (sendo que essas requisies sempre devero ser tratadas em conjunto na Paradigma).
5.

Dados da requisio no ERP.

O ERP gera um documento de integrao (Dados da Requisio no ERP) Transao PurchaseOrderLine no EAI.
Nota:
Aps uma ordem de compra ter sido enviada ao portal, ela ficar congelada, sendo que neste caso no ser permitida a eliminao
da ordem de compra. A eliminao, ou no caso cancelamento, somente poder ser feito atravs da Paradigma. Os dados alterados
da ordem de compra aps ela ter sido enviada para a Paradigma so reenviados para que seja mantida a consistncia entre os dois
sistemas.
6.

Retorno do processamento da requisio no Portal.

A plataforma do portal faz o processamento da mensagem de integrao (Dados da Requisio no ERP). (Transao
RequisitionOrderConfirm e ReturnIntegrationErrors no EAI).
11

INTEGRAO EGPxTSS

O retorno efetivado no ERP, que atualiza se a requisio foi integrada com sucesso ou se ocorreram erros na integrao. Os erros
so listados atravs do EAI para o usurio possa consult-los, corrigir e reenviar a ordem de compra.
Nota:
1. Consultar a situao na ordem de compra na consulta de ordens de compra (CC0505).
2. No necessrio armazenar nenhum nmero de referncia da Paradigma, pois o nmero da requisio no Portal ser o mesmo do
ERP. Neste caso o usurio tem a rastreabilidade das informaes.
3. Caso tenha ocorrido erro na efetivao de alguma parcela na Paradigma, a ordem dever ser marcada com erro, para que a
situao seja corrigida e a ordem reenviada.
7.

Comprador cria e envia cotao a partir da requisio.

Com a requisio salva no Portal de Compras, o comprador acessa a lista de requisies, podendo criar um processo de Tomada de
Preo (Solicitao de Cotao). Neste processo temos:
a.
b.
c.

O comprador seleciona as requisies que faro parte da cotao;

So definidos os fornecedores da cotao (conforme relacionamento Produto x Empresa (fornecedor));
O comprador envia a solicitao de cotao atravs do Portal de Compras para os fornecedores selecionados.

Nota:
1 - Como para a Paradigma cada entrega de uma requisio (ordem de compra) uma requisio independente, o comprador ao
inserir uma requisio (entrega) em um processo de cotao, dever inserir todas as outras requisies (entregas) que so referentes
a mesma ordem de compra no ERP no mesmo processo de cotao.
2 - Por conceito do portal, para que o fornecedor esteja disponvel para relacionamento na cotao pr-requisito que tenha sido
cadastrado o relacionamento do item x fornecedor.
8.

Fornecedores respondem a cotao.

Os fornecedores respondem ao processo de cotao via Portal de Compras.

Diferenas de conceito:
a.

f.

No EMS a cotao deve ser feita sempre com na unidade de medida do fornecedor, j no portal no h a opo para que o
fornecedor escolha uma unidade de medida ou possa responder na sua unidade de medida. Ou seja, o fornecedor sempre
ter que responder a cotao na unidade de medida interna do item;
Como no existe controle com relao utilizao da unidade de medida do fornecedor, a quantidade a ser apresentada
para o fornecedor no portal ser sempre a quantidade interna e no a quantidade do fornecedor;
O Portal possui o conceito de que o fornecedor informa o preo bruto da mercadoria, e o sistema calcula internamente o
preo lquido. (Para que o preo lquido entre os dois sistemas esteja equalizado, devem ser seguidas as regras para
configurao de preo lquido j apresentadas anteriormente);
Como a Paradigma controla o preo do fornecedor com 4 decimais e o ERP com 5, podero haver pequenas diferenas
entre os preos calculados entre os dois sistemas;
Ao gerar a cotao a Paradigma possui alguns agrupadores de itens, sendo que vrias ordens de compra podem gerar um
item na Cotao da Paradigma com a soma das quantidades. Neste caso o item possui vrias entregas que sero as
requisies (ordens de compra);
No ser permitido ao fornecedor informar uma condio especfica de pagamento que no esteja cadastrada no sistema.

9.

Comprador Encerra o item de cotao.

b.
c.
d.
e.

O comprador analisa as respostas dos fornecedores, seleciona a cotao vencedora e encerra o item de cotao, neste momento
ser enviado um documento de integrao para o ERP (Dados das Respostas da Cotao Transao ProcessQuotations) com
todas as respostas dos fornecedores juntamente com a cotao vencedora.
A Paradigma no deve permitir que mais uma proposta seja selecionada como vencedora, ou seja, para cada requisio da cotao,
pode haver apenas uma proposta (fornecedor) como vencedor.
A alterao da cotao e cancelamento na Paradigma somente permitida antes do encerramento da cotao. Aps a cotao ter
sido encerrada e enviada ao ERP, somente o ERP poder reabri-la em funo de algumas situaes detalhadas posteriormente.

12

INTEGRAO EGPxTSS

10. Dados da resposta da cotao.

Aps o encerramento do item de cotao na Paradigma, ele fica disponvel para ser buscado e efetivado pelo ERP. Uma vez que a
cotao tenha sido retornada para o ERP, somente poder ser disponibilizada novamente pela Paradigma caso o item tenha sido
reaberto e encerrado novamente pelo comprador. No caso, quando ocorrem esses encerramentos em funo de reabertura de itens,
somente os itens de cotao que foram reabertos sero retornados para o ERP na nova busca.
Sobre a estrutura do processo de cotao na Paradigma:

Uma cotao pode conter diversos itens, ou seja, diversas ordens de compra;
Uma cotao pode conter diversas respostas de fornecedores;
Uma cotao pode conter diversas respostas do mesmo fornecedor para a mesma ordem de compra.
Uma solicitao de cotao (cotao do item do ERP) pode ser enviada ao fornecedor e ele declinar ou no responder,
neste caso essas cotaes no so retornadas ao ERP;
Propostas aceitas e desclassificadas pelos compradores so retornadas ao ERP, porm somente sero gravadas as cotaes
aceitas e que no foram desclassificadas.

Em funo dessa estrutura, e de que o Pedido de compra na Paradigma somente pode ser referente a uma cotao, ao chegar uma
cotao da Paradigma, ser gerado um Processo de Compras, que agrupar as ordens de compra conforme o que foi feito na
Paradigma. Aps a criao do processo, so efetivadas as cotaes, sendo que uma cotao da Paradigma, quando efetivada no ERP
pode gerar diversas cotaes (respostas de fornecedores).
Para que o usurio possa manter a rastreabilidade entre o processo de cotao da Paradigma e o processo de compra do ERP, a
descrio do processo de compras criado no ERP ser sempre o Cdigo do processo da Paradigma (sendo que este no poder se
repetir para diferentes processos na Paradigma). O processo de compra tambm fica como integrado com a Paradigma, consultar na
funo Consulta Processo (OC0401).
Em funo do portal no permitir alterao na unidade de medida para que o fornecedor responda a cotao e o EMS exige que a
cotao seja realizada na unidade de medida do fornecedor, ao receber uma cotao, a unidade de medida e preo so convertidos
conforme a unidade de medida e fator de converso do relacionamento Item X Fornecedor.
Para manter a rastreabilidade entre os sistemas ser armazenado no ERP alm dos cdigos internos de controle da Paradigma o
Cdigo do processo, atravs do qual o usurio consegue identificar a cotao na Paradigma.
Nota:
Consultar na funo Consulta Cotaes (CC0506).
Como o ERP no possui controle de cotao por parcela da ordem de compra, ao gravar as informaes de uma cotao aprovada na
Paradigma, no ser considerado o prazo de entrega da cotao para recalcular as novas datas de entrega, sero assumidas as datas
informadas pelo fornecedor na Paradigma.
O Portal permite que o fornecedor informe preo proposto igual a R$ 0,00, caso isso ocorra o ERP ir bloquear a cotao para ajuste.
Caso ocorram erros na efetivao da cotao vencedora no ERP, ser enviada uma mensagem para reabertura de item de cotao na
Paradigma, para que possa ser corrigido o problema e a cotao reenviada ao ERP.
11. Aprovador aprova ou recusa processo de compra.
O processo de compra passa pela estratgia atual de aprovao interna no ERP (caso exista) e, uma vez aprovado, o comprador pode
fazer a gerao do pedido.
12. Reabertura de item de cotao na Paradigma.
Caso ocorram erros na efetivao da cotao vencedora vinda do Portal ou o processo seja reprovado no fluxo de aprovao do ERP,
enviada uma mensagem para a Paradigma, contendo os dados para a reabertura do item da cotao.
Nestes casos ser feita a reabertura do item da cotao na Paradigma, pode-se realizar a correo do que gerou o problema,
encerrar a cotao novamente e ela ser efetivada no ERP.
Como o controle ser por item de cotaes, caso o comprador deseje gerar o pedido dos itens que foram efetivados com sucesso,
isso ser possvel. E neste caso ele poder realizar a correo do item da cotao que deu problema posteriormente e gerar um
pedido separadamente.
13

INTEGRAO EGPxTSS

13. Comprador gera pedido de compra no ERP.

Com base nas respostas vencedoras o comprador gera o pedido de compra no ERP. Neste caso o comprador ter que criar o pedido
sempre se baseando no processo de compras que foi gerado para a cotao.
Nota:
Essa regra do processo de compra foi criada para atender a estrutura da Paradigma, que no permite que um pedido de compra
tenha ordens de compra (requisies) referente a processos de Cotao distintos.
14. Pedido passa pela aprovao interna do ERP.
O pedido passa pela estratgia atual de aprovao interna no ERP (caso exista) e, uma vez aprovado, fica disponvel para o
comprador fazer o envio para o portal.
15. Comprador seleciona pedidos para tratamento no portal.
Comprador seleciona os pedidos e envia para o portal de compras, por intermdio da interface para envio de pedidos (CC0329).
Para que o pedido possa ser enviado ao portal ele deve estar Aprovado, Impresso" e no deve possuir uma condio de
pagamento especfica.
Diferenas de conceito:
a.
b.

O portal no possui suporte a informao de condies especficas de pagamento, portando sempre ser necessrio
informar uma condio de pagamento que no seja a 0 Condio especial de pagamento.
Os pedidos neste caso sero enviados sempre como Normais.

16. Dados do pedido no ERP.

enviada uma mensagem de integrao (Dados do Pedido no ERP) para criao do pedido no portal (Transao PurchaseOrder no
EAI). O nmero do pedido do portal dever ser o mesmo que o ERP para permitir a rastreabilidade entre os sistemas.
Neste momento do envio do pedido, recalculado o valor lquido do pedido, pois podem ter ocorrido mudanas, e enviado o novo
valor para a Paradigma, que assumir o novo valor do pedido.
17. Retorno do processamento dos pedidos no Portal.
A plataforma do portal faz o processamento da mensagem de integrao (Dados do Pedido no ERP ). Se ocorrer um erro no
processamento, devolvida uma mensagem contendo o cdigo do erro e sua descrio, neste caso o pedido marcado Com Erro.
Se for integrado com sucesso o pedido marcado como Integrado. (Transao RequisitionOrderConfirm e
ReturnIntegrationErrors no EAI).
Nota:
Consultar situao do pedido na Funo Consulta de Pedidos (CC0509).
18. Fornecedor realiza Aceita/Recusa do pedido.
O fornecedor realiza o aceite/recusa do pedido no portal.
19. Dados do aceite do pedido no Portal.
O ERP busca essa informao de aceite/recusa e atualiza esse dado no ERP.
Nota:
1. Caso o pedido esteja recusado pelo fornecedor, o recebimento no ser permitido.
2. Consultar situao do pedido (aceite/recusa) no Funo Consulta de Pedidos (CC0509).

14

INTEGRAO EGPxTSS

Processo de Integrao Gesto de Pedidos sem Cotaes (com Contratos)

1.

Criao do Pedido no ERP.

O comprador gera um pedido de compra no ERP sem integrao com o portal de compras.
2.

Aprovao do Pedido no ERP.

O pedido passa pela estratgia atual de aprovao interna no ERP (caso exista) e, caso aprovado, enviado para o comprador fazer o
tratamento necessrio. Esse passo tambm realizado sem integrao com o portal de compras.
3.

Comprador seleciona pedidos para tratamento no portal.

Comprador seleciona os pedidos e envia para o portal de compras. Essa ao poder ser realizada pela rotina de envio de pedidos
para o portal (CC0329) ou no momento da impresso do pedido de compra (CC0305).
Para que o pedido possa ser enviado ao portal ele deve estar Aprovado, Impresso e no deve possuir uma condio de
pagamento especfica.
Diferenas de conceito:
a.
b.

O portal no possui suporte a informao de condies especficas de pagamento, portando sempre ser necessrio
informar uma condio de pagamento que no seja a 0 Condio especial de pagamento.
Os pedidos so divididos em trs categorias para serem enviados ao portal: Normal, emergencial e com contrato.

4.

Dados do pedido no ERP.

enviada uma mensagem de integrao (Dados do Pedido no ERP Transao PurchaseOrder no EAI) para criao do pedido no
portal. O nmero do pedido do portal dever ser o mesmo que o ERP para permitir a rastreabilidade entre os sistemas.
Neste momento do envio do pedido, calculado o valor lquido do pedido e enviado o novo valor para a Paradigma.
5.

Retorno do processamento do pedidos no Portal.

A plataforma do portal faz o processamento da mensagem de integrao (Dados do Pedido no ERP). Se ocorrer um erro no
processamento, devolvida uma mensagem contendo o cdigo do erro e sua descrio, neste caso o pedido marcado Com Erro.
Se for integrado com sucesso o pedido marcado como Integrado. (Transao RequisitionOrderConfirm e
ReturnIntegrationErrors no EAI).
Nota:
Consultar situao do pedido na Funo Consulta de Pedidos (CC0509).
6.

Fornecedor realiza Aceita/Recusa do pedido.

O fornecedor realiza o aceite/recusa do pedido no portal.

7.

Dados do aceite do pedido no Portal.

O ERP busca essa informao de aceite/recusa e atualiza esse dado no ERP.

Nota:
Caso o pedido esteja recusado pelo fornecedor, o recebimento no ser permitido.
Consultar situao do pedido (aceite/recusa) na Funo Consulta de Pedidos (CC0509).

15

INTEGRAO EGPxTSS

Processo de Integrao Alteraes e Cancelamentos

Na integrao existem ainda os fluxos alternativos, que contemplam as alteraes de ordens e pedidos, e tambm os cancelamentos.

Processo de Integrao Alterao de Pedido de Compra

1.

Comprador altera o pedido de compra.

Aps o pedido de compra ter sido enviado para a Paradigma a alterao do mesmo somente pode ser feita no ERP. Toda vez que ele
for alterado, ser enviada uma mensagem de atualizao do pedido para a Paradigma assim que no houverem mais pendncias de
aprovao.
Caso o ERP envie uma mensagem de alterao de pedido de compra e na Paradigma ocorra algum problema na efetivao, ser
retornado um erro. Neste caso o usurio ter que desfazer a alterao do pedido manualmente no ERP para deixar as informaes
equalizadas entre os sistemas.
2.

Aprovador aprova o pedido no ERP.

Caso esteja parametrizado para gerar pendncias de aprovao, o pedido passa pelo fluxo de aprovao antes da atualizao ser
enviada para Paradigma.
3.

Dados do Pedido no ERP.

Quando no houverem mais pendncias de aprovao, o pedido enviado para a Paradigma. (Transao PurchaseOrder no EAI).
4.

Retorno do processamento do pedido no portal.

A plataforma do portal faz o processamento da mensagem de integrao (Dados do Pedido no ERP). Se ocorrer um erro no
processamento, devolvida uma mensagem contendo o cdigo do erro e sua descrio, neste caso o pedido marcado Com Erro,
porm mantido como Integrado para saber se j foi integrado anteriormente e j est na Paradigma. (Transao
RequisitionOrderConfirm e ReturnIntegrationErrors no EAI).
Nota:
Consultar situao do pedido na Funo Consulta de Pedidos (CC0509).
5.

Fornecedor aceita/recusa o pedido.

Cada vez que enviada uma atualizao de pedido para a Paradigma, o pedido passa pelo aceite do fornecedor novamente.
Nota:
Consultar situao do pedido (aceite/recusa) na Funo Consulta de Pedidos (CC0509).

16

INTEGRAO EGPxTSS

Processo de Integrao Alterao de Ordem de Compra

1.

Comprador altera a ordem de compra.

Aps a ordem de compra ter sido enviada para a Paradigma a alterao da mesma somente pode ser feita no ERP. Toda vez que ela
for alterada, ser enviada uma mensagem de atualizao de requisio para a Paradigma.
2.

Dados da ordem de compra no ERP.

Os dados da ordem de compra so enviados para a Paradigma. (Transao PurchaseOrderLine no EAI).

3.

Retorno do processamento da ordem de compra no portal.

A plataforma do portal faz o processamento da mensagem de integrao (Dados da requisio no ERP). Se ocorrer um erro no
processamento, neste caso a ordem de compra marcada Com Erro, porm mantida como Integrada para saber se j foi
integrada anteriormente e j est na Paradigma. (Transao RequisitionOrderConfirm e ReturnIntegrationErrors no EAI).
Nota:
Consultar no CC0505.
Caso o ERP envie uma mensagem de alterao de ordem de compra e na Paradigma e ocorra algum problema na efetivao, ser
retornado um erro. Neste caso o usurio ter que desfazer a alterao da ordem manualmente no ERP para deixar as informaes
equalizadas entre os sistemas.

Processo de Integrao Cancelamento de Pedido de Compra

1.

Comprador cancela/elimina o pedido de compra no ERP.

Caso seja necessrio realizar o cancelamento do pedido, esse dever ser realizado no ERP, nesta ao ser enviado um documento
de integrao (Dados do Cancelamento do Pedido) para o portal tambm realize o cancelamento.
2.

Dados para o cancelamento do pedido.

Os dados do cancelamento do pedido enviados para a Paradigma.

3.

Retorno do cancelamento do pedido no portal.

O cancelamento do pedido a nica transao executada totalmente de forma sncrona com a Paradigma, pois no se pode deixar o
pedido ser eliminado no ERP sem saber se pode ser eliminado na Paradigma.

17

INTEGRAO EGPxTSS

Processo de Integrao Cancelamento de Ordem de Compra

1.

Comprador cancela/elimina a requisio no Portal

Caso seja necessrio realizar o cancelamento da requisio, esse dever ser realizado no portal de compras, nesta ao ser enviado
um documento de integrao (Dados do Cancelamento da Requisio no ERP Transao PurchaseOrderLine no EAI) para que o
cancelamento tambm seja realizado no ERP.
No processo de cotao, caso o usurio elimine uma Requisio (ordem de compra) da cotao e informe que ela no deve ser
liberada para poder ser utilizada em uma nova cotao, esta dever ser retornada como uma requisio cancelada para o ERP.
Nota:
A busca dos cancelamentos de requisio deve ocorrer da mesma forma que as cotaes, ou seja, uma vez buscadas pelo ERP no
devem mais ser retornadas.
2.

Dados para eliminao da ordem de compra no ERP.

A requisio eliminada no ERP com base nos dados enviados pela Paradigma.
Como na Paradigma podem existir diversas requisies para a mesma ordem de compra, o cancelamento de uma requisio na
Paradigma pode representar a eliminao de uma parcela no ERP, portanto o Paradigma obrigar o cancelamento de todas as
parcelas da requisio no Portal para que seja cancelada a ordem de compra no ERP.

Trasaes EAI para Integrao ERP x Portal de Compras Paradigma

Com a integrao entre o ERP 2 e o Portal de Compras Paradigma (WBC Web Business Center), que ser responsvel pela cotao
de itens com diversos fornecedores, possvel agregar volumes de compras para cotao de preo, dentre outras vantagens. A
integrao proporciona uma automao da rea de compras, pois todo o processo de respostas de cotaes realizado pelos
prprios fornecedores no portal de compras da Paradigma. A gerao de ordens de compra ser realizada no ERP 2, e sero enviadas
para o portal de acordo com a necessidade, para o tratamento pelo portal de compras. O processo de cotao e escolha dos
vencedores realizada no portal, sendo o pedido de compra gerado pelo ERP 2 e posteriormente enviado para o portal de compras
da Paradigma.
Existe ainda um segundo fluxo nesta integrao, onde o comprador pode realizar todo o processo at a gerao do pedido de
compra dentro do ERP e enviar ento o pedido para o portal.
Alm da integrao de transaes de negcio (ordens de compra, cotao e pedido) so integrados uma srie de cadastrados para
equalizar os dados utilizados entre os dois sistemas.

18

INTEGRAO EGPxTSS

Os mapas de integrao das transaes abaixo encontram-se liberadas no Datasul EAI:

Transao

Adapter

Envio/
Recebimento

Aplicativo

Web Service e operao

executada na Paradigma

CancelationOrder

adapters/xml/utp/axsut004.p (Web Service)

URL:
http://<servidor>:<porta>/ws/esb/ESBWebServ
Envio
ice,<servidor>,
<porta>,sendMessageSync,message,queue,stri
ng,WSCancelOrder

sender

WS: Pedido
Operao:
ProcessarPedidoCancelamento

Carrier

adapters/xml/utp/axsut001.p
(Fila EAI)

Envio

Sender

WS: Empresa
Operao: ProcessarEmpresa

Currency

adapters/xml/utp/axsut001.p
(Fila EAI)

Envio

Sender

WS: Moeda
Operao: ProcessarMoeda

CustomerVendor

adapters/xml/utp/axsut001.p
(Fila EAI)

Envio

sender

WS: Empresa
Operao: ProcessarEmpresa

InventoryGroup

adapters/xml/utp/axsut001.p (Fila EAI)

Envio

Sender

WS: Categoria
Operao: ProcessarCategoriaProduto

Item

adapters/xml/utp/axsut001.p (Fila EAI)

Envio

Sender

WS: Produto
Operao: ProcessarProduto

MaterialUser

adapters/xml/utp/axsut001.p (Fila EAI)

Envio

Sender

WS: Usuario
Operao: ProcessarUsuario

PaymentPlan

adapters/xml/utp/axsut001.p (Fila EAI)

Envio

Sender

WS: CondicaoPagamento
Operao:
ProcessarCondicaoPagamento

ProcessQuotations

adapters/xml/utp/axsut001.p (Fila EAI)

Envio

Sender

WS: Cotacao
Operao: ReabrirCotacaoItem

PurchaseOrder

adapters/xml/utp/axsut001.p (Fila EAI)

Envio

Sender

WS: Pedido
Operao: ProcessarPedido

PurchaseOrderLine

adapters/xml/utp/axsut001.p (Fila EAI)

Envio

Sender

WS: Requisicao
Operao: ProcessarRequisicao

Site

adapters/xml/utp/axsut001.p (Fila EAI)

Envio

Sender

WS: Empresa
Operao: ProcessarEmpresa

UnitOfMeasure

adapters/xml/utp/axsut001.p (Fila EAI)

Envio

Sender

WS: UnidadeMedida
Operao: ProcessarUnidadeMedida

VendorItem

adapters/xml/utp/axsut001.p (Fila EAI)

Envio

Sender

WS: EmpresaProduto
Operao: ProcessarEmpresaProduto

ProcessQuotations

adapters/xml/su2/axrsu003.p
(Padro de negcio Recebimento)

Recebimento

receiver

WS: Cotacao
Operao: RetornarCotacaoItem

PurchaseOrder

adapters/xml/su2/axrsu004.p
(Padro de negcio Recebimento)

Recebimento

receiver

WS: Pedido
Operao: RetornarPedidoAceite

PurchaseOrderLine

adapters/xml/su2/axrsu002.p
(Padro de negcio Recebimento)

Recebimento

receiver

WS: Requisicao
Operao:
RetornarRequisicaoEntregaCancelame
nto

RequisitionOrderConfir
m

adapters/xml/su2/axrsu011.p

Recebimento

receiver

Retorno do processamento de ordem

de compra e pedido de compra

ReturnIntegrationError
s

adapters/xml/su2/axrsu014.p

Recebimento

receiver

Retorno do processamento de
cadastros

CustomerVendorParadi
gma

adapters/xml/su2/axrsu012.p

Recebimento

receiver

WS: Empresa
Operao:
RetornaEmpresaSemDePara

19

INTEGRAO EGPxTSS

Trasaes EAI para Integrao ERP x Portal de Compras Paradigma Monitor de Integrao I
Permite a manuteno da fila de mensagens XML utilizadas na integrao assncrona do EAI. As mensagens assncronas so
mensagens utilizadas para transportar informaes entre produtos integrados. Levam esse nome pois no so simultneas e no
possuem ritmo regular e definido.
As mensagens visualizadas no Monitor so filtradas de acordo com seu destino, estado de processamento, tipo, transao s quais
esto associadas e a data em que foram geradas.
So necessrios os seguintes procedimentos para visualizar as mensagens do Monitor de Integrao:
1 - Acessar "Opes" no menu de qualquer mdulo do ERP 2;
2 - Selecionar a opo "Monitor de Integrao;

3 - apresentada a janela da funo Monitor de Integrao (EAI9999), onde possvel selecionar o estado de processamento da
mensagem desejada. Para seleo, so apresentadas as seguintes opes:
No processada: Quando selecionada, somente so apresentadas as mensagens no manipuladas no sistema de destino.
Erro: Quando selecionada, somente so apresentadas mensagens que o sistema de destino encontrou algum problema
ao recuper-las da fila.
Processada: Quando selecionada, somente so apresentadas as mensagens processadas com sucesso no sistema de
destino.
Nota
Para mais detalhes relacionados aos procedimentos do aplicativo Datasul EAI, acessar o Manual de Referncia do EAI, em especial a
funo Monitor de Integrao.

20

INTEGRAO EGPxTSS

Configuraes do ESB
Neste documento abordado a configurao de mapas e diagramas no ESB para as transformaes de mensagens trocadas entre o
ERP 2 e a Paradigma.
Nota:
Para realizar as configuraes listadas na sequncia necessrio ter o ESB (verso 12.1 ou superior) instalado, assim como o by You
Studio. Atentar para se j existir uma verso inferior no ESB sendo utilizada, ser necessrio migrar os diagramas/mapas para
utilizao atravs da nova verso do ESB.

Configuraes do ESB Criao do Projeto

Por intermdio do by You Studio criar um novo Projeto do tipo ESB Project:

Neste projeto, ser necessrio criar um diretrio chamado Paradigma (indicado pelo nmero 1 na figura) e importar os diagramas
para o projeto (indicado pelo nmero 2 na figura). Os 8 diagramas esto disponveis esto disponveis no diretrio
Integrator/Paradigma no produto EAI.

21

INTEGRAO EGPxTSS

Dentro do diretrio Paradigma devem ser colocados todos os arquivos com extenso .xsl (eles esto disponveis no diretrio
Integrator/Paradigma no produto EAI). Esses arquivos so necessrios para realizar a converso de mensagens no formato Datasul
para o formato Paradigma, e vice-versa, assim como realizar algumas configuraes da integrao.
Exemplo dos arquivos j dentro do projeto do ESB:

Tendo os diagramas e arquivos dentro do projeto do ESB, pode-se iniciar a configuraes dos componentes para realizar o acesso aos
Web Services da Paradigma e ao banco de dados do EAI.

22

INTEGRAO EGPxTSS

Configuraes do ESB Configurao para Acesso aos Web Services da Paradigma

Nota:
Para configurao dos componentes Web Services necessrio ter o conhecimento da URL a ser utilizada para acesso a Paradigma.
Nos diagramas, necessrio configurar os componentes WS Receiver e WS Sender para realizar a conexo correta aos Web
Services da Paradigma.
Na sequncia, apresentado um exemplo do diagrama ParadigmaAceiteRecusaPedReceiver, indicado em vermelho pelo nmero 1
est o componente WS Receiver que precisa ser configurado. Indicado pelo nmero 2, onde deve ser configurado a URL (WSDL
URL) e Operao (Operation).

A tabela abaixo contm a configurao para os componentes WS Receiver nos demais diagramas:
Diagrama

Componente do Diagrama

WSDL URL

Operation

ParadigmaAceitaRecusaPedR
eceiver

WSReceiverAceiteRecusa

<URL
Paradigma>/Pedido.svc?ws
dl

RetornarPedidoAceite

ParadigmaCancRequsicaoRec
eiver

WSReceiverRequisicaoCancela
mento

<URL
Paradigma>/Requisicao.svc
?wsdl

RetornarRequisicaoEntregaCancel
amento

ParadigmaCotacaoItemReceiv
er

WSReceiverCotacaoItem

<URL
Paradigma>/Cotacao.svc?
wsdl

RetornarCotacaoItem

paradigmacustomervendor

WSReceiverCustomerVendor

<URL Paradigma>/
Empresa.svc?wsdl

RetornaEmpresaSemDePara

23

INTEGRAO EGPxTSS

Na sequncia apresentado um exemplo do diagrama ParadigmaErroCotacaoReceiver, indicado em vermelho pelo nmero 1 onde
est o componente WS Sender que precisa ser configurado. Indicado pelo nmero 2, onde deve ser configurado a URL (WSDL URL),
Operao (Operation) e Parmetros.

24

INTEGRAO EGPxTSS

A tabela abaixo contm a configurao para os componentes WS Sender nos demais diagramas:
Diagrama

Componente do
Diagrama

WSDL URL

Operation

ParadigmaErroCotacaoReceiver WSCotacaoItem

<URL Paradigma>/Cotacao.svc?wsdl

ParadigmaCadastrosReceiver

WSUnidadeMedida

<URL Paradigma>/UnidadeMedida.svc?wsdl ProcessarUnidadeMedida

ParadigmaCadastrosReceiver

WSCondicaoPagamento

ParadigmaCadastrosReceiver

WSCategoria

<URL Paradigma>/Categoria.svc?wsdl

ProcessarCategoriaProduto

ParadigmaCadastrosReceiver

WSItem

<URL Paradigma>/Produto.svc?wsdl

ProcessarProduto

ParadigmaCadastrosReceiver

WSVendorItem

<URL Paradigma>/EmpresaProduto.svc?wsdl ProcessarEmpresaProduto

ParadigmaCadastrosReceiver

WSEmpresa

<URL Paradigma>/Empresa.svc?wsdl

ProcessarEmpresa

ParadigmaCadastrosReceiver

WSCurency

<URL Paradigma>/Moeda.svc?wsdl

ProcessarMoeda

ParadigmaCadastrosReceiver

WSMaterialUser

<URL Paradigma>/Usuario.svc?wsdl

ProcessarUsuario

ParadigmaTransNegocioReceiver WSPedido

<URL Paradigma>/Pedido.svc?wsdl

ProcessarPedido

ParadigmaTransNegocioReceiver WSPurchaseRequisition

<URL Paradigma>/Requisicao.svc?wsdl

ProcessarRequisicao

ParadigmaTransNegocioReceiver WSReabrirCotacaoItem

<URL Paradigma>/Cotacao.svc?wsdl

ReabrirCotacaoItem

ParadigmaTransNegocioReceiver WSReabrirCotacao

<URL Paradigma>/Cotacao.svc?wsdl

ReabrirCotacao

ParadigmaWSCancelOrder

<URL Paradigma>/Pedido.svc?wsdl

ProcessarPedidoCancelamento

WSCancelationOrder

<URL
Paradigma>/CondicaoPagamento.svc?wsdl

ReabrirCotacaoItem

ProcessarCondicaoPagamento

Os parmetros para todos os componentes WS Sender devem ser:

Name

Data Type

Value

XMLDocument

25

INTEGRAO EGPxTSS

Configuraes do ESB Configurao para Acesso ao Banco de Dados EAI

Nos diagramas necessrio configurar os componentes TOTVS Sender e TOTVS Receiver para realizar a conexo com o banco de
dados do EAI.
Na sequncia apresentado um exemplo do diagrama ParadigmaCancRequisicaoReceiver, indicado em vermelho pelo nmero 1
est o componente TOTVSSender que precisa ser configurado. Indicado pelo nmero 2, onde deve ser configurado o acesso ao
banco de dados do EAI. A conexo pode ser testada atravs do boto Test Connection.
Nota:
As informaes devero ser configuradas conforme a instalao do banco EAI no ambiente do cliente.

26

INTEGRAO EGPxTSS

A tabela abaixo possui a lista dos componentes que precisam ser configurados para conectar corretamente o banco de dados do EAI:
Diagrama

Componente no Diagrama

ParadigmaCadastrosReceiver

CadastrosReceiver

ParadigmaCadastrosReceiver

ErroCadastrosEAI

ParadigmaCancRequisicaoReceiver

SenderCancReqEAI

ParadigmaCotacaoItemReceiver

SendCotacaoEAI

ParadigmaErroCotacaoReceiver

ErroCotacaoReceiver

ParadigmaTransNegocioReceiver

TransNegocioReceiver

ParadigmaTransNegocioReceiver

RetornoNegocioEAI

ParadigmaAceitaRecusaPedReceiver

TOTVSSender1437

paradigmacustomervendor

TOTVSSenderCustomer

Configuraes do ESB Configurao para o Arquivo configurationsparadigma.xsl

ShipToAddress: Endereo de entrega padro a ser definido. Essa informao ser utilizada no envio de ordens de compra para o
portal da Paradigma.
Nota:
Trocar o valor 401pelo cdigo do endereo de entrega (Estabelecimento) padro informado pelo cliente.

BillToAddress: Endereo de cobrana padro a ser definido. Essa informao ser utilizada no envio de ordens de compra para o
portal da Paradigma.
Nota:
Trocar o valor 401 pelo cdigo do endereo de cobrana (Estabelecimento) padro informado pelo cliente.

Country: Sigla do pas. Essa informao ser utilizada para traduo da descrio do pas (Brasil) cadastrada no EMS, para a sigla do
pas enviada para a Paradigma.
Nota:
Somente necessrio alterar essa informao caso no cadastro possua uma descrio diferente de Brasil.

27

INTEGRAO EGPxTSS

Clculo de Preo Lquido

A base para os clculos o Preo Fornecedor (cotacao-item.preco-fornec).
IPI pelo preo lquido
Encargos financeiros inclusos no preo do fornecedor:

IPI incluso no preo: Retira o valor do desconto do preo (preo = preo - Valor do desconto) Retira a taxa financeira do
preo (Ver "Clculo para remover taxa financeira no preo") Retira o IPI do preo (preo = preo / (1 + (Alquota IPI / 100)))

IPI no incluso no preo: Retira a taxa financeira do preo (Ver "Clculo para remover taxa financeira no preo") Retira o
valor do desconto do preo (preo = preo - Valor do desconto) o Encargos financeiros no inclusos no preo do
fornecedor:

IPI incluso no preo: Retira o IPI do preo (preo = preo / (1 + (Alquota IPI / 100))) Retira o valor do desconto do preo
(preo = preo - Valor do desconto)

IPI no incluso no preo: Retira o valor do desconto do preo (preo = preo - Valor do desconto)

IPI pelo preo bruto

Encargos financeiros inclusos no preo do fornecedor:

IPI incluso no preo: Retira o IPI do preo (preo = preo / (1 + (Alquota IPI / 100))) Retira o valor do desconto do preo
(preo = preo - Valor do desconto) Retira a taxa financeira do preo (Ver "Clculo para remover taxa financeira no preo")

IPI no incluso no preo: Retira o valor do desconto do preo (preo = preo - Valor do desconto) Retira a taxa financeira do
preo (Ver "Clculo para remover taxa financeira no preo")

Encargos financeiros no inclusos no preo do fornecedor:

IPI incluso no preo: Retira o valor do desconto do preo (preo = preo - Valor do desconto) Retira o IPI do preo (preo =
preo / (1 + (Alquota IPI / 100)))

IPI no incluso no preo: Retira o valor do desconto do preo (preo = preo - Valor do desconto)

Obs.: Se houver ndice de converso para o fornecedor necessrio multiplicar o preo obtido pelo ndice.
Exemplo
Considerando uma cotao com os seguintes dados:

Preo do fornecedor: R$ 12,40000

Valor do desconto: R$ 0,1240

Encargos Financeiros e IPI inclusos no preo

Taxa financeira: 0,9000

28

INTEGRAO EGPxTSS

Dias de taxa financeira: 5

Alquota IPI: 10,00

Condio de pagamento: 30, 60 e 90

Prazo

Percentual de pagamento duplicata

30

33,33

60

33,33

90

33,34

Obs.: Exemplo considerando que o IPI est sendo calculado pelo preo lquido.
Passo 1:
Retirar o valor do desconto do preo (preo = preo - Valor do desconto)
12,4 0,1240 = 12,276
Passo 2:
Retirar a taxa financeira do preo
1. Para cada parcela calcular: Prazo de pagamento X Percentual Pagamento da Duplicata
30 x 33,33 = 999,99
60 x 33,33 = 1999,8
90 x 33,34 = 3000,6
2. Somar todos os resultados obtidos e dividir o valor por 100
(Considerar o valor obtido como "Prazo")
999,99 + 1999,8 + 3000,6 = 6000,39
Prazo = 6000,39 / 100 = 60,0039
3. Calcular: (Valor da Taxa / 100) + 1
(Considerar o valor obtido como "Clculo 1")
"Clculo 1" = (0,9 / 100) + 1 = 1,009
4. Calcular: (1 / Nmero de dias da taxa financeira)
(Considerar o valor obtido como "Clculo 2")
"Clculo 2" = (1 / 5) = 0,2
5. Calcular: Elevar o valor de "Clculo 1" a potncia encontrada em "Clculo 2"
(Considerar o valor obtido como "Clculo 3")
"Clculo 3" = (1,009)0,2 = 1,0017935547
6. Calcular: Elevar o valor de "Clculo 3" a potncia encontrada em "Prazo"
(Considerar o valor obtido como "Clculo 4")
"Clculo 4" = (1,0017935547)60,0039 = 1,1135174520
7. Resultado final: Preo = Preo / "Clculo 4". (Preo sem o desconto)
12,276 / 1,1135174520 = 11,0245241132
Passo 3:
Retirar o IPI do preo (preo = preo / (1 + (Alquota IPI / 100)))
11,0245241132 / (1 + (10 / 100)) = 10,0223
Preo Lquido: R$ 10,0223

29