...

Deck of Cards

effectDuration	0.5
id	cabecalho
effectType	slide

Card

default	true
effectDuration	0.5
id	MINHA-PLATAFORMA
label	MINHA PLATAFORMA
title	MINHA-PLATAFORMA
effectType	slide

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

Deck of Cards

effectDuration	0.5
id	tudo-sobre
effectType	slide

Card

effectDuration	0.5
id	Introducao
label	Introdução
title	Introdução
effectType	slide

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
Texto	Mais Informações
Link	https://wwwprodutos.me.com.br/totvs.com/ficha-tecnica/tudo-sobre-o-e-procurement-by-mercado-eletronico/

Índice

exclude	Conteúdo

Card

default	true
effectDuration	0.5
id	Sobre
label	Sobre
title	Sobre
effectType	slide

Informações

title	Pré-requisito

Para poder utilizar a integração Datasul x Mercado Eletrônico, é necessário realizar a contratação de:

Plataforma Mercado Eletrônico
HUB de Integração (middleware)

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 assim como também poderão ser enviado os Fornecedores do Mercado Eletrônico os novos Fornecedores escolhidos como vencedores nas etapas de negociação.
- 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 Datasul e enviada ao Mercado Eletrônico como "Requisição" , mas virá para o Datasul como Ordem de Compraas ordens que irão compor os pedidos 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 para aprovação conforme fluxo de aprovaçãoparametrizado no cliente.
- Cotações - As cotações das ordens serão feitas são todas concentradas no Mercado Eletrônico, mas virão para o Datasul conforme seu respectivo pedidojustamente porque a plataforma permite ampliar o acesso à cadeia de fornecedores. Para o Datasul, é enviada a cotação vencedora no momento da criação do pedido de compra.
- 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)A aprovação dos documentos continua sendo no Datasul, por exemplo, se o cliente utiliza o MLA para aprovação de documentos como cotação e pedidos de compra, estes vão seguir o fluxo normal no momento da criação no Datasul, ficando pendentes para aprovação conforme regras já definidas e utilizadas no ERP.
Permissibilidade de alterar registros - Os registros criados no ME como pedidos de compra podem ser alterados no Portal do ME conforme necessidade e regras de negócio que a ferramenta de integração irá garantir o envio das informações ao Datasul, garantindo a consistência dos dados.
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 e que já estão integrados no ME, 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 de forma segura pelos compradores, aumentando o loque leque de opções.
Filtros - Grande gama de filtros para personalizar as buscas e resultados.
Mapa Comparativo - Mapa comparativo apresentado no final da rodada de da cotação, trazendo valores preenchidos conforme melhor opção de cotação e fazendo uma simulaçãosugerindo a melhor opção de compra para a negociação.
Notificação Automática do Fornecedor - Quando o pedido de compra é gerado no ME, o fornecedor recebe automaticamente uma notificação por e-mail, onde através de um link , o mesmo consegue acessar a plataforma e fazer o aceite ou recusa do pedido de compra.

Para conhecer mais sobre o Mercado Eletrônico:

Painel

borderStyle	none
title	Conheça a Plataforma

Column

width	500

UNIVERSO TOTVS18/06/2024

Painel

Multimedia

name	Backoffice Datasul - Suprimentos - Integração com Mercado Eletrônico.mp4
height	100%

LINKS DA PLATAFORMA:

Button

Texto	Site

oficial

Oficial
Link	https://www.me.com.br/

Button

Texto	E-procurement by Mercado Eletrônico
Link	https://produtos.totvs.com/ficha-tecnica/tudo-sobre-o-e-procurement-by-mercado-eletronico/

Card

effectDuration	0.5
id	Configurações

Card

effectDuration	0.5
id	Configurações Iniciais Datasul
label	Configurações Iniciais Datasul
title	Configurações Iniciais Datasul
effectType	slide

Passo a passo

de

da configuração - Datasul

Para utilizar o aplicativo 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.
Configuração de empresas:

Aguardar retorno do ME

Card

effectDuration	0.5
id	Configurações Iniciais Mecado Mercado Eletrônico
label	Configurações Iniciais Mecado Mercado Eletrônico
title	Configurações Iniciais Mecado Mercado Eletrônico
effectType	slide

