Manual de Integrao

ERP x Portal de Compras WEBB

Manual de Integrao

Sumrio
ERP x Portal de Compras WEBB.....................................................................................................3
1.1 Introduo Integrao ERP x Portal de Compras WEBB............................................................. 3
1.2 Integrao ERP x Portal de Compras WEBB............................................................................... 5

Manual de Integrao
ERP x Portal de Compras WEBB

Manual de Integrao

ERP x Portal de compras WEBB

1.1

Introduo Integrao ERP x Portal de Compras WEBB

Viso Geral
Por intermdio da integrao entre o ERP 2 e o Portal de Compras Webb, que responsvel pela cotao de itens
com diversos fornecedores, o comprador pode 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 Webb. A gerao de ordens de compra
realizada no ERP 2, e so enviadas para o portal de acordo com a necessidade, para o tratamento pelo portal de
compras. O processo de tomada de preo, escolha da cotao vencedora e gerao do pedido de compra realizada
no portal, que atualiza o Datasul ERP 2 com essas dados. 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.

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

Transao

Adapter

Tipo

Aplicativo

Mensagem
no
portal de compras

ApproveReproveOrder

adapters/xml/utp/axsut001.p

Envio

sender

PurchaseOrder

adapters/xml/utp/axsut001.p

Envio

sender

PurchaseOrderLine

adapters/xml/utp/axsut001.p

Envio

sender

PurchaseOrderLineNotify

adapters/xml/utp/axsut001.p

Envio

sender

ReceiptOrder

adapters/xml/utp/axsut001.p

Envio

sender

ProcessQuotations

adapters/xml/su2/axrsu003.p

Recebimento

receiver

PurchaseOrder

adapters/xml/su2/axrsu004.p

Recebimento

receiver

PurchaseOrderLine

adapters/xml/su2/axrsu002.p

Recebimento

receiver

RequisitionOrderConfirm

adapters/xml/su2/axrsu011.p

Recebimento

receiver

PurchaseOderLineNotify

adapters/xml/utp/axsut001.p

Recebimento

sender

ApproveReproveOrder

adapters/xml/utp/axsut001.p

Recebimento

sender

Mensagem
533

Aprovao/Reprovao
de pedido
Mensagem 506 Dados
do pedido no ERP
Mensagem 506 Dados
da ordem de compra no
ERP
No
h
mensagem
referente no portal
Mensagem 582 Dados
do
recebimento
do
pedido no ERP
Mensagem 710 Dados
da solicitao de cotao
Mensagem 720 Dados
da resposta de cotao
Mensagem 530 Com
dados do pedido no
portal
Mensagem 530 Com
dados da ordem de
compra no portal
Mensagem
512

Confirmao de criao
de
ordem/pedido
no
portal
No
h
mensagem
referente no portal
Mensagem
533

Aprovao/Reprovao
de pedido

Manual de Integrao
ERP x Portal de Compras WEBB

Manual de Integrao

Monitor de Integrao EAI

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.

Manual de Integrao
ERP x Portal de Compras WEBB

Manual de Integrao

Integrao ERP x Portal de Compras WEBB

2.1
MCC

Compras

Portal
de
Compras
Webb
Compras

Viso Geral
Com a integrao entre o Datasul EMS 2 e o portal de compras Webb, 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 Webb. A gerao de ordens de compra ser
realizada no Datasul EMS 2, e sero enviadas para o portal de acordo com a necessidade, para o tratamento pelo
portal de compras. O processo de tomada de preo, escolha da cotao vencedora e gerao do pedido de compra
realizada no portal, que atualiza o Datasul EMS 2 com esses dados. 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.

Fluxo de gesto de pedidos com cotao

1 - Comprador cria/gera a ordem de compra no ERP 2.
2 - Comprador envia ordens de compra para tratamento do portal de compras.
3 Dados da ordem de compra so enviados ao portal.
4 Confirmao de criao da ordem no portal enviada ao ERP 2.
5 Dados da requisio criada no portal so enviados ao ERP 2.
6- Comprador cria e envia cotao a partir da(s) requisio(es) no portal.
7 Dados da criao da solicitao de cotao so enviados ao ERP 2.
8 Fornecedores respondem as cotaes no portal.
9 Dados da resposta da cotao so enviados ao ERP 2.
10 Comprador analisa as respostas e gera pr-pedido a partir da resposta selecionada no portal de compras.
11 Dados do pr-pedido so enviados ao ERP 2.
12 Aprovador aprova/recusa pedido no ERP 2.
13 Dados da aprovao/recusa do pr-pedido.
14 Fornecedor aceita/recusa pedido no portal.
15 Recebimento do pedido realizado no ERP 2.
16 Dados do recebimento do pedido.

Manual de Integrao
ERP x Portal de Compras WEBB

Manual de Integrao

Fluxo de gesto de pedidos sem cotao

1 Comprador cria o pedido no ERP 2.
2 Aprovador aprova pedido no ERP 2.
3 - Comprador envia o pedido para o portal de compras.
4 Dados do pedido so enviados ao portal.
5 Confirmao de criao do pedido do portal enviada ao ERP 2.
6 Dados do pr-pedido criado no portal so enviados ao ERP 2.
7 Aprovao automtica do pedido enviado ao portal.
8 Fornecedor aceita/recusa pedido no portal.
9 Recebimento do pedido realizado no ERP 2.
10 Dados do recebimento do pedido so enviados ao portal.

Manual de Integrao
ERP x Portal de Compras WEBB

Manual de Integrao

Pr-Requisitos da Integrao dos Produtos

- Contrato realizado com a Webb para utilizao do portal de compras.
- Datasul EAI e TOTVS ESB instalados, configurados
Obs.: O EAI deve ser configurado em modo batch.

ativos

para

integrao

com

portal

Webb.

Parametrizao da integrao - Origem

