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.
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
de Características e Funcionalidades:
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 Compra. Não
as ordens que irão compor os pedidos de compra. Atualmente, não engloba ordem de compra com contrato.
Pedido de Compra
-
Cotações -
Para conhecer mais sobre o App Minhas Pendência de Aprovação:
- O pedido de compra será criado no Mercado Eletrônico como "Pré-Pedido" e virá para o Datasul para aprovação conforme fluxo parametrizado no cliente.
Cotações - As cotações das ordens são todas concentradas no Mercado Eletrônico, justamente 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 - 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 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 de forma segura pelos compradores, aumentando o leque de opções.
Filtros - Grande gama de filtros para personalizar as buscas e resultados.
Mapa Comparativo - Mapa comparativo apresentado no final da rodada da cotação, sugerindo 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 TOTVS
Painel
Multimedia
name
Backoffice Datasul - Suprimentos - Integração com Mercado Eletrônico.mp4
Para utilizar a integração do ERP Datasul com o Mercado Eletrônico, devem ser atendidos os seguintes requisitos:
É necessário que o ERP esteja na release 12.1.2411 ou superior.
Usuário e senha de acesso ao TOTVS (Linha Datasul).
Usuário com permissão no programa "purchOrderLinePublic". As documentações referentes ao cadastro de permissões podem ser consultadas aqui e aqui.
No programa cc0104, ativar o parâmetro "Utiliza Integração ME", localizado na aba "Integrações".
No programa html.cc0301, ao selecionar uma ordem, clicar no botão "Integrar ME" (essa opção só estará disponível se os passos acima forem realizados).
Se for de interesse do usuário utilizar o MLA, ele precisa estar configurado como aprovador e possuir permissão ao menos no documento Pedido de Compra Normal e Emergencial no MLA - Módulo de Aprovação de Documentos. Para saber como configurar o módulo do MLA clique aqui.
Card
effectDuration
0.5
id
Configuracao
label
Configuração
title
Configuração
effectType
slide
Passo a passo de configuração
Para utilizar o aplicativo devem ser atendidos os seguintes requisitos.
É necessário que o ERP esteja na release 12.1.32 ou superior.
Para que o App consiga acessar as APIs do ERP, é necessário que seja atribuído acesso externo ao contexto "api" do servidor.
Deve ser solicitada a criação de um Alias para realizar a autenticação através do Mingle. Esse identificador estará vinculado ao ambiente com o contexto "api" externalizado e para cada ambiente (homologação, produção) haverá um alias de acesso. Saiba mais sobre o Mingle clicando aqui.
Smartphone com Android a partir da versão 7.1 ou Iphone a partir da versão 8.
Acesso à Internet no dispositivo móvel.
Usuário e senha de acesso ao TOTVS (Linha Datasul).
Caso deseje configurar as informações apresentadas no aplicativo para o usuário/documento, de forma diferente do padrão, deve ser utilizado o Configurador Visual do MLA. Veja a documentação aqui.
A partir da release 12.1.34, para o correto funcionamento, é necessário que seja realizada a configuração de um Broker para o App com o respectivo código: 5203 (Código do App Minhas pendências de Aprovação). Veja a documentação sobre o Broker aqui.
Outro pré-requisito é que a propriedade JWT do framework esteja preenchida com a URL deste link. Esta informação deve ser adicionada ao programa "Propriedades JWT" >> campo "URL do certificado (Mingle)".
A partir da release 12.1.33 (vide patch e versão em Novidades da Release - Minhas Pendências de Aprovação), é possível customizar a visualização e download de arquivos anexos aos documentos através de um ponto de EPC. Para habilitar esa funcionalidade, houve um incremento na versão da API que passa a ter a versão = 2. Para visualizar a documentação de implementação da EPC, clique aqui.
*Observação: Caso o aplicativo já esteja configurado, funcionando e seja inclusa uma nova Empresa no ambiente Totvs, é necessária a execução do programa especial spp\lap\spmla001.r através do menu Totvs ("Executar Programa"), para que sejam criadas as Configurações do Aplicativo Minhas Pendências para esta nova empresa. Para isso, o usuário precisa estar logado nesta nova empresa criada.
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.
Tendo todos os pré-requisitos da etapa de configuração atendidos, o aprovador estará apto a efetuar o acesso no aplicativo Minhas Pendências de Aprovação. Abaixo serão apresentadas as funções presentes no app.
Índice
maxLevel
2
minLevel
2
Primeiro Acesso
Ao realizar o primeiro acesso, será apresentada primeiramente a tela de aceite da Política de Privacidade do aplicativo. O aprovador precisa aceitar a política de privacidade para prosseguir.
Image RemovedImage Removed
Após aceitar a política de privacidade o aprovador é direcionado para a tela de login. A tela de política de privacidade não será apresentada novamente em acessos posteriores, a menos que os dados do aplicativo sejam eliminados, pois a informação do aceite fica gravada no dispositivo.
Na tela de login o aprovador deverá informar o usuário e senha usados para acessar o ERP TOTVS (Linha Datasul) e o Alias do Mingle criado para o ambiente que deseja acessar. A opção Lembrar usuário, quando ativada, irá gravar no dispositivo o usuário e alias para que no próximo acesso não seja necessário informá-los novamente. Por motivos de segurança não será gravada a senha de acesso.
Nessa tela há a opção Demonstração que ao ser acionada efetuará o acesso ao aplicativo com dados fictícios, para que seja possível efetuar testes e analisar o comportamento do app, sem a necessidade de conexão a um servidor.
Após preenchidos os dados de login o botão Entrar ficará habilitado para que seja possível efetivar o acesso.
Nota
title
Nota
Para ambientes com a arquitetura Datasul For THF (Tomcat), e a partir da atualização do patch 12.1.32.1, será possível realizar o login com usuário integrado (Active Directory). Para tanto, no aplicativo, deverão ser informados os dados de usuário@domínio (Ex.:itamar.silveira@SPL01) no campo de usuário.
Image RemovedImage Removed
Ao acionar a opção Entrar, é efetuada a busca dos dados necessários para o funcionamento do app, como: dados do usuário, empresas, estabelecimentos e documentos. Bem como é efetuada a busca das pendências de aprovação sob responsabilidade do aprovador. Após isso, será apresentado um rápido tutorial sobre as funcionalidades do app. Ao fim da visualização de todo o tutorial, o aplicativo grava a informação de que o mesmo foi completado, e este não será mais apresentado em acessos posteriores.
Após o tutorial é apresentada a listagem das pendências de aprovação.
Image Removed
Perfil e Configurações
Na tela principal, onde é apresentada a listagem de pendências de aprovação, há uma opção para acessar as informações do perfil conectado e configurações do aplicativo.
Image RemovedImage Removed
Na tela de perfil é apresentado o usuário, nome de usuário e alias utilizados na autenticação. No fim da tela é apresentada a versão do aplicativo no formato "9.9.9-9", onde os dígitos anteriores ao hífen "-" correspondem a versão do aplicativo em si; e o dígito após o hífen corresponde á versão da API que está sendo utilizada. Após a versão do aplicativo é apresentada a opção Sair que efetuará o logout do acesso, retornando o aprovador para a tela de login.
Nessa tela também são apresentadas opções de configurações gerais como:
Empresa Apresenta os grupos de empresas disponíveis para o usuário. Os grupos de empresas são formados por empresas que acessam o mesmo banco de dados. Para o caso onde existem empresas que utilizam bancos de negócio diferentes, é necessário selecionar o grupo de empresa para que seja realizada a troca dos bancos para retornar as informações das empresas correspondentes. Essa funcionalidade é o equivalente ao Troca de Empresa no Portal MLA. Inicialmente o aplicativo utiliza o grupo que contém a última empresa acessada pelo aprovador.
Informações
Para compor os grupos de empresas são buscadas as empresas vinculadas ao usuário no programa Manutenção de Usuário (SEC000AA). Para esse conjunto de empresas é realizada a seguinte verificação:
Arquitetura com JBOSS: são verificadas as informações de conexão do banco de negócio (movind) no Parâmetros Foundation (BTB962AA). Empresas que conectem o mesmo servidor para o banco movind serão agrupadas.
Arquitetura com TOMCAT: é verificado o broker de conexão do Appserver no Parâmetros Foundation (BTB962AA). Empresas que conectam o mesmo broker serão agrupadas.
Image Removed Quantidade de Pendências Nessa opção é possível definir quantas pendências serão buscadas por vez. O valor inicial é 20, o que significa que ao realizar a busca das pendências serão retornados os 20 primeiros registros com base no filtro e ordenação, ao navegar para o final da listagem serão buscados os próximos 20, e assim sucessivamente até que não hajam mais pendências a serem apresentadas. Image Removed Recurso de Deslizar Para aprovar ou reprovar pendências na listagem é possível deslizar o componente para os lados para acionar a ação desejada. Essa opção permite definir o comportamento desse recurso. Image Removed Ajuda Essa opção apresenta o mesmo tutorial apresentado no primeiro acesso após autenticar no aplicativo. Image Removed
Listagem de Pendências
Após a autenticação é realizada a busca das pendências de aprovação no ERP. Essa busca também pode ser feita ao atualizar a listagem (Refresher) deslizando o dedo na tela, puxando a listagem para baixo. Inicialmente serão buscadas as pendências levando em consideração as seguintes regras:
Serão buscadas pendências cujo aprovador logado seja o aprovador principal, alternativo ou mestre da pendência, conforme o que está configurado nas configurações gerais do aprovador no campo Mostrar do programa Configurador Visual MLA (html.configVisualMLA).
São buscadas as pendências de todos os documentos que o mesmo possui permissão ou dos quais assume a permissão dos aprovadores principais.
Nesse momento apenas as pendências de aprovação com situação Pendente serão apresentadas.
Caso nas configurações gerais do aprovador, no programa Configurador Visual MLA (html.configVisualMLA), esteja marcada a opção Apresentar pendências de todas as empresas, serão buscadas as pendências de todas as empresas do grupo de empresas selecionado. Caso contrário, apenas as pendências da última empresa acessada pelo usuário no ERP serão apresentadas.
Será apresentada no topo da tela a quantidade de pendências buscadas, sendo incrementado a cada "página" buscada.
Para cada pendência encontrada será apresentada, na listagem, a sigla do tipo de documento dessa pendência (Ex.: SC para Solicitação de Compra, PE para Pedido de Compra, etc.), a situação da pendência (Pendente, Aprovada, Reprovada ou Reaprovada) e os campos definidos para serem apresentados na listagem. Essa definição dos campos é feita no programa Configurador Visual MLA (html.configVisualMLA) na definição dos layouts por usuário e documento.
Image Removed
Pesquisa Rápida
Na listagem de pendências há a possibilidade de realizar uma pesquisa rápida nos registros que são apresentados em tela. Para isso basta acessar a opção de pesquisa e digitar a informação desejada. Logo após a digitação, serão buscados os registros que possuem essa informação em algum dos campos apresentados.
Image RemovedImage Removed
Ordenar
Com a opção de ordenação é possível buscar as pendências mais recentes, mais antigas, por empresa, por estabelecimento, por tipo de documento, por maior valor ou por menor valor. Conforme a ordenação selecionada, com exceção das ordenações por valor, será apresentado um agrupador correspondente á mesma. Quando ordenado por mais recentes, por exemplo, é apresentado o agrupador "Hoje" com as pendências geradas na data atual, "Este mês" com as pendências geradas em outras datas dentro do mês corrente, e assim por diante.
Quando selecionada uma ordenação diferente da ordenação inicial configurada no programa Configurador Visual MLA (html.configVisualMLA), o botão Ordenar ficará destacado, para que fique visível ao aprovador que foi alterada a ordenação.
Pode-se filtrar as pendências de aprovação pelos seguintes campos:
Empresa: Este campo é preenchido com a lista das empresas pertencentes ao grupo de empresas selecionado. Podem ser filtradas pendências para uma única empresa ou buscar para todas as empresas do grupo de empresas corrente. Inicialmente, caso nas configurações gerais do aprovador, no programa Configurador Visual MLA (html.configVisualMLA), esteja marcada a opção Apresentar pendências de todas as empresas, nesse campo estará selecionada a opção "Todas". Caso contrário, estará selecionada a última empresa acessada pelo usuário no ERP.
Estabelecimento: O preenchimento se dará conforme a opção de empresa selecionada, ou seja, se no campo Empresa for selecionado "Todas", será preenchido com a lista de todos os estabelecimentos que possuem parâmetros de aprovação no MLA e vinculados a todas as empresas do grupo de empresas corrente. Caso estiver selecionada uma empresa, será preenchido com a lista de estabelecimentos vinculados a esta. Inicialmente a opção selecionada será "Todos".
Data de Geração: Faixa de data de geração da pendência. Inicialmente a faixa estará aberta.
Pendências: Nessa opção pode-se selecionar quais pendências apresentar conforme o nível de relação do aprovador para com a mesma. Inicialmente a opção selecionada será conforme o que está configurado nas configurações gerais do aprovador no campo Mostrar do programa Configurador Visual MLA (html.configVisualMLA). As opções são:
Principais: Pendências cujo aprovador conectado é o aprovador principal;
Alternativas: Pendências cujo aprovador conectado é alternativo do aprovador principal;
Como Mestre: Essa opção só aparecerá quando o usuário estiver marcado como Mestre nos Usuários da Aprovação - MLA0103. Quando marcado apresentará pendências em que o aprovador conectado não é principal nem mesmo alternativo, porém tem a permissão de aprovar por ser mestre.
Tipo de Documento: Lista dos documentos permitidos para o aprovador, onde poderá ser configurado quais tipos de documento deseja considerar na busca.
Situação: Poderá ser configurado quais as situações a serem consideradas na busca. As opções são: Pendente, Aprovado, Reprovado, Reaprovado. Inicialmente apenas a opção Pendente estará selecionada.
Quando aplicado um filtro diferente das configurações iniciais, o botão Filtrar ficará destacado, para que fique visível ao aprovador que foi aplicado um filtro diferente.
A opção Limpar Filtros retornará os campos para os valores iniciais.
Image RemovedImage RemovedImage Removed
Detalhamento das pendências
Na tela de listagem ao tocar (pressionar rapidamente) em uma determinada pendência, será apresentada a tela de detalhamento da mesma. A tela possui duas seções padrões: Informações e Histórico. E também uma terceira seção que pode ser implementada via customização (EPC): Anexos.
Informações: Ao abrir a tela de detalhes serão buscadas no ERP as informações de detalhe das pendências, apresentando os campos configurados no programa Configurador Visual MLA (html.configVisualMLA) para o usuário/documento, na seção Detalhes. Para cada campo do tipo Lista será criada uma opção em tela, que ao ser acionada apresentará as informações do próximo nível em uma nova tela, criando uma navegação por níveis de informações. Image RemovedImage RemovedImage Removed
Histórico: Ao clicar nessa seção, serão buscados os históricos da pendência caso a mesma tenha sofrido aprovação ou rejeição anterior, realizada por outro aprovador ou pelo próprio aprovador conectado. Porém, os históricos serão apresentados apenas se a opção Visualiza Narrativa estiver marcada no programa Tipos de Documento - MLA0101. Image Removed
Anexos: Ao clicar nessa seção, será buscada a listagem de anexos do documento. As informações mostradas correspondem a data e hora em que os documentos foram anexados, bem como o nome do arquivo e uma descrição do mesmo. Nesta seção, é possível fazer download do documento ao clicar na opção: Image Removed. Atualmente para habilitar esta seção é necessário fazer a customização através de um ponto de EPC. Para saber como customizar, clique aqui.
Nota
title
Nota
Esta nova aba de Anexos está disponível a partir da versão 2.0.0 do aplicativo e patch 12.1.33.13. Para verificar demais patchs em que está disponível consulte a página Novidades da Release.
Image RemovedImage Removed
Aprovação e Reprovação Individual
Há duas formas de efetuar a aprovação ou rejeição de uma única pendência, são elas:
Deslizar a pendência na listagem: Na tela de listagem das pendências ao deslizar o componente (card) da pendência para o lado, serão apresentadas as ações de aprovar ou reprovar. A ação de cada lado será apresentada conforme o definido nas configurações do Recurso de Deslizar. Image RemovedImage Removed
Ao detalhar a pendência: Na tela de detalhamento da pendência e telas subsequentes que apresentam as informações dos níveis de informação, são apresentadas as opções Reprovar e Aprovar. Image RemovedImage Removed
A opção Reprovar será apresentada apenas para os registros pendentes de aprovação. Já a opção Aprovar será apresentada tanto para registros pendentes de aprovação quanto para rejeitados, pois nesse último caso, a aprovação fará a função de Reaprovar a pendência. A reaprovação no MLA é quando uma pendência foi rejeitada, mas o aprovador a aprova em seguida.
Ao aprovar a pendência será considerado o campo Aprovar sem mostrar tela de motivo de aprovação (exceto Avaliação de Crédito) das configurações gerais do aprovador no programa Configurador Visual MLA (html.configVisualMLA). Caso esse campo esteja marcado a tela de confirmação de aprovação não será apresentada, caso contrário a mesma será apresentada para que o usuário informe o motivo da aprovação. No caso de reprovação, sempre será apresentada a tela de confirmação, visto que o aprovador precisa indicar o código de rejeição.
Nota
title
Nota
Com exceção para os documentos 21 Avaliação de Crédito, que sempre solicitará o motivo e onde é obrigatório informar o motivo da reprovação ou aprovação.
Image RemovedImage RemovedImage Removed
A ação será executada diretamente no ERP, por isso é importante estar conectado a Internet. Será retornada uma mensagem de sucesso, caso seja possível executar a operação, do contrário apresentará um erro.
Image RemovedImage Removed
Aprovação e Rejeição em Lote
Na tela de listagem de pendências é possível aprovar e rejeitar várias pendências de uma só vez. Para isso, basta selecionar as pendências desejadas pressionando o componente (card) por alguns segundos. Após a primeira pendência selecionada dessa forma, será habilitado o modo de aprovação em lote, sendo assim as próximas pendências podem, também, ser selecionadas apenas com um toque. Quando a tela está nesse modo é apresentado um rodapé com os seguintes elementos:
Opção de desfazer: permite voltar a tela para o modo normal, removendo a seleção dos itens;
Contador: Apresenta a quantidade de pendências selecionadas;
Valor Total: Apresenta a soma dos valores das pendências selecionadas. O valor será apresentado na moeda configurada para o usuário no programa Usuários da Aprovação - MLA0103;
Reprovar: Opção para realizar a reprovação das pendências selecionadas. A ação terá o mesmo comportamento da reprovação individual;
Aprovar: Opção para realizar a aprovação das pendências selecionadas. A ação terá o mesmo comportamento da aprovação individual. Image RemovedImage RemovedImage Removed
Suportabilidade
Nota
title
Nota
A partir da versão 1.1.0 foram disponibilizadas ações para acesso direto a documentação e compartilhamento do arquivo de log do aplicativo.
A tela de login apresenta a opção Configurações que ao ser acionada apresentará uma tela com as opções Documentação e Compartilhar log. Estas opções também estão disponíveis nas ConfiguraçõesGerais do usuário após o login no aplicativo. A opção Documentação irá acessar a página de documentação com todas as informações do aplicativo. Essa página será aberta como uma nova guia no navegador do dispositivo.
Image RemovedImage RemovedImage Removed
A opção Compartilhar log, quando acionada, abrirá o compartilhamento do arquivo de log do aplicativo. Esse arquivo, gerado com o nome minhas-pendencias-aprovacao.log, conterá o monitoramento das últimas ações realizadas no aplicativo, e poderá ser compartilhado com a equipe de suporte em caso de inconsistência.
O arquivo conterá informações no formato JSON, podendo ser copiado seu conteúdo para um visualizador JSON, afim de identificar as ações monitoradas pelo log.
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:
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 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 manualmentecondiçõ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 manualmenteunidades 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 Addedpara 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 íconeImage Addedlocalizado no menu superior. Na opção deWorkflow, acessar"Importação/ Exportação Cargas".
Na tela de Cargas, é possível ver seu histórico de cargas, ou seja, todas as ações relacionadas a carga que foram feitas pelos usuários do mesmo ambiente. São apresentadas informações sobre cada carga: seu ID, quem solicitou, o início do processamento, o final do processamento, o status (se foi processado com sucesso ou houve algum erro) bem como a opção de baixar a carga. O ícone no lado esquerdo de cada linha também muda de cor conforme o status da carga (verde pra sucesso, vermelho pra erro) e a posição da seta indica se foi uma importação ou exportação.
Image Added
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ãoImage Added,Image AddedeImage Added.
Utilizando como exemplo aCarga 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 asconfiguraçõ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
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
locationName
Id do “local” no Datasul
address
address
Endereço (Rua) do estabelecimento
city
city
Cidade onde encontra-se o estabelecimento
postalCode
postalCode
CEP do estabelecimento
adressNumber
adressNumber
Número do endereço do estabelecimento
clientLocationId
clientLocationId
Id do estabelecimento no Datasul
neighborhood
neighborhood
Bairro do estabelecimento
locationId
Ele é o Id do local no ME que deverá ser utilizado como pathParam caso seja feita uma atualização (PUT) para ME. Esse campo pode estar vazio (“”) caso o local Datasul não tenha sido cadastrado no ME
transaction
1 - inclusão/2 - alteração/3 - exclusão
Não envia ME, é apenas para identificar se este estabelecimento deve ser incluído, alterado ou excluído no ME
locationType
DeliveryPlace e BillingPlace
Esse campo não virá preenchido na API do Datasul 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
Necessita de algum tratamento na ferramenta de integração?
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
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
Os dados do fornecedor são todos disponibilizados por uma API publica do Datasul ("supplierIntegrMePublic") que logo passam pela ferramenta de integração para serem devidamente traduzidos e então encaminhados para a API ("suppliers") do Mercado Eletrônico.
Valores encaminhados do Datasul para o Mercado Eletrônico (supplierIntegrMePublic)
Campo Datasul
Campo Mercado Eletrônico
Descrição do campo
Necessita de algum tratamento na ferramenta de integração?
tradingName
tradingName
Nome comercial
country
country
País do fornecedor
No Datasul country é um campo escrito por extenso, porém no ME é salvo em sigla.
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
address
Endereço do fornecedor
isDesactivated
isDesactivated
Informa se o fornecedor está desativado
city
city
Cidade do fornecedor
companyName
companyName
Nome completo do fornecedor
postalCode
postalCode
CEP
stateRegistrationNumber
stateRegistrationNumber
Número da inscrição estadual
languageId
languageId
Idioma do fornecedor
phoneNumber [{ }]
phoneNumber
Número de telefone para contato
No ME o campo “phoneNumber” ele é apenas um campo STRING enquanto no Datasul ele é um array, então para solucionar esse problema, 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
addressNumber
Número do endereço
state
state
Estado
neighborhood
neighborhood
Bairro
clientSupplierId
clientSupplierId
Id do fornecedor no Datasul
transaction
1 - inclusão
2 - alteração
3 - exclusão
Não envia ME, é apenas para identificar se este produto deve ser incluído, alterado ou excluído no ME
email
email
E-mail
Campo obrigatório no ME. Se estiver em branco no Datasul, colocar no payload como “Não Informado”
document: Array[ ]
Campo Datasul
Campo Mercado Eletrônico
Descrição do campo
Necessita de algum tratamento na ferramenta de integração?
number
number
Número do documento
type
type
Tipo do documento (CNPJ ou CPF)
accounts: Array[ ]
Campo Datasul
Campo Mercado Eletrônico
Descrição do campo
Necessita de algum tratamento 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
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 fornecedores (Datasul → ME) o Mercado Eletrônico enviará informações de como está o andamento da integração com o Datasul através da tecnologia de WebHook do Mercado Eletrônico. Os dados referentes ao status do cadastro do fornecedor ficarão gravados em uma tabela no Datasul e também caso ocorra algum erro de integração é possível configurar a ferramenta de integração para que os envolvidos recebam avisos e possam providenciar as devidas ações para normalizar possíveis problemas que possam acontecer.
Existe uma rastreabilidade entre os códigos do Datasul e o Mercado Eletrônico que permite fazer um de-para de cadastro nas ferramentas.
De-para da tabela de Status da Integração Datasul → ME
Campo Datasul
Conteúdo payload
Necessita de algum tratamento na ferramenta de integração?
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 asconfigurações iniciais.
O cadastro do item é feito diretamente no Datasul via CD0204 e as informações são encaminhadas para o Mercado Eletrônico. Para mais informações referente a inclusão, modificação e cópia de itens, acesse: Manufatura - Linha Datasul - MEN - Fluxo de cadastro de um novo item.
Produto Datasul → Mercado eletrônico
Os dados do produto são todos disponibilizados por uma API publica do Datasul ("itemIntegrMePublic") que logo passam pela ferramenta de integração para serem devidamente traduzidos para serem encaminhados para a API ("products") do Mercado Eletrônico.
Datasul
ME
Descrição
Necessita de algum tratamento na ferramenta de integração?
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
Descrição complementar
isService
isService
true or false (estoque ou sem estoque)
status
status
true (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 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 na 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 iniciar o fluxo de usuário, deve ter finalizado por completo as configurações iniciais.
O cadastro do usuário é feito diretamente no Datasul via CD1700 e as informações são encaminhadas para o Mercado Eletrônico. Para mais informações referente a manutenção de usuários, acesse: Manutenção de Usuário de Materiais - CD1700.
Apenas os usuários que são compradores tem os cadastros enviados para o Mercado Eletrônico e por consequência o login criado na ferramenta.
Por padrão, os logins são criados como liberados e ativos no ME.
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
Necessita de algum tratamento na ferramenta de integração?
purchasingGroups
purchasingGroups.
clientPurchasingGroupCode
purchasingGroups.
clientPurchasingGroupCode
Código do grupo de compra
purchasingGroups.
clientPurchasingGroupDescription
purchasingGroups.
clientPurchasingGroupDescription
Descrição do grupo de compra
role
role
Função
O padrão é “Geral”, mas pode ser alterado dependendo da configuração do usuário.
integrationTag
integrationTag
ID cadastrado no Datasul como comprador que será gravado como usuário de integração no Mercado Eletrônico
profile
profile
Perfil
O padrão é “Cadastro” mas pode ser alterado dependendo da configuração do usuário.
languageId
languageId
Idioma padrão do usuário
Idioma possíveis: Português, Inglês e Espanhol.
permission
permission
Permissão do usuário
O padrão é “Geral”, mas pode ser alterado dependendo da configuração do usuário.
buyerId
buyerId
ID do comprador (ME)
login
login
Login do usuário
isDeactivated
isDeactivated
Indica se o usuário está ativo ou não.
phone
phone
Número do telefone
contact
contact
Nome para contato
Se vier em branco do Datasul, colocar no payload como “Não informado”.
name
name
Nome do usuário
businessOrganizations
businessOrganizations.
code
businessOrganizations.
code
Códigos das empresas as quais o usuário é vinculado
businessOrganizations.
virtualEntityField
businessOrganizations.
virtualEntityField
Tipo (EMPRESA)
email
email
E-mail
É um campo obrigatório no Mercado Eletrônico, caso não seja informado no Datasul é necessário incluir como "Não informado".
costCenters
costCenters.
clientCostCenterId
costCenters.
clientCostCenterId
Código do centro de custo
Todos esses valores são devidamente criados e configurados no próprio modulo padrão de cadastro de usuários/comprador Datasul.
Atualização de status
Em todo o processo de cadastro de usuário (Datasul → ME) o Mercado Eletrônico mandará informações de como está o andamento da integração com o Datasul através da tecnologia de WebHook do Mercado Eletrônico. E com isso, passará por uma tradução dos dados do status do cadastro do usuário pela ferramenta de integração.
Nome Campo Dtsul
Conteúdo Payload
Necessita de algum tratamento na ferramenta de integração?
itemIdME
código do produto criado no ME
Conversão de tipos de dados
status
codigo do status de como foi a transacão no ME,
1 → em processamento no mercado eltrônico,
2 → executado sem erros
3 → executado com erros
processMessage
informações de erros e caso esteja vazio, significa que a integração ocorreu sem erros
lastUpdateDatetime
Data/hora atual
Card
effectDuration
0.5
id
Ordens de Compra
label
Ordens de Compra
title
Ordens de Compra
effectType
slide
Fluxo de Ordem de Compra
Para iniciar o fluxo de ordens de compra, é necessário ter finalizado os demais fluxos de cadastros e configurações iniciais.
A ordem de compra é o primeiro documento do fluxo de compra que integra com o Mercado Eletrônico.
O fluxo se inicia no Datasul onde é criada a solicitação de compra e a partir desta é gerada a Ordem de Compra. É a ordem de compra que será enviada ao Mercado Eletrônico que dará início ao processo de cotação.
Envio das Ordens de Compra ao Mercado Eletrônico
Se realizadas as configurações iniciais conforme descrito nesta documentação, o usuário terá disponível no programa html.cc0301, a opção “Integrar ME”.
Tendo disponível esta opção, basta marcar as ordens de compra que deseja enviar para o ME e após, clicar em “Integrar ME”.
Image Added
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
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
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
Necessita de algum tratamento na ferramenta de integração?
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.
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 uma ferramenta de 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
Qual o meu Usuário e Senha?
As credenciais de acesso ao 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.
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 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
title
Para 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
title
Meu 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
title
Qual 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
title
Qual 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.
Já 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
title
Erro 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
