Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Deck of Cards
effectDuration0.5
idcabecalho
effectTypeslide
Card
defaulttrue
effectDuration0.5
idMINHA-PLATAFORMA
labelMINHA PLATAFORMA
titleMINHA-PLATAFORMA
effectTypeslide
Deck of Cards
effectDuration0.5
idtudo-sobre
effectTypeslide
Card
effectDuration0.5
idIntroducao
labelIntrodução
titleIntrodução
effectTypeslide

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.

Button
Cor#000000
TextoMais Informações
Linkhttps://www.me.com.br/

Card
defaulttrue
effectDuration0.5
idSobre
labelSobre
titleSobre
effectTypeslide

Escopo

No Portal do ME, o comprador tem a visão de suas compras, recebimentos, financeiro, pode cotar ordens de compra recebidas pelo ERP, realizar alterações pertinentes nas informações e diversas outras possibilidades de processos. 

Características e Funcionalidades:  

  • Integrações - Haverá possibilidade de uma integração completa com todos os dados vindos do Datasul para o ME e vice-versa, para garantir a incorporação de todas as informações. Os fluxos contemplados inicialmente são:
    • Compradores - Poderão ser enviados para o Portal do ME os compradores do Datasul.
    • Fornecedores - Poderão ser enviados para o Portal do ME os fornecedores do Datasul.
    • Produtos -Poderão ser enviados para o Portal do ME os produtos do Datasul.
    • Estabelecimentos - Poderão ser enviados para o Portal do ME os estabelecimentos do Datasul.
    • Ordem de Compra -Será criada no Mercado Eletrônico como "Requisição", mas virá para o Datasul como Ordem de Compra. Atualmente, não engloba ordem de compra com contrato.
    • Pedido de Compra - O pedido de compra será criado no Mercado Eletrônico como "Pré-Pedido" e virá para o Datasul conforme fluxo de aprovação.
    • Cotações - As cotações das ordens serão feitas no Mercado Eletrônico, mas virão para o Datasul conforme seu respectivo pedido.
    • Fluxo de Aprovação - Se o MLA (link do mla) não estiver ativado, o pedido virá para o Datasul após a confirmação do mesmo pelo fornecedor no ME. Se estiver ativado, após a confirmação do mesmo pelo fornecedor no ME, ele virá como pendência de aprovação e será preciso aprová-lo. (verificar)
  • Permissibilidade de alterar registros - Os registros podem ser alterados no Portal do ME conforme necessidade e regras de negócio.
  • Dashboard Customizável -O Portal do ME tem um dashboard totalmente customizável, onde é possível escolher quais informações serão apresentadas bem como suas métricas.
  • Catálogo de Produtos - O catálogo de produtos apresentará os produtos cadastrados no Datasul, permitindo visualizá-los detalhadamente com todas as suas informações.
  • Comunidade de Fornecedores e Compradores - O E-Procurement do Mercado Eletrônico conta com vários fornecedores cadastrados que podem ser acessados por novos compradores, aumentando o loque de opções.
  • Filtros - Grande gama de filtros para personalizar as buscas e resultados.
  • Mapa Comparativo - Mapa comparativo apresentado no final da rodada de cotação, trazendo valores preenchidos conforme melhor opção de cotação e fazendo uma simulação.


Para conhecer mais sobre o Mercado Eletrônico:

Painel
borderStylenone
titleConheça a Plataforma
Column
width500

UNIVERSO TOTVS 

Multimedia
nameBackoffice Datasul - Suprimentos - Integração com Mercado Eletrônico.mp4

LINKS DA PLATAFORMA:

Card
effectDuration0.5
idConfigurações Iniciais Datasul
labelConfigurações Iniciais Datasul
titleConfigurações Iniciais Datasul
effectTypeslide

Passo a passo de configuração - Datasul

Para utilizar o aplicativo 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
  • Configuração de empresas:
    • Aguardar retorno do ME
Card
effectDuration0.5
idConfigurações Iniciais Mecado Eletrônico
labelConfigurações Iniciais Mecado Eletrônico
titleConfigurações Iniciais Mecado Eletrônico
effectTypeslide

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


Painel
borderStylenone
titleCarga de dados

A forma de realizar o cadastro dos dados referentes a moeda, condição de pagamento e unidade de medida é realizando carga de dados.

Esses dados podem ser inseridos no sistema por cadastro manual, pelo Portal do ME, ou via importação de planilhas.

- CADASTRO MANUAL PELO PORTAL ME

Para cadastrar manualmente moedas, será necessário estar logado com a conta do ME no portal, acessar o ícone de "Mais" localizado no menu superior , ir até a opção de "Workflow" e dentro do menu expansível acessar "Moedas"

