erp x portal de compras webb

Manual de IntegraoERP x Portal de Compras WEBB

Manual de Integrao

2Manual de IntegraoERP x Portal de Compras WEBB

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

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 itenscom diversos fornecedores, o comprador pode agregar volumes de compras para cotao de preo, dentre outrasvantagens. A integrao proporciona uma automao da rea de compras, pois todo o processo de respostas decotaes 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 decompras. O processo de tomada de preo, escolha da cotao vencedora e gerao do pedido de compra realizadano portal, que atualiza o Datasul ERP 2 com essas dados. Existe ainda um segundo fluxo nesta integrao, onde ocomprador pode realizar todo o processo at a gerao do pedido de compra dentro do ERP e enviar ento o pedidopara o portal.

Transaes

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

Transao Adapter Tipo Aplicativo Mensagem noportal de compras

ApproveReproveOrder adapters/xml/utp/axsut001.p Envio sender Mensagem 533 Aprovao/Reprovaode pedido

PurchaseOrder adapters/xml/utp/axsut001.p Envio sender Mensagem 506 Dadosdo pedido no ERP

PurchaseOrderLine adapters/xml/utp/axsut001.p Envio sender Mensagem 506 Dadosda ordem de compra noERP

PurchaseOrderLineNotify adapters/xml/utp/axsut001.p Envio sender No h mensagemreferente no portal

ReceiptOrder adapters/xml/utp/axsut001.p Envio sender Mensagem 582 Dadosdo recebimento dopedido no ERP

ProcessQuotations adapters/xml/su2/axrsu003.p Recebimento receiver Mensagem 710 Dadosda solicitao de cotaoMensagem 720 Dadosda resposta de cotao

PurchaseOrder adapters/xml/su2/axrsu004.p Recebimento receiver Mensagem 530 Comdados do pedido noportal

PurchaseOrderLine adapters/xml/su2/axrsu002.p Recebimento receiver Mensagem 530 Comdados da ordem decompra no portal

RequisitionOrderConfirm adapters/xml/su2/axrsu011.p Recebimento receiver Mensagem 512 Confirmao de criaode ordem/pedido noportal

PurchaseOderLineNotify adapters/xml/utp/axsut001.p Recebimento sender No h mensagemreferente no portal

ApproveReproveOrder adapters/xml/utp/axsut001.p Recebimento sender Mensagem 533 Aprovao/Reprovaode pedido

Manual de Integrao


Monitor de Integrao EAI

Permite a manuteno da fila de mensagens XML utilizadas na integrao assncrona do EAI. As mensagensassncronas so mensagens utilizadas para transportar informaes entre produtos integrados. Levam esse nomepois 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 deprocessamento da mensagem desejada. Para seleo, so apresentadas as seguintes opes:

No processada: Quando selecionada, somente so apresentadas as mensagens no manipuladas nosistema de destino.

Erro: Quando selecionada, somente so apresentadas mensagens que o sistema de destino encontroualgum problema ao recuper-las da fila.

Processada: Quando selecionada, somente so apresentadas as mensagens processadas com sucesso nosistema 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


2.1 Integrao ERP x Portal de Compras WEBB

MCCCompras

PortaldeComprasWebbCompras

Viso Geral

Com a integrao entre o Datasul EMS 2 e o portal de compras Webb, que ser responsvel pela cotao deitens com diversos fornecedores, possvel agregar volumes de compras para cotao de preo, dentre outrasvantagens. A integrao proporciona uma automao da rea de compras, pois todo o processo de respostas decotaes realizado pelos prprios fornecedores no portal de compras Webb. A gerao de ordens de compra serrealizada no Datasul EMS 2, e sero enviadas para o portal de acordo com a necessidade, para o tratamento peloportal 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 opedido 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


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


Pr-Requisitos da Integrao dos Produtos

- Contrato realizado com a Webb para utilizao do portal de compras.

- Datasul EAI e TOTVS ESB instalados, configurados e ativos para a integrao com o portal Webb.Obs.: O EAI deve ser configurado em modo batch.

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 decompra;

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, casocontrrio poder existir vrios fornecedores com o mesmo CNPJ e no ser possvel fazer o link dos fornecedores doERP 2 e do Portal na troca de mensagens. (O cliente poder definir a relao entre CNPJ do fornecedor no portal ecdigos do fornecedor no ERP por intermdio do TOTVS ESB). Caso no seja definido, e exista mais de umfornecedor na base ser utilizado sempre o primeiro encontrado;

