Conteúdo

O Mercado Eletrônico é uma plataforma especialista em comércio B2B  (Business to Business: expressão utilizada para se referir a empresas que vendem produtos e serviços para outras empresas). Nele, as transações comerciais entre empresas são realizadas em um ambiente de alta performance onde a informação é estrategicamente compartilhada e serviços inéditos são oferecidos.

Mais Informações

Índice

Passo a passo da configuração - Datasul

Para utilizar a integração do ERP Datasul com o Mercado Eletrônico, devem ser atendidos os seguintes requisitos:

• É necessário que o ERP esteja na release 12.1.2411 ou superior.
• Usuário e senha de acesso ao TOTVS (Linha Datasul). 
• Usuário com permissão no programa "purchOrderLinePublic". As documentações referentes ao cadastro de permissões podem ser consultadas aqui e aqui.
• No programa cc0104, ativar o parâmetro "Utiliza Integração ME", localizado na aba "Integrações".
• No programa html.cc0301, ao selecionar uma ordem, clicar no botão "Integrar ME" (essa opção só estará disponível se os passos acima forem realizados).
• Se for de interesse do usuário utilizar o MLA, ele  precisa estar configurado como aprovador e possuir permissão ao menos no documento Pedido de Compra Normal e Emergencial no MLA - Módulo de Aprovação de Documentos. Para saber como configurar o módulo do MLA clique aqui. 

Passo a passo da configuração - Mercado Eletrônico

Diagrama do Fluxo

O fluxo completo pode ser visto no diagrama, que contém todas as etapas da integração desde a criação da Ordem de Compra até o Pedido, sinalizando se passa pelo ERP Datasul ou Mercado Eletrônico.

Fluxo de Estabelecimento

Para iniciar o fluxo de estabelecimentos, deve se ter finalizado por completo as configurações iniciais.

A integração contempla o envio dos cadastros de estabelecimentos do ERP Datasul para o Mercado Eletrônico. No Mercado Eletrônico, o cadastro de estabelecimento pode ser consultado em Preferências - Locais. Os tipos "Cobrança" e "Entrega" correspondem ao cadastro de Estabelecimento do Datasul.

A integração contempla a inclusão e modificação dos registros do Datasul para o Mercado Eletrônico, logo, se alguma alteração for realizada no ME, esta não será levada para o Datasul, toda alteração de cadastro de estabelecimento deve ser feita no Datasul.

Estabelecimento Datasul → Mercado eletrônico

Os dados do estabelecimento são todos disponibilizados por uma API publica do Datasul ("locationIntegrMePublic") que passam pelo ferramenta de integração para serem devidamente traduzidas e serem encaminhadas para a API ("locations") do Mercado Eletrônico.

Valores encaminhados do Datasul para o Mercado Eletrônico (locationIntegrMePublic)

Fluxo de Fornecedor

Para iniciar o fluxo de fornecedores, é necessário ter finalizado por completo as configurações iniciais.

A integração contempla:

• o envio dos cadastros de fornecedores do ERP Datasul para o Mercado Eletrônico;
• o envio do cadastro do fornecedor do Mercado Eletrônico para o Datasul quando o Pré-Pedido for de um Fornecedor que ainda não existe no ERP Datasul;

A integração que envia os cadastros dos fornecedores do Datasul -> ME contempla a inclusão e modificação dos registros do Datasul para o Mercado Eletrônico, logo, as alterações dos cadastros originários no Datasul devem ser sempre realizadas no ERP para serem levadas para o ME.

 No Mercado Eletrônico, o cadastro de fornecedores pode ser consultado em “Fornecedores”.

O fluxo de fornecedores é configurado na ferramenta de integração e todos os cadastros (podem ser criados filtros para serem levados só alguns grupos de cadastros) são levados para o Mercado Eletrônico. No ME, eles possuem um código próprio e também possuem o código do Datasul para manter o rastreamento entre os sistemas.

No caso dos cadastros que são levados do ME para o Datasul, não são todos que são levados. Esse cadastro acontece no momento em que o pedido é criado no Datasul, o fluxo de integração verifica se o fornecedor em questão possui cadastro no Datasul e se não possuir, primeiro é criado o cadastro do fornecedor no Datasul, para depois criar a cotação e o pedido.

Campos Enviados na Integração Fornecedor Datasul → Mercado eletrônico

Os dados do fornecedor são todos disponibilizados por uma API publica do Datasul ("supplierIntegrMePublic") que logo passam pela ferramenta de integração para serem devidamente traduzidos e então encaminhados para a API ("suppliers") do Mercado Eletrônico.