Na tela de Moedas, é possível adicioná-las pelo botão  inserindo o tipo da moeda e sua descrição, além da tradução da mesma se for necessário.

Para fazer o cadastro da conversão de determinada moeda, é preciso acessar o botão e dentro da tela apresentada acessar .

Será possível então cadastrar as informações pertinentes a conversão de determinada moeda, sua vigência e taxa. Para salvar, clicar em .

Para cadastrar manualmente condições de pagamento, será necessário estar logado com a conta do ME no portal, acessar o ícone de "Mais" localizado no menu superior e ir até a opção de "Workflow".

Dentro do menu expansível acessar "Condições de Pagamento". 

Na tela de Condições de Pagamento, acessar o botão  onde será apresentada a tela de cadastro e poderão ser feitas as inclusões dos dados desejados.

Clicar em  para salvar.

Para cadastrar manualmente unidades de medida, será necessário estar logado com a conta do ME no portal, acessar o ícone de "Mais" localizado no menu superior , ir até a opção de "Workflow" e dentro do menu expansível acessar "Cadastro de Unidades".

Na tela de Unidade de Medida, cadastrar uma nova unidade pelo botão . Clicar em  para salvar.

- CADASTRO POR CARGAS EXCEL

Para realizar carga dos dados de moeda, condição de pagamento e unidade de medida por planilha excel, é necessário acessar o ícone  localizado no menu superior. Na opção de Workflow, acessar "Importação/ Exportação Cargas".

Na tela de Cargas, é possível ver seu histórico de cargas, ou seja, todas as ações relacionadas a carga que foram feitas pelos usuários do mesmo ambiente. São apresentadas informações sobre cada carga: seu ID, quem solicitou, o início do processamento, o final do processamento, o status (se foi processado com sucesso ou houve algum erro) bem como a opção de baixar a carga. O ícone no lado esquerdo de cada linha também muda de cor conforme o status da carga (verde pra sucesso, vermelho pra erro) e a posição da seta indica se foi uma importação ou exportação.

Image Removed

Image Removed

Para realizar uma importação/ exportação de dados para o ME, é preciso clicar no botão  e escolher qual tipo de carga deseja. As cargas que utilizaremos são ,  e .

Utilizando como exemplo a Carga de Moeda, para obter o arquivo clicar em .

Será baixado para a máquina local um template excel contendo os campos necessários. Vai ser preciso preenchê-los conforme os dados existentes no Datasul. Colunas com a marcação vermelha são obrigatórias. Após o preenchimento, inserir o arquivo editado na seção . Caso hajam erros com o preenchimento, serão apresentados no momento após do upload.

Após o upload, acompanhar o andamento do envio no histórico de cargas e realizar demais ajustes se for necessário. Para visualizar os erros detalhadamente, acesse o botão .

Se o upload for finalizado sem erros, vai ser possível ver os dados adicionados no Mercado Eletrônico.

- CADASTRO DAS DEMAIS INFORMAÇÕES


O cadastro das demais informações é feito através da própria ferramenta de integração. A carga é realizada por APIs, onde os dados serão enviados conforme filtros estabelecidos. As informações que são contempladas na integração atual estão listadas na aba "Sobre".


Card
effectDuration0.5
idProdutos
label Produtos
titleProdutos
effectTypeslide

Fluxo de Produto

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

Produto Datasul → Mercado eletrônico

Os dados do produto são todos disponibilizados por uma API publica do Datasul ("itemIntegrMePublic") que logo passam pelo aparelho integrador padrão (TOTVS IPASS) para serem devidamente traduzidos para serem encaminhados para a API ("products") do Mercado Eletrônico.


Datasul

ME

Descrição

Necessita de algum tratamento no IPASS?

materialOrigin

materialOrigin

origem do material


note

note

narrativa/observação


clientGroupId

clientGroupId

código do grupo do item


clientGroupDescription

clientGroupDescription

descrição do grupo do item


isGeneric

isGeneric

true or false


productIdentificationCode:

type

productIdentificationCode:

type

no momento, utilizado para envio dos códigos NCM/NBM


productIdentificationCode:

value

productIdentificationCode:

value

no momento, utilizado para envio dos códigos NCM/NBM


description

description

Descrição do item


groups

groups

Grupos que o item pertence


manufacturerCode

não existe

código do fabricante, não existe na api do ME, não enviar.


measurementUnit

measurementUnit

Unidade de Medida


productIdMe

productIdMe

código do produto no ME (quando for post vai vir em branco)


