Integração TOTVS Marketplace

Contexto de negócio

Com a integração entre o ERP 2 e o Portal de Compras Paradigma (WBC – Web Business Center), que será responsável pela cotação de itens com diversos fornecedores, é possível agregar volumes de compras para cotação de preço, dentre outras vantagens. A integração proporciona uma automação da área de compras, pois todo o processo de respostas de cotações é realizado pelos próprios fornecedores no portal de compras da Paradigma. A geração de ordens de compra será realizada no ERP 2, e serão enviadas para o portal de acordo com a necessidade, para o tratamento pelo portal de compras. O processo de cotação 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 integração, onde o comprador pode realizar todo o processo até a geração do pedido de compra dentro do ERP e enviar então o pedido para o portal.

Além da integração de transações de negócio (ordens de compra, cotação e pedido) são integrados uma série de cadastrados para equalizar os dados utilizados entre os dois sistemas.

Fluxo de Integração de Cadastros

Usuário inclui ou altera um cadastro no ERP;
Dados do Cadastro incluído ou alterado são enviados para a Paradigma;
Dados de retorno do processamento do cadastro na Paradigma (sucesso ou erro) são enviados ao ERP;
Busca o fornecedor do Clic business para a sua base de fornecedores;
Dados do fornecedor são envidas para o ERP;
Se o cadastro for executado com sucesso, o código do fornecedor é atualizado no portal.

Fluxo de Gestão de Pedidos com Cotação

O requisitante gera uma solicitação de compra no ERP;
Aprovador aprova solicitação no ERP;
Comprador Gera Ordem de Compra;
Comprador seleciona as ordens de compra para tratamento no portal;
Dados da requisição no ERP são enviados para o portal;
Retorno do processamento da requisição no Portal é enviada ao ERP;
Comprador cria e envia cotação a partir da requisição;
Fornecedores respondem a cotação;
Comprador Encerra o item de cotação ou a cotação;
Dados da resposta da cotação são enviados ao ERP;
Aprovador aprova ou recusa processo de compra;
Reabertura de item de cotação na Paradigma (no caso de recusa de processo);
Comprador gera pedido de compra no ERP;
Pedido passa pela aprovação interna do ERP;
Comprador seleciona pedidos para tratamento no portal;
Dados do pedido no ERP são enviados para o portal;
Retorno do processamento dos pedidos no Portal é enviado ao ERP;
Fornecedor realiza Aceita/Recusa do pedido;
Dados do aceite do pedido no Portal são enviados ao ERP.

Fluxo de Gestão de Pedidos Sem Cotação

Criação do Pedido no ERP;
Aprovação do Pedido no ERP;
Comprador seleciona pedidos para tratamento no portal;
Dados do pedido no ERP são enviados para o Portal;
Retorno do processamento do pedido no Portal é enviado ao ERP;
Fornecedor realiza Aceita/Recusa do pedido;
Dados do aceite do pedido no Portal são enviados ao ERP.

Fluxo de Alterações e Cancelamento

Alteração de Pedido de Compra

Comprador altera o pedido de compra no ERP;
Aprovador aprova o pedido no ERP;
Dados do Pedido no ERP são enviados para a Paradigma;
Retorno do processamento do pedido no portal é enviado ao ERP;
Fornecedor aceita/recusa o pedido no Portal;
Dados do aceite do pedido no Portal são enviados ao ERP.

Alteração de Ordem de Compra

Comprador altera a ordem de compra no ERP;
Dados da ordem de compra do ERP são enviados para a Paradigma;
Retorno do processamento da ordem de compra no portal é enviada ao ERP.

Cancelamento de Pedido de Compra

Comprador cancela/elimina o pedido de compra no ERP;
Dados para o cancelamento do pedido são enviados para o Portal;
Retorno do cancelamento do pedido no portal é enviado ao ERP.

Cancelamento de Ordem de Compra

Comprador cancela/elimina a requisição no Portal;
Dados para eliminação da ordem de compra são enviados ao ERP.

Pré-requisitos instalação

Contrato realizado com a Paradigma para utilização do portal de compras (WBC – Web Business Center).

Datasul EAI e TOTVS ESB instalados, configurados e ativos para a integração com o portal da Paradigma.

Nota:

TOTVS | ESB Server 12.2.3 ou superior;

TOTVS | Developer Studio 11.1;

TOTVS | ESB Plugin 12.2.3 ou superior.

Parametrização da Integração no Produto, Origem

