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.
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
borderStyle
none
title
Conheça a Plataforma
Column
width
500
UNIVERSO TOTVS
Multimedia
name
Backoffice Datasul - Suprimentos - Integração com Mercado Eletrônico.mp4
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:
As empresas precisam ser iguais as que o cliente tem no Datasul, pois é necessário manter a consistência dos dados.
As empresas são criadas e configuradas pela equipe do Mercado EletrônicoAguardar retorno do ME
Card
effectDuration
0.5
id
Configurações Iniciais Mecado Eletrônico
label
Configurações Iniciais Mecado Eletrônico
title
Configurações Iniciais Mecado Eletrônico
effectType
slide
Passo a passo de configuração - Mercado Eletrônico
A forma de realizar o cadastro dos dados referentes aa moeda,condição condição de pagamentopagamento eunidade unidade de medidaé realizando é 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 manualmentemoedas, será necessário estar logado com a conta do ME no portal, acessar o ícone de "Mais" localizado no menu superior Image Modified, 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ãobotão Image Modified 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ãobotão Image Modifiede dentro da tela apresentada acessaracessar Image Modified.
Será possível então cadastrar as informações pertinentes a conversão de determinada moeda, sua vigência e taxa. Para salvar, clicar emem Image Modified.
Para cadastrar manualmentecondições de pagamento, será necessário estar logado com a conta do ME no portal, acessar o ícone dede "Mais"localizado localizado no menu superiorsuperior Image Modifiede ir até a opção dede "Workflow".
Dentro do menu expansível acessaracessar "Condições de Pagamento".
Na tela de Condições de Pagamento, acessar o botãobotão Image Modifiedonde onde será apresentada a tela de cadastro e poderão ser feitas as inclusões dos dados desejados.
Clicar emem Image Modifiedpara para salvar.
Para cadastrar manualmenteunidades de medida, será necessário estar logado com a conta do ME no portal, acessar o ícone dede "Mais"localizado localizado no menu superiorsuperior Image Modified, ir até a opção dede "Workflow"e dentro do menu expansível acessaracessar "Cadastro de Unidades".
Na tela de Unidade de Medida, cadastrar uma nova unidade pelo botãobotão Image Modified. Clicar emem Image Modifiedpara 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 íconelocalizado no menu superior. Na opção deWorkflow, 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ãobotão Image Modifiede e escolher qual tipo de carga deseja. As cargas que utilizaremos são,e.
Utilizando como exemplo aCarga de Moeda,para obter o arquivo clicar emem Image Modified.
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 vermelhavermelha Image Modifiedsão obrigatórias. Após o preenchimento, inserir o arquivo editado na seçãoseção Image Modified. 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ãobotão Image Modified.
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
effectDuration
0.5
id
Estabelecimentos
label
Estabelecimentos
title
Estabelecimentos
effectType
slide
Fluxo de Estabelecimento
Para se iniciar o fluxo de estabelecimentos, deve se ter finalizado por completo asconfigurações iniciais.
Estabelecimento Datasul → Mercado eletrônico
Os dados do estabelecimento são todos disponibilizados por uma API publica do Datasul ("locationIntegrMePublic") que logo passam pelo aparelho integrador padrão (TOTVS IPASS) para serem devidamente traduzidos para serem encaminhados para a API ("locations") do Mercado Eletrônico.
Valores encaminhados do Datasul para o Mercado Eletrônico (locationIntegrMePublic)
Campo Datasul
Campo Mercado Eletrônico
Descrição do campo
Necessita de algum tratamento no IPASS?
country
country
País do local
No Datasul country é um campo escrito por extenso, porém no ME é salvo em sigla.
Datasul: Brasil
ME: BR
locationName
locationName
Id do “local” no Datasul
address
address
Endereço (Rua) do estabelecimento
city
city
Cidade onde encontra-se o estabelecimento
postalCode
postalCode
CEP do estabelecimento
adressNumber
adressNumber
Número do endereço do estabelecimento
clientLocationId
clientLocationId
Id do estabelecimento no Datasul
neighborhood
neighborhood
Bairro do estabelecimento
locationId
Ele é o Id do local no ME que deverá ser utilizado como pathParam caso seja feita uma atualização (PUT) para ME. Esse campo pode estar vazio (“”) caso o local Datasul não tenha sido cadastrado no ME
transaction
1 - inclusão
2 - alteração
3 - exclusão
Não envia ME, é apenas para identificar se este estabelecimento deve ser incluído, alterado ou excluído no ME
locationType
DeliveryPlace e BillingPlace
Esse campo não virá preenchido na API do Datasul entao devera ser criado. Como citado abaixo nas regras, nesse fluxo será necessário mandar duas request para API do ME, uma com o locationType: “DeliveryPlace” e outra com locationType: “BillingPlace”.
Obs: independente se for para a API de PUT ou de POST do ME.
companyNationalRegistration: Array[ ]
Campo Datasul
Campo Mercado Eletrônico
Descrição do campo
Necessita de algum tratamento no IPASS?
number
number
É a sequência de números de um CPF ou a um CNPJ do correspondente da empresa
type
type
Identifica o tipo do documento do correspondente da empresa, CPF ou CNPJ
stateRegistrationNumber
stateRegistrationNumber
Estado onde encontra-se o estabelecimento
bussinesOrganization: Array[ ]
Campo Datasul
Campo Mercado Eletrônico
Descrição do campo
Necessita de algum tratamento no IPASS?
entityType
entityType
Tipo (EMPRESA)
clientBusinessOrganizationId
clientBusinessOrganizationId
Código da empresa a qual o estabelecimento está vinculado
Atualização de status
Em todo o processo de cadastro de estabelecimento (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 estabelecimento passarão por uma tradução do status realizada pelo aparelho integrador TOTVS IPASS.
Campo Datasul
Conteúdo payload
Necessita de algum tratamento no IPASS?
locationIdMe
Código do local criado no ME (identificador)
status
2
processMessage
Enviar campo no payload com conteúdo em branco
lastUpdateDatetime
Data/hora atual
lastUpdateDatetime
Card
effectDuration
0.5
id
Fornecedores
label
Fornecedores
title
Fornecedores
effectType
slide
Fluxo de Fornecedor
Para se iniciar o fluxo de fornecedores, deve se ter finalizado por completo asconfigurações iniciais.
Fornecedor Datasul → Mercado eletrônico
Os dados do fornecedor são todos disponibilizados por uma API publica do Datasul ("supplierIntegrMePublic") que logo passam pelo aparelho integrador padrão (TOTVS IPASS) para serem devidamente traduzidos para serem encaminhados para a API ("suppliers") do Mercado Eletrônico.
Valores encaminhados do Datasul para o Mercado Eletrônico (locationIntegrMePublic)
Campo Datasul
Campo Mercado Eletrônico
Descrição do campo
Necessita de algum tratamento no IPASS?
tradingName
tradingName
Nome comercial
country
country
País do fornecedor
No Datasul country é um campo escrito por extenso, porém no ME é salvo em sigla.
Datasul: Brasil
ME: BR
supplierId
Id do fornecedor ME que deverá ser utilizado como pathParam caso seja feita uma atualização PUT para ME. Esse campo pode estar vazio (“”) caso o fornecedor Datasul não tenha sido cadastrado no ME
address
address
Endereço do fornecedor
isDesactivated
isDesactivated
Informa se o fornecedor está desativado
city
city
Cida do fornecedor
companyName
companyName
Nome completo do fornecedor
postalCode
postalCode
CEP
stateRegistrationNumber
stateRegistrationNumber
Número da inscrição estadual
languageId
languageId
Idioma do fornecedor
phoneNumber [{ }]
phoneNumber
Número de telefone para contato
No ME o campo “phoneNumber” ele é apenas um campo STRING enquanto no Datasul ele é um array, então para solucionar esse problema, concatenar os valores separados por pipe no campo do payload da API do ME
contact [{ }]
contact
Contato
No Datasul, os contatos é um array, pois pode ter vários contatos salvos, porém no ME ele é uma string única. Então deverá procurar o primeiro objeto do array “contact” que tem o campo
“role” == “comprador”
e, caso isso não aconteça, mandar o campo “contact” com o valor “Não informado”. Se existir o campo contato com role = comprador então enviar no campo “contact” da api do ME as informações (name, phone email) concatenadas em um único campo, separados por pipe
addressNumber
addressNumber
Número do endereço
state
state
Estado
neighborhood
neighborhood
Bairro
clientSupplierId
clientSupplierId
Id do fornecedor no Datasul
transaction
1 - inclusão
2 - alteração
3 - exclusão
Não envia ME, é apenas para identificar se este produto deve ser incluído, alterado ou excluído no ME
email
email
E-mail
Campo obrigatório no ME. Se estiver em branco no Datasul, colocar no payload como “Não Informado”
document: Array[ ]
Campo Datasul
Campo Mercado Eletrônico
Descrição do campo
Necessita de algum tratamento no IPASS?
number
number
Número do documento
type
type
Tipo do documento (CNPJ ou CPF)
accounts: Array[ ]
Campo Datasul
Campo Mercado Eletrônico
Descrição do campo
Necessita de algum tratamento no IPASS?
number
number
Conta-corrente
bank
bank
Número do banco
Na api do ME esse campo é do tipo string, tem q fazer DE-PARA dos tipos.
checkDigit
checkDigit
Dígito conta corrente
isActive
isActive
Informa se a conta está ativa
branch
branch
Agência
supplierAccountId
Id do Fornecedor no ME (supplierId)
Atualização de status
Em todo o processo de cadastro de fornecedor (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 passarão por uma tradução do status realizada pelo aparelho integrador TOTVS IPASS.
Campo Datasul
Conteúdo payload
Necessita de algum tratamento no IPASS?
supplierIdMe
Código do fornecedor criado no ME (identificador)
status
2
processMessage
Enviar campo no payload com conteúdo em branco
lastUpdateDatetime
Data/hora atual
lastUpdateDatetime
Mercado eletrônico → Fornecedor Datasul
Os dados do fornecedor são todos disponibilizados por uma API publica do Mercado Elêtronico ("suppliers") que logo passam pelo aparelho integrador padrão (TOTVS IPASS) para serem devidamente traduzidos para serem encaminhados para a API ("supplierIntegrMePublic") do Datasul.
Campo Mercado Eletrônico
Campo Datasul
Descrição do campo
Necessita de algum tratamento no IPASS?
supplierId
supplierId
Código do fornecedor no ME
No Datasul, trata-se de um campo do tipo string e no ME é do tipo int32
clientSupplierId
clientSupplierId
Código do fornecedor no Datasul. Esse campo estará vazio caso o fornecedor ainda não tenha sido criado no Datasul
tradingName
tradingName
Nome comercial
companyName
companyName
Nome completo do fornecedor
contact
contact
Contato
address
address
Endereço
city
city
Cidade
addressNumber
addressNumber
Número do endereço
complement
complement
Complemento
neighborhood
neighborhood
Bairro
state
state
Estado
country
country
País
No Datasul country é um campo escrito por extenso, porém no ME é salvo em sigla.
Datasul: Brasil
ME: BR
postalCode
postalCode
CEP
No ME o campo “phoneNumber” ele é apenas um campo char enquanto no DS ele é um array, então para solucionar esse problema, apenas o transforme em um vetor de char.
languageId
languageId
Idioma
0 = português
supplierGroup
supplierGroup
Grupo de fornecedores
isDeactivated
isDeactivated
Indica se o fornecedor está ativo
stateRegistrationNumber
stateRegistrationNumber
Número da inscrição estadual
homologationStatus
homologationStatus
additionalEmails [ ]
additionalEmails [ ]
E-mails adicionais do fornecedor
email Array[ ]
Campo Mercado Eletrônico
Campo Datasul
Descrição do campo
Necessita de algum tratamento no IPASS?
email
email
E-mail
documents Array[ ]
Campo Mercado Eletrônico
Campo Datasul
Descrição do campo
Necessita de algum tratamento no IPASS?
number
number
Número do documento
type
type
Tipo do documento (CNPJ ou CPF)
data Array[ ] *contas
Campo Mercado Eletrônico
Campo Datasul
Descrição do campo
Necessita de algum tratamento no IPASS?
supplierAccountsId
supplierAccountsId
Código da conta no ME
number
number
Conta-corrente
bank
bank
Número do banco
checkDigit
checkDigit
Dígito conta corrente
branch
branch
Agência
branchCodeDigit
branchCodeDigit
Dígito da agência
Atualização do fornecedor Datasul → Mercado Eletrônico
Em todo o processo de cadastro de fornecedor (ME → Datasul) o Datasul enviará na resposta da requisição o id do fornecedor gerado no Datasul, mantendo atualizando os dois lados da integração.
Campo Mercado Eletrônico
Campo Datasul
Descrição do campo
Necessita de algum tratamento no IPASS?
clientSupplierId
clientSupplierId
Id criado no Datasul. Os outros campos não há necessidade de DE-PARA
supplierId
suppliers/{supplierId}
Código do fornecedor
no ME trata-se de um campo int32
Card
effectDuration
0.5
id
Produtos
label
Produtos
title
Produtos
effectType
slide
Fluxo de Produto
Para se iniciar o fluxo de produtos, deve se ter finalizado por completo asconfiguraçõ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 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
Utilizado para envio dos códigos NCM/NBM
productIdentificationCode:
value
productIdentificationCode:
value
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 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.
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
effectDuration
0.5
id
Usuários
label
Usuários
title
Usuários
effectType
slide
Fluxo de Usuários/Comprador
Para se iniciar o fluxo de usuário, deve se 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.
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
purchasingGroups.
clientPurchasingGroupCode
purchasingGroups.
clientPurchasingGroupCode
Código do grupo de compra
purchasingGroups.
clientPurchasingGroupDescription
purchasingGroups.
clientPurchasingGroupDescription
Descrição do grupo de compra
role
role
Função
O padrão é “Geral”, mas pode ser alterado dependendo da configuração do usuário.
integrationTag
integrationTag
ID cadastrado no Datasul como comprador que será gravado como usuário de integração no Mercado Eletrônico
profile
profile
Perfil
O padrão é “Cadastro” mas pode ser alterado dependendo da configuração do usuário.
languageId
languageId
Idioma padrão do usuário
Idioma possíveis: Português, Inglês e Espanhol.
permission
permission
Permissão do usuário
O padrão é “Geral”, mas pode ser alterado dependendo da configuração do usuário.
buyerId
buyerId
ID do comprador (ME)
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 Datasul, colocar no payload como “Não informado”.
name
name
Nome do usuário
businessOrganizations
businessOrganizations.
code
businessOrganizations.
code
Códigos das empresas as quais o usuário é vinculado
businessOrganizations.
virtualEntityField
businessOrganizations.
virtualEntityField
Tipo (EMPRESA)
email
email
E-mail
É um campo obrigatório no Mercado Eletrônico, caso não seja informado no Datasul é necessário incluir como "Não informado".
costCenters
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
effectDuration
0.5
id
Pedidos
label
Pedidos
title
Pedidos
effectType
slide
Fluxo de Pedidos
Para iniciar o fluxo de pedidos, é necessário ter finalizado as configurações iniciais.
Inclusão de Pedidos Mercado eletrônico → Datasul
Os pedidos são sempre criados no Mercado Eletrônico e posteriormente enviados ao Datasul.
Para melhor entendimento do funcionamento do fluxo de criação do pedido de compra, segue o passo a passo do fluxo de forma resumida:
Processo de compra inicia com o comprador enviando as ordens de compras do Datasul para o ME*;
Comprador inicia o processo de solicitações das cotações para os fornecedores no ME;
Comprador escolhe a cotação vencedora no ME;
A partir da cotação vencedora, comprador gera o pré-pedido no ME;
O pré pedido é enviado do ME para o Datasul onde será criado um pedido de compra correspondente;
No Datasul, dependendo da parametrização, a cotação e/ou pedido de compra ficam pendentes de aprovação aguardando ação do aprovador para continuidade do fluxo.
Depois de aprovados os documentos, é enviado uma atualização de status para o ME e se este foi aprovado no Datasul, automaticamente o pré-pedido se torna um pedido no ME.
Este pedido no ME automaticamente é enviado para aceite do fornecedor.
ME* - nos referimos a ME a plataforma Mercado Eletrônico.
Tendo em mente a ideia macro do fluxo, veremos agora em detalhes o fluxo de criação e alteração de pedido de compra:
Quando é escolhida a cotação vencedora no ME , na tela de Mapa Comparativo é 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
Continuando o fluxo, o comprador então deverá gerar o Pré-pedido no Mercado Eletrônico e ao final clicar em “Enviar Pré Pedido”.
Nesse momento esse Pré-pedido será enviado para criação no Datasul. Enquanto isso, no ME, ele ficará com o seguinte status:
Os valores são todos disponibilizados pela API publica do Datasul ("quotationPublic", "orderIntegrMePublic" e "purchOrderPublic")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
Valores encaminhados do Datasul para o Mercado eletrônico (purchOrderPublic)
Campo Datasul
Campo Mercado Eletronico
Descrição do campo
Necessita de algum tratamento no IPASS?
preOrderId
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
grossValue
grossValue
Valor bruto do pedido
note
note
Narrativa
freightPaymentType
freightPaymentType
Frete Pago ou A Pagar
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
clientPaymentConditionId
clientPaymentConditionId
Código da Condição de Pagamento
carrierCode
carrierCode
Código da Transportadora
isEmergencial
Indica se o pedido é emergencial (0 para 'Não' e 1 para 'Sim')
statusME
Confirmed (Impresso no Datasul)
purchaseOrderLines
purchaseOrderLines
Dados da Ordem de Compra/Cotação
requestId
requestId
ID de requisição do Mercado Eletrônico
measurementUnit
measurementUnit
Unidade de Medida
unitPrice
unitPrice
Preço da Unidade
clientProductId
clientProductId
Código do Item no Datasul
ipiTax
ipiTax
Percentual IPI
icmTax
icmTax
Percentual ICMS
issTax
issTax
Percentual ISS
purchaseOrderLinesDeliveries
Dados referentes a tabela prazo-compra
quantity
quantity
Quantidade
deliveryDate
deliveryDate
Data de entrega
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
default
true
effectDuration
0.5
id
Suporte
label
Suporte
effectType
slide
Perguntas Frequentes (FAQs)
Expandir
title
A partir de qual versão poderei utilizar a integração?
A partir da release 12.1.2411 esta novidade estará disponível.
Expandir
title
Para 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
title
Qual 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
title
A 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
title
O 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
title
Qual o meu Usuário e Senha?
As credenciais de acesso são ser obtidas através doPartner'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.