Manual de Integrao


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

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

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

Arquivo Descriosendrequisitiontowebb.xsl (Mensagem 506) Mapa de transformaes com dados

referentes a ordem de compra enviada ao portalsendordertowebb.xsl (Mensagem 506) - Mapa de transformaes com dados

referentes ao pedido de compra enviado ao portalwebbconfirmrequisitionorder.xsl (Mensagem 512) Mapa de transformaes com dados da

confirmao de criao de solicitao ou pedido no portalwebbrequisitionsinformation.xsl (Mensagem 530) Mapa de transformaes com dados

referente a criao da solicitao no portalwebbcreateorder.xsl (Mensagem 530) Mapa de transformaes com dados

referente ao pr-pedido no portalwebbcreatequotation.xsl (Mensagem 710) Mapa de transformaes com dados da

criao de cotao no portalwebbupdatequotation.xsl (Mensagem 720) Mapa de transformaes com dados da

resposta de cotao no portalapprovereproveordertowebb.xsl (Mensagem 533) Mapa de transformaes com dados de

Aprovao, Recusa ou Suspenso de pr-pedidoreceiptordertowebb.xsl (Mensagem 582) Mapa de transformaes com dados do

recebimento de pedido no ERP 2configurationswebb.xsl Esse arquivo dever conter configuraes referente a integrao

que devem ser verificadas a cada implantao com base eminformaes acordadas com o cliente e a Webb (configuraesdetalhadas na sequncia).

cxmlconverter.xsl Converso de mensagens no format cXMLinternalconfigurationswebb.xsl 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;

Obs.: As configuraes desse arquivo deve ser verificadas nomomento da implantao, pois o prefixo pode ser alterado paracada cliente.

senderrortowebb.xsl Mapa de transformaes que faz a leitura dos errosretrnados pela efetivao de pedido (PurchaseOrder) etransforma em uma mensagem 533 de suspenso para o portal

twotypeconverter.xsl Arquivo que deve criar uma estrutura para que seja possvelidentificar os dois tipos de XML vindos do portal: cXML eWebbXML

twotyperollbackconverter.xsl Arquivo que desfaz a estrutura criada pelo arquivotwotypeconverter.xsl e retorno a estrutura do XML para aestrutura original

Manual de Integrao


webb_cxmlisvsequence.std Arquivo para identificar o ISVsequence com informaes paraidentificar se a mensagem referente a um pedido ou a umaordem (Quando o XML tiver na estrutura principal cXML)

webb_cxmlwebbtransactionidentifier.std Identifica qual a mensagem vinda do portal (Ex.: 512, 530...)para transformao e recebimento de mensagem no formato doERP 2 (quando o XML estiver no formato cXML);

webb_ismessageprocessed.std Identifica se o retorno recebido um processamento OK demensagem, ou se ocorreu algum erro

webb_operationtype.std Verificao do tipo de operao realizada(incluso/alterao)

webb_transactionidentifier.std Identifica de qual transao a mensagem referente (ex.:PurchaseOrder, PurchaseOrderLine, ApproveReproveOrder...)para transformao e envio de nova mensagem para o portal

webb_webbxmlisvsequence.std Arquivo para identificar o ISVsequence com informaes paraidentificar se a mensagem referente a um pedido ou a umaordem

webb_webbxmlwebbtransactionidentifier.std Identifica qual a mensagem vinda do portal (Ex.: 512, 530...)para transformao e recebimento de mensagem no formato doERP 2

webb_xmltype.std Arquivo para identificao de mensagem no formato cXML eWebbXML

webbtowebbconverter.xsl Montagem do arquivo novamente no formato Webbwebbxmlconverter.xsl 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 peloidentificador 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


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 podedefinir 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 linhada sequncia (exemplo 2). Os CNPJs dos fornecedores devem ser colocados onde est indicado o valor999999999999 e o respectivo cdigo do fornecedor no ERP onde est indicado o valor 99. Essa linha dever serrepetida 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 nomomento da criao do pedido, customizar esse template. O parmetro shipAddress contm o valor do endereode entrega, o parmetro billAddress contm o valor do endereo de faturamento. Por padro retorna-se o valorinformado no portal, conforme exemplo 1.