Passo a passo

de

da configuração - Mercado Eletrônico

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 Image Removed, 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 Image Removed 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 Image Removede dentro da tela apresentada acessar Image Removed.

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 Image Removed.

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 Image Removede 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 Image Removed onde será apresentada a tela de cadastro e poderão ser feitas as inclusões dos dados desejados.

Clicar em Image Removed 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 Image Removed, 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 Image Removed. Clicar em Image Removed 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 Image Removed 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 RemovedImage Removed

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

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

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 Image Removedsão obrigatórias. Após o preenchimento, inserir o arquivo editado na seção Image Removed. 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 Image Removed.

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".

Painel

borderStyle	none
title	Carga de dados

title	Dados de Acesso

Os dados de acesso (API Keys) para se integrar os produtos e serviços do Mercado Eletrônico são criados por usuários com perfil de desenvolvedores. Os desenvolvedores possuem autonomia para gerir os acessos e Webhooks existentes na integração. O processo para incluir um usuário com perfil de Desenvolvedor está disponível clicando aqui.

Painel

borderStyle	solid
title	Empresas

Ao configurar as empresas, é obrigatório que elas sejam iguais as que o cliente tem no Datasul (códigos das empresas), devido a importância de manter a consistência dos dados. Sua criação é feita pela própria equipe do Mercado Eletrônico - são as chamadas BORGS - , bem como sua configuração.

As ordem de compra (Datasul) e requisições (Mercado eletrônico) precisam ter a mesma estrutura de Business Organizations para que sejam criadas corretamente.

Exemplo:

a ordem de compra número 8000 no Datasul pertence a Empresa com código 10 (Descrição "Datasul Empresa 10") e Estabelecimento código 15 (Descrição "Datasul Estabelecimento 15") .

Então a requisição quando é criada no Mercado Eletrônico deve ter uma estrutura de BORG da mesma forma:

{
"data": [
{
"código": "10",
"tipo": "empresa",
"descrição": "Datasul Empresa 10"
},
{
"código": "15",
"tipo": "estabelecimento.",
"descrição": "Datasul Estabelecimento 15"
}
]

Painel

borderStyle	solid
title	Carga 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, pois estes dados não são tratados pela integração.

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

Aviso

title	Aviso

As moedas, condição de pagamento e unidade de medida devem seguir exatamente a mesma nomenclatura, símbolo e descrição do que já existe no cadastro do ERP Datasul.

Aviso

title	Importante - Cadastro de Moedas

No Mercado Eletrônico, o campo "Moeda" é preparado para receber valores no formato ISO-4217. Visando garantir a integridade entre os dados, é necessário realizar o cadastro nesse formato, conforme valores já registrados no ERP ( programa CD0914) pois validaremos no Datasul.

Para saber mais sobre o formato ISO-4217, acesse https://www.iso.org/iso-4217-currency-codes.html.

CADASTRO MANUAL PELO PORTAL ME

Para cadastrar manualmente as moedas, será necessário estar logado com a conta do ME no portal, acessar o ícone de "Mais" localizado no menu superior Image Added, 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 Image Added 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 Image Addede dentro da tela apresentada acessar Image Added.

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 Image Added.

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 Image Addede 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 Image Added onde será apresentada a tela de cadastro e poderão ser feitas as inclusões dos dados desejados.

Clicar em Image Added 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 Image Added, 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 Image Added. Clicar em Image Added 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 Image Added 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 Added

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

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

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 Image Addedsão obrigatórias. Após o preenchimento, inserir o arquivo editado na seção Image Added. 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 Image Added.

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 fluxos criados. As informações que são contempladas na integração atual estão listadas na aba "Sobre".

Card

effectDuration	0.5
id	Diagrama
label	Diagrama Fluxo
title	Diagrama
effectType	slide

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.

Painel

borderStyle	none
title	Fluxo Completo

Image Added

Card

effectDuration	0.5
id	Estabelecimentos
label	Estabelecimentos
title	Estabelecimentos
effectType	slide

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.

Image Added

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)

Campo Datasul

Campo Mercado Eletrônico

