Base de Conhecimentos da DataPlus Sistemas - Contribuições do usuário [pt-br]

RN AvisoNotaRecebimentoRemessaEmAberto

2026-11-03T14:50:03Z

Samuel: adicionada pagina da regra

Regra de negócio do tipo Habilitadora que pode ser acoplada ao DataPlus ERP e tem por objetivo habilitar o monitoramento e a geração de avisos sobre notas de recebimento de remessa com quantidades pendentes de retorno ou devolução.

== Acoplamento ==
Essa regra de negócio deve ser acoplada ao formulário de [[Controle de Avisos]] (Infra.ControleAvisos). Ela esta preparada para funcionar com designador '''Execucao''' em conjunto com o elemento '''ProcessaAvisos''', no tempo de execução '''Antes'''.

== Parâmetros ==
'''GeraAvisosRepetitivos''': Se verdadeiro, habilita a geração de avisos em todos os ciclos de processamento, inclusive mais de uma vez no mesmo dia. Se falso, limita o processamento a uma vez por dia;

'''CodigosUsuario''': Lista de códigos dos usuários que receberão os avisos, separados por vírgula;

'''DiasEmAberto''': Quantidade de dias decorridos desde a data de emissão da nota para gerar o aviso. Informe 0 para considerar as notas até a data atual, sem aguardar dias adicionais. São consideradas somente notas do tipo Recebimento de Remessa que possuam itens com quantidade pendente de retorno ou devolução.

RN Gnre GeraDocumento

2026-10-30T18:30:36Z

Samuel: /* Parâmetros */

