Linha Datasul

Árvore de páginas

Versões comparadas

Versão antiga 9

changes.mady.by.user Jamile Cristina Espindola Stinghen

Gravado em

comparado com

Nova versão 10

changes.mady.by.user Luan Davi Ponick

Gravado em

Chave

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

...

Deck of Cards
effectDuration0.5
idcabecalho
effectTypeslide
Card
defaulttrue
effectDuration0.5
idMINHA-PLATAFORMA
labelMINHA PLATAFORMA
titleMINHA-PLATAFORMA
effectTypeslide

costCenters

costCenters.
Deck of Cards
effectDuration0.5
idtudo-sobre
effectTypeslide
Card
effectDuration0.5
idIntroducao
labelIntrodução
titleIntrodução
effectTypeslide

Conteúdo

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

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

Card
defaulttrue
effectDuration0.5
idSobre
labelSobre
titleSobre
effectTypeslide

Escopo

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

Características e Funcionalidades:  

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


Para conhecer mais sobre o Mercado Eletrônico:

Painel
borderStylenone
titleConheça a Plataforma
Column
width500

WEBINAR  

Conector de Widget
width720
urlhttps://www.youtube.com/watch?v=VgVosV3TIlg
height420

Apresentação Webinar - 23062021.pdf


Section

VÍDEOS HOW TO




Card
effectDuration0.5
idConfiguracaoConfigurações Iniciais Datasul
labelConfigurações Iniciais DatasulConfiguração
titleConfigurações Iniciais Datasul
effectTypeslide

Passo a passo de configuração - Datasul

Para utilizar o aplicativo devem ser atendidos os seguintes requisitos.

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

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

O aplicativo está disponível para Android a partir da versão 7.1 na Play Store e para IOS a partir da versão 8 na Apple Store.
Clique na imagem abaixo, referente a sua plataforma, ou utilize o respectivo QR Code para instalá-lo em seu dispositivo.


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 Modified

, inserindo

 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 Modifiede dentro da tela apresentada acessar 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 em Image Modified.

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

Clicar em Image Modified 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 Modified, 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 Modified. Clicar em Image Modified para salvar.

- CADASTRO

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 Modified 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 ModifiedImage Removed

Image ModifiedImage Removed

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

Utilizando como exemplo a Carga de Moeda, para obter o arquivo clicar em 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 vermelha Image Modifiedsão obrigatórias. Após o preenchimento, inserir o arquivo editado na seçã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ã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".


Painel
borderStylenone
titleCarga de dados

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

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

CADASTRO MANUAL PELO PORTAL ME

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

Na tela de Moedas

Painel
borderStylenone
titleCarga de Dados

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

Column
width150

asdasdasdasdasd



Card
effectDuration0.5
idUsuarios e Produtos
labelUsuarios e Produtos
titleUsuarios Produtos
effectTypeslide
effectDuration0.5
idProdutos
label Produtos
titleProdutos
effectTypeslide

Fluxo de Produto

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

Produto Data sul → Mercado eletrônico

Os valores são todos disponibilizados por uma API publica do Data sul ("itemIntegrMePublic") que logo passam pelo aparelho integrador padrão (TOTVS IPASS) para serem devidamente lapidados para serem encaminhados para o Mercado Eletrônico.


Datasul

Tipo

ME


Necessita de algum tratamento no IPASS?

materialOrigin

Char

materialOrigin

origem do material


note

char

note

narrativa/observação


clientGroupId

char

clientGroupId

código do grupo do item


clientGroupDescription

Char

clientGroupDescription

descrição do grupo do item


isGeneric

Lógico

isGeneric

true or false


productIdentificationCode:

type

Char

productIdentificationCode:

type

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


productIdentificationCode:

value

Char

productIdentificationCode:

value

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


description

Char

description

Descrição do item


array de groups


array de groups

Idem para ambos as aplicações, enviar tal qual como foi gerado no payload do ME


manufacturerCode

integer

não existe

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


measurementUnit

Char

measurementUnit

Unidade de Medida


productIdMe

Char

productIdMe

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


clientReferenceProductId

Char

clientReferenceProductId

código do produto no Datasul


clientProductId

Char

clientProductId

código do produto no Datasul


estimatedPrice

Decimal

estimatedPrice

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


complement

Char

complement

descrição complementar


transaction

Integer


1 - inclusão

2 - alteração

3 - exclusão

Não envia ao Mercado eletronico, é apenas para identificar se este produto deve ser incluído, alterado ou excluído no Mercado Eltronico.

isService

Lógico

isService

true or false (estoque ou sem estoque)


status

Lógico

status

true or false (ativo ou não)


Todos esses valores são devidamente criados e configurados no proprio modulo padrao de criação e alteração de produto data sul.

Fluxo de Usuários e Produtos

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

Deck of Cards
effectDuration0.5
idtudo-sobre
effectTypeslide
Card
effectDuration0.5
idProdutos
labelProdutos
titleProdutos
effectTypeslide
Necessita de algum tratamento no De-Para?
Card
effectDuration0.5
idUsuarios e Produtos
labelUsuarios e Produtos
titleUsuarios Produtos
effectTypeslide

Fluxo de Usuários

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


Usuários Data sul → Mercado eletrônico

Os valores são todos disponibilizados pela API publica do Data sul "buyerPublic" que logo passam pelo aparelho integrador

padrão

padrão TOTVS IPASS para serem devidamente

lapidados

traduzidas para só aí serem encaminhados para

o

API buyerPublic do Mercado Eletrônico.

Valores encaminhados do Data sul para o Mercado

eletrônico

eletrônico 

Campo Datasul

Tipo

do

dado

Campo Mercado Eletronico

Descrição do campo

Necessita de algum tratamento no

De-Para

IPASS?