Descrição do campo

Necessita de algum tratamento na ferramenta de integração?

country

País do local

No Datasul, country é um campo escrito por extenso, porém no ME é salvo em sigla.

Exemplo:

Datasul: Brasil
ME: BR

locationName

Id do “local” no Datasul

address

Endereço (Rua) do estabelecimento

city

Cidade onde encontra-se o estabelecimento

postalCode

CEP do estabelecimento

adressNumber

Número do endereço do estabelecimento

clientLocationId

Id do estabelecimento no Datasul

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 então devera ser criado. Como citado abaixo nas regras, nesse fluxo será necessário mandar duas request's 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
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 na ferramenta de integração?
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 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.

Campos da API de status de Locais do Datasul.

Campo Datasul	Conteúdo payload	Necessita de algum tratamento na ferramenta de integração?
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

Fluxo de Estabelecimento

Para se iniciar o fluxo de estabelecimentos, deve se ter finalizado por completo as configuraçõ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)

companyNationalRegistration: Array[ ]

bussinesOrganization: Array[ ]

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.

document: Array[ ]

accounts: Array[ ]

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.

Mercado eletrônico → Fornecedor Datasul

Os dados do fornecedor são todos disponibilizados por uma API publica do Mercado Elêtronico Datasul ("supplierssupplierIntegrMePublic") que logo passam pelo aparelho integrador padrão (TOTVS IPASS) pela ferramenta de integração para serem devidamente traduzidos para serem e então encaminhados para a API ("supplierIntegrMePublicsuppliers") do Datasul.

Campo

Mercado Eletrônico.

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

Card

effectDuration	0.5
id	Fornecedores
label	Fornecedores
title	Fornecedores
effectType	slide

Fluxo de Fornecedor

Para iniciar o fluxo de fornecedores, é necessário ter finalizado por completo asconfiguraçõ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”.

Image Added

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.

Image Added

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

Card

effectDuration	0.5
id	Estabelecimentos
label	Estabelecimentos
title	Estabelecimentos
effectType	slide

Campo Datasul

Campo Mercado Eletrônico

Descrição do campo

Necessita de algum tratamento no IPASS?

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

Id do “local” no Datasul

address

Endereço (Rua) do estabelecimento

city

Cidade onde encontra-se o estabelecimento

postalCode

CEP do estabelecimento

adressNumber

Número do endereço do estabelecimento

clientLocationId

Id do estabelecimento no Datasul

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.

Campo Datasul

Campo Mercado Eletrônico

Descrição do campo

Necessita de algum tratamento no IPASS?

number

É a sequência de números de um CPF ou a um CNPJ do correspondente da empresa

type

Identifica o tipo do documento do correspondente da empresa, CPF ou CNPJ

stateRegistrationNumber

Estado onde encontra-se o estabelecimento

Campo Datasul

Campo Mercado Eletrônico

Descrição do campo

Necessita de algum tratamento no IPASS?

entityType

Tipo (EMPRESA)

clientBusinessOrganizationId

Código da empresa a qual o estabelecimento está vinculado

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 as configuraçõ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

Nome comercial

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

Endereço do fornecedor

isDesactivated

Informa se o fornecedor está desativado

city

Cida do fornecedor

companyName

Nome completo do fornecedor

postalCode

CEP

stateRegistrationNumber

Número da inscrição estadual

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

Número do endereço

state

Estado

neighborhood

Bairro

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

E-mail

Campo obrigatório no ME. Se estiver em branco no Datasul, colocar no payload como “Não Informado”

Campo Datasul

Campo Mercado Eletrônico

Descrição do campo

Necessita de algum tratamento no IPASS?

number

Número do documento

type

Tipo do documento (CNPJ ou CPF)

Campo Datasul

Campo Mercado Eletrônico

Descrição do campo

Necessita de algum tratamento no IPASS?

number

Conta-corrente

bank

Número do banco

Na api do ME esse campo é do tipo string, tem q fazer DE-PARA dos tipos.

checkDigit

Dígito conta corrente

isActive

Informa se a conta está ativa

branch

Agência

supplierAccountId

Id do Fornecedor no ME (supplierId)

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

