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:
Como não serão tratadas regras para outros países nesta primeira fase do projeto, somente estabelecimentos brasileiros serão enviados para a Paradigma.
Quando for incluído um fornecedor no ERP e integrado com o Portal pela primeira vez, é gerada uma senha para acesso no Portal com o número do CNPJ, assim, quando o fornecedor acessar o portal pela primeira vez, é solicitada a alteração da senha. Observação: como o Protheus não obriga informar e-mail, o Portal realizará essa validação, e caso não esteja preenchido, a mensagem retornará com erro.
Caso a entidade de Fornecedores no Protheus estiver configuradacomo compartilhada, para cada filial será necessário gerar um novo envio da mensagem para que o fornecedor seja vinculado a filial que irá utilizálo.
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 for 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, assim, quando o usuário acessar o portal pela primeira vez, é solicitada a alteração da senha.
Caso a entidade de Compradores no Protheus estiver configuradacomo compartilhada, para cada filial será necessário fazer o vínculo manualmente no portal, exceto para a filial que enviou a mensagem, pois esta já estará vinculada ao comprador.
Observação: serão enviados para o Portal somente os relacionamentos de item X fornecedor de fornecedores que possuírem integração com o Portal de Compras.
Considerações do fluxo Gestão de pedidos com cotação (sem contratos):
Para que a ordem de compra possa ser enviada ao Portal ela deve estar como Aberta (não é possível enviar ordens planejadas) e não deve pertencer a um contrato fechado, não ter pedido de compra ainda relacionado e nem fornecedor designado.
As ordens de compra não devem ter datas de entrega menores que a data atual, caso contrário também não podem ser enviadas.
Observação: para ordens de compra que possuem mais de uma entrega, a cada entrega da ordem será criada uma requisição diferenciada na Paradigma.
Observação: após uma ordem de compra ter sido enviada ao Portal, ela ficará congelada, sendo que neste caso não será permitida a exclusão da ordem de compra. A exclusão ou cancelamento poderá ser feito somente por meio do Portal. A requisição não poderá ser alterada nem no ERP nem no Portal, caso necessário ela deverá ser cancelada e excluída para que uma nova sega criada.
Caso tenha ocorrido erro na efetivação de alguma parcela na Paradigma, a ordem deverá ser marcada com erro (retornado de imediato na mensagem, já que é síncrono) para que a situação seja corrigida e a ordem reenviada.
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.
Observação: 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á incluir todas as outras requisições (entregas) que são referentes a mesma ordem de compra no ERP no mesmo processo de cotação.
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 ou ele esteja cadastrado na categoria (Grupo de Produtos).
Diferenças de conceito:
a) No Protheus a cotação deve ser feita sempre com a 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. 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.
b) 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 do documento DefinicaoCalculoPreco_Paradigma.docx (disponível no portal Paradigma) para o cálculo do preço no Portal.
c) Como a Paradigma controla o preço do fornecedor com 4 decimais e o ERP com 6, podem ocorrer pequenas diferenças entre os preços calculados entre os dois sistemas.
d) Ao gerar a cotação o Portal 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).
e) O fornecedor no Portal pode informar uma quantidade inferior da requisição, como o ERP não permite isso, a Paradigma parametrizará para que o fornecedor não altere a quantidade solicitada, ou seja, a resposta será sempre igual a solicitada.
O Portal não deve permitir que mais de uma proposta seja selecionada como vencedora, ou seja, para cada requisição da cotação, pode haver apenas uma proposta (fornecedor) como vencedora.
A alteração da cotação e cancelamento no Portal é permitida somente antes do encerramento da cotação, depois disso, após ser enviada ao ERP, apenas por intermédio dele poderá reabri-la em função de algumas situações.
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:
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.
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 é 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 corrigido e a cotação reenviada ao ERP.
Para que o usuário possa manter a rastreabilidade entre o processo de cotação do Portal e o pedido no ERP, será armazenado o número da cotação nos pedidos criados e terá opção de consulta na tela de pedidos por número da cotação trazendo todos os respectivos pedidos.
Como o controle será por item de cotações, se o comprador deseja gerar o pedido dos itens que foram efetivados com sucesso, isso será possível e ele poderá realizar a correção do item da cotação que deu problema posteriormente e gerar um pedido separadamente.
Observação: se o pedido estiver recusado pelo fornecedor, o recebimento não será permitido, ou seja, ele será cancelado.
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
No processo de cotação, se o usuário eliminar uma Requisição (ordem de compra) da cotação e informar que ela não deve ser liberada para ser utilizada em uma nova cotação, ela deve retornar como uma requisição cancelada para o ERP.
Observação: uma vez enviadas ao ERP, não serão mais ser enviadas.
Como no Portal podem existir diversas requisições para a mesma ordem de compra, o cancelamento de uma requisição pode representar a eliminação de uma parcela no ERP, portanto o Portal obrigará o cancelamento de todas as parcelas da requisição no Portal para que seja cancelada a ordem de compra no ERP.
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.
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 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 produtos com o campo _INTMKT = 1-Sim:
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:
Observação: evite o uso de Prints de telas, facilitando, assim, o trabalho de tradução e versionamento deste documento.
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 |