O ERP 2 deve ser parametrizado para utilizar os mdulos de Compras e Cotaes de Compras (CD0101);
A funo referente integrao ("integra-portal-compra") do ERP 2 com o portal de compras deve estar ativa
(CD7070);
Parmetro Integra com o Portal de compras ativado no programa CC0104 Manuteno de parmetros de
compra;
O cliente no dever utilizar aprovao de cotaes, pois o portal no suporta esse processo;
O cliente dever utilizar nos parmetros globais (CD0101) a opo de CNPJ obrigatrio e Com bloqueio, caso
contrrio poder existir vrios fornecedores com o mesmo CNPJ e no ser possvel fazer o link dos fornecedores do
ERP 2 e do Portal na troca de mensagens. (O cliente poder definir a relao entre CNPJ do fornecedor no portal e
cdigos do fornecedor no ERP por intermdio do TOTVS ESB). Caso no seja definido, e exista mais de um
fornecedor na base ser utilizado sempre o primeiro encontrado;

Manual de Integrao
ERP x Portal de Compras WEBB

Manual de Integrao

A lista das transaes que devero ser implantadas para essa integrao no EAI podem ser visualizadas em
Introduo Integrao ERP x Portal de Compras WEBB.

Mapas e diagramas para as transformaes de mensagens trocadas entre o ERP 2 e

Webb
O diagrama ESB com configuraes dos mapas o esb-config-webb-sem-logs.xml. Para configurao do
ambiente, dever ser buscado esse arquivo do diretrio Integrator e colocado no diretrio de instalao do TOTVS
ESB. O arquivo dever ser renomeado para esb-config.xml. Todos os arquivos abaixo (contidos na pasta
Integrator do produto ERP 2), devero ser colocados no diretrio de instalao do TOTVS ESB, em um diretrio
chamado Webb. Se essa pasta ainda no existir, deve ser criada.

Arquivo
sendrequisitiontowebb.xsl
sendordertowebb.xsl
webbconfirmrequisitionorder.xsl
webbrequisitionsinformation.xsl
webbcreateorder.xsl
webbcreatequotation.xsl
webbupdatequotation.xsl
approvereproveordertowebb.xsl
receiptordertowebb.xsl
configurationswebb.xsl

cxmlconverter.xsl
internalconfigurationswebb.xsl

Descrio
(Mensagem 506) Mapa de transformaes com dados
referentes a ordem de compra enviada ao portal
(Mensagem 506) - Mapa de transformaes com dados
referentes ao pedido de compra enviado ao portal
(Mensagem 512) Mapa de transformaes com dados da
confirmao de criao de solicitao ou pedido no portal
(Mensagem 530) Mapa de transformaes com dados
referente a criao da solicitao no portal
(Mensagem 530) Mapa de transformaes com dados
referente ao pr-pedido no portal
(Mensagem 710) Mapa de transformaes com dados da
criao de cotao no portal
(Mensagem 720) Mapa de transformaes com dados da
resposta de cotao no portal
(Mensagem 533) Mapa de transformaes com dados de
Aprovao, Recusa ou Suspenso de pr-pedido
(Mensagem 582) Mapa de transformaes com dados do
recebimento de pedido no ERP 2
Esse arquivo dever conter configuraes referente a integrao
que devem ser verificadas a cada implantao com base em
informaes acordadas com o cliente e a Webb (configuraes
detalhadas na sequncia).
Converso de mensagens no format cXML
Esse arquivo dever conter informaes referente a
configuraes internas da integrao. Por exemplo:
- Template para remover o prefixo do login do comprador;
- Template para gerao de nmero randmico;

senderrortowebb.xsl

twotypeconverter.xsl

twotyperollbackconverter.xsl

Obs.: As configuraes desse arquivo deve ser verificadas no

momento da implantao, pois o prefixo pode ser alterado para
cada cliente.
Mapa de transformaes que faz a leitura dos erros
retrnados pela efetivao de pedido (PurchaseOrder) e
transforma em uma mensagem 533 de suspenso para o portal
Arquivo que deve criar uma estrutura para que seja possvel
identificar os dois tipos de XML vindos do portal: cXML e
WebbXML
Arquivo que desfaz a estrutura criada pelo arquivo
twotypeconverter.xsl e retorno a estrutura do XML para a
estrutura original

Manual de Integrao
ERP x Portal de Compras WEBB

Manual de Integrao

webb_cxmlisvsequence.std

webb_cxmlwebbtransactionidentifier.std

webb_ismessageprocessed.std
webb_operationtype.std
webb_transactionidentifier.std

webb_webbxmlisvsequence.std

webb_webbxmlwebbtransactionidentifier.std

webb_xmltype.std
webbtowebbconverter.xsl
webbxmlconverter.xsl

Arquivo para identificar o ISVsequence com informaes para

identificar se a mensagem referente a um pedido ou a uma
ordem (Quando o XML tiver na estrutura principal cXML)
Identifica qual a mensagem vinda do portal (Ex.: 512, 530...)
para transformao e recebimento de mensagem no formato do
ERP 2 (quando o XML estiver no formato cXML);
Identifica se o retorno recebido um processamento OK de
mensagem, ou se ocorreu algum erro
Verificao
do
tipo
de
operao
realizada
(incluso/alterao)
Identifica de qual transao a mensagem referente (ex.:
PurchaseOrder, PurchaseOrderLine, ApproveReproveOrder...)
para transformao e envio de nova mensagem para o portal
Arquivo para identificar o ISVsequence com informaes para
identificar se a mensagem referente a um pedido ou a uma
ordem
Identifica qual a mensagem vinda do portal (Ex.: 512, 530...)
para transformao e recebimento de mensagem no formato do
ERP 2
Arquivo para identificao de mensagem no formato cXML e
WebbXML
Montagem do arquivo novamente no formato Webb
Converso de mensagens no format WebbXML