clientReferenceProductId

clientReferenceProductId

código do produto no Datasul


clientProductId

clientProductId

código do produto no Datasul


estimatedPrice

estimatedPrice

preço estimado (no Datasul vem o preço da última compra)


complement

complement

descrição complementar


isService

isService

true or false (estoque ou sem estoque)


status

status

true or false (ativo ou não)


Todos esses valores são devidamente criados e configurados no proprio 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.


Nome Campo Dtsul

Conteúdo Payload

Necessita de algum tratamento no De-Para?

itemIdME

código do produto criado no ME

No ME, esse campo é um inteiro, quando for para enviar no payload do Dtsul, deve ser enviado como char.

status

codigo do status de como foi a transacao no ME,

1 → em processamento no mercado eltronico,

2 → executado sem erroros 

3 → executado com erros


processMessage

informaçoes de erros e caso esteje vazio, significa que a integração ocorreu sem erros


lastUpdateDatetime


Data/hora atual


Card
effectDuration0.5
idUsuarios
labelUsuarios
titleUsuarios
effectTypeslide

Fluxo de Usuários/Comprador

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


Usuários Datasul → Mercado eletrônico

Os valores são todos disponibilizados pela API publica do Datasul ("buyerPublic")que logo passam pelo aparelho integrador padrão TOTVS IPASS 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 

Campo Datasul

Campo Mercado Eletronico

Descrição do campo

Necessita de algum tratamento no IPASS?

purchasingGroups.

clientPurchasingGroupCode

purchasingGroups.

clientPurchasingGroupCode

Código do grupo de compra


purchasingGroups. 

clientPurchasingGroupDescription

purchasingGroups.

clientPurchasingGroupDescription

descrição do grupo de compra


profile

profile

perfil

o padrao é “Cadastro” mas pode ser alterado dependendo da configuração do usuario

languageId

languageId

idioma padrão do usuário

Idioma possiveis:EN/BR, English e Spanish

permission

permission

permissão do usuário

o padrao é “Geral” , mas pode ser alterado dependendo da configuração do usuario

login

login

Login do usuário


isDeactivated

isDeactivated

indica se o usuário está ativo ou não.


phone

phone

número do telefone


contact

contact

nome para contato

se vier em branco do Dtsul, colocar no payload como “Não informado”

name

name

nome do usuário


businessOrganizations.

code

businessOrganizations.

code

Códigos das empresas as quais o usuário é vinculado 


businessOrganizations.

virtualEntityField

businessOrganizations.

virtualEntityField

tipo (EMPRESA)


costCenters.

clientCostCenterId

costCenters.

clientCostCenterId

código do centro de custo


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 mandara 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 tudo, tera novamente passara por uma tradução dos dados do status do cadastro do usuário pelo aparelho integrador TOTVS IPASS.


Nome Campo Dtsul

Conteúdo Payload

Necessita de algum tratamento no De-Para?

itemIdME

código do produto criado no ME

Conversao de tipos de dados

status

codigo do status de como foi a transacao no ME,

1 → em processamento no mercado eltronico,

2 → executado sem errors

3 → executado com erros


processMessage

informaçoes de erros e caso esteje vazio, significa que a integração ocorreu sem erros


lastUpdateDatetime


Data/hora atual


Card
effectDuration0.5
idPedidos
labelPedidos
titlePedidos
effectTypeslide

Fluxo de Pedidos

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


Inclusão Pedidos Datasul → Mercado eletrônico

Os valores são todos disponibilizados pela API publica do Datasul ("quotationPublic" e "orderIntegrMePublic")que logo passam pelo aparelho integrador padrão TOTVS IPASS para serem devidamente traduzidas para só aí serem encaminhados para API ("pré-orders") do Mercado Eletrônico.

Valores encaminhados do Datasul para o Mercado eletrônico (quotationPublic)

Campo Datasul

Campo Mercado Eletronico

Descrição do campo

Necessita de algum tratamento no IPASS?

PreOrderId

PreOrderId

Código do pré-pedido no ME


userCode

integrationTag

Código do comprador/login no Datasul


vendorID

clientSupplierId

ID do fornecedor do Datasul


paymentTermId

paymentTermId

Forma de pagamento

No Mercado Eletrônico, esse campo é tratado como char, enquanto no Datasul ele é armazenado como número.

freight

freightValue

Valor total do frete


freightPaymentType

icoTerm

Tipo do pagamento do frete, pode ser FOB/CIF

No ME, o campo é tratado como char, mas no Datasul ele é salvo como um número, onde 1 indica que já está pago e 0 que ainda não foi pago. Assim, se o valor vindo do ME for 'FOB', ele deve ser convertido para 0, e se for 'CIF', deve ser convertido para 1.