email Array[ ]

Necessita de algum tratamento no IPASS?

Campo Datasul

Campo Mercado Eletrônico

Campo Datasul

Descrição do campo

Necessita de algum tratamento no IPASS?

supplierId

Código do fornecedor no ME

No Datasul, trata-se de um campo do tipo string e no ME é do tipo int32

clientSupplierId

Código do fornecedor no Datasul. Esse campo estará vazio caso o fornecedor ainda não tenha sido criado no Datasul

tradingName

Nome comercial

companyName

Nome completo do fornecedor

contact

Contato

address

Endereço

city

Cidade

addressNumber

Número do endereço

complement

Complemento

na ferramenta de integração?

tradingName

Nome comercial

country

País do fornecedor

No Datasul country é um campo escrito por extenso, porém no ME é salvo em sigla.

Exemplo:

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

Endereço do fornecedor

isDesactivated

Informa se o fornecedor está desativado

city

Cidade do fornecedor

companyName

Nome completo do fornecedor

postalCode

CEP

stateRegistrationNumber

Número da inscrição estadual

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

neighborhood

Bairro

state

Estado

country

País

No Datasul country é um campo escrito por extenso, porém no ME é salvo em sigla.

Datasul: Brasil

ME: BR

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

Idioma

0 = português

foi concatenado 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

Número do endereço

state

Estado

neighborhood

Bairro

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

supplierGroup

Grupo de fornecedores

isDeactivated

Indica se o fornecedor está ativo

stateRegistrationNumber

Número da inscrição estadual

homologationStatus

additionalEmails [ ]

E-mails adicionais do fornecedor

Campo Mercado Eletrônico

Campo Datasul

Descrição do campo

email

E-mail

Campo obrigatório no ME. Se estiver em branco no Datasul, colocar no payload como “Não Informado”

document: documents Array[ ]

Campo Datasul	Campo Mercado Eletrônico	Campo Datasul	Descrição Descrição do campo	Necessita de algum tratamento no IPASSna ferramenta de integração?
number	number	Número do documento
type	type	Tipo do documento (CNPJ ou CPF)

data accounts: Array[ ] *contas

Código da conta no ME

Campo Datasul	Campo Mercado EletrônicoCampo Datasul	Descrição do campo	Necessita de algum tratamento no IPASS?	supplierAccountsId	supplierAccountsId	na ferramenta de integração?
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	branchCodeDigit	branchCodeDigit	Dígito da agência

Atualização do fornecedor Datasul → Mercado Eletrônico


		supplierAccountId	Id do Fornecedor no ME (supplierId)

groups: Array[ ]

Campo Datasul	Campo Mercado Eletrônico	Descrição do campo	Necessita de algum tratamento na ferramenta de integração?
ep-codigo	description	"EMPRESA " + Código da Empresa

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

Em todo o processo de cadastro de

fornecedor

fornecedores (Datasul → 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

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

Campo Datasul	Conteúdo payload	Necessita de algum tratamento na ferramenta de integração?
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

Integração Fornecedor Mercado eletrônico → Fornecedor Datasul

Devido a particularidade do ME (Mercado Eletrônico) conter o processo de homologação de fornecedores, não haverá o fluxo de de criação de fornecedores do ME (Mercado Eletrônico) para o Datasul. Apenas depois da etapa de homologação concluída no ME (Mercado Eletrônico), será necessário cadastrar manualmente o fornecedor no sistema Datasul.

Passo a passo para realizar o cadastro de um Fornecedor do Marketplace originado no ME (Mercado Eletrônico), para o Datasul:

Realizar o processo de homologação do Fornecedor no ME.
Após homologar, cadastrar manualmente o Fornecedor no Datasul.

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 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.

Datasul	ME	Descrição
materialOrigin	materialOrigin	Origem do material
note	note	Narrativa/observação
clientGroupId	clientGroupId	Código do grupo do item
clientGroupDescription	clientGroupDescription	Descrição do

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 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 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). Caso não exista histórico de última compra, o preço considerado será o preço de reposição do relacionamento Item x Estabelecimento. E caso o mesmo também esteja zerado, utilizará o preço de reposição do item.
complement	complement	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