Configuraes a serem realizadas no arquivo configurationswebb.xsl

a) ISVID: Informao definida pela Webb como identificador do cliente; Obs.: Trocar o valor 0700004 pelo
identificador correto do cliente.

b) SolutionPrefix: Prefixo definido pela Webb para a soluo;

Obs.: Essa configurao no precisa ser alterada, ser mantido sempre o valor TOT.

c) ClientPrefix: Prefixo definido pela Webb para o login dos usurios;

Obs.: Trocar o valor TOT pelo prefixo correto do cliente.

d) ShipToAddress: Endereo de entrega padro a ser definido;

Obs.: Trocar o valor 401pelo cdigo do endereo de entrega padro informado pelo cliente.

e) BillToAddress: Endereo de cobrana padro a ser definido;

Manual de Integrao
ERP x Portal de Compras WEBB

Manual de Integrao

Obs.: Trocar o valor 101 pelo cdigo do endereo de cobrana padro informado pelo cliente.

f) CNPJ: Caso haja mais de um fornecedor cadastrado no ERP 2 para com o mesmo CNPJ, o cliente pode
definir qual o cdigo ser utilizado para o CNPJ;
Obs.: Neste caso tirar dos comentrios o trecho que est indicado em verde (exemplo 1), e comentar a linha
da sequncia (exemplo 2). Os CNPJs dos fornecedores devem ser colocados onde est indicado o valor
999999999999 e o respectivo cdigo do fornecedor no ERP onde est indicado o valor 99. Essa linha dever ser
repetida para quantos fornecedores existirem com CNPJ duplicado na base.

Exemplo 1:

Exemplo 2:

g) VerifyShipToAdress: Caso haja necessidade de alterar o endereo de entrega vindo da Webb no

momento da criao do pedido, customizar esse template. O parmetro shipAddress contm o valor do endereo
de entrega, o parmetro billAddress contm o valor do endereo de faturamento. Por padro retorna-se o valor
informado no portal, conforme exemplo 1.
Exemplo 1:

Manual de Integrao
ERP x Portal de Compras WEBB

10

Manual de Integrao

Caso haja necessidade de trocar, por exemplo, o endereo de entrega pelo faturamento, deixar o template
conforme exemplo 2 (neste caso o endereo de entrega ser sempre o mesmo que o endereo de faturamento).

Exemplo 2:

Caso haja necessidade de fazer um de-para dos cdigos de endereo de entrega. Utilizar como base o exemplo 3.
Obs.: Neste caso tirar dos comentrios o trecho que est indicado em verde (exemplo 1), e comentar a linha da sequncia
(exemplo 3). Os cdigos de endereo de entrega vindos da Webb devem ser colocados no lugar do XXX e o novo cdigo a
ser efetivado no ERP onde est indicado o valor 99. Essa linha dever ser repetida para quantos endereos de entrega
existirem.

Manual de Integrao
ERP x Portal de Compras WEBB

11

Manual de Integrao

Exemplo 3:

h) ConvertShipToAdressWebb: Caso haja necessidade de alterar o endereo de entrega a ser enviado para
a Webb no momento do envio do pedido, customizar esse template. O parmetro shipAddress contm o valor do
endereo de entrega, o parmetro billAddress contm o valor do endereo de faturamento e o parmetro
warehouse contm o depsito da primeira ordem de compra do pedido. Por padro retorna-se o valor informado no
pedido para o endereo de entrega, conforme exemplo 1.
Exemplo 1:

Caso haja necessidade de trocar, por exemplo, o endereo de entrega pelo faturamento, deixar o template
conforme exemplo 2 (neste caso o endereo de entrega ser sempre o mesmo que o endereo de faturamento).
Exemplo 2:

Configuraes a serem realizadas no ESB

O diagrama/componente HTTCHANNELReceiver representa o nome da fila para onde a Webb deve encaminhar as
mensagens;
Verificar qual a URL de envio de mensagens de mensagens para a Webb e alterar caso necessrio. Essa URL dever
ser obtida com a Webb e verificada nos seguintes componentes:
- Diagrama "EMSReturnReceiver", componente "HTTPSender110"
- Diagrama "EMSReceiver", componente "HTTPSender17"
Obs.: Verificar exemplo na sequncia:

Manual de Integrao
ERP x Portal de Compras WEBB

12

Manual de Integrao

Para a troca de mensagens, os servidores da Webb e do cliente devero estar configurados para se comunicar
(liberao de IPs e portas);
A porta liberada para recebimento de mensagens da Webb, no ambiente dever ser configurada no ESB: Config /
Edit Properties / Internal HTTP Server / Campo "Port", conforme exemplo na sequncia:

Manual de Integrao
ERP x Portal de Compras WEBB

13

Manual de Integrao

Para comunicao do ESB com EAI, dever ser realizada uma configurao no componente abaixo para acessar o
banco do EAI:
Diagrama
"EMSReturnReceiver":
Diagrama
"EMSReceiver":
- Diagrama "HTTPCHANNELReceiver": componente "EMSSender"

componente
componente

"EMSReturnReceiver"
"EMSReceiver"

Obs.: As informaes devero ser configuradas conforme a instalao do banco EAI no ambiente do cliente. Na
sequncia exemplo de configurao para acesso a um banco Progress (a esquerda) e a um banco Oracle (direita).

Manual de Integrao
ERP x Portal de Compras WEBB

14

Manual de Integrao

Manual de Integrao
ERP x Portal de Compras WEBB

15

Manual de Integrao

Para testar a conexo utilizar o boto "Text Conection":

Manual de Integrao
ERP x Portal de Compras WEBB

16

Manual de Integrao

Parametrizao da integrao - Destino