Exemplo 1:

Manual de Integrao


Caso haja necessidade de trocar, por exemplo, o endereo de entrega pelo faturamento, deixar o templateconforme 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 aser efetivado no ERP onde est indicado o valor 99. Essa linha dever ser repetida para quantos endereos de entregaexistirem.

Manual de Integrao


Exemplo 3:

h) ConvertShipToAdressWebb: Caso haja necessidade de alterar o endereo de entrega a ser enviado paraa Webb no momento do envio do pedido, customizar esse template. O parmetro shipAddress contm o valor doendereo de entrega, o parmetro billAddress contm o valor do endereo de faturamento e o parmetrowarehouse contm o depsito da primeira ordem de compra do pedido. Por padro retorna-se o valor informado nopedido 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 templateconforme 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 asmensagens;

Verificar qual a URL de envio de mensagens de mensagens para a Webb e alterar caso necessrio. Essa URL deverser 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


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


Para comunicao do ESB com EAI, dever ser realizada uma configurao no componente abaixo para acessar obanco do EAI:

- Diagrama "EMSReturnReceiver": componente "EMSReturnReceiver"- Diagrama "EMSReceiver": componente "EMSReceiver"- Diagrama "HTTPCHANNELReceiver": componente "EMSSender"

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

Manual de Integrao


Manual de Integrao


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

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, pormsem 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 comrelao aos itens do pedido - cada item para um fornecedor diferente). No ERP 2 no existe essapossibilidade. Portanto o portal dever estar configurado para gerar nmeros de pedidos diferentes paracada fornecedor.

O portal de compras possui a opo de transferncia de requisies entre compradores, essa opo deverestar desabilitada para a integrao com o ERP 2.

Campos que devem aparecer para o fornecedor na resposta da cotao e que so configurveis conformeparmetros de compras (CC0104), como o caso de "Alquota ICMS", "Alquota ISS" e "Taxa Financeiradevem 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 marcadoremover ou desabilitar:

- Alquota ICMS (ALIQUOTAICMS)

Manual de Integrao


Parmetro: "Utiliza ISS" (CC0104 - Manuteno Parmetros Compras)Se no marcado remover ou desabilitar: - Alquota ISS (ALIQUOTAISS) Informaes complementares eatributos a serem configurados no portal de compras:

Mensagem 506 Solicitao:

Identificador DescrioCATCOMP Categoria de compra (famlia do item)REQUISITANTE RequisitanteDEPOSITO Depsito

Mensagem 506 Pedido (Cabealho):

Identificador Descrio

TRANSPORTADOR Transportador

FRETEINCLUSO Frete incluso

Mensagem 506 Pedido (Itens):

Identificador Descrio

CATCOMP Categoria de compra (famlia do item)REQUISITANTE RequisitanteALIQUOTAIPI Alquota IPIALIQUOTAICMS Alquota ICMSCODIGOICMS Cdigo ICMSALIQUOTAISS Alquota ISSVALORFRETE Valor de freteTAXAFIN Taxa FinanceiraDIASTAXAFIN Dias Taxa FinanceiraPERCDESC Percentual de descontoNARRATIVA NarrativaCONDESP01 Condio de pagamento especfica parcela 1CONDESP02 Condio de pagamento especfica parcela 2CONDESP03 Condio de pagamento especfica parcela 3CONDESP04 Condio de pagamento especfica parcela 4CONDESP05 Condio de pagamento especfica parcela 5CONDESP06 Condio de pagamento especfica parcela 6CONDESP07 Condio de pagamento especfica parcela 7CONDESP08 Condio de pagamento especfica parcela 8CONDESP09 Condio de pagamento especfica parcela 9CONDESP10 Condio de pagamento especfica parcela 10CONDESP11 Condio de pagamento especfica parcela 11CONDESP12 Condio de pagamento especfica parcela 12

Mensagem 720:

Identificador Descrio Tipo de campo noportal

Valores possveis

TAXAFIN Taxa financeira CL Campo livre 999,9999

Manual de Integrao


DIASTAXAFIN Dias Taxa Financeira CL Campo livre 999ALIQUOTAICMS Alquota ICMS 999,99ALIQUOTAISS Alquota ISS CL Campo livre 999,99ALIQUOTAIPI Alquota IPI CL Campo livre 999,99PERCDESC Percentual de