purchasingGroups.

clientPurchasingGroupCode

char

purchasingGroups.

clientPurchasingGroupCode

Código do grupo de compra


purchasingGroups. 

clientPurchasingGroupDescription

char

purchasingGroups.

clientPurchasingGroupDescription

descrição do grupo de compra


profile

char

profile

perfil

o padrao é

“Cadastro” mas

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

languageId

int

languageId

idioma padrão do usuário

Idioma possiveis:

0=

EN/BR

1=English

3=

, English e Spanish

permission

char

permission

permissão do usuário

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

buyerId

char


Ele é o Id do comprador no ME que deverá ser utilizado como pathParam caso seja feita uma atualização (PUT) para ME. Esse campo pode estar vazio (“”) caso o comprador Datasul não tenha sido cadastrado no ME.

No Datasul é um campo char e no ME é um campo do tipo INT, necessário fazer a alteração de tipo no

Jitterbit

TOTVS IPASS.

login

char

login

Login do usuário


isDeactivated

bool

isDeactivated

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


phone

char

phone

número do telefone


contact

char

contact

nome para contato

obrigatório no Jitterbit,

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

name

char

name

nome do usuário

Datasul

Tipo

ME

Descrição


businessOrganizations.

code

char

businessOrganizations.

code

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

businessOrganizations.virtualEntityField

char

businessOrganizations.virtualEntityField

tipo (EMPRESA)

businessOrganizations.description

char

não há necessidade de enviar.

Datasul

Tipo

ME

Descrição

Necessita de algum tratamento no De-Para?


businessOrganizations.

virtualEntityField

char

businessOrganizations.

virtualEntityField

tipo (EMPRESA)


costCenters.

clientCostCenterId

char

costCenters.

clientCostCenterId

código do centro de custo


Todos esses valores são devidamente criados e configurados no proprio modulo padrao de cadastro de usuarios/comprador data sul.

Web Hook

quando é iniciado

Card
defaulttrue
effectDuration0.5
idSuporte
labelSuporte
effectTypeslide

Perguntas Frequentes (FAQs)

Expandir
titleA partir de qual versão poderei utilizar o aplicativo?

A partir da release 12.1.32. Nessa versão foi liberada toda a estrutura do APP, documentos de 1 a 4 apresentando informações próprias dos documentos e demais documentos (inclusive específicos) apresentando informações genéricas (comuns para todos os tipos de documento). Os demais documentos serão disponibilizados conforme a demanda das equipes responsáveis. Para acompanhas as entregas pode ser consultada as seção de novidades da release.

Expandir
titlePara utilizar o aplicativo do MLA terei algum custo extra?

O aplicativo escala sobre a licença I da TOTVS. Grande parte dos nosso clientes já possuem essa licença. Portanto, precisará ser alinhado com o seu ESN (Executivo de Soluções de Negócios) da TOTVS para avaliar se possui licenças disponíveis em seu ambiente, ou se há a necessidade de adquirir mais.

Expandir
titleMeu servidor de aplicação precisa estar disponível na Web?

É necessário expor parte do Datasul na web, e o mais aconselhado é a utilização de um proxy reverso para que possam ser aplicadas políticas de redirecionamento, controle de acesso e aplicação de https. Uma vez que você tenha um proxy basta expor o contexto de APIs ("/api"). Caso queira pode configurar o proxy para aceitar somente requisições com origem do mingle (produto TOTVS que fica na nuvem e faz a comunicação entre o app e o ERP).

Expandir
titleQual o Endereço do servidor REST deve ser configurado no alias do Mingle?

Após habilitar o acesso externo ao contexto de APIs ("/api") do seu ambiente, deverá ser solicitado o alias do Mingle e este deverá apontar para a URL desse contexto de api do seu servidor (ex.: servidor:porta/api).

Expandir
titleQual o meu Usuário e Senha?

Correspondem ao mesmo usuário e senha que você utiliza para fazer acesso no ERP TOTVS (Linha Datasul). Porém, o login integrado (Active Directory), poderá ser usado apenas em ambientes com a arquitetura Datasul For THF (Tomcat), e será preciso atualizar o patch 12.1.32.1. Para utilizar o login integrado basta informar o usuário@domínio no campo de usuário da tela de login.

Expandir
titleÉ possível aprovar documentos específicos no app?

Sim. Inicialmente está liberada a aprovação dos documentos específicos apresentando apenas os campos genéricos. Para utilizar as informações de negócio próprias do documento, será necessário que o cliente desenvolva uma API, para cada tipo de documento específico. Para mais informações, consulte a documentação Disponibilizar documentos para serem aprovados pelo APP - Minhas Pendências de Aprovação.

Expandir
titleJá tenho documentos específicos criados e funcionando na versão Web, precisarei fazer algo pra que funcione no aplicativo?

Sim. A estrutura do aplicativo é diferente e precisará ser desenvolvida uma API exclusiva para ser utilizada nele. Você consegue reaproveitar a lógica de negócio referente à busca das informações, mas precisaria adequá-la para corresponder á estrutura da API para o App. Saiba mais sobre o Mingle.

Expandir
titleErro 500. "TSL Certificate is not trusted." Como resolver?

Quando ocorre este erro significa que o endereço que o cliente expõe o Datasul possui um certificado digital, porém o Mingle não está conseguindo se conectar. Além de ser um middleware, antes de realizar a comunicação com o endereço, ele valida a cadeia do certificado, e se ela no for válido não realizar a comunicação, retornando erro 500.

Para sanar esta situação, é necessária a validação do certificado instalado para que o acesso do Mingle ao ERP possa ser realizado com sucesso.

Para consultar a validade do certificado, pode ser utilizado este endereço: https://www.digicert.com/help/



Materiais Auxiliares

...