(Apenas são considerados itens ativos para realizar a integração. Itens obsoletos são desconsiderados)

businessOrganization Array[ ]

Campo Mercado Eletrônico

Campo Datasul

Descrição do campo

Necessita de algum tratamento na ferramenta de integração?

code

ep-codigo

cod-estabel

Código da Empresa

Código Estabelecimento

virtualEntityField

"EMPRESA"

"ESTABELECIMENTO"

description

nome

Descrição da empresa/estabelecimento

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 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-Parana ferramenta de integração?
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.

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.

Aviso

title	Importante - Campo "E-mail" do Usuário/Comprador

No Mercado Eletrônico, o campo "Usuário" é utilizado como chave para o cadastro utilizando a seguinte nomenclatura: "DTS_{{{cod-usuario}}}".

Antes de integrar, é possível verificar o estado desse campo sem o identificador "DTS_" na tela CD1700.

Image Added

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

Campo Datasul	Campo Mercado Eletronico	Descrição do campo
purchasingGroups
purchasingGroups. clientPurchasingGroupCode	purchasingGroups. clientPurchasingGroupCode	Código do grupo de compra
purchasingGroups. clientPurchasingGroupDescription	purchasingGroups. clientPurchasingGroupDescription	Descrição do grupo de compra

role

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 Datasul → ME) o mercado eletrônico mandara 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 tudoisso, tera novamente passara passará por uma tradução dos dados do status do cadastro do usuário pelo aparelho integrador TOTVS IPASSpela ferramenta de integração.

*Nome Campo Dtsul*	*Conteúdo Payload*	Necessita de algum tratamento no De-Parana ferramenta de integração?
itemIdME	código do produto criado no ME	Conversao Conversão de tipos de dados
status	codigo do status de como foi a transacao transacão no ME, 1 → em processamento no mercado eltronicoeltrônico, 2 → executado sem errorserros 3 → executado com erros
processMessage	informaçoes informações de erros e caso esteje esteja vazio, significa que a integração ocorreu sem erros
lastUpdateDatetime	Data/hora atual

Card

effectDuration	0.5
id	PedidosOrdens de Compra
label	PedidosOrdens de Compra
title	PedidosOrdens de Compra
effectType	slide

Fluxo de

Pedidos

Ordem de Compra

Para iniciar o fluxo de pedidosordens de compra, é necessário ter finalizado as os demais fluxos de cadastros e 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.

Image Removed

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

Mercado Eletrônico depois de aprovado.

https://app.screencast.com/YYAhTZ4Trgdhq

(gerar um .gif da criação.)

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:

Image Removed

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.

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”.

Image Added

Aviso

title	Importante

As ordens de compra com as características abaixo, não podem ser enviadas para serem integradas no ME. Ao tentar integrar alguma ordem com alguma dessas características, o programa html.cc0301 irá retornar uma mensagem ao usuário informando que não é possível a integração, por algum dos motivos abaixo:

a ordem não pode pertencer a um contrato;
a ordem não pode possuir pedido de compra relacionado;
a ordem não pode estar atrelada a um pacote de compra;
a ordem não pode possuir fornecedor designado e nem cotação;
a ordem não pode possuir data de entrega menor que a data atual;
a ordem não pode possuir integração com outra aplicação externa. Só podem ser integradas com o ME, as ordens que ainda não estão integradas com outras ferramentas.

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.

Image Added

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.

Image Added

Informações

title	Segue listagem dos outros status que a ordem de compra pode ter na integração do Mercado Eletrônico:

Registro enviado para processamento: aguardando a ferramenta de integração efetivar o registro no Mercado Eletrônico;
Registro processado com sucesso: registro criado com sucesso no ME;
Registro não processado - erro na integração: ao tentar criar o registro no destino, houve algum erro. Deve ser verificado o log para corrigir e tentar refazer a integração;
Em cotação: ordem de compra está em processo de cotação no ME
Aguardando Aprovação da Cotação: aguardando os responsáveis aprovar a cotação no Datasul
Aguardando Aprovação do Pedido: aguardando todos os responsáveis aprovar o pedido de compra no Datasul
Pedido Aprovado: pedido aprovado no Datasul e enviado status de aprovação para o ME
Pedido Rejeitado: pedido recusado no Datasul e enviado status de recusa ao ME

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