Regra de negócio do tipo Habilitadora que pode ser acoplada ao [https://wiki.dataplussistemas.com.br/DataPlus_ERP DataPlus ERP] e tem por objetivo gerar documentos e vinculá-los automaticamente às notas selecionadas para a emissão de uma GNRe.

== Acoplamento ==
Essa regra de negócio só poder acoplada à entidade DataPlus.Sistemas.GNREns.Gnre. Ela está preparada para funcionar com o elemento '''grava()''', sendo seu designador por '''Execução''' e tempo de execução '''Depois'''.

== Parâmetros ==
'''GerarApenasUmDoc:''' Define se o sistema deve gerar apenas um documento consolidado para todas as guias selecionadas.

'''QtdeDiasVencto:''' Define a quantidade de dias a serem adicionados na data de emissão para calcular o vencimento (utilizado em caso de agrupamento).

'''FornecedorCodigo:''' Define o código do Parceiro Fornecedor a ser considerado na criação do documento.

'''ClassificacaoCodigo:''' Define o código da Classificação financeira a ser considerada na criação do documento.

'''ClassificacaoJurosCodigo:''' Define o código do Juros a ser considerado na criação do documento.

'''DivisaoCodigo:''' Define o código da Divisão a ser considerada na criação do documento.

'''CentroCustoCodigo:''' Define o código do Centro de Custo a ser considerado na criação do documento.

'''PortadorCodigo:''' Define o código do Portador a ser considerado na criação do documento.

'''SituacaoCodigo:''' Define o código da Situação a ser atribuída ao documento no momento da criação.

Mercado Livre

2026-09-23T18:32:24Z

Samuel: /* 1° Passo - Criar um aplicativo */

Passo a passo de como utilizar a API do Mercado Livre.

Fluxo de notas no Mercado Livre:
[[Arquivo:Fluxo notas Mercado Livre.png|centro|commoldura]]
 

'''Obs: O aplicativo criado para o Mercado Livre, será o mesmo para o Mercado Pago''' 
Url de teste do webhook a ser informada em '''URL de retornos de chamada de notificação''': https://ws32.dataplussistemas.com.br/DataPlusERP.svc/ProcessNotificationMLFull
 

Para ambiente de produção, deve ser usado a URL do cliente.

== 1° Passo - Criar um aplicativo ==

Acessar Link: https://developers.mercadolivre.com.br/devcenter 

[[Arquivo:Criar nova aplicação ML.png|centro|commoldura]] 

Informar os dados básicos da aplicação:

[[Arquivo:Informacoes basicas.png|centro|commoldura]]

A URL de redirecionamento deve ser esta https://ws32.dataplussistemas.com.br/DataPlusERP.svc/AuthorizationMercadoLivre e as permissões as seguintes

[[Arquivo:Url de redirect.png|centro|commoldura]]

[[Arquivo:Permissoess.png|centro|commoldura]]
 

Selecionar todos os tópicos disponíveis na aplicação, e no campo url de retornos de chamada de notificação, insira o seguinte URL: https://ws32.dataplussistemas.com.br/datapluserp.svc/processnotificationmlfull: 
[[Arquivo:Topicoss.png|centro|commoldura]]

== 2° Passo - Solicitar o Token de liberação ==

Acessar a aplicação, e coletar o '''ID do aplicativo e a Chave Secreta''' 
[[Arquivo:Credenciais aplicativos ML.png|centro]]

 

Inserir no menu de configuração de integração, no seguinte campo:
[[Arquivo:Integracao ecommerce ml.png|centro|commoldura]]
 Após isso, clicar em Gerar Token Autorização, após isso, será redirecionado para a seguinte página, clique em autorizar:

[[Arquivo:Autorizacao Mercado Livre.png|centro|commoldura]]
Após isso, será redirecionado para algo semelhante a isso:
[[Arquivo:Okdeucerto.png|centro|commoldura]]

o "ok" indica que o processo funcionou como esperado, após isso retorne para o ERP, no formulário de configuração, na aba Mercado Livre, no campo Caminho Credenciais, insira o destino onde será salvo o arquivo com as credenciais do token, preferencialmente em '''AppData/Local''':
[[Arquivo:Configuraçao2.png|centro|commoldura]]

== 3° Passo - Solicitar o Access Token ==

Após configurado o destino, basta ir até o ERP, no formulário de configurações de integração para solicitar o '''Access Token''' 

Pronto para solicitar o token de Acesso: 
[[Arquivo:Menu config tokens.png|centro|commoldura]]

 

 

Após a mensagem de sucesso, será criado um XML contendo as credenciais de acesso a API na pasta '''AppData/Local''' do usuário chamado ApiConfig.: 
[[Arquivo:XML da credenciais ML.png|centro]]

== Requisitos para funcionamento correto do recurso ==

1° - Cadastrar a própria empresa como parceiro fornecedor.

2° - Cadastrar a Ebazar como cliente e transportadora com as seguintes informações:

CNPJ: 03.007.331/0121-58
Inscrição Estadual (IE): 312.210.513.110
Razão Social: EBAZAR.COM.BR LTDA

Endereço:
Rua: Rod. Pres. Tancredo de Almeida Neves
Número: 45
Bairro: Parque Santa Delfa
Cidade: Franco da Rocha
Estado: SP
CEP: 07809-105

3° - Indicar o CFOP de retorno de materiais em que a Operação Fiscal esteja informada como '''Retorno'''.

4° - Cadastrar o ID Externo das condições de pagamento conforme descrito abaixo:
01 - Dinheiro
02 - Cheque
03 - Cartão de Crédito
04 -Cartão de Débito
05 - Crédito Loja
10 - Vale Alimentação
11 - Vale Refeição
12 - Vale Presente
13 - Vale Combustível
15 - Boleto Bancário
90 - Sem Pagamento
99 - Outros
16 - Depósito Bancário
17 - Pagamento Instantâneo (PIX)
18 - Transferência Bancária, Carteira Digital
19 - Programa de Fidelidade, Cashback, Crédito Virtual

5° - Configurar os parâmetros necessários no formulário de configuração de integração.

6° - Cadastrar os produtos que serão vendidos no marketplace.

7° - Acoplar a regra [[RN_BaixaDuplicata_Movimento]].

A aplicação está pronta para ser consumida.

== Erros Comuns ==

Pode ser que ao tentar autenticar o aplicativo, aconteça alguns erros

'''1° Não foi possível conectar o aplicativo a conta'''
 

[[Arquivo:Mercado Livre - Não foi possível conectar o aplicativo.png|centro|Mercado Livre - Não foi possível conectar o aplicativo]]
 

'''2° Utilizar o token do cliente internamente'''
 

É comum utilizarmos o token do cliente em testes internos, mas isso exige cautela. Como o token possui validade limitada, se o ERP identificar que ele expirou, realizará a renovação automática, o que invalidará o acesso no ambiente do cliente. Portanto, antes de testar, verifique o tempo de expiração; caso esteja próximo do vencimento, aguarde a renovação pelo próprio servidor do cliente.

Última atualização: 08/04/2026 10:00

[[index.php?title=Categoria:Interna]]

Arquivo:Menu config tokens.png

2026-09-23T18:25:12Z

Samuel:

Arquivo:Configuraçao2.png

2026-09-23T18:22:29Z

Samuel:

config

Arquivo:Okdeucerto.png

2026-09-23T18:13:50Z

Samuel:

deucerto

Arquivo:Autorizacao Mercado Livre.png

2026-09-23T18:11:25Z

Samuel:

aut

Arquivo:Integracao ecommerce ml.png

2026-09-23T18:10:17Z

Samuel:

Arquivo:Topicoss.png

2026-09-23T17:42:00Z

Samuel:

Topicos

Arquivo:Permissoess.png

2026-09-23T17:41:30Z

Samuel:

Permissoes

Arquivo:Url de redirect.png

2026-09-23T17:35:08Z

Samuel:

Url de redirect

Arquivo:Informacoes basicas.png

2026-09-23T17:30:37Z

Samuel:

Informacoes basicas

RN Aviso PedidoCompraNaoEntregue

2026-09-21T11:49:29Z

Samuel: /* Parâmetros */

Regra de negócio do tipo Habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem por objetivo habilitar o monitoramento e geração de avisos, a cada dia, sobre quais [[Pedido de Compra]] que não foram entregues.

== Acoplamento ==
Essa regra de negócio deve ser acoplada ao formulário de [[Controle de Avisos]] (Infra.ControleAvisos). Ela esta preparada para funcionar com designador '''Execucao''' em conjunto com o elemento '''ProcessaAvisos''', no tempo de execução '''Antes'''.

== Parâmetros ==
'''GeraAvisosRepetitivos:''' Se verdadeiro, habilita a geração de avisos mais de uma vez no mesmo dia. (Em produção, manter este parâmetro desmarcado);

'''UsuarioParaNotificacao:''' Código do usuário que receberá a notificação dos avisos;

'''DiasAntecedenciaDataEntrega:''' Quantidade de dias antes da data de entrega para gerar o aviso. Informe 0 para não acionar.;