O ERP 2 deve ser parametrizado para utilizar os módulos de “Compras” e “Cotações de Compras” (CD0101);
A utilização do Processo de Compra nos parâmetros de cotação (OC0101) deverá estar habilitada, campo “Utiliza Processo”;
A função referente a integração ("PORTAL-PARADIGMA") do ERP 2 com o portal de compras Paradigma deve estar ativa (CD7070);
Parâmetro “Integra com o Portal de compras” ativado no programa CC0104 – Manutenção de parâmetros de compra;
A lista das transações que deverão ser implantadas para essa integração no EAI podem ser visualizadas em Transações Integração ERP x Portal de Compras Paradigma.
Caso seja utilizado o módulo de MLA: cadastrar o programa “lap/mla0301d.p” como programa de aprovação no (MLA0101) para os documentos que são utilizados e que possuem integração com a Paradigma (pedido de compra, contrato e cotação).

Configurar os diagramas no ESB conforme orientações disponíveis em configurações do ESB.

Para realizar a carga de dados cadastrais na Paradigma, deve ser utilizado o programa de Carga de Dados via EAI (CD0323), selecionando a opção Marketplace (Paradigma). No programa serão listados todos os programas para realizar a carga de dados de cada entidade.

Nota:
É importante que seja executado o programa de conferência de dados antes de iniciar as cargas de dados, para identificar possíveis inconsistências.

Parametrização da Integração no Produto, Destino

Cálculo do preço líquido

É necessário realizar as configurações para o cálculo do preço líquido na Paradigma. Variáveis envolvidas no cálculo:

Percentual de desconto: informado na cotação;
Taxa financeira: informada na cotação;
Alíquota IPI: informada na cotação;
Cálculo do IPI pelo preço bruto ou líquido: pode mudar conforme o cliente, é necessário verificar no ERP (programa

Manutenção de Parâmetros de Compra (CC0104)) como deve ser o cálculo;

Condição de pagamento: números de dias e percentual de pagamento das parcelas (condição de pagamento da cotação).

Pré-requisitos das taxas a serem informadas no Paradigma:

Taxa financeira: Somente pode estar habilitada ou aparecendo para informar a taxa se o cliente tiver parametrizado dessa forma no ERP (Verificar no programa Manutenção de Parâmetros de Compra (CC0104), o parâmetro “Utiliza Taxa Financ”). O controle para dizer se está ou não incluso no preço deve estar habilitado conforme o parâmetro também;
Alíquota IPI: Sempre visível/habilitado. O controle para dizer se está ou não incluso no preço deve estar habilitado;
Alíquota ICMS: Somente pode estar habilitada ou aparecendo para informar a taxa se o cliente tiver parametrizado dessa forma no ERP (Verificar no programa Manutenção de Parâmetros de Compra (CC0104), o parâmetro “Utiliza ICMS”). O controle para dizer se está ou não incluso no preço NÃO deve estar habilitado (neste caso deve considerar que sempre está incluso no preço bruto);
Alíquota ISS: Somente pode estar habilitada ou aparecendo para informar a taxa se o cliente tiver parametrizado dessa forma no ERP (Verificar no programa Manutenção de Parâmetros de Compra (CC0104), o parâmetro “Utiliza ISS”). O controle para dizer se está ou não incluso no preço NÃO deve estar habilitado (neste caso deve considerar que sempre está incluso no preço bruto).

Nota:
Para mais detalhes, veja o cálculo do preço líquido.

Processos de Integração

Abaixo são apresentados os dois fluxos de mensagens que são trocadas entre o EMS e o portal Paradigma: gestão de pedidos com cotação e gestão de pedidos sem cotação. Além disso, são apresentados os fluxos de mensagens de cadastros, alterações e cancelamentos de requisições (ordens de compra) e pedidos.

A Paradigma trata todas as suas transações como síncrona, porém para não prejudicar a performance do sistema, através do TOTVS ESB, as transações são tratadas de forma assíncrona. Ou seja, o retorno das mensagens será tratado como uma nova mensagem no EAI, onde se houverem erros, o usuário deverá corrigir e integrar novamente o registro em questão.

Nota: Não é possível integrar ordens simultaneamente ao mercado eletrônico e ao portal paradigma.

Processo de Integração – Cadastros

1. Usuário inclui ou altera um cadastro no ERP

Para equalização dos dados cadastrais entre os dois sistemas (Datasul EMS 2 e Paradigma) será realizada a integração de alg uns cadastros. A integração desses cadastros parte do ERP para a Paradigma, e ocorre quando há uma inclusão ou alteração de um registro. Eliminações não são tratadas.

A integração do sentido contrário 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 não haja incompatibilidade dos dados.

Nota:
Exceções serão detalhadas na sequência.