Campo Datasul	Campo Mercado Eletronico	Descrição do campo	Necessita de algum tratamento na ferramenta de integração?
note	note	observação/narrativa da ordem de compra
isEmergency	emergency	se a ordem de compra é emergencial ou não. Sempre vai sair como false do Datasul pq embora haja o status com prioridade alta, no ME esse campo = true indica que a requisição não terá cotação e está apta para ser gerada um pedido Emergencial.
integrationTag	integrationTag	id do comprador no Datasul que será gravado como usuário de integração no ME	No Datasul é o cod-comprado e no Me é o usuário de integração. então no ME vai receber o mesmo conteúdo do login do Datasul (cod-comprado)
isCanceled	isCanceled	só será true quando a ordem de compra for eliminada no Datasul
clientRequestId	clientRequestId	número da ordem de compra no Datasul
category	category	tipo da ordem de compra, pode ser: Compra, Beneficiamento ou Serviço, enviar conforme json Datasul.
clientDeliveryPlaceId	clientDeliveryPlaceId	Local de Entrega: mesmo código no Datasul e ME.
transaction		1 - inclusão / 2 - alteração / 3 - exclusão	Não envia ME, é apenas para identificar se esta ordem de compra deve ser incluída, alterada ou excluída no ME
statusMe	status	campo status do ME, conforme acordado com o pessoal do ME, deve ser enviado sempre = 0 (submitted)
RequestItems
itemNumber	itemNumber	sequencial do Item (deve ter sempre = 1)
note	note	narrativa/observação do item
quantity	quantity	quantidade total do item solicitado na ordem
clientGroupId	clientGroupId	código do grupo do item (já previamente cadastrado no ME)
clientGroupDescription	clientGroupDescription	descrição do grupo do item (já previamente cadastrado no ME)
isGeneric	isGeneric	define se o item é genérico ou não
description	description	descrição do item, nome completo
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)
measurementUnity	measurementUnity	Unidade de Medida do item da ordem de compra
isService	isService	se a ordem de compra é do tipo serviço precisa enviar para o Me esse campo como true (ver pela category)
Deliveries - Entregas (array)
quantity	quantity	quantidade da entrega da parcela
deliveryDate	deliveryDate	data da entrega da parcela
businessOrganizations
code	businessOrganizations.code	código da empresa da ordem no Datasul, deve ter o mesmo código no ME	ex: possui a BORG empresa com o código 001.
virtualEntityField	businessOrganizations.virtualEntityField	tipo enviado na estrutura “businessOrganization” (empresa, filial) Enviar conforme json gerado no Datasul	ex: "Empresa"
code	businessOrganizations.code	código da filial se houver (estabelecimento), deve ter o mesmo código no ME	ex: possui a BORG filial com o codigo 1001.
virtualEntityField	businessOrganizations.virtualEntityField	tipo enviado na estrutura “businessOrganization” (empresa, filial) Enviar conforme json gerado no Datasul	ex: "Filial"

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

Campo Datasul	Descrição do Campo	Necessita de algum tratamento na ferramenta de integração?
orderLineNumberME	código da ordem de compra criada no ME	No ME, esse campo é um integer, quando for para enviar no payload do Datasul, deve ser enviado como char. Esse código vem no webhook do Me.
status	status do registro processado na integração
processMessage	Mensagem da integração, se houver

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.

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

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

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.

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

effectDuration	0.5
id	Pedidos
label	Pedidos de Compra
title	Pedidos
effectType	slide

Fluxo de Pedido de Compra

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

Informações

Para melhor entendimento do funcionamento do fluxo de criação do pedido de compra, segue o passo a passo do fluxo de forma resumida:

O processo de compras inicia com o comprador enviando as ordens de compras criadas no Datasul para o ME*;
No ME, o comprador inicia a rodada de negociação de preço das ordens com os fornecedores;
Finalizada a negociação, o comprador escolhe a cotação vencedora no ME;
A partir da cotação vencedora, comprador gera o Pré-pedido no ME;
Os dados do Pré-pedido são enviados para o Datasul, e com base nesse é criado o pedido de compra com o número padrão do Datasul;
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 todos os documentos no Datasul, é enviado uma atualização de status para o ME e automaticamente é gerado o pedido no ME.
Este pedido do ME é enviado automaticamente para aceite/recusa do fornecedor.

ME* → abreviatura que utilizamos para referenciar a plataforma Mercado Eletrônico.

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:

Image Added

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.

Image Added

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.

Image Added

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.

Nota

title	Importante!

Apenas a cotação vencedora é enviada para o Datasul, as demais cotações que fizeram parte do processo de negociação ficam no Mercado Eletrônico e podem ser consultadas na ferramenta quando necessário. Assim, como acontece com o pedido de compra, as cotações oriundas do ME não podem ser modificadas no ERP Datasul, se elas possuem integração, ao tentar modificar ou excluir pelos programas , é mostrada uma mensagem ao usuário informando que a cotação possui integração e portanto não pode ser alterada. Caso seja necessário reabrir a negociação ou alterar pedido, estes devem ser feitos pelo ME.

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.

Image Added

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:

Image Added

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”.

Image Added

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.

Aviso

title	Importante! Validação das Alterações

No ME, dependendo do tipo de alteração feita no pedido, valem as seguintes regras:

Se uma alteração não impactar no 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 com o status: "Aguardando Integração ERP", sendo que a ferramenta de integração deverá reenviar o pedido para nova aprovação no Datasul.
Exemplo: Alteração na condição de pagamento do Pedido.

Image Added

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.

Aviso

title	Aviso

Vale lembrar que todas as informações trocadas entre o ERP Totvs e o Mercado Eletrônico depende de uma ferramenta de integração que troca informação entre a API dos dois sistemas. Portanto, podem ocorrer erro nessa troca de informação, em virtude de erros de cadastros, tipos de campos incompatíveis , entre outros problemas. Quando a integração é implementada são configuradas formas de receber os alertas e mensagens para determinar e sanar os problemas que podem ocorrer durante a troca de dados nos fluxos dos processos.

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

Campo Datasul	Campo Mercado Eletrônico	Descrição do campo	Necessita de algum tratamento na ferramenta de integração?
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.

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

Campo Datasul	Campo Mercado Eletronico	Descrição do campo
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
clientPaymentConditionId	clientPaymentConditionId	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 ou Não Impresso no Datasul)
purchaseOrderLines	purchaseOrderLines	Array com os dados das Ordens de Compra do Pedido
requestId purchaseOrderLines	requestId	ID de requisição do Mercado Eletrônico (fica relacionada ao número da ordem de compra no Datasul)
measurementUnit purchaseOrderLines	measurementUnit	Unidade de Medida
unitPrice purchaseOrderLines	unitPrice	Preço unitário do item
clientProductId purchaseOrderLines	clientProductId	Código do Item no Datasul
freight purchaseOrderLines	freight	Valor do frete
ipiTax purchaseOrderLines	ipiTax	Percentual IPI
icmTax purchaseOrderLines	icmTax	Percentual ICMS
issTax purchaseOrderLines	issTax	Percentual ISS
purchaseOrderLinesDeliveries		Array com os dados dos Prazos de Entregas das Ordens do Pedido
requestId purchaseOrderLinesDeliveries	requestId	ID de requisição do Mercado Eletrônico (fica relacionada ao número da ordem de compra no Datasul)
quantity purchaseOrderLinesDeliveries	quantity	Quantidade
deliveryDate purchaseOrderLinesDeliveries	deliveryDate	Data de entrega

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:

Image Added

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

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

Código do pré-pedido no ME

userCode

integrationTag

Código do comprador/login no Datasul

vendorID

clientSupplierId

ID do fornecedor do Datasul

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

orderDate

creationDate

Data de criação do pedido

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.

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

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

clientSupplierId

ID do fornecedor no Datasul

clientPayment ConditionId

Forma de pagamento

freightPaymentType

Forma de pagamento do frete

grossValue

Valor bruto do pedido

note

Observação

creationDate

Data de criação do pedido