DescontoCL Campo livre 99,99999

FRETEINCLUSO Frete Incluso AR Acesso Rpido CIF FOBVALORFRETE Valor Frete CL Campo livre 999999999,9999TRANSPORTADOR Transportador AR Acesso Rpido (Conforme cadastro de

transportadores do cliente)CONTATO Contato CL Campo livre

Mensagem 530:

Identificador Descrio Tipo de campo noportal

Valores possveis

TRANSPORTADOR

(Cabealho)

Transportador AR Acesso Rpido (Conforme cadastro detransportadores docliente)

NARRATIVA Narrativa CL Campo livreTAXAFIN Taxa financeira CL Campo livre 999,9999DIASTAXAFIN Dias Taxa Financeira CL Campo livre 999ALIQUOTAIPI Alquota IPI CL Campo livre 999,99ALIQUOTAICMS Alquota ICMS CL Campo livre 999,99ALIQUOTAISS Alquota ISS CL Campo livre 999,99PERCDESC Percentual de Desconto CL Campo livre 99,99999FRETEINCLUSO

(Cabealho)

Frete Incluso AR Acesso Rpido CIFFOB

VALORFRETE Valor Frete CL Campo livre 999999999,9999

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

Cadastrar endereos de entrega, endereos de faturamento, condies de pagamento, transportador, fornecedoresno 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 pedidossem cotao, os quais so descritos na sequncia. Os diagramas de fluxo de dados apresentados na sequnciadetalham como ocorre a integrao entre o ERP 2 e o portal de compras Webb. Os Diagramas de Fluxo de Dadosapresentados nas trs primeiras figuras mostram como o fluxo de gesto de pedidos com cotao.

Manual de Integrao


O processo 1 representa a criao da requisio no ERP 2, que realizada pelo requisitante atravs doprograma CD1406 Requisio/Solicitao de compras. Para o portal de compras ser considerada uma requisio aordem de compra do ERP 2, e no a requisio de compra. Todo o processo de criao de requisio e criao ougerao 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 CD1720Aprovao de documentos. Para o caso do ERP 2 existe a aprovao apenas para a requisio, para a ordem decompra no existe esse tratamento. (Esse processo tambm no tem integrao com o portal de compras).

Manual de Integrao


Na sequncia, o processo 3 indica a gerao de ordens de compra atravs do programa CC0325 Gerao deordens 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 compradorselecionar as ordens que deseja enviar para o portal de compras (CC0324 Envio de ordens para o portal decompras). Este programa faz uma chamada ao adapter AXSU002 que faz o envio da ordem de compra para oportal. Isto est representado no processo 4.