carrierCode

carrierCode

Esse campo atualmente não esta vindo do Mercado Eletrônico pois será acrescentado ao payload de resposta da API POem uma atualização posteriormente.


orderDate

creationDate

Data de criação do pedido


currency

currency

Moeda (mesmo símbolo Datasul)


requestId

purchaseOrderLines

requestItems.requestId

purchaseOrderLines

ID do pedido


measurementUnit

purchaseOrderLines

measurementUnit

purchaseOrderLines

Unidade de Medida


unitPrice

purchaseOrderLines

unitPrice

purchaseOrderLines

Preço Unitário


clientProductId

purchaseOrderLines

clientProductId

purchaseOrderLines

Código do fornecedor Datasul


ipiTax

purchaseOrderLines

taxe[{}]

purchaseOrderLines

Taxa IPI

No ME, esse valor é armazenado em um array de objetos, enquanto no Datasul é um campo char isolado. Desta forma, é necessário buscar no objeto 'taxes' da requisição da API de pré-order items onde type == 'IPI' e capturar o valor de 'taxRate' para atribuí-lo à variável ipiTax.

icmTax

purchaseOrderLines

taxe[{}]

purchaseOrderLines

Taxa ICMS

No ME, esse valor é armazenado em um array de objetos, enquanto no Datasul ele é um campo char isolado. Desta forma, é necessário buscar no objeto 'taxes' da requisição da API de pré-order items onde type == 'ICMS', capturar o valor de 'taxRate' e atribuí-lo à variável icmTax.

issTax

purchaseOrderLines

taxe[{}]

purchaseOrderLines

Taxa ISS

No ME, esse valor é armazenado em um array de objetos, enquanto no Datasul ele é um campo char isolado. Desta forma, é necessário buscar no objeto 'taxes' da requisição da API de pré-order items onde type == 'ISS', capturar o valor de 'taxRate' e atribuí-lo à variável issTax.

requestId

purchaseOrderLinesDeliveries

requestItems.requestId

purchaseOrderLinesDeliveries

Número da requisição do Mercado Eletrônico


quantity

purchaseOrderLinesDeliveries

deliveries.quantity

purchaseOrderLinesDeliveries

Quantidade do item da parcela da entrega


deliveryDate

purchaseOrderLinesDeliveries

deliveries.deliveryDate

purchaseOrderLinesDeliveries

Data de entrega da parcela


isEmergencial

-

Indica se o pedido é emergencial ou não

Como não há um campo específico, uma alternativa é consultar o número da ordem. Pedidos emergenciais não se originam no Datasul, portanto, se o número da ordem não existir, o pedido deve ser considerado emergencial.

Valores encaminhados do Datasul para o Mercado eletrônico (orderIntegrMePublic)

Campo Datasul

Campo Mercado Eletronico

Descrição do campo

Necessita de algum tratamento no IPASS?

preOrder

preOrderId

ID do pré-pedido criado no ME


integrationTag

integrationTag

Comprador que realizou a criação do pré-pedido


clientSupplierId

clientSupplierId

ID do fornecedor no Datasul


clientPayment ConditionId

clientPayment ConditionId

Forma de pagamento


freightPaymentType

freightPaymentType

Forma de pagamento do frete


grossValue

grossValue

Valor bruto do pedido


note

note

Observação


creationDate

creationDate

Data de criação do pedido


currency

currency

Símbolo da moeda


clientDeliveryPlaceId

clientDeliveryPlaceId

Local de entrega


clientBillingPlaceId

clientBillingPlaceId

Local de cobrança



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

Atualização de status

Em todo o processo de cadastro de pré-pedido (Datasul → ME), o Mercado Eletrônico enviará atualizações sobre a integração com o Datasul por meio da tecnologia WebHook do Mercado Eletrônico. Os dados referentes ao status do pré-pedido passarão por uma tradução do status realizada pelo aparelho integrador TOTVS IPASS.


Nome Campo Dtsul

Conteúdo Payload

Necessita de algum tratamento no De-Para?

clientOrderId

Número do pedido gerado no Datasul


status

Status para indicar que foi aprovado


clientSupplierId

Código emitente pedido Datasul


note

Narrativa


1. Criação e alteração de Pedido/Pré-Pedido (ME→Datasul)

Quando um pré-pedido é gerado no ME, ele deve ser criado no Datasul. No entanto, como o Datasul não possui o conceito de pré-pedido, ele será salvo diretamente como um "pedido de compra".