Valores encaminhados do Datasul para o Mercado Eletrônico (supplierIntegrMePublic)

Atualização de status Integração Datasul → ME

Em todo o processo de cadastro de fornecedores (Datasul → ME) o Mercado Eletrônico enviará informações de como está o andamento da integração com o Datasul através da tecnologia de WebHook do Mercado Eletrônico. Os dados referentes ao status do cadastro do fornecedor ficarão gravados em uma tabela no Datasul e também caso ocorra algum erro de integração é possível configurar a ferramenta de integração para que os envolvidos recebam avisos e possam providenciar as devidas ações para normalizar possíveis problemas que possam acontecer.

Existe uma rastreabilidade entre os códigos do Datasul e o Mercado Eletrônico que permite fazer um de-para de cadastro nas ferramentas.

De-para da tabela de Status da Integração Datasul → ME

Campos Enviados na Integração Fornecedor Mercado eletrônico → Fornecedor Datasul 

Os dados do fornecedor são todos disponibilizados por uma API pública do Mercado Eletrônico ("suppliers") que passam pela ferramenta de integração para serem devidamente traduzidos e serem encaminhados para a API ("supplierIntegrMePublic") do Datasul.

De-para dos campos da API do ME → Datasul

Fluxo de Produto

Para se iniciar o fluxo de produtos, deve se ter finalizado por completo as configurações iniciais. 

O cadastro do item é feito diretamente no Datasul via CD0204 e as informações são encaminhadas para o Mercado Eletrônico. Para mais informações referente a inclusão, modificação e cópia de itens, acesse: Manufatura - Linha Datasul - MEN - Fluxo de cadastro de um novo item.

Produto Datasul → Mercado eletrônico

Os dados do produto são todos disponibilizados por uma API publica do Datasul ("itemIntegrMePublic") que logo passam pela ferramenta de integração para serem devidamente traduzidos para serem encaminhados para a API ("products") do Mercado Eletrônico.

Todos esses valores são devidamente criados e configurados no próprio modulo padrão de criação e alteração de produto Datasul.

Atualização de status

Em todo o processo de cadastro de produto (dataSul → ME) o mercado eletrônico mandara informações de como está o andamento da integração com o Datasul através da tecnologia de WebHook do Mercado Eltrônico. E com tudo, tera novamente uma tradução dos dados do status do cadastro do usuario do ME para o Datasul.

Fluxo de Usuários/Comprador

Para iniciar o fluxo de usuário, deve ter finalizado por completo as configurações iniciais. 

O cadastro do usuário é feito diretamente no Datasul via CD1700 e as informações são encaminhadas para o Mercado Eletrônico. Para mais informações referente a manutenção de usuários, acesse: Manutenção de Usuário de Materiais - CD1700.

Apenas os usuários que são compradores tem os cadastros enviados para o Mercado Eletrônico e por consequência o login criado na ferramenta.

Por padrão, os logins são criados como liberados e ativos no ME.

Usuários Datasul → Mercado eletrônico

Os valores são todos disponibilizados pela API publica do Datasul ("buyerPublic") que logo passam pela ferramenta de integração para serem devidamente traduzidas para só aí serem encaminhados para API ("users") do Mercado Eletrônico.

Valores encaminhados do Datasul para o Mercado eletrônico 

Todos esses valores são devidamente criados e configurados no próprio modulo padrão de cadastro de usuários/comprador Datasul.

Atualização de status

Em todo o processo de cadastro de usuário (Datasul → ME) o Mercado Eletrônico mandará informações de como está o andamento da integração com o Datasul através da tecnologia de WebHook do Mercado Eletrônico. E com isso, passará por uma tradução dos dados do status do cadastro do usuário pela ferramenta de integração.

Fluxo de Ordem de Compra

Para iniciar o fluxo de ordens de compra, é necessário ter finalizado os demais fluxos de cadastros e configurações iniciais.

A ordem de compra é o primeiro documento do fluxo de compra que integra com o Mercado Eletrônico. 

O fluxo se inicia no Datasul onde é criada a solicitação de compra e a partir desta é gerada a Ordem de Compra. É a ordem de compra que será enviada ao Mercado Eletrônico que dará início ao processo de cotação. 

Envio das Ordens de Compra ao Mercado Eletrônico

Se realizadas as configurações iniciais conforme descrito nesta documentação, o usuário terá disponível no programa html.cc0301, a opção “Integrar ME”.

Tendo disponível esta opção, basta marcar as ordens de compra que deseja enviar para o ME e após, clicar em “Integrar ME”. 