O portal possui a opo de gerao de pedido direto (atravs de ordens de compra enviadas pelo ERP 2, porm
sem a gerao de cotaes). Essa opo no dever ser habilitada para a integrao com o ERP 2.
No portal existe a opo de gerao de pedido para mais de um fornecedor (sendo essa diferena feita com
relao aos itens do pedido - cada item para um fornecedor diferente). No ERP 2 no existe essa
possibilidade. Portanto o portal dever estar configurado para gerar nmeros de pedidos diferentes para
cada fornecedor.
O portal de compras possui a opo de transferncia de requisies entre compradores, essa opo dever
estar desabilitada para a integrao com o ERP 2.
Campos que devem aparecer para o fornecedor na resposta da cotao e que so configurveis conforme
parmetros de compras (CC0104), como o caso de "Alquota ICMS", "Alquota ISS" e "Taxa Financeira
devem ser configurados no portal para cliente (conforme definio de utilizao dos campos).

Parmetro: "Utiliza Taxa Fincanc" (CC0104 - Manuteno Parmetros Compras)

Se no marcado remover ou desabilitar: - Taxa Financeira (TAXAFIN) - Dias taxa financeira (DIASTAXAFIN)

Parmetro: "Utiliza ICMS" (CC0104 - Manuteno Parmetros Compras) Se no marcado

remover ou desabilitar:
- Alquota ICMS (ALIQUOTAICMS)
Manual de Integrao
ERP x Portal de Compras WEBB

17

Manual de Integrao

Parmetro: "Utiliza ISS" (CC0104 - Manuteno Parmetros Compras)

Se no marcado remover ou desabilitar: - Alquota ISS (ALIQUOTAISS) Informaes complementares e
atributos a serem configurados no portal de compras:

Mensagem 506 Solicitao:

Identificador
CATCOMP

Descrio

REQUISITANTE

Categoria de compra (famlia do item)

Requisitante

DEPOSITO

Depsito

Mensagem 506 Pedido (Cabealho):

Identificador

Descrio

TRANSPORTADOR

Transportador

FRETEINCLUSO

Frete incluso

Mensagem 506 Pedido (Itens):

Identificador
CATCOMP
REQUISITANTE
ALIQUOTAIPI
ALIQUOTAICMS
CODIGOICMS
ALIQUOTAISS
VALORFRETE
TAXAFIN
DIASTAXAFIN
PERCDESC
NARRATIVA
CONDESP01
CONDESP02
CONDESP03
CONDESP04
CONDESP05
CONDESP06
CONDESP07
CONDESP08
CONDESP09
CONDESP10
CONDESP11
CONDESP12

Descrio
Categoria de compra (famlia do item)
Requisitante
Alquota IPI
Alquota ICMS
Cdigo ICMS
Alquota ISS
Valor de frete
Taxa Financeira
Dias Taxa Financeira
Percentual de desconto
Narrativa
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela
Condio de pagamento especfica parcela

1
2
3
4
5
6
7
8
9
10
11
12

Mensagem 720:
Identificador

Descrio

TAXAFIN

Taxa financeira

Tipo de campo no
portal
CL Campo livre

Valores possveis
999,9999
Manual de Integrao
ERP x Portal de Compras WEBB

18

Manual de Integrao

DIASTAXAFIN
ALIQUOTAICMS
ALIQUOTAISS
ALIQUOTAIPI
PERCDESC

CL Campo livre

FRETEINCLUSO
VALORFRETE
TRANSPORTADOR

Dias Taxa Financeira

Alquota ICMS
Alquota ISS
Alquota IPI
Percentual
de
Desconto
Frete Incluso
Valor Frete
Transportador

CONTATO

Contato

CL Campo livre

CL Campo livre
CL Campo livre
CL Campo livre
AR Acesso Rpido
CL Campo livre
AR Acesso Rpido

999
999,99
999,99
999,99
99,99999
CIF FOB
999999999,9999
(Conforme
cadastro
de
transportadores do cliente)

Mensagem 530:
Identificador

Descrio

Tipo de campo no
portal

Valores possveis

TRANSPORTADOR

Transportador

AR Acesso Rpido

(Conforme cadastro
transportadores
cliente)

NARRATIVA

Narrativa

CL Campo livre

TAXAFIN

Taxa financeira

CL Campo livre

999,9999

DIASTAXAFIN

Dias Taxa Financeira

CL Campo livre

999

ALIQUOTAIPI

Alquota IPI

CL Campo livre

999,99

ALIQUOTAICMS

Alquota ICMS

CL Campo livre

999,99

ALIQUOTAISS

Alquota ISS

CL Campo livre

999,99

PERCDESC

Percentual de Desconto

CL Campo livre

99,99999

FRETEINCLUSO

Frete Incluso

AR Acesso Rpido

CIF
FOB

(Cabealho)
VALORFRETE

Valor Frete

CL Campo livre

999999999,9999

(Cabealho)

de
do

Necessrio configurar grupos de acesso e login de usurio. Para logins de compradores dever ser utilizado o
padro: Prefixo do cliente + Login ERP (em caixa alta).

Cadastrar endereos de entrega, endereos de faturamento, condies de pagamento, transportador, fornecedores

no portal, conforme dados cadastrados no ERP 2.

Configurar permisses de acesso de cada grupo de usurio, conforme documentao da Webb.

Processos de Integrao
Existem dois fluxos de integrao: o Fluxo de gesto de pedidos com cotao e o fluxo de gesto de pedidos
sem cotao, os quais so descritos na sequncia. Os diagramas de fluxo de dados apresentados na sequncia
detalham como ocorre a integrao entre o ERP 2 e o portal de compras Webb. Os Diagramas de Fluxo de Dados
apresentados nas trs primeiras figuras mostram como o fluxo de gesto de pedidos com cotao.

Manual de Integrao
ERP x Portal de Compras WEBB

19

Manual de Integrao

