A integração entre o ERP TOTVS e o Portal de Compras Paradigma contempla a possibilidade de ter uma cotação com uma opção maior de fornecedores e oferta que atenda uma requisição (solicitação de compra) parcialmente ou em sua totalidade, desta forma, ela é realizada após uma requisição emitida pelo ERP TOTVS sendo enviada automaticamente para o Portal de Compras Paradigma que será responsável pelo fluxo da cotação. A cotação retornará para o ERP somente após o seu encerramento, ou seja, quando as cotações estiverem concluídas e a melhor delas for escolhida, assim, é gerado um pedido de compra no ERP TOTVS que refletirá no Portal para que o fornecedor ganhador confirme a capacidade de atendimento.
Esta integração se dará utilizando Mensagem Única/EAI2.
A integração visa melhorias no processo de cotação com o objetivo de comprar materiais e insumos pelos menores preços e contemplar os padrões de quantidade, qualidade e prazos pré-definidos, bem como, redução de custos dos processos de compras para obter ganho de competitividade.
Requisitos
Cenário Atual
Contexto
Solução Proposta
Funcionalidades que serão atendidas: Serão apresentados dois fluxos de mensagens trocadas entre o Protheus e o Portal Paradigma que contemplam a gestão de pedidos com cotação (sem contratos) e a gestão de pedidos sem cotação (com contratos). Além disso, existem também os fluxos de mensagens de cadastros, alterações e cancelamentos de requisições e pedidos.
De acordo com o padrão da Paradigma, serão tratadas todas as transações síncronas por meio da Mensagem Única/EAI2 utilizando resposta da própria mensagem única de retorno.
Cenários das operações
Usuário inclui ou altera um cadastro no ERP
Para equalização das informações entre os dois sistemas (Protheus e Paradigma), será realizada a integração de alguns cadastros que sempre parte do ERP para a Paradigma e ocorre quando há uma inclusão ou alteração de um registro.
Fora do escopo: Eliminações não serão tratadas, deverá ser feita exclusão manualmente no Portal.
Como não haverá a integração inversa (da Paradigma para o ERP), os cadastros que forem integrados devem ser bloqueados na Paradigma para que não haja incompatibilidade dos dados.
Observações: Exceções serão detalhadas na sequência.
Dados do Cadastro incluído ou alterado enviados para o Paradigma: Cadastros que serão integrados:
Considerações do fluxo Gestão de pedidos com cotação (sem contratos):
Uma vez que a cotação tenha sido retornada para o ERP, somente poderá ser disponibilizada novamente pelo Portal se o item estiver reaberto e encerrado novamente pelo comprador. No caso, quando ocorrem esses encerramentos em função de reabertura de itens, apenas os itens de cotação que foram reabertos serão retornados para o ERP.
Sobre a estrutura do processo de cotação no Portal:
Em função do Portal não permitir alteração na unidade de medida para que o fornecedor responda a cotação e no Protheus a cotação ser realizada na unidade de medida do fornecedor, ao receber uma cotação, a unidade de medida e preço são convertidos conforme a unidade de medida e fator de conversão do relacionamento Item X Fornecedor.
Como as cotações são geradas baseadas nas entregas das propostas do item da cotação, para manter a rastreabilidade também será armazenado um código único (enviado pelo Portal) referente a entrega da proposta.
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.
Caso ocorram erros na efetivação da cotação vencedora no ERP, será enviada uma mensagem para reabertura de item de cotação no Portal, para que possa ser corrigida e a cotação reenviada ao ERP.
Na integração existem ainda os fluxos alternativos que contemplam as alterações de ordens e pedidos, bem como, os cancelamentos.
Cancelamento de Pedido de Compra
Cancelamento de Ordem de Compra
Parâmetros
MV_EAIMETH: receiveMessage
MV_EAIURL2: coloque o endereço do ambiente do Marketplace. É necessário verificar no caso de implantação.
MV_EAIWS: WSEAISERVICE
MV_EAIXSD: \xsd\totvsmessage
MV_MKPLACE: quando houver integração com o Marketplace deixe o parâmetro como .T.
MV_ACCISV: Informar o código de um usuário Comprador devidamente integrado ao portal Marketplace.
WebService
O WebService é fundamental para integração das funcionalidades do TOTVS – Protheus com o Portal MarketPlace Paradigma.
O WebService deve estar com o Serviço EAISERVICE - HABILITADO, como segue figura abaixo:
Configuração do appserver.ini a ser realizada no ambiente do cliente.
;=========== WEBSERVICE MARKETPLACE ============
[HTTP]
Enable=1
Port=8096
Path=C:\TOTVS\P11\Protheus_Data\WEB\WS
[JOB_WS_TMP_PRD]
TYPE=WEBEX
ENVIRONMENT=Protheus_TMp
INSTANCES=5,10
SIGAWEB=WS
INSTANCENAME=WS
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
TRACE=1
XMLSAVEALL=1
[192.168.2.253:8096]
ENABLE=1
PATH=C:\TOTVS\P11\Protheus_Data\WEB\WS
ENVIRONMENT= Protheus _TMp
RESPONSEJOB=JOB_WS_TMP_PRD
INSTANCENAME=WS
DEFAULTPAGE=wsindex.apw
[186.255.47.249:8096]
ENABLE=1
PATH=C:\TOTVS\P11\Protheus_Data\WEB\WS
ENVIRONMENT= Protheus _TMp
RESPONSEJOB=JOB_WS_TMP_PRD
INSTANCENAME=WS
DEFAULTPAGE=wsindex.apw
[ONSTART]
JOBS=JOB_WS_TMP_PRD
REFRASHRATE=180
RefreshRate=120
Schedules já configurados:
Configuração do Agent:
Monitor do Agent:
Agendamentos:
Após o cadastro do Agendamento, deve-se configurar a Recorrência, clicando no botão e configurando conforme tela abaixo:
Tabelas Envolvidas
O cadastro de Produto deve ter todos os campos obrigatórios do sistema preenchidos.
Pasta Cadastrais:
Pasta Outros:
SB5->B5_ENVMKT: campo Envia MKT. Apresenta as opções:
0 – Não: não realiza a integração.
1 – Sim: sempre envia Solicitações com este produto.
2 – Talvez: prepara Solicitação para envio; só é enviada com intervenção do operador.
Detalhes para criação do campo SB5->B5_ENVMKT:
Controle de Integração
Caso haja a necessidade de se integrar alguma entidade apenas em condições específicas, será necessário a criação do campo _INTMKT na entidade em questão, e adicionar o campo criado na condição do cadastro do adapter referente a entidade conforme o exemplo:
Integrar apenas Produtos com o campo _INTMKT = 1-Sim:
Cadastro de Adapters
Centro de Custo
Item
Fornecedor
Coloque no campo Condição a seguinte expressão: !Empty(SA2->A2_CGC) .And. !Empty(SA2->A2_EMAIL) .And. !Empty(SA2->A2_CONTATO) .And. SA2->A2_TIPO <> "X"
Produto X Fornecedor
Coloque no campo condição a seguinte expressão: SA2->( DbSeek(xFilial("SA2")+SA5->A5_FORNECE + SA5->A5_LOJA ) ) .And. !SA2->A2_TIPO == "X"
Comprador
Coloque no campo Condição a expressão: !Empty(SY1->Y1_EMAIL)
Solicitação de Compra
Cancelamento de Solicitação de Compra
Pedido de Compra
Cotação
Condição de Pagamento
Unidade de Medida
Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo.
Instalação de produtos ou ferramentas necessárias podem referenciar outros documentos existentes, desde que estejam disponíveis no repositório de documentação da TOTVS ou sejam enviados junto com o documento da integração em si.
As informações mínimas necessárias para teste tópico são:
Método | ID | Descrição | Origem | Destino | XSD (versões podem variar) |
Cadastros | 01 | Centro de Custo | Protheus | Marketplace | CostCenter_2_000.xsd |
02 | Produto | Protheus | Marketplace | Item_2_000.xsd | |
03 | Comprador | Protheus | Marketplace | User_4_001.xsd | |
04 | Condições de pagamento | Protheus | Marketplace | PaymentCondition_2_000.xsd | |
05 | Unidade de medida | Protheus | Marketplace | UnitOfMeasure_2_000.xsd | |
06 | Fornecedor | Protheus | Marketplace | CustomerVerndor_2_000.xsd | |
07 | Produto X Fornecedor | Protheus | Marketplace | ProductSupplierRealationship_2_000.xsd | |
Processos | 08 | Solicitação de Compras | Protheus | Marketplace | Request_1_005.xsd |
09 | Cancelamento da Solicitação de Compras | Protheus | Marketplace | CancelRequest_1_000.xsd | |
10 | Pedido de compra | Protheus | Marketplace | Order_3_002.xsd | |
11 | Cotação | Protheus | Marketplace | Quotation_1_000.xsd |