Depois de selecionadas,  as ordens de compras ficam aguardando a ferramenta de integração fazer a tradução e enviar o cadastro das ordens ao Mercado Eletrônico. No ME, estas ordens são criadas com o tipo “requisição”.

Veja na figura abaixo, como exemplo, a ordem de compra 872. Esta foi selecionada no Datasul para integrar no ME. Uma vez integrada no ME ela é criada como requisição, mas mantém o número de origem do Datasul (ordem de compra) e também passa a ter um número de requisição no ME, dessa forma, fica claro e fácil a rastreabilidade entre os sistemas.

Enquanto a ordem de compra não possuir nenhuma cotação no ME e estiver com o status “Não confirmada”, ela pode ser alterada ou cancelada no Datasul. Tendo alguma cotação vinculada e ainda nenhum pedido atrelado ela só pode ser cancelada.

Se a ordem de compra não puder ser alterada ou cancelada, ao tentar fazer a modificação ou exclusão em algum programa do ERP Datasul como por exemplo: cc0301, html.cc0301, entre outros,  o usuário irá receber uma mensagem informando que esta ordem de compra está integrada com o Mercado Eletrônico e que portanto não pode ser alterada ou cancelada.

As alterações e cancelamentos são refletidas no ME pela ferramenta de integração.

Na tela do html.cc0301 também é possível acompanhar o status da integração das ordens de compra pelo campo "Status no ME" e também é possível verificar o número da requisição correspondente no ME pelo campo "ID no ME", vide a figura abaixo.

Tabelas com o de-para dos campos das API's de Ordem de Compra

Atualização de status

Conforme já mencionado anteriormente, em vários momentos da integração da ordem de compra são registrados o status da integração. Esse status é registrado através do uso de Webhooks enviados pelo Mercado Eletrônico e cujo conteúdo são gravados em tabelas de status do Datasul., depois de traduzida por uma API de status no fluxo de integração.

Campos da API Status Integração Ordem de Compra Datasul

Fluxo de Pedido de Compra

Para iniciar o fluxo de pedidos, é necessário ter finalizado os demais fluxos de cadastros e configurações iniciais.

Inclusão de Pedido de Compra: Mercado Eletrônico → Datasul

Os pedidos de compra são sempre criados no Mercado Eletrônico e posteriormente enviados ao Datasul para inclusão.

Desta forma, toda alteração e cancelamento de pedido sempre deve ser feita no ME e a ferramenta de integração irá refletir a alteração para o Datasul. Essa forma de trabalho é necessária para garantir a consistência das informações. É por esse motivo também que nos programas do ERP Datasul, todo pedido de compra que possui integração com o Mercado Eletrônico possui uma trava que não permite a modificação ou cancelamento pelo comprador no ERP.

Detalhamento do Fluxo de Criação de Pedido de Compra

Após encerrada a apuração das cotações no ME, o comprador pode acessar a tela de Mapa Comparativo, e nesta tela é possível fazer a geração do Pré-pedido:

No Datasul, não existe esse documento denominado Pré-pedido. Trata-se de um processo que só existe no Mercado Eletrônico. 

Podemos entender o Pré-pedido como um Pedido que está em fase de aprovações. O Pré-pedido é um documento intermediário que ficará vinculado ao documento Pedido no ME depois de aprovado. No vídeo a seguir, pode ser visto um exemplo de geração do Pré-pedido no ME.

O Pré-pedido gerado no Me fica com o status "Aguardando Integração no ERP".  Enquanto estiver com esse status, não é possível alterar a cotação e nem alterar o Pré-pedido no ME.

Outra ação que ocorre quando um Pré-pedido é gerado no ME, é o envio dos dados desse documento para a ferramenta de integração. Com os dados desse documento será criado o pedido de compra no Datasul.

No Datasul, dependendo da parametrização do cliente, o pedido pode ser criado em duas etapas:

• Se o cliente possuir aprovação ativa para o documento de Cotação de Materiais, então, é possível que a cotação fique pendente de aprovação aguardando a aprovação do responsável para que seja criado o pedido. Somente após a ação do usuário é que será dado continuidade na criação do pedido de compra. Neste cenário, a ferramenta de integração irá tentar integrar o pedido durante um tempo (depende de configuração) até que a cotação seja aprovada.

• Se o cliente possuir aprovação ativa somente para o documento de pedido, seja total ou por item, então o pedido e cotação são criados no mesmo momento no Datasul, e se for o caso, o pedido fica pendente para aprovação, aguardando  a aprovação dos responsáveis conforme parametrizado pelo usuário.

