Escolar Documentos
Profissional Documentos
Cultura Documentos
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
INTEGRAO EGPxTSS
INTEGRAO EGPxTSS
INTEGRAO EGPxTSS
INTEGRAO EGPxTSS
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).
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.
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.
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.
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.
Quando o usurio atualiza o fornecedor no portal que estava disponvel no Clic Business, esse fica pendente para integrar com o ERP.
5.
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.
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.
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.
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.
O comprador analisa as solicitaes em aberto, agrupa por item se necessrio e gera a ordem de compra.
4.
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.
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.
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.
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.
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.
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.
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
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
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.
14
INTEGRAO EGPxTSS
1.
O comprador gera um pedido de compra no ERP sem integrao com o portal de compras.
2.
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 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.
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.
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.
15
INTEGRAO EGPxTSS
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.
Caso esteja parametrizado para gerar pendncias de aprovao, o pedido passa pelo fluxo de aprovao antes da atualizao ser
enviada para Paradigma.
3.
Quando no houverem mais pendncias de aprovao, o pedido enviado para a Paradigma. (Transao PurchaseOrder no EAI).
4.
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.
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
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.
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.
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.
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
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.
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.
18
INTEGRAO EGPxTSS
Adapter
Envio/
Recebimento
Aplicativo
CancelationOrder
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
Envio
Sender
WS: Categoria
Operao: ProcessarCategoriaProduto
Item
Envio
Sender
WS: Produto
Operao: ProcessarProduto
MaterialUser
Envio
Sender
WS: Usuario
Operao: ProcessarUsuario
PaymentPlan
Envio
Sender
WS: CondicaoPagamento
Operao:
ProcessarCondicaoPagamento
ProcessQuotations
Envio
Sender
WS: Cotacao
Operao: ReabrirCotacaoItem
PurchaseOrder
Envio
Sender
WS: Pedido
Operao: ProcessarPedido
PurchaseOrderLine
Envio
Sender
WS: Requisicao
Operao: ProcessarRequisicao
Site
Envio
Sender
WS: Empresa
Operao: ProcessarEmpresa
UnitOfMeasure
Envio
Sender
WS: UnidadeMedida
Operao: ProcessarUnidadeMedida
VendorItem
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
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.
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
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
ParadigmaCadastrosReceiver
WSCondicaoPagamento
ParadigmaCadastrosReceiver
WSCategoria
<URL Paradigma>/Categoria.svc?wsdl
ProcessarCategoriaProduto
ParadigmaCadastrosReceiver
WSItem
<URL Paradigma>/Produto.svc?wsdl
ProcessarProduto
ParadigmaCadastrosReceiver
WSVendorItem
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
Data Type
Value
XMLDocument
25
INTEGRAO EGPxTSS
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
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
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 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")
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:
INTEGRAO EGPxTSS
Prazo
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