2. Dados do Cadastro incluído ou alterado são enviados para a Paradigma

Os cadastros que serão integrados são os seguintes:

Unidade de Medida (Transação “UnitOfMeasure” no EAI);
Item (Paradigma trata como Produto) - (Transação “Item” no EAI);
Moeda - (Transação “Currency” no EAI);
Condição de Pagamento: Ao enviar uma condição de pagamento para a Paradigma é necessário relacioná-la a uma empresa, como no ERP não existe este controle, a condição de pagamento deve estar disponível para ser utilizada por todas as empresas, sem restrições - (Transação “PaymentPlan” no EAI);
Grupo de estoque (Paradigma trata como Categoria de Produto) - (Transação “InventoryGroup” no EAI);
Fornecedor (Paradigma trata como Empresa Vendedora) – (Transação “CustomerVendor” no EAI) - Como não serão tratadas importações nesta primeira fase do projeto, somente fornecedores brasileiros serão enviados para a Paradigma;

Quando incluído um fornecedor no ERP e integrado com o portal pela primeira vez, é gerada uma senha para acesso no portal com o usuário sendo o número do CNPJ do fornecedor. Quando o fornecedor acessar o portal pela primeira vez, é solicitada a alteraçã o da senha.

Nota:
1. Como o EMS não obriga informar e-mail no cadastro, o portal irá realizar essa validação, e caso não esteja preenchido a mensagem será retornada com erro.
2. O EMS possui opção de deixar o fornecedor inativo por um determinado período, no final deste período o fornecedor é considerado automaticamente ativo. O Portal não possui esse tipo de controle, portanto para ativar o fornecedor no portal ao final do período, o cadastro deverá ser alterado para envio da mensagem de alteração.
3. Somente serão integrados com o portal os fornecedores que forem parametrizados para esse fim, esse controle estará disponível para o usuário no Cadastro de Fornecedores do ERP (CD0401).
4. O código do fornecedor na Paradigma terá a seguinte estrutura: for + <código do fornecedor no ERP>