Depois que o pedido é totalmente aprovado no Datasul, é enviada uma atualização para o Mercado Eletrônico informando o número do pedido do Datasul e avisando que este pedido está aprovado. O Pré-pedido então, tem seu status alterado para aprovado. As telas do ME passam a mostrar o número do pedido criado no Datasul junto com o número do Pré-pedido do ME.

Além disso, o ME recebendo o status de pedido aprovado no ERP, gera automaticamente seu pedido de compra, e este também fica vinculado ao número do pedido do Datasul existente, vide a figura abaixo para melhor entendimento:

Quando o pedido é gerado no ME, este fica com o status de "Não lido". Isso acontece porque no momento da geração é enviado uma notificação por e-mail ao Fornecedor solicitando que este acesse a plataforma do ME e faça a recusa ou aceita do pedido de compra. Nesse momento, o fornecedor também pode alterar as datas de entrega se assim o desejar.

Qualquer alteração que é realizada no pedido de compra no Mercado Eletrônico é refletida no Datasul, ou seja, é enviada a alteração para o Datasul.

Após o aceite do pedido pelo fornecedor, o status do pedido é alterado para “Confirmado”.

Alteração de Pedido de Compra: Mercado Eletrônico → Datasul

Toda alteração de pedido de compra deve ser feita no Mercado Eletrônico, a ferramenta de integração se encarrega de levar as alterações para o Datasul para consistir os dados do pedido. Por isso que no Datasul, se o comprador tentar modificar algum pedido de compra pelos programas do menu (ex: cc0300), não será possível, recebendo  uma msg de aviso informando que o pedido está integrado e que portanto, a modificação não é possível. Apenas a aprovação/reprovação de pedido de compra é possível no ERP.

No ME, enquanto o Pré-Pedido estiver com o status "Aguardando Integração no ERP" , este não pode ser alterado ou cancelado, este fica aguardando o retorno do Datasul que pode ser:

• Aprovado : neste caso é gerado um pedido no ME e este pedido pode ser alterado se necessário; 
• Recusado: neste caso o Pré-pedido muda para o status “Recusado” e pode ser cancelado ou alterado.

O comprador pode fazer várias modificações no pedido de compra gerado no ME, como por exemplo:

• Alterações no cabeçalho do pedido: frete, local de entrega, transportadora, tipo de frete, condição de pagamento, moeda, observações.
• Alterações nos itens do pedido (ordens): preço, data de entrega, impostos, observações.
• Cancelamento de item: um item ou requisição pode ser cancelado.
• Informar recebimento: pode ser adicionado o recebimento dos itens.

Reiterando que, todas as alterações feitas no ME são refletidas para o Datasul pela integração das API's.

Aceite/Recusa do Pedido de Compra pelo Fornecedor

Conforme já mencionado, quando o pedido é criado, o fornecedor recebe uma notificação por e-mail para acessar a plataforma do Mercado Eletrônico, ler os dados do pedido e então fazer o aceite ou recusa.

No caso de recusa, o fornecedor atualmente tem a opção de recusar o pedido inteiro. No entanto, o pedido não é cancelado automaticamente, neste caso o comprador pode alterar e submeter o pedido novamente ou cancelar e iniciar um novo pedido.

Nas alterações realizadas pelo comprador, valem as mesmas regras já explicadas anteriormente no tópico “Validação das Alterações”.

A exceção ocorre se o fornecedor for alterado, situação em que o pedido no Datasul será cancelado, pois não é possível alterar o fornecedor de um pedido.

Alteração de data de entrega pelo fornecedor:

Quando o fornecedor recebe o pedido para aceite, ele pode também alterar a data de entrega dos itens. Entretanto, para efetivar essas modificações, o comprador deverá acessar o pedido no ME para aprovar ou recusar as novas datas. Caso contrário, a alteração não será efetivada no sistema.

Tabelas com o de-para dos campos das API's de Cotação e Pedido de Compra

Os valores dos campos que compõe a cotação e pedido são todos disponibilizados pelas API's  do Mercado Eletrônico e passam pela ferramenta de integração para serem devidamente traduzidas e então serem enviadas para as API's da Totvs que irá criar os dados no ERP.

De-para da API de cotação

De-Para dos Campos da api de pedido de compra :

Todos esses valores fazem parte das API's e são devidamente configurados na criação do fluxo na ferramenta de integração entre Totvs Datasul e Mercado Eletrônico..

Atualização de status

A atualização de status da integração do Datasul x ME atualmente existe somente no programa html.cc0301, conforme pode ser visto na figura a seguir:

No campo "Status no ME", pode ser verificado quando a ordem é enviada para processamento , quando a cotação está pendente, entre outras etapas do fluxo.