O processo 1 representa a criao da requisio no ERP 2, que realizada pelo requisitante atravs do
programa CD1406 Requisio/Solicitao de compras. Para o portal de compras ser considerada uma requisio a
ordem de compra do ERP 2, e no a requisio de compra. Todo o processo de criao de requisio e criao ou
gerao de ordens de compra sero feitos no ERP 2, sem nenhuma integrao com o portal de compras.
O segundo processo onde o aprovador realiza a aprovao da requisio, atravs do programa CD1720
Aprovao de documentos. Para o caso do ERP 2 existe a aprovao apenas para a requisio, para a ordem de
compra no existe esse tratamento. (Esse processo tambm no tem integrao com o portal de compras).

Manual de Integrao
ERP x Portal de Compras WEBB

20

Manual de Integrao

Na sequncia, o processo 3 indica a gerao de ordens de compra atravs do programa CC0325 Gerao de
ordens de compra ou a criao de ordens de compra atravs do CC0301 Manuteno de ordens.
O comprador seleciona ordens de compra para tratamento no Portal de Compras, o envio de requisies
(ordens de compra) para o portal dever ser realizado atravs de uma nova interface que permite ao comprador
selecionar as ordens que deseja enviar para o portal de compras (CC0324 Envio de ordens para o portal de
compras). Este programa faz uma chamada ao adapter AXSU002 que faz o envio da ordem de compra para o
portal. Isto est representado no processo 4.
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, deve possuir apenas uma parcela e deve possuir um comprador definido (pois o
portal direciona a requisio diretamente para um comprador especificado. Ao enviar uma ordem de compra para o
portal, por padro a ordem tem seu comprador alterado para o usurio que est utilizando o sistema no momento
(para que isso no ocorra, pode-se alterar na tela de parmetros). Depois de uma ordem de compra ter sido
integrada com sucesso ao portal, ela no poder ser reenviada e ficar congelada (no podendo sofrer alteraes
enquanto estiver com essa situao). Existe a opo de o usurio descongelar a ordem de compra para realizar
algumas alteraes em campos que no so impactantes para o portal. Os dados alterados na ordem de compra
aps a integrao com o portal ficaro inconsistentes se comparados ao portal.
A transao que envia que envia os dados da ordem de compra para o portal a PurchaseOrderLine que
transformada pelo TOTVS ESB na mensagem 506. Neste momento da integrao j podem ser observados algumas
diferenas de conceitos entre os sistemas:
1. O portal permite trabalhar com uma requisio que pode conter vrios itens. O ERP 2, como est
integrando a ordem de compra sempre ter uma requisio (ordem) e apenas um item (Somente as requisio no
ERP 2 podem conter mais de um item);

Manual de Integrao
ERP x Portal de Compras WEBB

21

Manual de Integrao

2. O portal trabalha apenas com uma data de entrega, enquanto o ERP 2 pode ter vrias. Por esse motivo
apenas sero enviadas ordens que possuam apenas uma parcela;
3. O portal permite categorizar as requisies por algum tipo, para o ERP 2 no existe uma distino entre

Manual de Integrao
ERP x Portal de Compras WEBB

22

Manual de Integrao

tipos de ordens de compra, portanto todas sero consideradas da mesma categoria (Padro).
Ao receber a mensagem 506, o portal a processa e gera a confirmao de criao da requisio (Processo 5).
enviada ento ao ERP 2 a mensagem 512 para indicar se requisio foi processada corretamente no portal ou se
ocorreu algum erro. A mensagem 512 transformada na transao RequisitionOrderConfirm no TOTVS ESB. Caso
tenha ocorrido algum erro a ordem de compra ficar disponvel para que o usurio corrija o problema e possa envila novamente ao portal. Caso a ordem tenha sido processada com sucesso, o nmero que foi gerado para a ordem
no portal armazenado no ERP 2. Alm da mensagem 512, enviada tambm a mensagem 530 (transao
PurchaseOrderLine) quando a ordem de compra foi processada corretamente no portal. Essa mensagem contm
tambm o nmero dos itens da solicitao no portal. Para o caso do ERP 2, apenas guardado o nmero da
solicitao pai no portal e o nmero do item para que seja possvel identificar posteriormente, pois sempre ser
uma solicitao com um item. Isso apresentado no processo 6.
O processo 7 mostra a criao e gerao das cotaes a partir das requisies. O processo de solicitao de
cotao, respostas de cotao e aprovao de cotao ser sempre realizado no portal quando a ordem de compra
for integrada a ele. Por isso no ser possvel incluir ou alterar cotaes para ordens que estejam vinculadas ao
portal de compras. Nesse processo tambm h uma diferena de conceitos, no portal de compras o comprador tem a
possibilidade de gerar uma cotao com vrias requisies, e pode ainda selecionar apenas alguns itens de uma
solicitao para que faam parte de uma cotao. No ERP 2, no h essa possibilidade, a cotao gerada sempre
para uma nica ordem.
Quando enviada a mensagem 506 com dados da ordem de compra, so enviados tambm os fornecedores
sugeridos, para que o comprador possa enviar a solicitao de cotao (relacionamento Item X Fornecedor). Esses
fornecedores so apenas uma sugesto, o comprador pode utiliz-los e tambm incluir outros na solicitao de
cotao, como achar melhor.
Quando o comprador envia a solicitao de cotao para os fornecedores, enviada ao ERP 2 a mensagem
710 (Transao ProcessQuotations). Para cada item da cotao do portal gerada uma cotao pendente no ERP
2. A cotao gerada como pendente, pois ainda no h uma resposta do fornecedor. O processo 7 e 8
demonstram. Diferenas de conceito neste processo:
1. O portal de compras pode ter uma cotao com vrios itens, para o ERP 2, a cada item da cotao ser
gerada uma nova cotao (com as referncias do portal);
2. O portal de compras controla o cadastro de fornecedores pelo CNPJ, o ERP 2 por um cdigo (e em algumas
situaes pode possuir CNPJ duplicado);
3. O portal controla a de expirao da cotao por uma data, o ERP 2 em um nmero de dias ( realizada a
converso).
O prximo processo (9) diz respeito as respostas dos fornecedores, que so realizadas no portal de compras.
Tambm h diferenas de conceito nesta situao:
1. No ERP 2 a cotao deve ser feita sempre com na unidade de medida do fornecedor, j no portal no h a
opo para 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 sempre na unidade de medida interna do item (enviada na
mensagem com os dados da ordem de compra);
2. Como no existe controle com relao a 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;
3. O portal permite que o fornecedor altere a quantidade a ser cotada, no momento da resposta da cotao;
4. O Portal se baseia no preo unitrio lquido da mercadoria para demonstrar os valores de cotaes e
pedidos, o ERP 2 se baseia no preo unitrio bruto e calcula e armazena mais dois valores: preo unitrio lquido e
preo unitrio na quantidade do fornecedor (Clculo do Preo do Fornecedor).
Quando o fornecedor responde a uma cotao no portal, ela enviada ao ERP 2 atravs da mensagem 720 e
atualizada no ERP 2 (Transao ProcessQuotations, demonstrada no processo 10).
Em funo do portal no permitir alterao na unidade de medida para que o fornecedor responda a cotao e
o ERP 2 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.
Em funo do portal permitir alterao de quantidade no momento da resposta do fornecedor, caso chegue
uma cotao no ERP 2 que possua uma quantidade diferenciada o sistema dever retornar um erro.

Manual de Integrao
ERP x Portal de Compras WEBB

23

Manual de Integrao

Ao responder uma cotao o fornecedor tem a opo de incluir mais de uma resposta para a mesma cotao,
portanto a mensagem 720 poder conter uma ou mais respostas para a mesma cotao. O ERP 2 armazenar todas
as respostas.
A verso atual da integrao no contempla o envio de mensagens de erro da cotao para o portal, portanto
qualquer erro que acontea ao efetivar uma cotao do ERP 2, apenas ficar registrado no EAI. Caso a mensagem
no seja verificada e comprador gere um pedido no portal com base em uma cotao que no tenha sido efetivada
no ERP 2, ser retornada uma mensagem de suspenso do pedido para o portal.
Em funo do portal trabalhar com um valor lquido, quando esse valor recebido pelo ERP 2 necessrio
calcular os demais valores que o sistema armazena (preo bruto e preo unitrio na quantidade do fornecedor).
No ser permitido ao fornecedor informar uma condio especfica de pagamento que no esteja cadastrada
no sistema.
No diagrama de fluxo de dados apresentado na prxima figura, apresentado a continuidade do fluxo, onde
no onde processo 11 o comprador analisa as respostas de cotao no portal de compras, seleciona a resposta
vencedora e gera um pedido com base nesta cotao.
Ao analisar as respostas dos fornecedores, o comprador, se julgar necessrio pode gerar um fluxo de
contraproposta, onde so enviadas novas solicitaes de cotao para que os fornecedores respondam. No portal h
como ver a relao entre as cotaes originais e as contrapropostas. No momento de selecionar uma resposta
vencedora o comprador pode selecionar tanto uma resposta da cotao original ou ento do fluxo de contraproposta.
Para o ERP 2 as contraproposta so apenas consideradas novas cotaes. Diferenas de conceito neste processo: no
portal existe a possibilidade de gerar mais de um pedido com base nas mesmas requisies, ou seja, selecionar
respostas de mais de fornecedor e gerar pedidos diferenciados. O ERP 2 no permite a gerao de mais de um
pedido para a mesma ordem de compra, portanto se isso ocorrer, o pedido dever ser suspenso, indicando que a
ordem j est relacionada a outro pedido.

Manual de Integrao
ERP x Portal de Compras WEBB

24

Manual de Integrao

Quando o comprador gera um pr-pedido no portal, enviada ao ERP 2 a mensagem 530 (Transao
PuchaseOrder) com os dados do pedido gerado. O ERP 2 deve validar esses dados e processar o pedido, para que

Manual de Integrao
ERP x Portal de Compras WEBB

25

Manual de Integrao

passe pelo fluxo de aprovao do ERP 2.

Caso ocorra algum erro no momento de efetivar o pedido, o ERP 2 dever enviar uma mensagem de
suspenso de pedido (533) para o portal. Pois dessa forma o comprador poder corrigir o que est errado no pedido
e reenvi-lo ao ERP 2. Obs.: Caso tenha ocorrido algum erro no momento da incluso de cotao que no tenha sido
corrigido, independente do erro o pedido ser suspenso com uma mensagem Cotao item inexistente. O usurio
dever procurar o erro original na cotao.
Como no h uma mensagem especfica para aprovao de cotao, o recebimento de uma mensagem de
pr-pedido, significa que determinada cotao foi aprovada. Neste momento as datas das parcelas de ordens de
compra so atualizadas conforme o prazo de entrega negociado na cotao. Como na ordem de compra quando um
pedido originado no portal de compras, fica congelado, para que usurio no possa alterar seus dados (existe a
opo de descongelamento para o pedido tambm).
No momento da gerao do pedido o comprador pode alterar os dados do pedido (como preos, alquotas,
descontos...), em funo disso necessrio consider-los tambm no momento da criao do pedido no ERP 2. 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, caso contrrio o pedido
ser suspenso no portal.
Aps o pedido ser efetivado no ERP 2, ele deve passar pelo fluxo de aprovao dentro do ERP, apresentado no
processo 13.
1. Aprovao: Independentemente se for uma aprovao automtica ou manual, quando o pedido estiver
totalmente aprovado, ser enviada uma mensagem 533 (transao ApproveReproveOrder) ao portal indicando a
aprovao do pedido. Obs.: Se for uma aprovao for item, somente quando for realizada a aprovao de todos os
itens que ser enviada uma mensagem ao portal de compras;
2. Reprovao: Independentemente se for uma aprovao total ou por item, na primeira reprovao que
ocorrer, ser enviada uma mensagem 533 para o portal indicando a reprovao do pedido. Neste caso o usurio ter
que recomear o fluxo do incio e desconsiderar esse pedido, pois o portal no trata re-aprovao de pedido. Se o
usurio alterar um pedido reprovado no ERP 2, ser gerada uma nova pendncia de aprovao, porm a partir
desse momento as mensagens de aprovao/reprovao no sero mais enviadas por portal.
Aps o envio de mensagem de aprovao de pedido para o portal, o pedido deve ser aceito pelo fornecedor
(processo 15). Na verso atual da integrao, essas mensagens de aceite/recusa de pedido pelo fornecedor no so
enviadas ao ERP 2. Neste caso o processo de verificao se o pedido est aceito ou no pelo fornecedor deve ser
feito manualmente.
Caso o fornecedor reprove o pedido, o comprador (no portal) poderia selecionar outra cotao como
"vencedora" e gerar um novo pedido. No ERP, isso no ser possvel, pois as ordens no podero ser desvinculadas
do pedido original. Neste caso, ficou definido que quando um pedido for reprovado, todo o processo ter que ser
realizado novamente, desde o envio de solicitaes para o portal. (Como essa estratgia causa bastante impacto ao
usurio, na segunda fase do projeto dever ser verificada outra alternativa para esta situao). Obs.: Caso seja feito
o recebimento de um pedido ainda no aceito pelo fornecedor ou rejeitado, os dados do recebimento no sero
atualizados no portal. E essa atualizao ter que ser feita de maneira manual no portal de compras.
O recebimento do pedido indicado no processo 16, no momento do recebimento dos pedidos (recebimento
fiscal) enviada uma mensagem ao portal de compras sinalizando os itens que foram recebidos, as respectivas
quantidades e se foi um recebimento total ou parcial do item em questo. enviada a mensagem 582 (Transao
ReceiptOrder para o portal, que atualiza os dados do recebimento no portal de compras.
Na sequncia so apresentados Diagramas de Fluxo de Dados do fluxo de gesto de pedidos sem cotao.
O processo 1 mostra a criao do pedido no ERP, onde no fluxo de pedidos sem cotao, o pedido gerado no
prprio ERP 2, sem nenhuma integrao com o portal de compras. Aps isso ele passa pelo fluxo da aprovao do
pedido feito todo no ERP, sem nenhuma integrao com o portal de compras (processo 2). Aps aprovado o pedido
preciso ser emitido no ERP, atravs do programa CC0305 (processo 3).
O envio de pedidos para o portal dever ser realizado atravs de uma nova interface (CC0329) que permite ao
comprador selecionar os pedidos que deseja enviar para o portal de compras ou atravs do programa de impresso
de pedido (CC0305). Os pedidos so divididos em trs categorias para serem enviados ao portal: Normal,
emergencial e com contrato.

Manual de Integrao
ERP x Portal de Compras WEBB

26

Manual de Integrao

Para que o pedido possa ser enviado ao portal ele deve estar Aprovado e Impresso.
Ao enviar um pedido para o portal de compras enviada uma mensagem 506, contendo as informaes do
pedido. O valor do pedido enviado ao portal, sempre o valor lquido da mercadoria (Clculo do Preo Lquido).
Depois de um pedido de compra ter sido integrado com sucesso ao portal, ele no poder ser reenviado e ficar
congelado (no podendo sofrer alteraes enquanto estiver com essa situao). Existe a opo de o usurio
descongelar o pedido de compra para realizar algumas alteraes em campos que no so impactantes para o
portal. Os dados alterados no pedido aps a integrao com o portal ficaro inconsistentes se comparados ao portal.

Manual de Integrao
ERP x Portal de Compras WEBB

27

Manual de Integrao

Aps o processamento da mensagem 506 pelo portal de compras, enviada ao ERP 2 a mensagem 512 para
indicar se o pedido foi processado corretamente no portal ou se ocorreu algum erro. Caso tenha ocorrido algum erro
o pedido de compras ficar disponvel para que o usurio corrija o problema e possa envi-lo novamente ao portal.
Caso o pedido tenha sido processado com sucesso, o nmero que foi gerado para o pedido no portal armazenado
no ERP 2.
O pedido fica disponvel no portal para que o comprador altere alguns dados (se necessrio) e o envie
(processo 6). Ento a mensagem 530 envia ao ERP com os dados do pedido de compra no portal. Essa mensagem

Manual de Integrao
ERP x Portal de Compras WEBB

28

Manual de Integrao

contm tambm o nmero dos itens do pedido no portal, ou seja, ordens de compra. Neste caso o nmero das
ordens do portal armazenado tambm no ERP 2.
Mesmo que o pedido j tenha sido enviado para o portal aprovado o portal espera uma mensagem 533 de
aprovao para dar continuidade no processo. Portanto logo aps receber a mensagem 530 com os dados do pedido
atualizados no portal, uma mensagem 533 automtica ser enviada ao portal de compras (processo 8).
Aps o envio de mensagem de aprovao de pedido para o portal, o pedido deve ser aceito pelo fornecedor.
Na verso atual da integrao, essas mensagens de aceite/recusa de pedido pelo fornecedor no so enviadas ao
ERP 2. Neste caso o processo de verificao se o pedido est aceito ou no pelo fornecedor deve ser feito
manualmente.
No momento do recebimento dos pedidos (recebimento fiscal) enviada uma mensagem ao portal de
compras sinalizando os itens que foram recebidos, as respectivas quantidades e se foi um recebimento total ou
parcial do item em questo.

Tratamento de Erros de Integrao - Efetivao da Cotao (transao

ProcessQuotations)
Erro

Mensagem

Soluo

No encontrado(a) ordem de
compra para chave informada.

Verificar se a ordem a ordem de compra existe no ERP com o cdigo

enviado. O erro pode acontecer por ela ter sido eliminada.

51317

Data de entrega inferior data

de hoje.

Para realizar da solicitao de cotao e efetuar respostas, a data de

entrega da ordem de compra ainda deve estar vlida, ou seja, deve
ser maior que a data atual.

No encontrado(a) emitente
para chave informada.

Verificar e corrigir caso necessrio o CNPJ do fornecedor cadastrado no

ERP. O erro pode ocorrer caso o CNPJ cadastrado para o fornecedor
esteja diferente no portal de compras e no ERP. Reprocessar a
mensagens aps correo do CNPJ.

No encontrado(a) cdigo da
cotao no portal para chave
informada.

Verificar se mensagem de solicitao de cotao foi processada

corretamente no ERP. O erro pode acontecer em funo de estar
tentando efetivar uma resposta de cotao, para uma solicitao que
no foi efetivada no ERP.

51309

Quantidade informada deve ser

igual a quantidade solicitada.

A quantidade da cotao no pode ser alterada nas repostas do

fornecedor. Caso isso ocorra, o comprador pode gerar uma
contraproposta no portal, para que o fornecedor responda novamente a
cotao (sem alterar a quantidade).

51338

Contedo do campo <nome do

campo> (<contedo>) deve
estar no formato <formato do
campo>.

Corrigir o contedo do campo apresentado na mensagem, conforme

formato apresentado. A correo deve ser realizada no portal de
compras.

25368

Situao do(a) relacionamento

item x fornecedor , deve ser
ativo.

Ativar o relacionamento item x fornecedor (CC0105) e reprocessar a

mensagem.

4261

Transportador no cadastrado.

Cadastrar o transportador no ERP e reprocessar a mensagem.

8303

Condio de pagamento no
est cadastrada.

Cadastrar a
mensagem.

condio

de

pagamento

no

ERP

reprocessar

Manual de Integrao
ERP x Portal de Compras WEBB

29

Manual de Integrao

27998

Condio
de
pagamento
especial deve ser informada.

Ao responder uma cotao o fornecedor deve selecionar uma condio

de pagamento que seja diferente da condio especial (0). Caso isso
ocorra, o comprador pode gerar uma contra-proposta no portal, para
que o fornecedor responda novamente a cotao (com uma condio
de pagamento vlida).

51594

Fornecedor:
CNPJ:
cadastrado como cliente.

est

Cadastrar o emitente tambm como fornecedor no ERP e reprocessar a

mensagem.

16381

No encontrado Emitente para

CNPJ:<CNPJ do fornecedor> .

Cadastrar o fornecedor que est no portal de compras no ERP e

reprocessar a mensagem.

Tratamento de Erros de Integrao - Confirmao de criao de ordem ou pedido

(transao RequisitionOrderConfirm)
Erro
1

Mensagem
Criao da ordem <nmero da
ordem de compra> no portal de
compras: " + <descrio do
erro>.

Soluo
Verificar o erro ocorrido, e conforme deve ser tomada uma ao.
Ex.: Usurio no cadastrado. O usurio comprador dever ser
cadastrado no portal de compras.
Obs.: Essas mensagens de erro so originadas do portal de compras
Webb.

Tratamento de Erros de Integrao - Efetivao de pedido (transao PurchaseOrder)

Erro

Mensagem

Soluo

6363

Pedido de Compra invlido.

Verificar se o pedido de compra existe no ERP com o cdigo enviado.

O erro pode acontecer por ele ter sido eliminado.

51179

Sistema parametrizado para

utilizar aprovao de cotao.

Configurar o sistema para que no seja utilizada a aprovao de

cotao (CD1750) e reprocessar a mensagem.

6364

Ordem de compra invlida.

Verificar se a ordem a ordem de compra existe no ERP com o cdigo

enviado. O erro pode acontecer por ela ter sido eliminada.

51309

Quantidade informada deve ser

igual a quantidade solicitada.

A quantidade das ordens do pedido no pode ser alterada. Caso isso

ocorra, o comprador dever corrigir a quantidade no portal e reenviar
o pedido para o ERP.

51234

Cotao item inexistente.

Verificar se ocorreu algum erro na efetivao da cotao no ERP. Pode

ter ocorrido algum erro na efetivao da solicitao de cotao ou na
resposta fornecedor. Neste caso, o problema da cotao deve ser
solucionado primeiramente, para depois conseguir efetivar o pedido.

51338

Contedo do campo <nome do

campo> (<contedo>) deve
estar no formato <formato do
campo>.

Corrigir o contedo do campo apresentado na mensagem, conforme

formato apresentado. A correo deve ser realizada no portal de
compras.

Manual de Integrao
ERP x Portal de Compras WEBB

30

Manual de Integrao

7381

Condio de
cadastrada.

pagamento

no

Cadastrar a condio de pagamento no ERP e reprocessar a

mensagem.

7850

Transportador do pedido no
cadastrado.

Cadastrar o transportador no ERP e reprocessar a mensagem.

56

Moeda inexistente.

Cadastrar a moeda no ERP e reprocessar a mensagem.

51530

As ordens de compra do pedido

devem
possuir
a
mesma
natureza.

Cancelar alguns itens do pedido que possuam natureza distintas,

manter apenas itens que pertena a mesma natureza. Enviar o pedido
para o ERP novamente. Com os itens cancelados pode-se gerar um
pedido de compra.

Manual de Integrao
ERP x Portal de Compras WEBB

31