Para que a ordem de compra possa ser enviada ao portal ela deve estar como No Confirmada, no devepertencer a um pacote de compra, deve possuir apenas uma parcela e deve possuir um comprador definido (pois oportal direciona a requisio diretamente para um comprador especificado. Ao enviar uma ordem de compra para oportal, 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 sidointegrada com sucesso ao portal, ela no poder ser reenviada e ficar congelada (no podendo sofrer alteraesenquanto estiver com essa situao). Existe a opo de o usurio descongelar a ordem de compra para realizaralgumas alteraes em campos que no so impactantes para o portal. Os dados alterados na ordem de compraaps 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 algumasdiferenas de conceitos entre os sistemas:

1. O portal permite trabalhar com uma requisio que pode conter vrios itens. O ERP 2, como estintegrando a ordem de compra sempre ter uma requisio (ordem) e apenas um item (Somente as requisio noERP 2 podem conter mais de um item);

Manual de Integrao


2. O portal trabalha apenas com uma data de entrega, enquanto o ERP 2 pode ter vrias. Por esse motivoapenas 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


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 seocorreu algum erro. A mensagem 512 transformada na transao RequisitionOrderConfirm no TOTVS ESB. Casotenha ocorrido algum erro a ordem de compra ficar disponvel para que o usurio corrija o problema e possa envi-la novamente ao portal. Caso a ordem tenha sido processada com sucesso, o nmero que foi gerado para a ordemno portal armazenado no ERP 2. Alm da mensagem 512, enviada tambm a mensagem 530 (transaoPurchaseOrderLine) quando a ordem de compra foi processada corretamente no portal. Essa mensagem contmtambm o nmero dos itens da solicitao no portal. Para o caso do ERP 2, apenas guardado o nmero dasolicitao pai no portal e o nmero do item para que seja possvel identificar posteriormente, pois sempre seruma 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 decotao, respostas de cotao e aprovao de cotao ser sempre realizado no portal quando a ordem de comprafor integrada a ele. Por isso no ser possvel incluir ou alterar cotaes para ordens que estejam vinculadas aoportal de compras. Nesse processo tambm h uma diferena de conceitos, no portal de compras o comprador tem apossibilidade de gerar uma cotao com vrias requisies, e pode ainda selecionar apenas alguns itens de umasolicitao para que faam parte de uma cotao. No ERP 2, no h essa possibilidade, a cotao gerada semprepara uma nica ordem.

Quando enviada a mensagem 506 com dados da ordem de compra, so enviados tambm os fornecedoressugeridos, para que o comprador possa enviar a solicitao de cotao (relacionamento Item X Fornecedor). Essesfornecedores so apenas uma sugesto, o comprador pode utiliz-los e tambm incluir outros na solicitao decotao, como achar melhor.

Quando o comprador envia a solicitao de cotao para os fornecedores, enviada ao ERP 2 a mensagem710 (Transao ProcessQuotations). Para cada item da cotao do portal gerada uma cotao pendente no ERP2. A cotao gerada como pendente, pois ainda no h uma resposta do fornecedor. O processo 7 e 8demonstram. 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 sergerada 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 algumassituaes 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 aconverso).

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 aopo para o fornecedor escolha uma unidade de medida ou possa responder na sua unidade de medida. Ou seja, ofornecedor sempre ter que responder a cotao sempre na unidade de medida interna do item (enviada namensagem 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 serapresentada 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 epedidos, o ERP 2 se baseia no preo unitrio bruto e calcula e armazena mais dois valores: preo unitrio lquido epreo 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 eatualizada 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 eo ERP 2 exige que a cotao seja realizada na unidade de medida do fornecedor, ao receber uma cotao, a unidadede medida e preo so convertidos conforme a unidade de medida e fator de converso do relacionamento Item XFornecedor.

Em funo do portal permitir alterao de quantidade no momento da resposta do fornecedor, caso chegueuma cotao no ERP 2 que possua uma quantidade diferenciada o sistema dever retornar um erro.

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 todasas respostas.

A verso atual da integrao no contempla o envio de mensagens de erro da cotao para o portal, portantoqualquer erro que acontea ao efetivar uma cotao do ERP 2, apenas ficar registrado no EAI. Caso a mensagemno seja verificada e comprador gere um pedido no portal com base em uma cotao que no tenha sido efetivadano 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 necessriocalcular 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 cadastradano sistema.

No diagrama de fluxo de dados apresentado na prxima figura, apresentado a continuidade do fluxo, ondeno onde processo 11 o comprador analisa as respostas de cotao no portal de compras, seleciona a respostavencedora e gera um pedido com base nesta cotao.

Ao analisar as respostas dos fornecedores, o comprador, se julgar necessrio pode gerar um fluxo decontraproposta, onde so enviadas novas solicitaes de cotao para que os fornecedores respondam. No portal hcomo ver a relao entre as cotaes originais e as contrapropostas. No momento de selecionar uma respostavencedora 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: noportal existe a possibilidade de gerar mais de um pedido com base nas mesmas requisies, ou seja, selecionarrespostas de mais de fornecedor e gerar pedidos diferenciados. O ERP 2 no permite a gerao de mais de umpedido para a mesma ordem de compra, portanto se isso ocorrer, o pedido dever ser suspenso, indicando que aordem j est relacionada a outro pedido.

Manual de Integrao


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

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 desuspenso de pedido (533) para o portal. Pois dessa forma o comprador poder corrigir o que est errado no pedidoe reenvi-lo ao ERP 2. Obs.: Caso tenha ocorrido algum erro no momento da incluso de cotao que no tenha sidocorrigido, independente do erro o pedido ser suspenso com uma mensagem Cotao item inexistente. O usuriodever procurar o erro original na cotao.

Como no h uma mensagem especfica para aprovao de cotao, o recebimento de uma mensagem depr-pedido, significa que determinada cotao foi aprovada. Neste momento as datas das parcelas de ordens decompra so atualizadas conforme o prazo de entrega negociado na cotao. Como na ordem de compra quando umpedido originado no portal de compras, fica congelado, para que usurio no possa alterar seus dados (existe aopo 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. Oportal no possui suporte a informao de condies especficas de pagamento, portando sempre ser necessrioinformar uma condio de pagamento que no seja a 0 Condio especial de pagamento, caso contrrio o pedidoser suspenso no portal.

Aps o pedido ser efetivado no ERP 2, ele deve passar pelo fluxo de aprovao dentro do ERP, apresentado noprocesso 13.

1. Aprovao: Independentemente se for uma aprovao automtica ou manual, quando o pedido estivertotalmente aprovado, ser enviada uma mensagem 533 (transao ApproveReproveOrder) ao portal indicando aaprovao do pedido. Obs.: Se for uma aprovao for item, somente quando for realizada a aprovao de todos ositens que ser enviada uma mensagem ao portal de compras;

2. Reprovao: Independentemente se for uma aprovao total ou por item, na primeira reprovao queocorrer, ser enviada uma mensagem 533 para o portal indicando a reprovao do pedido. Neste caso o usurio terque recomear o fluxo do incio e desconsiderar esse pedido, pois o portal no trata re-aprovao de pedido. Se ousurio alterar um pedido reprovado no ERP 2, ser gerada uma nova pendncia de aprovao, porm a partirdesse 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 soenviadas ao ERP 2. Neste caso o processo de verificao se o pedido est aceito ou no pelo fornecedor deve serfeito 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 desvinculadasdo pedido original. Neste caso, ficou definido que quando um pedido for reprovado, todo o processo ter que serrealizado novamente, desde o envio de solicitaes para o portal. (Como essa estratgia causa bastante impacto aousurio, na segunda fase do projeto dever ser verificada outra alternativa para esta situao). Obs.: Caso seja feitoo recebimento de um pedido ainda no aceito pelo fornecedor ou rejeitado, os dados do recebimento no seroatualizados 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 (recebimentofiscal) enviada uma mensagem ao portal de compras sinalizando os itens que foram recebidos, as respectivasquantidades e se foi um recebimento total ou parcial do item em questo. enviada a mensagem 582 (TransaoReceiptOrder 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 noprprio ERP 2, sem nenhuma integrao com o portal de compras. Aps isso ele passa pelo fluxo da aprovao dopedido feito todo no ERP, sem nenhuma integrao com o portal de compras (processo 2). Aps aprovado o pedidopreciso 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 aocomprador selecionar os pedidos que deseja enviar para o portal de compras ou atravs do programa de impressode pedido (CC0305). Os pedidos so divididos em trs categorias para serem enviados ao portal: Normal,emergencial e com contrato.

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 dopedido. 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 ficarcongelado (no podendo sofrer alteraes enquanto estiver com essa situao). Existe a opo de o usuriodescongelar o pedido de compra para realizar algumas alteraes em campos que no so impactantes para oportal. Os dados alterados no pedido aps a integrao com o portal ficaro inconsistentes se comparados ao portal.

Manual de Integrao


Aps o processamento da mensagem 506 pelo portal de compras, enviada ao ERP 2 a mensagem 512 paraindicar se o pedido foi processado corretamente no portal ou se ocorreu algum erro. Caso tenha ocorrido algum erroo 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 armazenadono 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


contm tambm o nmero dos itens do pedido no portal, ou seja, ordens de compra. Neste caso o nmero dasordens 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 deaprovao para dar continuidade no processo. Portanto logo aps receber a mensagem 530 com os dados do pedidoatualizados 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 aoERP 2. Neste caso o processo de verificao se o pedido est aceito ou no pelo fornecedor deve ser feitomanualmente.

No momento do recebimento dos pedidos (recebimento fiscal) enviada uma mensagem ao portal decompras sinalizando os itens que foram recebidos, as respectivas quantidades e se foi um recebimento total ouparcial do item em questo.

Tratamento de Erros de Integrao - Efetivao da Cotao (transaoProcessQuotations)

Erro Mensagem Soluo

2 No encontrado(a) ordem decompra para chave informada.

Verificar se a ordem a ordem de compra existe no ERP com o cdigoenviado. O erro pode acontecer por ela ter sido eliminada.

51317 Data de entrega inferior datade hoje.

Para realizar da solicitao de cotao e efetuar respostas, a data deentrega da ordem de compra ainda deve estar vlida, ou seja, deveser maior que a data atual.

2 No encontrado(a) emitentepara chave informada.

Verificar e corrigir caso necessrio o CNPJ do fornecedor cadastrado noERP. O erro pode ocorrer caso o CNPJ cadastrado para o fornecedoresteja diferente no portal de compras e no ERP. Reprocessar amensagens aps correo do CNPJ.

2 No encontrado(a) cdigo dacotao no portal para chaveinformada.

Verificar se mensagem de solicitao de cotao foi processadacorretamente no ERP. O erro pode acontecer em funo de estartentando efetivar uma resposta de cotao, para uma solicitao queno foi efetivada no ERP.

51309 Quantidade informada deve serigual a quantidade solicitada.

A quantidade da cotao no pode ser alterada nas repostas dofornecedor. Caso isso ocorra, o comprador pode gerar umacontraproposta no portal, para que o fornecedor responda novamente acotao (sem alterar a quantidade).

51338 Contedo do campo () deveestar no formato .

Corrigir o contedo do campo apresentado na mensagem, conformeformato apresentado. A correo deve ser realizada no portal decompras.

25368 Situao do(a) relacionamentoitem x fornecedor , deve serativo.

Ativar o relacionamento item x fornecedor (CC0105) e reprocessar amensagem.

4261 Transportador no cadastrado. Cadastrar o transportador no ERP e reprocessar a mensagem.

8303 Condio de pagamento noest cadastrada.

Cadastrar a condio de pagamento no ERP e reprocessar amensagem.

Manual de Integrao


27998 Condio de pagamentoespecial deve ser informada.

Ao responder uma cotao o fornecedor deve selecionar uma condiode pagamento que seja diferente da condio especial (0). Caso issoocorra, o comprador pode gerar uma contra-proposta no portal, paraque o fornecedor responda novamente a cotao (com uma condiode pagamento vlida).

51594 Fornecedor: CNPJ: estcadastrado como cliente.

Cadastrar o emitente tambm como fornecedor no ERP e reprocessar amensagem.

16381 No encontrado Emitente paraCNPJ: .

Cadastrar o fornecedor que est no portal de compras no ERP ereprocessar a mensagem.

Tratamento de Erros de Integrao - Confirmao de criao de ordem ou pedido(transao RequisitionOrderConfirm)

Erro Mensagem Soluo

1 Criao da ordem no portal decompras: " + .

Verificar o erro ocorrido, e conforme deve ser tomada uma ao.

Ex.: Usurio no cadastrado. O usurio comprador dever sercadastrado no portal de compras.

Obs.: Essas mensagens de erro so originadas do portal de comprasWebb.

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 parautilizar aprovao de cotao.

Configurar o sistema para que no seja utilizada a aprovao decotao (CD1750) e reprocessar a mensagem.

6364 Ordem de compra invlida. Verificar se a ordem a ordem de compra existe no ERP com o cdigoenviado. O erro pode acontecer por ela ter sido eliminada.

51309 Quantidade informada deve serigual a quantidade solicitada.

A quantidade das ordens do pedido no pode ser alterada. Caso issoocorra, o comprador dever corrigir a quantidade no portal e reenviaro pedido para o ERP.

51234 Cotao item inexistente. Verificar se ocorreu algum erro na efetivao da cotao no ERP. Podeter ocorrido algum erro na efetivao da solicitao de cotao ou naresposta fornecedor. Neste caso, o problema da cotao deve sersolucionado primeiramente, para depois conseguir efetivar o pedido.

51338 Contedo do campo () deveestar no formato .

Corrigir o contedo do campo apresentado na mensagem, conformeformato apresentado. A correo deve ser realizada no portal decompras.

Manual de Integrao


7381 Condio de pagamento nocadastrada.

Cadastrar a condio de pagamento no ERP e reprocessar amensagem.

7850 Transportador do pedido nocadastrado.

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 pedidodevem possuir a mesmanatureza.

Cancelar alguns itens do pedido que possuam natureza distintas,manter apenas itens que pertena a mesma natureza. Enviar o pedidopara o ERP novamente. Com os itens cancelados pode-se gerar umpedido de compra.

erp x portal de compras webb

Documents