Após a criação do pré-pedido no ME, ele permanece com o status de "AGUARDANDO INTEGRAÇÃO ERP" até ser aprovado no Datasul. Durante esse período, não é permitido fazer alterações no pré-pedido ou na cotação.

Enquanto o pedido no Datasul não for aprovado, não será possível alterar os dados no ME. Assim que o pedido de compra for aprovado no Datasul, o pedido aguardará aprovação do fornecedor no Mercado Eletrônico.

2. Alteração de Pedido - Mercado Eletrônico (ME)

Regras para alteração de Pedidos no Mercado Eletrônico:

O Pré-Pedido não pode ser alterado, mas após a aprovação, o pedido no Mercado Eletrônico permite as seguintes modificações:
Cabeçalho: frete, local de entrega, transportadora, tipo de frete, condição de pagamento, moeda, observações.
Itens do pedido: preço, data de entrega, impostos, observações.
Cancelamento ou recusa de item: um item ou requisição pode ser cancelado ou recusado.
Informar recebimento: pode ser adicionado o recebimento dos itens.


Validação de integridade de status:

Se uma alteração não impactar o fluxo de aprovação no Datasul, o status do Pré-Pedido e Pedido não serão alterados no Mercado Eletrônico.
Exemplo: Alterar o valor de um item para um valor inferior.
Se a alteração impactar o fluxo de aprovações no Datasul, o Pedido no ME será cancelado e voltará ao status de Pré-Pedido ("AGUARDANDO INTEGRAÇÃO ERP"), sendo necessário reenviar o pedido para nova aprovação no Datasul.
Exemplo: Alteração na condição de pagamento do Pedido.

3. Alteração de Pedido Rejeitado - Datasul

O Pedido pode ser cancelado no ME, retornando para a fase de cotação. Isso cancela o Pré-Pedido e reinicia o processo.
O Pedido pode ser alterado e reenviado para nova aprovação no Datasul, mantendo o mesmo Pré-Pedido.

4. Alteração de Pedido Aguardando Aceite - Mercado Eletrônico (ME)

Um pedido enviado ao fornecedor para aceite no ME pode ser alterado enquanto estiver com o status "Aguardando Aceite".
Durante esse período, o pedido será marcado como Não Lido.


Rejeição do pedido pelo fornecedor:

O fornecedor pode recusar itens específicos ou o pedido inteiro. No entanto, o pedido não é cancelado e permite novas alterações.
Caso ocorra alguma alteração, o processo seguirá as regras descritas anteriormente. A exceção ocorre se o fornecedor for alterado, situação em que o pedido no Datasul será cancelado.
Alteração de data de entrega pelo fornecedor:

Se o fornecedor modificar a data de entrega, o comprador deverá acessar o pedido no ME para aprovar ou recusar a nova data. Caso contrário, a alteração não será efetivada no sistema.


Card
defaulttrue
effectDuration0.5
idSuporte
labelSuporte
effectTypeslide

Perguntas Frequentes (FAQs)

Expandir
titleA partir de qual versão poderei utilizar a integração?

A partir da release 12.1.2411 esta novidade estará disponível.

Expandir
titlePara utilizar a integração Datasul x Mercado Eletrônico terei algum custo extra?

Para poder utilizar a integração Datasul x ME, será preciso contratar a plataforma Mercado Eletrônico bem como a ferramenta integradoraIPaas.

Expandir
titleQual será o tratamento da integração em relação à consistência dos dados?

Para a integração com o Mercado Eletrônico, só será permitida a alteração de informações no sistema de origem, ou seja: ao criar a ordem de compra no Datasul e integrá-la com o Mercado Eletrônico, ela não poderá sofrer alterações via Mercado Eletrônico, apenas no Datasul.

O mesmo serve para o Pedido de Compra. Ele será criado no Mercado Eletrônico e por sua vez não poderá sofrer alterações no Datasul.

Expandir
titleA integração é realizada instantaneamente?

Não, haverá um tempo definido inicialmente em minutos para que a ordem possa ser integrada com o ME, ou seja, enviada para o sistema deles. Porém o cliente pode customizar esse período de tempo conforme sua necessidade

Expandir
titleO que é o IPaas?

O iPaas é uma ferramenta da Totvs que permite a transferência de informações de um programa para outro. Para mais informações sobre a solução,clique aqui.

Expandir
titleQual o meu Usuário e Senha?

As credenciais de acesso são ser obtidas através do Partner's portal  do Mercado Eletrônico. O usuário e senha são referenciados como Api Key (usuário) e Api Secret (senha). É necessário o cadastro de ambos para acessar o ME.

...