Estabelecimento (Paradigma trata como Empresa Compradora) – (Transação “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 não serão tratadas regras para outros países, somente estabelecimentos brasileiros serão enviados para a Paradigma;

Nota:
O código do estabelecimento na Paradigma terá a seguinte estrutura: est + <código do estabelecimento no ERP>

Transportador (Paradigma trata como Empresa Transportadora) - (Transação “Carrier” no EAI) - Como não serão tratadas importações, somente transportadores brasileiros serão enviados para a Paradigma;

Nota:
O código do transportador na Paradigma terá a seguinte estrutura: tra + <código do transportador no ERP>

Item Fornecedor (Paradigma trata como Produto x Empresa) – (Transação “VendorItem” no EAI) Ao enviar esse relacionamento para a Paradigma, além do relacionamento entre Produto e Empresa deverá ser criado também o relacionamento entre Categoria e Empresa;

Nota:
Somente serão enviados para o portal os relacionamentos de item x fornecedor de fornecedores que possuírem integração com o portal de compras, configurado na função Cadastro de Fornecedores do ERP (CD0401).

Usuário – (Transação “MaterialUser” no EAI) – Serão integrados os usuários de materiais que sejam compradores e/ou requisitantes.

Como é necessário vincular o usuário a uma única empresa ao enviar a integração, esse cadastro deverá ser habilitado para alt eração na Paradigma. Isso se faz necessário para que seja possível relacionar um usuário a mais de uma empresa.

Como no ERP não possui a obrigatoriedade de informar o e-mail no cadastro de usuário, essa validação será realizada pela Paradigma, sendo retornado um erro, caso não seja enviado o e-mail para o usuário.

Quando incluído um usuário no ERP e integrado com o portal pela primeira vez, é gerada uma senha para acesso no portal que é enviada por e-mail para o endereço informado no cadastro de usuário do ERP (por isso é importante que essa informação esteja correta). Quando o usuário acessar o portal pela primeira vez, é solicitada a alteração da senha.

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

A Paradigma trata todas as suas transações como síncrona, porém para não prejudicar a performance do sistema, através do TOTVS ESB, o processo foi tornado assíncrono. Ou seja, o retorno das mensagens será tratado como uma nova mensagem no EAI (Transaçã o “ReturnIntegrationErrors” no EAI), onde se houverem erros, o usuário deverá corrigir e integrar o cadastro novamente.

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

Quando o usuário atualiza o fornecedor no portal que estava disponível no Clic Business, esse fica pendente para integrar com o ERP.

5. Dados do fornecedor na Paradigma

Fornecedor – (Transação “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 situação de Inativo. Será necessári o que esse cadastro seja revisado pelo usuário, atualizando os dados que não foram integrados pelo portal. Depois dessa revisão o fornecedor poderá ter sua situação alterada para ativo.

6. Atualiza código fornecedor

Não ocorrendo nenhum erro na integração do fornecedor no ERP, o código do ERP desse fornecedor é atualizado no portal para manter a integridade entre eles.

Processo de Integração – Gestão de Pedidos com Cotação

No fluxo de gestão de pedidos com cotações, o processo de cotações das ordens de compra e escolha do fornecedor vencedor é realizado no portal de compras da Paradigma.

Detalhamento do fluxo:

1. O requisitante gera uma solicitação de compra no ERP.

Todo o processo de criação de requisição ou geração de ordens de compra serão feitos no ERP, sem nenhuma integração com o portal de compras.

2. Aprovador aprova solicitação no ERP.

A solicitação passa pela estratégia atual de aprovação interna no ERP (caso exista) e, uma vez aprovado, é enviada para o comprador fazer o tratamento necessário.

3. Comprador Gera Ordem de Compra.

O comprador analisa as solicitações em aberto, agrupa por item se necessário e gera a ordem de compra.

4. Comprador seleciona as ordens de compra para tratamento no portal.

O comprador seleciona as ordens de compra que deseja trabalhar através do portal de Compras e as envia, através 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 requisições ou que foram criadas por outras rotinas no ERP.

Para que a ordem de compra possa ser enviada ao portal ela deve estar como “Não Confirmada”, não deve pertencer a um pacote de compra e não deve pertencer a um contrato. A ordem não precisa ter um comprador definido para ser enviado, ele poderá ser definido no portal. As parcelas da ordem de compra não devem ter datas de entrega menores que a data atual, caso contrário também não podem ser enviadas.

Nota:
Para ordens de compra que possuam mais de uma entrega (parcela), a cada entrega da ordem será criada uma requisição diferenciada na Paradigma (sendo que essas requisições sempre deverão ser tratadas em conjunto na Paradigma).

5. Dados da requisição no ERP.

O ERP gera um documento de integração (Dados da Requisição no ERP) – Transação “PurchaseOrderLine” no EAI.

Nota:
Após uma ordem de compra ter sido enviada ao portal, ela ficará congelada, sendo que neste caso não será permitida a eliminaç ão da ordem de compra. A eliminação, ou no caso cancelamento, somente poderá ser feito através da Paradigma. Os dados alterados da ordem de compra após ela ter sido enviada para a Paradigma são reenviados para que seja mantida a consistência entre os do is sistemas.

6. Retorno do processamento da requisição no Portal.

A plataforma do portal faz o processamento da mensagem de integração (Dados da Requisição no ERP). (Transação “RequisitionOrderConfirm” e “ReturnIntegrationErrors” no EAI).

O retorno é efetivado no ERP, que atualiza se a requisição foi integrada com sucesso ou se ocorreram erros na integração. Os erros são listados através do EAI para o usuário possa consultá-los, corrigir e reenviar a ordem de compra.

Nota:
1. Consultar a situação na ordem de compra na consulta de ordens de compra (CC0505).

2. Não é necessário armazenar nenhum número de referência da Paradigma, pois o número da requisição no Portal será o mesmo do ERP. Neste caso o usuário tem a rastreabilidade das informações.
3. Caso tenha ocorrido erro na efetivação de alguma parcela na Paradigma, a ordem deverá ser marcada com erro, para que a situação seja corrigida e a ordem reenviada.

7. Comprador cria e envia cotação a partir da requisição.

Com a requisição salva no Portal de Compras, o comprador acessa a lista de requisições, podendo criar um processo de Tomada de Preço (Solicitação de Cotação). Neste processo temos:

a.     O comprador seleciona as requisições que farão parte da cotação;
b.     São definidos os fornecedores da cotação (conforme relacionamento Produto x Empresa (fornecedor));
c.     O comprador envia a solicitação de cotação através do Portal de Compras para os fornecedores selecionados.

Nota:
1 - Como para a Paradigma cada entrega de uma requisição (ordem de compra) é uma requisição independente, o comprador ao inserir uma requisição (entrega) em um processo de cotação, deverá inserir todas as outras requisições (entregas) que são referentes a mesma ordem de compra no ERP no mesmo processo de cotação.
2 - Por conceito do portal, para que o fornecedor esteja disponível para relacionamento na cotação é pré-requisito que tenha sido cadastrado o relacionamento do item x fornecedor.

8. Fornecedores respondem a cotação.

Os fornecedores respondem ao processo de cotação via Portal de Compras. Diferenças de conceito:

a.     No EMS a cotação deve ser feita sempre com na unidade de medida do fornecedor, já no portal não há a opção 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 cotação na unidade de medida interna do item;
b.     Como não existe controle com relação à utilização da unidade de medida do fornecedor, a quantidade a ser apresentada para o fornecedor no portal será sempre a quantidade interna e não a quantidade do fornecedor;
c.     O Portal possui o conceito de que o fornecedor informa o preço bruto da mercadoria, e o sistema calcula internamente o preço líquido. (Para que o preço líquido entre os dois sistemas esteja equalizado, devem ser seguidas as regras para configuração de preço líquido já apresentadas anteriormente);
d.     Como a Paradigma controla o preço do fornecedor com 4 decimais e o ERP com 5, poderão haver pequenas diferenças entre os preços calculados entre os dois sistemas;
e.     Ao gerar a cotação a Paradigma possui alguns “agrupadores” de itens, sendo que várias ordens de compra podem gerar um item na Cotação da Paradigma com a soma das quantidades. Neste caso o item possui várias entregas que serão as requisições (ordens de compra);
f.     Não será permitido ao fornecedor informar uma condição específica de pagamento que não esteja cadastrada no sistema.

9. Comprador Encerra o item de cotação.

O comprador analisa as respostas dos fornecedores, seleciona a cotação vencedora e encerra o item de cotação, neste momento será enviado um documento de integração para o ERP (Dados das Respostas da Cotação – Transação “ProcessQuotations”) com todas as respostas dos fornecedores juntamente com a cotação vencedora.

A Paradigma não deve permitir que mais uma proposta seja selecionada como vencedora, ou seja, para cada requisição d a cotação, pode haver apenas uma proposta (fornecedor) como vencedor.

A alteração da cotação e cancelamento na Paradigma somente é permitida antes do encerramento da cotação. Após a cotação ter sido encerrada e enviada ao ERP, somente o ERP poderá reabri-la em função de algumas situações detalhadas posteriormente.

10. Dados da resposta da cotação.

Após o encerramento do item de cotação na Paradigma, ele fica disponível para ser buscado e efetivado pelo ERP. Uma vez que a cotação tenha sido retornada para o ERP, somente poderá ser disponibilizada novamente pela Paradigma caso o item tenha sido reaberto e encerrado novamente pelo comprador. No caso, quando ocorrem esses encerramentos em função de reabertura de itens, somente os itens de cotação que foram reabertos serão retornados para o ERP na nova busca.

Sobre a estrutura do processo de cotação na Paradigma:

Uma cotação pode conter diversos itens, ou seja, diversas ordens de compra;
Uma cotação pode conter diversas respostas de fornecedores;
Uma cotação pode conter diversas respostas do mesmo fornecedor para a mesma ordem de compra.
Uma solicitação de cotação (cotação do item do ERP) pode ser enviada ao fornecedor e ele declinar ou não responder, neste caso essas cotações não são retornadas ao ERP;
Propostas aceitas e desclassificadas pelos compradores são retornadas ao ERP, porém somente serão gravadas as cotações aceitas e que não foram desclassificadas.

Em função dessa estrutura, e de que o Pedido de compra na Paradigma somente pode ser referente a uma co tação, ao chegar uma cotação da Paradigma, será gerado um Processo de Compras, que agrupará as ordens de compra conforme o que foi feito na Paradigma. Após a criação do processo, são efetivadas as cotações, sendo que uma cotação da Paradigma, quando efetiv ada no ERP pode gerar diversas cotações (respostas de fornecedores).

Para que o usuário possa manter a rastreabilidade entre o processo de cotação da Paradigma e o processo de compra do ERP, a descrição do processo de compras criado no ERP será sempre o Código do processo da Paradigma (sendo que este não poderá se repetir para diferentes processos na Paradigma). O processo de compra também fica como integrado com a Paradigma, consultar na função Consulta Processo (OC0401).

Em função do portal não permitir alteração na unidade de medida para que o fornecedor responda a cotação e o EMS exige que a cotação seja realizada na unidade de medida do fornecedor, ao receber uma cotação, a unidade de medida e preço são convertido s conforme a unidade de medida e fator de conversão do relacionamento Item X Fornecedor.

Para manter a rastreabilidade entre os sistemas será armazenado no ERP além dos códigos internos de controle da Paradigma o “Código do processo”, através do qual o usuário consegue identificar a cotação na Paradigma.

Nota:
Consultar na função Consulta Cotações (CC0506).

Como o ERP não possui controle de cotação por parcela da ordem de compra, ao gravar as informações de uma cotação aprovada na Paradigma, não será considerado o prazo de entrega da cotação para recalcular as novas datas de entrega, serão assumidas as datas informadas pelo fornecedor na Paradigma.

O Portal permite que o fornecedor informe preço proposto igual a R$ 0,00, caso isso ocorra o ERP irá bloquear a cotação para ajuste. Caso ocorram erros na efetivação da cotação vencedora no ERP, será enviada uma mensagem para reabertura de item de cotação na Paradigma, para que possa ser corrigido o problema e a cotação reenviada ao ERP.

11. Aprovador aprova ou recusa processo de compra.

O processo de compra passa pela estratégia atual de aprovação interna no ERP (caso exista) e, uma vez aprovado, o comprador pode fazer a geração do pedido.

12. Reabertura de item de cotação na Paradigma.

Caso ocorram erros na efetivação da cotação vencedora vinda do Portal ou o processo seja reprovado no fluxo de aprovação do ERP, é enviada uma mensagem para a Paradigma, contendo os dados para a reabertura do item da cotação.

Nestes casos será feita a reabertura do item da cotação na Paradigma, pode-se realizar a correção do que gerou o problema, encerrar a cotação novamente e ela será efetivada no ERP.

Como o controle será por item de cotações, caso o comprador deseje gerar o pedido dos itens que foram efetivados com sucesso, isso será possível. E neste caso ele poderá realizar a correção do item da cotação que deu problema posteriormente e gerar um pedido separadamente.

13. Comprador gera pedido de compra no ERP.

Com base nas respostas vencedoras o comprador gera o pedido de compra no ERP. Neste caso o comprador terá que criar o pedido sempre se baseando no processo de compras que foi gerado para a cotação.

Nota:
Essa regra do processo de compra foi criada para atender a estrutura da Paradigma, que não permite que um pedido de compra tenha ordens de compra (requisições) referente a processos de Cotação distintos.

14. Pedido passa pela aprovação interna do ERP.

O pedido passa pela estratégia atual de aprovação interna no ERP (caso exista) e, uma vez aprovado, fica disponível para o comprador fazer o envio para o portal.

15. Comprador seleciona pedidos para tratamento no portal.

Comprador seleciona os pedidos e envia para o portal de compras, por intermédio da interface para envio de pedidos (CC0329). Para que o pedido possa ser enviado ao portal ele deve estar “Aprovado”, “Impresso" e não deve possuir uma condição de pagamento específica. Diferenças de conceito:

a. O portal não possui suporte a informação de condições específicas de pagamento, portando sempre será necessário informar uma condição de pagamento que não seja a “0 – Condição especial de pagamento”.

b. Os pedidos neste caso serão enviados sempre como Normais.

16. Dados do pedido no ERP.

É enviada uma mensagem de integração (Dados do Pedido no ERP) para criação do pedido no portal (Transação “PurchaseOrder” no EAI). O número do pedido do portal deverá ser o mesmo que o ERP para permitir a rastreabilidade entre os sistemas.

Neste momento do envio do pedido, é recalculado o valor líquido do pedido, pois podem ter ocorrido mudanças, e enviado o novo valor para a Paradigma, que assumirá o novo valor do pedido.

17. Retorno do processamento dos pedidos no Portal.

A plataforma do portal faz o processamento da mensagem de integração (Dados do Pedido no ERP ). Se ocorrer um erro no processamento, é devolvida uma mensagem contendo o código do erro e sua descrição, neste caso o pedido é marcado “Com Erro”. Se for integrado com sucesso o pedido é marcado como “Integrado”. (Transação “RequisitionOrderConfirm” e “ReturnIntegrationErrors” no EAI).

Nota:
Consultar situação do pedido na Função Consulta de Pedidos (CC0509).

18. Fornecedor realiza Aceita/Recusa do pedido.

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

19. Dados do aceite do pedido no Portal.

O ERP busca essa informação de aceite/recusa e atualiza esse dado no ERP.

Nota:
1. Caso o pedido esteja recusado pelo fornecedor, o recebimento não será permitido.
2. Consultar situação do pedido (aceite/recusa) no Função Consulta de Pedidos (CC0509).

Processo de Integração – Gestão de Pedidos sem Cotações (com Contratos)

1. Criação do Pedido no ERP.

O comprador gera um pedido de compra no ERP sem integração com o portal de compras.

2. Aprovação do Pedido no ERP.

O pedido passa pela estratégia atual de aprovação interna no ERP (caso exista) e, caso aprovado, é enviado para o comprador f azer o tratamento necessário. Esse passo também é realizado sem integração com o portal de compras.

3. Comprador seleciona pedidos para tratamento no portal.

Comprador seleciona os pedidos e envia para o portal de compras. Essa ação poderá ser realizada pela rotina de envio de pedidos para o portal (CC0329) ou no momento da impressão do pedido de compra (CC0305).

Para que o pedido possa ser enviado ao portal ele deve estar “Aprovado”, “Impresso” e não deve possuir uma condição de pagamento específica.

Diferenças de conceito:

a. O portal não possui suporte a informação de condições específicas de pagamento, portando sempre será necessário informar uma condição de pagamento que não seja a “0 – Condição especial de pagamento”.
b. Os pedidos são divididos em três categorias para serem enviados ao portal: Normal, emergencial e com contrato.

4. Dados do pedido no ERP.

É enviada uma mensagem de integração (Dados do Pedido no ERP – Transação “PurchaseOrder” no EAI) para criação do pedido no portal. O número 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 líquido do pedido e enviado o novo valor para a Paradigma.

5. Retorno do processamento do pedidos no Portal.

A plataforma do portal faz o processamento da mensagem de integração (Dados do Pedido no ERP). Se ocorrer um erro no processamento, é devolvida uma mensagem contendo o código do erro e sua descrição, neste caso o pedido é marcado “Com Erro”. Se for integrado com sucesso o pedido é marcado como “Integrado”. (Transação “RequisitionOrderConfirm” e “ReturnIntegrationErrors” no EAI).

Nota:
Consultar situação do pedido na Função Consulta de Pedidos (CC0509).

6. Fornecedor realiza Aceita/Recusa do pedido.

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

7. Dados do aceite do pedido no Portal.

O ERP busca essa informação de aceite/recusa e atualiza esse dado no ERP.

Nota:
Caso o pedido esteja recusado pelo fornecedor, o recebimento não será permitido.
Consultar situação do pedido (aceite/recusa) na Função Consulta de Pedidos (CC0509).

Processo de Integração – Alterações e Cancelamentos

Na integração existem ainda os fluxos alternativos, que contemplam as alterações de ordens e pedidos, e também os cancelamentos.

1. Comprador altera o pedido de compra.

Após o pedido de compra ter sido enviado para a Paradigma a alteração do mesmo somente pode ser feita no ERP. Toda vez que el e for alterado, será enviada uma mensagem de atualização do pedido para a Paradigma assim que não houverem mais pendências de aprovação.

Caso o ERP envie uma mensagem de alteração de pedido de compra e na Paradigma ocorra algum problema na efetivação, será retornado um erro. Neste caso o usuário terá que desfazer a alteração do pedido manualmente no ERP para deixar as informações equalizadas entre os sistemas.

2. Aprovador aprova o pedido no ERP.

Caso esteja parametrizado para gerar pendências de aprovação, o pedido passa pelo fluxo de aprovação antes da atualiz ação ser enviada para Paradigma.

3. Dados do Pedido no ERP.

Quando não houverem mais pendências de aprovação, o pedido é enviado para a Paradigma. (Transação “PurchaseOrder” no EAI).

4. Retorno do processamento do pedido no portal.

A plataforma do portal faz o processamento da mensagem de integração (Dados do Pedido no ERP). Se ocorrer um erro no processamento, é devolvida uma mensagem contendo o código do erro e sua descrição, neste caso o pedido é marcado “Com Erro”, porém mantido como “Integrado” para saber se já foi integrado anteriormente e já está na Paradigma. (Transação “RequisitionOrderConfirm” e “ReturnIntegrationErrors” no EAI).

Nota:
Consultar situação do pedido na Função Consulta de Pedidos (CC0509).

5. Fornecedor aceita/recusa o pedido.

Cada vez que é enviada uma atualização de pedido para a Paradigma, o pedido passa pelo aceite do fornecedor novamente.

Nota:
Consultar situação do pedido (aceite/recusa) na Função Consulta de Pedidos (CC0509).

Processo de Integração – Alteração de Ordem de Compra

1. Comprador altera a ordem de compra.

Após a ordem de compra ter sido enviada para a Paradigma a alteração da mesma somente pode ser feita no ERP. Toda vez que ela for alterada, será enviada uma mensagem de atualização de requisição para a Paradigma.

2. Dados da ordem de compra no ERP.

Os dados da ordem de compra são enviados para a Paradigma. (Transação “PurchaseOrderLine” no EAI).

3. Retorno do processamento da ordem de compra no portal.

A plataforma do portal faz o processamento da mensagem de integração (Dados da requisição no ERP). Se ocorrer um erro no processamento, neste caso a ordem de compra é marcada “Com Erro”, porém mantida como “Integrada” para saber se já foi integrada anteriormente e já está na Paradigma. (Transação “RequisitionOrderConfirm” e “ReturnIntegrationErrors” no EAI).

Nota:
Consultar no CC0505.

Caso o ERP envie uma mensagem de alteração de ordem de compra e na Paradigma e ocorra algum problema na efetivação, será retornado um erro. Neste caso o usuário terá que desfazer a alteração da ordem manualmente no ERP para deixar as informações equalizadas entre os sistemas.

Processo de Integração – Cancelamento de Pedido de Compra

1. Comprador cancela/elimina o pedido de compra no ERP.

Caso seja necessário realizar o cancelamento do pedido, esse deverá ser realizado no ERP, nesta ação será enviado um document o de integração (Dados do Cancelamento do Pedido) para o portal também realize o cancelamento.

2. Dados para o cancelamento do pedido.

Os dados do cancelamento do pedido enviados para a Paradigma.

3. Retorno do cancelamento do pedido no portal.

O cancelamento do pedido é a única transação executada totalmente de forma síncrona com a Paradigma, pois não se pode deixar o pedido ser eliminado no ERP sem saber se pode ser eliminado na Paradigma.

Processo de Integração – Cancelamento de Ordem de Compra

1. Comprador cancela/elimina a requisição no Portal

Caso seja necessário realizar o cancelamento da requisição, esse deverá ser realizado no portal de compras, nesta ação será e nviado um documento de integração (Dados do Cancelamento da Requisição no ERP – Transação “PurchaseOrderLine” no EAI) para que o cancelamento também seja realizado no ERP.

No processo de cotação, caso o usuário elimine uma Requisição (ordem de compra) da cotação e informe que ela não deve ser liberada para poder ser utilizada em uma nova cotação, esta deverá ser retornada como uma requisição cancelada para o ERP.

Nota:
A busca dos cancelamentos de requisição deve ocorrer da mesma forma que as cotações, ou seja, uma vez buscadas pelo ERP não devem mais ser retornadas.

2. Dados para eliminação da ordem de compra no ERP.

A requisição é eliminada no ERP com base nos dados enviados pela Paradigma.

Como na Paradigma podem existir diversas requisições para a mesma ordem de compra, o cancelamento de uma requisição na Paradigma pode representar a eliminação de uma parcela no ERP, portanto o Paradigma obrigará o cancelamento de todas as parcelas da requisição no Portal para que seja cancelada a ordem de compra no ERP.

Transações EAI para Integração ERP x Portal de Compras Paradigma

Com a integração entre o ERP 2 e o Portal de Compras Paradigma (WBC – Web Business Center), que será responsável pela cotação de itens com diversos fornecedores, é possível agregar volumes de compras para cotação de preço, dentre outras vantagens. A integração proporciona uma automação da área de compras, pois todo o processo de respostas de cotações é realizado pelos próprios fornecedores no portal de compras da Paradigma. A geração de ordens de compra será realizada no ERP 2, e serão envia das para o portal de acordo com a necessidade, para o tratamento pelo portal de compras. O processo de cotação e escolha dos vencedores é realizada no portal, sendo o pedido de compra gerado pelo ERP 2 e posteriormente enviado para o portal de compra s da Paradigma.

Existe ainda um segundo fluxo nesta integração, onde o comprador pode realizar todo o processo até a geração do pedido de compra dentro do ERP e enviar então o pedido para o portal.

Além da integração de transações de negócio (ordens de compra, cotação e pedido) são integrados uma série de cadastrados para equalizar os dados utilizados entre os dois sistemas.

Os mapas de integração das transações abaixo encontram-se liberadas no Datasul EAI:

Transação

Adapter

Envio/ Recebimento

Aplicativo

Web Service e operação executada na Paradigma

CancelationOrder

adapters/xml/utp/axsut004.p (Web Service) URL: http://<servidor>:<porta>/ws/esb/ESBWebServ ice,<servidor>,

<porta>,sendMessageSync,message,queue,stri

ng,WSCancelOrder

Envio

sender

WS: Pedido Operação: ProcessarPedidoCancelamento

Carrier

adapters/xml/utp/axsut001.p

(Fila EAI)

Envio

Sender

WS: Empresa

Operação: ProcessarEmpresa

Currency

adapters/xml/utp/axsut001.p

(Fila EAI)

Envio

Sender

WS: Moeda

Operação: ProcessarMoeda

CustomerVendor

adapters/xml/utp/axsut001.p

(Fila EAI)

Envio

sender

WS: Empresa

Operação: ProcessarEmpresa

InventoryGroup