currency

Símbolo da moeda

clientDeliveryPlaceId

Local de entrega

clientBillingPlaceId

Local de cobrança

Campo Datasul

Campo Mercado Eletronico

Descrição do campo

Necessita de algum tratamento no IPASS?

preOrderId

ID do pré-pedido criado no ME

integrationTag

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

clientSupplierId

ID do fornecedor no Datasul

clientPayment ConditionId

Forma de pagamento

grossValue

Valor bruto do pedido

note

Narrativa

freightPaymentType

Frete Pago ou A Pagar

creationDate

Data de criação do pedido

currency

Símbolo da moeda

clientDeliveryPlaceId

Local de entrega

clientBillingPlaceId

Local de cobrança

clientPaymentConditionId

Código da Condição de Pagamento

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

Dados da Ordem de Compra/Cotação

requestId

ID de requisição do Mercado Eletrônico

measurementUnit

Unidade de Medida

unitPrice

Preço da Unidade

clientProductId

Código do Item no Datasul

ipiTax

Percentual IPI

icmTax

Percentual ICMS

issTax

Percentual ISS

purchaseOrderLinesDeliveries

Dados referentes a tabela prazo-compra

quantity

Quantidade

deliveryDate

Data de entrega

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

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 uma ferramenta integradoraIPaasde integração.

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 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 MEao Mercado Eletrônico são criadas automaticamente pela integração do cadastro de compradores existente no Datasul. Todos os compradores existentes no Datasul são enviados ao Mercado Eletrônico para criação de usuário e senha de acesso, estes recebem o mesmo login já existente no Datasul. Também é possível criar manualmente no Mercado Eletrônico um usuário e senha por um usuário que já seja administrador ou pelo próprio contato do pessoal do Mercado eletrônico.

HTML

<!-- esconder o menu --> 
<style> 
div.theme-default .ia-splitter #main { 
margin-left: 0px; 
} 

.ia-fixed-sidebar, .ia-splitter-left { 
display: none; 
} 

#main { 
padding-left: 10px; 
padding-right: 10px; 
overflow-x: hidden; 
} 

.aui-header-primary .aui-nav, .aui-page-panel { 
margin-left: 0px !important; 
} 

.aui-header-primary .aui-nav { 
margin-left: 0px !important; 
} 

#header {
display: none;
}

</style>

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 33

Nova versão Atual

Chave

Conteúdo

Índice

Escopo

Passo a passo

da configuração - Datasul

Passo a passo

da configuração - Mercado Eletrônico

CADASTRO MANUAL PELO PORTAL ME

CADASTRO POR CARGAS EXCEL

CADASTRO DAS DEMAIS INFORMAÇÕES

Diagrama do Fluxo

Fluxo de Estabelecimento

Estabelecimento Datasul → Mercado eletrônico

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

Atualização de status

Fluxo de Fornecedor

Fluxo de Estabelecimento

Estabelecimento Datasul → Mercado eletrônico

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

Atualização de status

Fluxo de Fornecedor

Fornecedor Datasul → Mercado eletrônico

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

Atualização de status

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

Atualização do fornecedor Datasul → Mercado Eletrônico

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

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

Integração Fornecedor Mercado eletrônico → Fornecedor Datasul

Fluxo de Produto

Produto Datasul → Mercado eletrônico

Fluxo de Produto

Produto Datasul → Mercado eletrônico

Atualização de status

Atualização de status

Fluxo de Usuários/Comprador

Usuários Datasul → Mercado eletrônico

Usuários Datasul → Mercado eletrônico

Valores encaminhados do Datasul para o Mercado eletrônico

Valores encaminhados do Datasul para o Mercado eletrônico

Atualização de status

Fluxo de

Ordem de Compra

Inclusão de Pedidos Mercado eletrônico → Datasul

Envio das Ordens de Compra ao Mercado Eletrônico

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

Atualização de status

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

Fluxo de Pedido de Compra

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

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

Aceite/Recusa do Pedido de Compra pelo Fornecedor

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

De-para da API de cotação

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

Atualização de status

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

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

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

Atualização de status

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

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

3. Alteração de Pedido Rejeitado - Datasul

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