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

https://wiki.dataplussistemas.com.br/api.php?action=feedcontributions&feedformat=atom&user=Vinicius Base de Conhecimentos da DataPlus Sistemas - Contribuições do usuário [pt-br] 2026-08-04T20:51:53Z Contribuições do usuário MediaWiki 1.45.3 https://wiki.dataplussistemas.com.br/index.php?title=Erros_Comuns_-_Apps_Mobile&diff=17187 Erros Comuns - Apps Mobile 2026-07-24T12:41:32Z

<p>Vinicius: </p> <hr /> <div>== 🛑 The Operation Has Timed Out ==<br /> O aplicativo móvel exibe um alerta de estouro de tempo limite (<code>Timeout</code>) ao tentar se comunicar com o backend/API.<br /> <br /> Reinicie o serviço do '''IIS''' (''Internet Information Services'') no servidor web correspondente.<br /> [[Arquivo:Timed Out App.png|nenhum|miniaturadaimagem]]<br /> <br /> == 🛑 SERVICE_NOT_AVAILABLE (FCM) ==<br /> Verificar a conexão com a internet no dispositivo, ou se a rede/firewall está bloqueando as portas do Firebase/Google.</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Erros_Comuns_-_Apps_Mobile&diff=17143 Erros Comuns - Apps Mobile 2026-07-21T19:59:17Z

<p>Vinicius: </p> <hr /> <div>== 🛑 The Operation Has Timed Out ==<br /> O aplicativo móvel exibe um alerta de estouro de tempo limite (<code>Timeout</code>) ao tentar se comunicar com o backend/API.<br /> <br /> Reinicie o serviço do '''IIS''' (''Internet Information Services'') no servidor web correspondente.<br /> [[Arquivo:Timed Out App.png|nenhum|miniaturadaimagem]]<br /> <br /> == 🛑 SERVICE_NOT_AVAILABLE (FCM) ==<br /> Verificar a conexão com a internet no dispositivo, se o emulador possui '''Google Play Store/APIs''' instaladas ou se a rede/firewall está bloqueando as portas do Firebase/Google.</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Erros_Comuns_-_Apps_Mobile&diff=17142 Erros Comuns - Apps Mobile 2026-07-21T19:58:56Z

<p>Vinicius: </p> <hr /> <div>== 🛑 The Operation Has Timed Out ==<br /> O aplicativo móvel exibe um alerta de estouro de tempo limite (<code>Timeout</code>) ao tentar se comunicar com o backend/API.<br /> <br /> Reinicie o serviço do '''IIS''' (''Internet Information Services'') no servidor web correspondente.<br /> [[Arquivo:Timed Out App.png|nenhum|miniaturadaimagem]]<br /> <br /> == 🛑 SERVICE_NOT_AVAILABLE (<code>F</code><code>CM</code>) ==<br /> Verificar a conexão com a internet no dispositivo, se o emulador possui '''Google Play Store/APIs''' instaladas ou se a rede/firewall está bloqueando as portas do Firebase/Google.</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Sum%C3%A1rio_Apps_Mobile&diff=17113 Sumário Apps Mobile 2026-07-20T18:00:18Z

<p>Vinicius: </p> <hr /> <div>== Projetos Mobile: ==<br /> * 📱 [[Força de Vendas ERP]]<br /> * 📱 [[App Reabastecimento]]<br /> * 📱 [[App Produção]]<br /> * 📱 [[DataPlus ERP Mobile]]<br /> * 📱 [[App Cargas]]<br /> <br /> == Guias Técnicos: ==<br /> * 🚀 [[Guia de Geração de Versão: Mobile (Android e iOS)|Geração de Versão (Android e iOS)]]<br /> * ℹ️ [[Informacoesapps|Informações Gerais sobre os App]]<br /> <br /> == Suporte: ==<br /> <br /> * [[Erros Comuns - Apps Mobile]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Sum%C3%A1rio_Apps_Mobile&diff=17112 Sumário Apps Mobile 2026-07-20T17:59:56Z

<p>Vinicius: </p> <hr /> <div>== Projetos Mobile: ==<br /> * 📱 [[Força de Vendas ERP]]<br /> * 📱 [[App Reabastecimento]]<br /> * 📱 [[App Produção]]<br /> * 📱 [[DataPlus ERP Mobile]]<br /> * 📱 [[App Cargas]]<br /> <br /> == Guias Técnicos: ==<br /> * 🚀 [[Guia de Geração de Versão: Mobile (Android e iOS)|Geração de Versão (Android e iOS)]]<br /> * ℹ️ [[Informacoesapps|Informações Gerais sobre os App]]<br /> <br /> == Suporte Problemas ==<br /> <br /> * [[Erros Comuns - Apps Mobile]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Erros_Comuns_-_Apps_Mobile&diff=17111 Erros Comuns - Apps Mobile 2026-07-20T17:57:12Z

<p>Vinicius: Criou página com '== The Operation has Timed Out == Basta reiniciar o web-service no IIS miniaturadaimagem'</p> <hr /> <div>== The Operation has Timed Out ==<br /> Basta reiniciar o web-service no IIS<br /> [[Arquivo:Timed Out App.png|nenhum|miniaturadaimagem]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Arquivo:Timed_Out_App.png&diff=17110 Arquivo:Timed Out App.png 2026-07-20T17:55:07Z

<p>Vinicius: </p> <hr /> <div>Timed Out App</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Sum%C3%A1rio_Apps_Mobile&diff=17109 Sumário Apps Mobile 2026-07-20T17:47:49Z

<p>Vinicius: </p> <hr /> <div>== Projetos Mobile: ==<br /> * 📱 [[Força de Vendas ERP]]<br /> * 📱 [[App Reabastecimento]]<br /> * 📱 [[App Produção]]<br /> * 📱 [[DataPlus ERP Mobile]]<br /> * 📱 [[App Cargas]]<br /> <br /> == Guias Técnicos: ==<br /> * 🚀 [[Guia de Geração de Versão: Mobile (Android e iOS)|Geração de Versão (Android e iOS)]]<br /> * ℹ️ [[Informacoesapps|Informações Gerais sobre os App]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Sum%C3%A1rio_Apps_Mobile&diff=17105 Sumário Apps Mobile 2026-07-20T14:39:55Z

<p>Vinicius: </p> <hr /> <div>== '''Projetos Mobile:''' ==<br /> * 📱 [[Força de Vendas ERP]]<br /> * 📱 [[App Reabastecimento]]<br /> * 📱 [[App Produção]]<br /> * 📱 [[DataPlus ERP Mobile]]<br /> * 📱 [[App Cargas]]<br /> == '''Guias Técnicos:''' ==<br /> * 🚀 [[Guia de Geração de Versão: Mobile (Android e iOS)|Geração de Versão (Android e iOS)]]<br /> * ℹ️ [[Informacoesapps|Informações Gerais sobre os App]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Sum%C3%A1rio_Apps_Mobile&diff=17103 Sumário Apps Mobile 2026-07-20T14:37:06Z

<p>Vinicius: </p> <hr /> <div>== '''Projetos Mobile:''' ==<br /> * 📱 Força de Vendas ERP<br /> * 📱 App Reabastecimento<br /> * 📱 App Produção<br /> * 📱 DataPlus ERP Mobile<br /> * 📱 App Cargas<br /> == '''Guias Técnicos:''' ==<br /> * 🚀 Geração de Versão (Android e iOS)<br /> * ℹ️ Informações Gerais sobre os App</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Sum%C3%A1rio_Apps_Mobile&diff=17102 Sumário Apps Mobile 2026-07-20T14:35:38Z

<p>Vinicius: </p> <hr /> <div>== '''Projetos Mobile:''' ==<br /> <br /> ** 📱 Força de Vendas ERP<br /> ** 📱 App Reabastecimento<br /> ** 📱 App Produção<br /> ** 📱 DataPlus ERP Mobile<br /> ** 📱 App Cargas<br /> <br /> == '''Guias Técnicos:''' ==<br /> <br /> ** 🚀 Geração de Versão (Android e iOS)<br /> ** ℹ️ Informações Gerais sobre os App</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Sum%C3%A1rio_Apps_Mobile&diff=17101 Sumário Apps Mobile 2026-07-20T14:25:00Z

<p>Vinicius: Criação do Sumário de Aplicativo Mobiles</p> <hr /> <div>Sumário para os aplicativos Mobile<br /> <br /> Força de Vendas ([[Força de Vendas ERP]])<br /> <br /> Reabastecimento ([[App Reabastecimento]])<br /> <br /> Produção ([[App Produção]])<br /> <br /> ERP Mobile ([[DataPlus ERP Mobile]])<br /> <br /> Cargas ([[App Cargas]])<br /> <br /> <br /> Geração de versão ([[Guia de Geração de Versão: Mobile (Android e iOS)]])<br /> <br /> <br /> Informações sobre os Apps ([[Informacoesapps]])</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=For%C3%A7a_de_Vendas_ERP_Desemvolvimento&diff=17100 Força de Vendas ERP Desemvolvimento 2026-07-20T14:13:37Z

<p>Vinicius: Vinicius moveu Força de Vendas ERP Desemvolvimento para Guia de Geração de Versão: Mobile (Android e iOS): Remover o conteúdo do arquivo doc e deixar na página do Wiki e atualizar o conteúdo</p> <hr /> <div>#REDIRECIONAMENTO [[Guia de Geração de Versão: Mobile (Android e iOS)]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=RN_Integracao_Shopee_v2&diff=17092 RN Integracao Shopee v2 2026-07-20T11:50:46Z

<p>Vinicius: </p> <hr /> <div>Regra de negócio do tipo habilitadora, acoplável ao DataPlus ERP, com o objetivo de configurar e manipular a integração entre a API da Shopee (versão 2) e o DataPlusERP. Ela pode ser acessada por meio da tela de integração do sistema.<br /> <br /> Para a versão 2 da API da Shopee, foi incluído um novo processo de autenticação de usuário/aplicativo.<br /> <br /> == Acoplamento ==<br /> Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos. Ela está preparada para funcionar com o elemento '''ExecutaOperacao''', sendo seu designador por '''Execução''' e tempo de execução '''Depois'''.<br /> <br /> == Parâmetros ==<br /> '''UrlEcommerce:'''<br /> <br><br /> <br /> URL de homologação -> https://openplatform.sandbox.test-stable.shopee.sg<br /> <br><br /> <br /> URL de produção -> https://openplatform.shopee.com.br<br /> <br /> '''UrlAutorizacao:'''<br /> <br><br /> <br /> URL de homologação -> https://partner.test-stable.shopeemobile.com<br /> <br><br /> <br /> URL de produção -> https://openplatform.shopee.com.br<br /> <br /> <br /> '''PartnerId:''' Partner ID (Identificador do aplicativo da Shopee);<br /> <br /> '''PartnerKey:''' Partner Key (Chave Secreta do aplicativo da Shopee);<br /> <br /> '''ShopId:''' ID da Loja Shopee (ShopID);<br /> <br /> '''NumeroListaPrecoProdutos:''' Lista de Preços para realizar o envio dos produtos para o web service;<br /> <br /> '''EmpresaReceptora:''' Empresa em que o pedido será integrado.<br /> <br /> '''QtdeEstoque:''' Quantidade de estoque fixa a ser enviada. Se for zero ou vazio, enviará o estoque atual individual de cada produto.<br /> <br /> '''CodigoStatusPedido:''' Código de status do pedido (do e-commerce) a ser considerado na busca de dados (Ex.: READY_TO_SHIP);<br /> <br /> '''SituacaoCodigo:''' Código da situação padrão para a gravação dos pedidos;<br /> <br /> '''PortadorCodigo:''' Código do portador padrão para a gravação dos pedidos;<br /> <br /> '''CondicaoPagto:''' Código da condicao de pagamento padrão para a gravação dos pedidos;<br /> <br /> '''TransportadoraCodigo:''' Código da transportadora padrão para a gravação dos pedidos;<br /> <br /> '''OpSaidaCodigo:''' Código da operação de saída padrão para a gravação dos pedidos;<br /> <br /> '''RepresentanteCodigo:''' Código do representante padrão para a gravação dos pedidos;<br /> <br /> '''TelevendasCodigo:''' Código do televendas padrão para a gravação dos pedidos;<br /> <br /> '''CaracteristicaCodigo:''' Código da característica de venda padrão para a gravação dos pedidos;<br /> <br /> '''DiasPrazoEntrega:''' Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);<br /> <br /> '''TipoFrete:''' Tipo de frete;<br /> <br /> '''StatusCliente:''' Código do status de pessoa para clientes trazidos do e-commerce;<br /> <br /> '''RamoAtividadeCodigo:''' Código do ramo de atividade padrão para a gravação dos clientes;<br /> <br /> '''DefinirEnqFiscal:''' Define o enquadramento fiscal do cliente ao integrá-lo;<br /> <br /> '''EnqFiscalPessoaFisica:''' Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;<br /> <br /> '''EnqFiscalPessoaJuridica:''' Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;<br /> <br /> '''FamiliasKit:''' Define quais famílias serão consideradas para kits na integração;<br /> <br /> '''CanaisVenda:''' Define quais serão os canais de venda dos produtos. Separar por vírgulas (Ex.: 91008, 91009);<br /> <br /> '''NomeImpressoraEtiquetas:''' Nome da impressora para impressão de etiquetas;<br /> <br /> == 1° Passo - Criar um Aplicativo ==<br /> <br /> Acessar Link:<br /> [https://open.business.accounts.shopee.com/authenticate/login?client_id=11&should_hide_back=true&next=https%3A%2F%2Fopen.shopee.com%2Fopservice%2Fapi%2Fv1%2Faccount%2Finit_session%3Fredirect_url%3Dhttps%253A%252F%252Fopen.shopee.com%252F Shopee - Login]<br /> <br /> Após acessar a conta, basta ir até o "Personal Center"<br /> [[Arquivo:Personal Center - Shopee Developer.png|Personal Center - Shopee Developer]]<br /> <br /> <br><br /> <br><br /> <br /> Depois basta ir em Cadastro -> Cadastro de Aplicativos: [https://open.shopee.com/console/app Shopee - Aplicativo]<br /> <br /> <br><br /> <br><br /> <br /> [[Arquivo:App - Shopee Developer.png|App - Shopee Developer]]<br /> <br /> Depois basta selecionar o aplicativo ou criar um novo:<br /> <br /> <br><br /> <br><br /> <br /> [[Arquivo:New App - Shopee Developer.png|New App - Shopee Developer]]<br /> <br /> <br><br /> <br><br /> Ao criar um novo aplicativo, a URL de Callback (Redirect URL Domain) será essa: <ref>https://google.com</ref>.<br /> <br /> Após a criação do aplicativo, você poderá obter as credenciais de acesso a API, como o Partner_id e o Partner_key:<br /> <br /> <br><br /> <br><br /> <br /> [[Arquivo:Credenciais - Shopee Developer.png|Credenciais - Shopee Developer]]<br /> <br /> == 2° Passo - Criar uma loja ==<br /> Este procedimento é necessário prioritariamente em ambiente de homologação, visto que, em produção, a loja do cliente já estará previamente configurada e ativa.<br /> <br /> <br><br /> <br><br /> <br /> [[Arquivo:Loja - Shopee Developer.png|Loja - Shopee Developer]]<br /> <br /> <br /> == 3° Passo - Configuração no ERP ==<br /> <br /> No ERP basta informar as credencias ClientId (Partner_id) e ClientSecret (Partner_key) para receber um código de identificação para a coleta do Token de autorização (Access Token) '''(o code obtido tem duração de 5 minutos)''' para a configuração do E-commerce.<br /> <br /> Após informar o as credenciais e a identificação para recebimento do token, basta clicar no botão '''Gerar Token Autorização''', após o click uma tela na Web será aberta, para a autorização do aplicativo:<br /> [[Arquivo:Credenciais (Code) Part.1 - Shopee Developer.png|Credenciais (Code) Part.1 - Shopee Developer]]<br /> <br /> [[Arquivo:Credenciais (Code) Part.2 - Shopee Developer.png|Credenciais (Code) Part.2 - Shopee Developer]]<br /> <br /> [[Arquivo:Credenciais (Code) Part.3 - Shopee Developer.png|Credenciais (Code) Part.3 - Shopee Developer]]<br /> <br /> Após realizar as confirmações necessárias, é preciso coletar a URL que foi retornada no site do '''Google''' e informar no campo '''Identificação Token Temporário'''<br /> [[Arquivo:Credenciais (Code) Part.4 - Shopee Developer.png|Credenciais (Code) Part.4 - Shopee Developer]]<br /> <br /> Após gerar o token de acesso temporário, basta clicar em '''Gerar Token Acesso''':<br /> [[Arquivo:Credenciais (Code) Part.5 - Shopee Developer.png|Credenciais (Code) Part.5 - Shopee Developer]]<br /> <br /> <br><br /> <br /> Com a mensagem o ecommerce está configurado corretamente. As credenciais de acesso é armazenada em um XML na pasta do usuário '''(C:\Users\USUARIO\AppData\Local)''' no arquivo ApiConfig no nó <Shopee_Shop_PARTNER_ID>.<br /> <br /> == Requisitos ==<br /> <br /> '''Produtos:'''<br /> Atributo adicional: J:\Vb.Net\Scripts\Atributos Adicionais\Adiciona campos adicionais no cadastro de Produto - Shopee.sql; <br><br /> Marcar o produto para o aceite de integrações; <br><br /> Informar embalagem com as dimensões; <br><br /> E obrigatóriamente informar imagem(ns) no produto (ao menos uma) marcada como desenho.</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=RN_Integracao_Magis5&diff=16834 RN Integracao Magis5 2026-06-23T18:06:35Z

<p>Vinicius: </p> <hr /> <div>Regra de negócio do tipo habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem o objetivo configurar e manipular a integração entre API Magis5 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.<br /> <br /> == Acoplamento ==<br /> Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos ou Infra.ControleAvisos(). Ela está preparada para funcionar com o elemento '''ExecutaOperacao''', sendo seu designador por '''Execução''' e tempo de execução '''Depois'''.<br /> <br /> Essa regra de negócio foi adaptada para também funcionar no dpServer.<br /> Quando executada pelo dpServer, seu comportamento é restrito à consulta e integração de pedidos, não abrangendo outras operações disponíveis.<br /> <br /> Além disso, algumas propriedades são exclusivas do dpServer e devem ser configuradas apenas quando a execução ocorrer nesse ambiente, como PeriodoExecucao, GerarLog e UsuariosParaNotificacao.<br /> Esses parâmetros controlam o agendamento, e notificações das execuções automáticas realizadas.<br /> <br /> == Parâmetros ==<br /> '''UrlEcommerce:''' Url do e-commerce;<br /> <br /> '''StatusPedido:''' Status do pedido (do e-commerce) a ser considerado na busca de dados: '''ready_to_print''' é o status que a Magis garante que está pronto para ser criado o pedido no ERP e faturado<br><br /> <br /> '''Token:''' Token recebido pela Magis após contratar o serviço de API (Sem esse token a integração não funciona).<br /> <br /> '''StatusCliente:''' Código do status de pessoa para clientes trazidos do e-commerce;<br /> <br /> '''RamoAtividadeCodigo:''' Código do ramo de atividade padrão para a gravação dos clientes;<br /> <br /> '''DefinirEnqFiscal:''' Define o enquadramento fiscal do cliente ao integrá-lo;<br /> <br /> '''EnqFiscalPessoaFisica:''' Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;<br /> <br /> '''EnqFiscalPessoaJuridica:''' Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;<br /> <br /> '''NumeroListaPrecoProdutos:''' Lista de Preços para realizar o envio dos produtos para o web service;<br /> <br /> '''QtdeEstoque:''' Quantidade de estoque fixa a ser enviada;<br /> <br /> '''IntegracaoMagalu''' ''':''' Possui integração com a Magalu (se marcada esta opção, é removido os pontos do código do produto;<br /> <br /> '''EmpresaReceptora:''' Empresa em que a regra será executada.;<br /> <br /> '''DiasPrazoEntrega:''' Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);<br /> <br /> '''SituacaoCodigo:''' Código da situação padrão para a gravação dos pedidos;<br /> <br /> '''PortadorCodigo:''' Código do portador padrão para a gravação dos pedidos;<br /> <br /> '''TransportadoraCodigo:''' Código da transportadora padrão para a gravação dos pedidos;<br /> <br /> '''OpSaidaCodigo:''' Código da operação de saída padrão para a gravação dos pedidos;<br /> <br /> '''RepresentanteCodigo:''' Código do representante padrão para a gravação dos pedidos;<br /> <br /> '''TelevendasCodigo:''' Código do televendas padrão para a gravação dos pedidos;<br /> <br /> '''CaracteristicaCodigo:''' Código da característica de venda padrão para a gravação dos pedidos;<br /> <br /> '''TipoFrete:''' Tipo de frete;<br /> <br /> '''DescontoPessoaFisica:''' Desconto para cliente pessoa física.<br /> <br /> '''CanalConfigurado:''' Informe o nome dos canais separados por vírgula. Exemplo: Shopee, Mercado Livre, Magazine Luiza. Cada nome de canal está associado à configuração de parcela única.<br /> <br /> '''ValorCanalConfigurado:''' Informe U para parcela única ou N para não parcela única, separados por vírgula e mantendo a sequência da propriedade CanalPagaParcelaUnica. Exemplo: U, N, U.<br /> <br /> '''IdsLojas:''' ID das lojas (separadas por ponto e vírgula), que são utilizadas para coleta de pedidos.<br /> <br /> '''NomeImpressoraEtiquetas:''' Nome da impressora para impressão de etiquetas.<br /> <br /> <br /> <br /> '''Propriedades de filtro de pedidos:'''<br /> <br /> É possível informar os níveis da família nas listas.<br /> <br /> '''AnaliseParaInclusao''' ''':''' Código das famílias dos produtos presentes nos pedidos que serão integrados na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01);<br /> <br /> '''AnaliseParaExclusao:''' Código das famílias dos produtos presentes nos pedidos que serão excluídos na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01).<br /> <br /> Obs: O critério adotado é que, caso um produto atenda ao filtro, '''o pedido inteiro''' é integrado ou ignorado.<br /> <br /> Para o seu funcionamento adequado, é necessário configurar duas regras na empresa responsável pelo faturamento dos pedidos que devem ser ignorados nas demais:<br /> <br /> * '''1ª Regra:''' Deve conter apenas o(s) ID(s) da(s) loja(s) referente(s) à empresa configurada.<br /> * '''2ª Regra:''' Deve conter o(s) ID(s) das demais lojas, excluindo aquelas presentes na primeira regra. Esta regra deve ser preenchida com a lista de inclusão (família incluída na lista de exclusão da regra das outras empresas).<br /> <br /> <blockquote>'''Observação:''' As regras das demais empresas devem estar configuradas utilizando a lista de exclusão.</blockquote><br /> <br /> <br /> '''Propriedades exclusivas para o dpServer:'''<br /> <br /> '''PeriodoExecucao:''' Período que a regra será executada. Informar em minutos ex.: 60 (dpServer).<br /> <br /> '''GerarLog:''' Gera uma log dos pedidos retornados com o mesmo nome da regra (dpServer).<br /> <br /> '''UsuariosParaNotificacao:''' Código dos usuários que receberão a notificação (Separar por vírgula Ex: 1,2,3) (dpServer)<br /> <br /> == OBSERVAÇÃO IMPORTANTE== <br /> É necessário cadastrar todas as formas de parcelamento possíveis que podem ser recebidas de cada marketplace. Para que o sistema identifique que essa condição de pagamento está vinculada à integração da Magis, a descrição deve conter o nome "magis", seguido de um traço e a quantidade de parcelas correspondentes. '''Por exemplo: magis-1x, magis-2x, magis-3x. '''Certifique-se de cadastrar todas as opções necessárias para garantir o correto funcionamento da integração.<br /> Caso não for configurado o '''CanalConfigurado''' e '''ValorCanalConfigurado''' ele vai pegar por padrao a configuração '''magis-1x'''.</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=RN_Integracao_Magis5&diff=16728 RN Integracao Magis5 2026-06-19T13:21:48Z

<p>Vinicius: </p> <hr /> <div>Regra de negócio do tipo habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem o objetivo configurar e manipular a integração entre API Magis5 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.<br /> <br /> == Acoplamento ==<br /> Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos ou Infra.ControleAvisos(). Ela está preparada para funcionar com o elemento '''ExecutaOperacao''', sendo seu designador por '''Execução''' e tempo de execução '''Depois'''.<br /> <br /> Essa regra de negócio foi adaptada para também funcionar no dpServer.<br /> Quando executada pelo dpServer, seu comportamento é restrito à consulta e integração de pedidos, não abrangendo outras operações disponíveis.<br /> <br /> Além disso, algumas propriedades são exclusivas do dpServer e devem ser configuradas apenas quando a execução ocorrer nesse ambiente, como PeriodoExecucao, GerarLog e UsuariosParaNotificacao.<br /> Esses parâmetros controlam o agendamento, e notificações das execuções automáticas realizadas.<br /> <br /> == Parâmetros ==<br /> '''UrlEcommerce:''' Url do e-commerce;<br /> <br /> '''StatusPedido:''' Status do pedido (do e-commerce) a ser considerado na busca de dados: '''ready_to_print''' é o status que a Magis garante que está pronto para ser criado o pedido no ERP e faturado<br><br /> <br /> '''Token:''' Token recebido pela Magis após contratar o serviço de API (Sem esse token a integração não funciona).<br /> <br /> '''StatusCliente:''' Código do status de pessoa para clientes trazidos do e-commerce;<br /> <br /> '''RamoAtividadeCodigo:''' Código do ramo de atividade padrão para a gravação dos clientes;<br /> <br /> '''DefinirEnqFiscal:''' Define o enquadramento fiscal do cliente ao integrá-lo;<br /> <br /> '''EnqFiscalPessoaFisica:''' Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;<br /> <br /> '''EnqFiscalPessoaJuridica:''' Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;<br /> <br /> '''NumeroListaPrecoProdutos:''' Lista de Preços para realizar o envio dos produtos para o web service;<br /> <br /> '''QtdeEstoque:''' Quantidade de estoque fixa a ser enviada;<br /> <br /> '''IntegracaoMagalu''' ''':''' Possui integração com a Magalu (se marcada esta opção, é removido os pontos do código do produto;<br /> <br /> '''EmpresaReceptora:''' Empresa em que a regra será executada.;<br /> <br /> '''DiasPrazoEntrega:''' Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);<br /> <br /> '''SituacaoCodigo:''' Código da situação padrão para a gravação dos pedidos;<br /> <br /> '''PortadorCodigo:''' Código do portador padrão para a gravação dos pedidos;<br /> <br /> '''TransportadoraCodigo:''' Código da transportadora padrão para a gravação dos pedidos;<br /> <br /> '''OpSaidaCodigo:''' Código da operação de saída padrão para a gravação dos pedidos;<br /> <br /> '''RepresentanteCodigo:''' Código do representante padrão para a gravação dos pedidos;<br /> <br /> '''TelevendasCodigo:''' Código do televendas padrão para a gravação dos pedidos;<br /> <br /> '''CaracteristicaCodigo:''' Código da característica de venda padrão para a gravação dos pedidos;<br /> <br /> '''TipoFrete:''' Tipo de frete;<br /> <br /> '''DescontoPessoaFisica:''' Desconto para cliente pessoa física.<br /> <br /> '''CanalConfigurado:''' Informe o nome dos canais separados por vírgula. Exemplo: Shopee, Mercado Livre, Magazine Luiza. Cada nome de canal está associado à configuração de parcela única.<br /> <br /> '''ValorCanalConfigurado:''' Informe U para parcela única ou N para não parcela única, separados por vírgula e mantendo a sequência da propriedade CanalPagaParcelaUnica. Exemplo: U, N, U.<br /> <br /> '''IdsLojas:''' ID das lojas (separadas por ponto e vírgula), que são utilizadas para coleta de pedidos.<br /> <br /> <br /> '''Propriedades de filtro de pedidos:'''<br /> <br /> É possível informar os níveis da família nas listas.<br /> <br /> '''AnaliseParaInclusao''' ''':''' Código das famílias dos produtos presentes nos pedidos que serão integrados na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01);<br /> <br /> '''AnaliseParaExclusao:''' Código das famílias dos produtos presentes nos pedidos que serão excluídos na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01).<br /> <br /> Obs: O critério adotado é que, caso um produto atenda ao filtro, '''o pedido inteiro''' é integrado ou ignorado.<br /> <br /> Para o seu funcionamento adequado, é necessário configurar duas regras na empresa responsável pelo faturamento dos pedidos que devem ser ignorados nas demais:<br /> <br /> * '''1ª Regra:''' Deve conter apenas o(s) ID(s) da(s) loja(s) referente(s) à empresa configurada.<br /> * '''2ª Regra:''' Deve conter o(s) ID(s) das demais lojas, excluindo aquelas presentes na primeira regra. Esta regra deve ser preenchida com a lista de inclusão (família incluída na lista de exclusão da regra das outras empresas).<br /> <br /> <blockquote>'''Observação:''' As regras das demais empresas devem estar configuradas utilizando a lista de exclusão.</blockquote><br /> <br /> <br /> '''Propriedades exclusivas para o dpServer:'''<br /> <br /> '''PeriodoExecucao:''' Período que a regra será executada. Informar em minutos ex.: 60 (dpServer).<br /> <br /> '''GerarLog:''' Gera uma log dos pedidos retornados com o mesmo nome da regra (dpServer).<br /> <br /> '''UsuariosParaNotificacao:''' Código dos usuários que receberão a notificação (Separar por vírgula Ex: 1,2,3) (dpServer)<br /> <br /> == OBSERVAÇÃO IMPORTANTE== <br /> É necessário cadastrar todas as formas de parcelamento possíveis que podem ser recebidas de cada marketplace. Para que o sistema identifique que essa condição de pagamento está vinculada à integração da Magis, a descrição deve conter o nome "magis", seguido de um traço e a quantidade de parcelas correspondentes. '''Por exemplo: magis-1x, magis-2x, magis-3x. '''Certifique-se de cadastrar todas as opções necessárias para garantir o correto funcionamento da integração.<br /> Caso não for configurado o '''CanalConfigurado''' e '''ValorCanalConfigurado''' ele vai pegar por padrao a configuração '''magis-1x'''.</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=RN_Integracao_Magis5&diff=16698 RN Integracao Magis5 2026-06-12T14:21:09Z

<p>Vinicius: </p> <hr /> <div>Regra de negócio do tipo habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem o objetivo configurar e manipular a integração entre API Magis5 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.<br /> <br /> == Acoplamento ==<br /> Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos ou Infra.ControleAvisos(). Ela está preparada para funcionar com o elemento '''ExecutaOperacao''', sendo seu designador por '''Execução''' e tempo de execução '''Depois'''.<br /> <br /> Essa regra de negócio foi adaptada para também funcionar no dpServer.<br /> Quando executada pelo dpServer, seu comportamento é restrito à consulta e integração de pedidos, não abrangendo outras operações disponíveis.<br /> <br /> Além disso, algumas propriedades são exclusivas do dpServer e devem ser configuradas apenas quando a execução ocorrer nesse ambiente, como PeriodoExecucao, GerarLog e UsuariosParaNotificacao.<br /> Esses parâmetros controlam o agendamento, e notificações das execuções automáticas realizadas.<br /> <br /> == Parâmetros ==<br /> '''UrlEcommerce:''' Url do e-commerce;<br /> <br /> '''StatusPedido:''' Status do pedido (do e-commerce) a ser considerado na busca de dados: '''ready_to_print''' é o status que a Magis garante que está pronto para ser criado o pedido no ERP e faturado<br><br /> <br /> '''Token:''' Token recebido pela Magis após contratar o serviço de API (Sem esse token a integração não funciona).<br /> <br /> '''StatusCliente:''' Código do status de pessoa para clientes trazidos do e-commerce;<br /> <br /> '''RamoAtividadeCodigo:''' Código do ramo de atividade padrão para a gravação dos clientes;<br /> <br /> '''DefinirEnqFiscal:''' Define o enquadramento fiscal do cliente ao integrá-lo;<br /> <br /> '''EnqFiscalPessoaFisica:''' Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;<br /> <br /> '''EnqFiscalPessoaJuridica:''' Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;<br /> <br /> '''EmpresaReceptora:''' Empresa em que a regra será executada.;<br /> <br /> '''DiasPrazoEntrega:''' Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);<br /> <br /> '''SituacaoCodigo:''' Código da situação padrão para a gravação dos pedidos;<br /> <br /> '''PortadorCodigo:''' Código do portador padrão para a gravação dos pedidos;<br /> <br /> '''TransportadoraCodigo:''' Código da transportadora padrão para a gravação dos pedidos;<br /> <br /> '''OpSaidaCodigo:''' Código da operação de saída padrão para a gravação dos pedidos;<br /> <br /> '''RepresentanteCodigo:''' Código do representante padrão para a gravação dos pedidos;<br /> <br /> '''TelevendasCodigo:''' Código do televendas padrão para a gravação dos pedidos;<br /> <br /> '''CaracteristicaCodigo:''' Código da característica de venda padrão para a gravação dos pedidos;<br /> <br /> '''TipoFrete:''' Tipo de frete;<br /> <br /> '''DescontoPessoaFisica:''' Desconto para cliente pessoa física.<br /> <br /> '''CanalConfigurado:''' Informe o nome dos canais separados por vírgula. Exemplo: Shopee, Mercado Livre, Magazine Luiza. Cada nome de canal está associado à configuração de parcela única.<br /> <br /> '''ValorCanalConfigurado:''' Informe U para parcela única ou N para não parcela única, separados por vírgula e mantendo a sequência da propriedade CanalPagaParcelaUnica. Exemplo: U, N, U.<br /> <br /> '''IdsLojas:''' ID das lojas (separadas por ponto e vírgula), que são utilizadas para coleta de pedidos.<br /> <br /> <br /> '''Propriedades de filtro de pedidos:'''<br /> <br /> É possível informar os níveis da família nas listas.<br /> <br /> '''AnaliseParaInclusao''' ''':''' Código das famílias dos produtos presentes nos pedidos que serão integrados na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01);<br /> <br /> '''AnaliseParaExclusao:''' Código das famílias dos produtos presentes nos pedidos que serão excluídos na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01).<br /> <br /> Obs: O critério adotado é que, caso um produto atenda ao filtro, '''o pedido inteiro''' é integrado ou ignorado.<br /> <br /> Para o seu funcionamento adequado, é necessário configurar duas regras na empresa responsável pelo faturamento dos pedidos que devem ser ignorados nas demais:<br /> <br /> * '''1ª Regra:''' Deve conter apenas o(s) ID(s) da(s) loja(s) referente(s) à empresa configurada.<br /> * '''2ª Regra:''' Deve conter o(s) ID(s) das demais lojas, excluindo aquelas presentes na primeira regra. Esta regra deve ser preenchida com a lista de inclusão (família incluída na lista de exclusão da regra das outras empresas).<br /> <br /> <blockquote>'''Observação:''' As regras das demais empresas devem estar configuradas utilizando a lista de exclusão.</blockquote><br /> <br /> <br /> '''Propriedades exclusivas para o dpServer:'''<br /> <br /> '''PeriodoExecucao:''' Período que a regra será executada. Informar em minutos ex.: 60 (dpServer).<br /> <br /> '''GerarLog:''' Gera uma log dos pedidos retornados com o mesmo nome da regra (dpServer).<br /> <br /> '''UsuariosParaNotificacao:''' Código dos usuários que receberão a notificação (Separar por vírgula Ex: 1,2,3) (dpServer)<br /> <br /> == OBSERVAÇÃO IMPORTANTE== <br /> É necessário cadastrar todas as formas de parcelamento possíveis que podem ser recebidas de cada marketplace. Para que o sistema identifique que essa condição de pagamento está vinculada à integração da Magis, a descrição deve conter o nome "magis", seguido de um traço e a quantidade de parcelas correspondentes. '''Por exemplo: magis-1x, magis-2x, magis-3x. '''Certifique-se de cadastrar todas as opções necessárias para garantir o correto funcionamento da integração.<br /> Caso não for configurado o '''CanalConfigurado''' e '''ValorCanalConfigurado''' ele vai pegar por padrao a configuração '''magis-1x'''.</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=RN_Integracao_Magis5&diff=16697 RN Integracao Magis5 2026-06-12T14:15:35Z

<p>Vinicius: </p> <hr /> <div>Regra de negócio do tipo habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem o objetivo configurar e manipular a integração entre API Magis5 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.<br /> <br /> == Acoplamento ==<br /> Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos ou Infra.ControleAvisos(). Ela está preparada para funcionar com o elemento '''ExecutaOperacao''', sendo seu designador por '''Execução''' e tempo de execução '''Depois'''.<br /> <br /> Essa regra de negócio foi adaptada para também funcionar no dpServer.<br /> Quando executada pelo dpServer, seu comportamento é restrito à consulta e integração de pedidos, não abrangendo outras operações disponíveis.<br /> <br /> Além disso, algumas propriedades são exclusivas do dpServer e devem ser configuradas apenas quando a execução ocorrer nesse ambiente, como PeriodoExecucao, GerarLog e UsuariosParaNotificacao.<br /> Esses parâmetros controlam o agendamento, e notificações das execuções automáticas realizadas.<br /> <br /> == Parâmetros ==<br /> '''UrlEcommerce:''' Url do e-commerce;<br /> <br /> '''StatusPedido:''' Status do pedido (do e-commerce) a ser considerado na busca de dados: '''ready_to_print''' é o status que a Magis garante que está pronto para ser criado o pedido no ERP e faturado<br><br /> <br /> '''Token:''' Token recebido pela Magis após contratar o serviço de API (Sem esse token a integração não funciona).<br /> <br /> '''StatusCliente:''' Código do status de pessoa para clientes trazidos do e-commerce;<br /> <br /> '''RamoAtividadeCodigo:''' Código do ramo de atividade padrão para a gravação dos clientes;<br /> <br /> '''DefinirEnqFiscal:''' Define o enquadramento fiscal do cliente ao integrá-lo;<br /> <br /> '''EnqFiscalPessoaFisica:''' Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;<br /> <br /> '''EnqFiscalPessoaJuridica:''' Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;<br /> <br /> '''EmpresaReceptora:''' Empresa em que a regra será executada.;<br /> <br /> '''DiasPrazoEntrega:''' Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);<br /> <br /> '''SituacaoCodigo:''' Código da situação padrão para a gravação dos pedidos;<br /> <br /> '''PortadorCodigo:''' Código do portador padrão para a gravação dos pedidos;<br /> <br /> '''TransportadoraCodigo:''' Código da transportadora padrão para a gravação dos pedidos;<br /> <br /> '''OpSaidaCodigo:''' Código da operação de saída padrão para a gravação dos pedidos;<br /> <br /> '''RepresentanteCodigo:''' Código do representante padrão para a gravação dos pedidos;<br /> <br /> '''TelevendasCodigo:''' Código do televendas padrão para a gravação dos pedidos;<br /> <br /> '''CaracteristicaCodigo:''' Código da característica de venda padrão para a gravação dos pedidos;<br /> <br /> '''TipoFrete:''' Tipo de frete;<br /> <br /> '''DescontoPessoaFisica:''' Desconto para cliente pessoa física.<br /> <br /> '''CanalConfigurado:''' Informe o nome dos canais separados por vírgula. Exemplo: Shopee, Mercado Livre, Magazine Luiza. Cada nome de canal está associado à configuração de parcela única.<br /> <br /> '''ValorCanalConfigurado:''' Informe U para parcela única ou N para não parcela única, separados por vírgula e mantendo a sequência da propriedade CanalPagaParcelaUnica. Exemplo: U, N, U.<br /> <br /> '''IdsLojas:''' ID das lojas (separadas por ponto e vírgula), que são utilizadas para coleta de pedidos.<br /> <br /> <br /> '''Propriedades de filtro de pedidos:'''<br /> <br /> '''AnaliseParaInclusao''' ''':''' Código das famílias dos produtos presentes nos pedidos que serão integrados na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01);<br /> <br /> '''AnaliseParaExclusao:''' Código das famílias dos produtos presentes nos pedidos que serão excluídos na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01).<br /> <br /> Obs: O critério adotado é que, caso um produto atenda ao filtro, '''o pedido inteiro''' é integrado ou ignorado.<br /> <br /> Para o seu funcionamento adequado, é necessário configurar duas regras na empresa responsável pelo faturamento dos pedidos que devem ser ignorados nas demais:<br /> <br /> * '''1ª Regra:''' Deve conter apenas o(s) ID(s) da(s) loja(s) referente(s) à empresa configurada.<br /> * '''2ª Regra:''' Deve conter o(s) ID(s) das demais lojas, excluindo aquelas presentes na primeira regra. Esta regra deve ser preenchida com a lista de inclusão (família incluída na lista de exclusão da regra das outras empresas).<br /> <br /> <blockquote>'''Observação:''' As regras das demais empresas devem estar configuradas utilizando a lista de exclusão.</blockquote><br /> <br /> <br /> '''Propriedades exclusivas para o dpServer:'''<br /> <br /> '''PeriodoExecucao:''' Período que a regra será executada. Informar em minutos ex.: 60 (dpServer).<br /> <br /> '''GerarLog:''' Gera uma log dos pedidos retornados com o mesmo nome da regra (dpServer).<br /> <br /> '''UsuariosParaNotificacao:''' Código dos usuários que receberão a notificação (Separar por vírgula Ex: 1,2,3) (dpServer)<br /> <br /> == OBSERVAÇÃO IMPORTANTE== <br /> É necessário cadastrar todas as formas de parcelamento possíveis que podem ser recebidas de cada marketplace. Para que o sistema identifique que essa condição de pagamento está vinculada à integração da Magis, a descrição deve conter o nome "magis", seguido de um traço e a quantidade de parcelas correspondentes. '''Por exemplo: magis-1x, magis-2x, magis-3x. '''Certifique-se de cadastrar todas as opções necessárias para garantir o correto funcionamento da integração.<br /> Caso não for configurado o '''CanalConfigurado''' e '''ValorCanalConfigurado''' ele vai pegar por padrao a configuração '''magis-1x'''.</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=RN_Integracao_Magis5&diff=16696 RN Integracao Magis5 2026-06-12T14:10:59Z

<p>Vinicius: </p> <hr /> <div>Regra de negócio do tipo habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem o objetivo configurar e manipular a integração entre API Magis5 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.<br /> <br /> == Acoplamento ==<br /> Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos ou Infra.ControleAvisos(). Ela está preparada para funcionar com o elemento '''ExecutaOperacao''', sendo seu designador por '''Execução''' e tempo de execução '''Depois'''.<br /> <br /> Essa regra de negócio foi adaptada para também funcionar no dpServer.<br /> Quando executada pelo dpServer, seu comportamento é restrito à consulta e integração de pedidos, não abrangendo outras operações disponíveis.<br /> <br /> Além disso, algumas propriedades são exclusivas do dpServer e devem ser configuradas apenas quando a execução ocorrer nesse ambiente, como PeriodoExecucao, GerarLog e UsuariosParaNotificacao.<br /> Esses parâmetros controlam o agendamento, e notificações das execuções automáticas realizadas.<br /> <br /> == Parâmetros ==<br /> '''UrlEcommerce:''' Url do e-commerce;<br /> <br /> '''StatusPedido:''' Status do pedido (do e-commerce) a ser considerado na busca de dados: '''ready_to_print''' é o status que a Magis garante que está pronto para ser criado o pedido no ERP e faturado<br><br /> <br /> '''Token:''' Token recebido pela Magis após contratar o serviço de API (Sem esse token a integração não funciona).<br /> <br /> '''StatusCliente:''' Código do status de pessoa para clientes trazidos do e-commerce;<br /> <br /> '''RamoAtividadeCodigo:''' Código do ramo de atividade padrão para a gravação dos clientes;<br /> <br /> '''DefinirEnqFiscal:''' Define o enquadramento fiscal do cliente ao integrá-lo;<br /> <br /> '''EnqFiscalPessoaFisica:''' Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;<br /> <br /> '''EnqFiscalPessoaJuridica:''' Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;<br /> <br /> '''EmpresaReceptora:''' Empresa em que a regra será executada.;<br /> <br /> '''DiasPrazoEntrega:''' Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);<br /> <br /> '''SituacaoCodigo:''' Código da situação padrão para a gravação dos pedidos;<br /> <br /> '''PortadorCodigo:''' Código do portador padrão para a gravação dos pedidos;<br /> <br /> '''TransportadoraCodigo:''' Código da transportadora padrão para a gravação dos pedidos;<br /> <br /> '''OpSaidaCodigo:''' Código da operação de saída padrão para a gravação dos pedidos;<br /> <br /> '''RepresentanteCodigo:''' Código do representante padrão para a gravação dos pedidos;<br /> <br /> '''TelevendasCodigo:''' Código do televendas padrão para a gravação dos pedidos;<br /> <br /> '''CaracteristicaCodigo:''' Código da característica de venda padrão para a gravação dos pedidos;<br /> <br /> '''TipoFrete:''' Tipo de frete;<br /> <br /> '''DescontoPessoaFisica:''' Desconto para cliente pessoa física.<br /> <br /> '''CanalConfigurado:''' Informe o nome dos canais separados por vírgula. Exemplo: Shopee, Mercado Livre, Magazine Luiza. Cada nome de canal está associado à configuração de parcela única.<br /> <br /> '''ValorCanalConfigurado:''' Informe U para parcela única ou N para não parcela única, separados por vírgula e mantendo a sequência da propriedade CanalPagaParcelaUnica. Exemplo: U, N, U.<br /> <br /> '''IdsLojas:''' ID das lojas (separadas por ponto e vírgula), que são utilizadas para coleta de pedidos.<br /> <br /> <br /> '''Propriedades de filtro de pedidos:'''<br /> <br /> '''AnaliseParaInclusao''' ''':''' Código das famílias dos produtos presentes nos pedidos que serão integrados na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01);<br /> <br /> '''AnaliseParaExclusao:''' Código das famílias dos produtos presentes nos pedidos que serão excluídos na empresa. Informar separados por ponto e vírgula (Ex.: 10; 11.01).<br /> <br /> Obs: O critério adotado é que, caso um produto atenda ao filtro, '''o pedido inteiro''' é integrado ou ignorado.<br /> <br /> <br /> '''Propriedades exclusivas para o dpServer:'''<br /> <br /> '''PeriodoExecucao:''' Período que a regra será executada. Informar em minutos ex.: 60 (dpServer).<br /> <br /> '''GerarLog:''' Gera uma log dos pedidos retornados com o mesmo nome da regra (dpServer).<br /> <br /> '''UsuariosParaNotificacao:''' Código dos usuários que receberão a notificação (Separar por vírgula Ex: 1,2,3) (dpServer)<br /> <br /> == OBSERVAÇÃO IMPORTANTE== <br /> É necessário cadastrar todas as formas de parcelamento possíveis que podem ser recebidas de cada marketplace. Para que o sistema identifique que essa condição de pagamento está vinculada à integração da Magis, a descrição deve conter o nome "magis", seguido de um traço e a quantidade de parcelas correspondentes. '''Por exemplo: magis-1x, magis-2x, magis-3x. '''Certifique-se de cadastrar todas as opções necessárias para garantir o correto funcionamento da integração.<br /> Caso não for configurado o '''CanalConfigurado''' e '''ValorCanalConfigurado''' ele vai pegar por padrao a configuração '''magis-1x'''.</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=DPServer_-_Servi%C3%A7o&diff=16675 DPServer - Serviço 2026-06-11T11:42:22Z

<p>Vinicius: </p> <hr /> <div>= 📖 MANUAL DE DEPLOY E ATUALIZAÇÃO: Matriz de Responsabilidades (dpServer) =<br /> Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.<br /> <br /> == 💻 1. ESCOPO DO DESENVOLVIMENTO ==<br /> <br /> === Alteração da Versão do Executável (Assembly) ===<br /> <br /> * Incrementar o número da versão física do arquivo sempre que houver modificações.<br /> * '''Como fazer:''' No Visual Studio, acesse as propriedades do projeto <code>dpServerService</code> -> Aba '''Aplicativo''' -> Botão '''Informações do Assembly...''' -> Incremente a '''Versão do assembly''' e '''Versão do arquivo''' (Ex: <code>1.0.0.0</code> para <code>1.1.0.0</code>).[[Arquivo:Mudança de versão - dpServerService.png|miniaturadaimagem|785x785px|centro]]<br /> * ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.<br /> <br /> === Compilação em Modo Release ===<br /> <br /> * Alterar o seletor do Visual Studio de <code>Debug</code> para '''<code>Release</code>''' e executar o comando '''Recompilar Solução''' (''Rebuild Solution'') dos dois projetos.<br /> <br /> === Compilação e Geração do Instalador (.msi) ===<br /> Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.<br /> <br /> O projeto possui um projeto de Setup integrado (usando Microsoft Visual Studio Installer Projects).<br /> <br /> # Na janela do ''Solution Explorer'', localize o projeto de instalação ('''<code>dpServerService.Setup</code>''') .<br /> # Clique com o botão direito sobre o projeto '''<code>dpServerService.Setup</code>'''e selecione '''Compilar''' (''Build'') ou ''Rebuild''.<br /> # O Visual Studio gerará os arquivos de instalação na pasta de saída do setup.<br /> # Navegue até a pasta física do projeto de setup (Ex: <code>...\</code><code>dpServerService.Setup\Release\</code>) e copie o arquivo '''<code>dpServerService.Setup.msi</code>''' (e o <code>setup.exe</code> se houver).<br /> # Disponibilize estes arquivos para a equipe de Atendimento.<br /> ⚠️ '''REGRA:''' '''NUNCA''' inclua o arquivo <code>dpServerService.exe.config</code> (App.Config) no pacote de atualização. O envio deste arquivo destrói as configurações customizadas do cliente, pois é lá que fica configurado o caminho dos arquivos de atualização.<br /> <br /> == 🛠️ 2. ESCOPO DO ATENDIMENTO / SUPORTE ==<br /> O Atendimento é responsável pela implantação no servidor do cliente, configuração dos ambientes, parametrização dos arquivos locais e aplicação de atualizações enviadas pelo desenvolvimento.<br /> <br /> === Primeira Instalação e Configuração do Ambiente ===<br /> <br /> * '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.<br /> * '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente. <br /> * '''Pasta de instalação: P'''asta de arquivos de instalações dos outros sistemas. <br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 1 - dpServerService.png|centro|miniaturadaimagem|471x471px]]<br /> Escolha o caminho de instalação e clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 2 - dpServerService.png|centro|miniaturadaimagem|486x486px]]<br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 3 - dpServerService.png|centro|miniaturadaimagem|496x496px]]<br /> <br /> <br /> Aguarde a instalação concluir e clique em '''fechar'''.<br /> <br /> * 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação Ex: <code>C:\Program Files (x86)\...\dpServerService.Setup</code>. <br /> * 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz. Criar uma pasta para os arquivos do '''dpServer''' (Ex: <code>value="SUGESTÃO: CAMINHO_PASTA_DE_ARQUIVOS_DOS_SISTEMAS"</code>). <br /> [[Arquivo:AppConfig - dpServerService.png|centro|miniaturadaimagem|711x711px]]<br /> * 4. Verificar se as credenciais do email estão corretas.<br /> * 5. Configurar as informações do banco de dados (dbServer e DataBase).<br /> * 6. Informar o código da empresa ativa. (A empresa configurada servirá como padrão para as regras de negócio que não possuem essa informação).<br /> <br /> == 🛠️ 3. VERIFICAR STATUS DO SERVIÇO (PÓS INSTALAÇÃO) ==<br /> '''Primeira Instalação:''' > Após concluir as configurações nos arquivos, o serviço será inicializado automaticamente, é válido verificar se o serviço do Windows foi iniciado. Siga os passos abaixo:<br /> <br /> # Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.<br /> # Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").<br /> # Certifique-se de que o status na coluna correspondente está em '''"Em execução"'''. Caso esteja '''"Iniciando"''' aguarde alguns segundos e atualize.[[Arquivo:Serviços - dpServerServico.png|centro|miniaturadaimagem|712x712px]]<br /> <br /> == 🛠️ 4. ATUALIZAÇÃO ==<br /> <br /> === Aplicação de Atualizações (Update de Versão) ===<br /> <br /> * Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>CAMINHO_PASTA_DE_ARQUIVOS_DOS_SISTEMAS\Atualizacao</code>).<br /> * Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.<br /> * O serviço detectará os arquivos novos, fará a substituição e reiniciará de forma 100% automatizada em até 5 minutos.<br /> <br /> == 🔍 5. GUIA DE RESOLUÇÃO DE PROBLEMAS ==<br /> Se a atualização falhar ou o serviço não iniciar, o Atendimento deve seguir este roteiro de checagem:<br /> <br /> === O serviço não atualizou automaticamente? ===<br /> <br /> * '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.<br /> * '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png|miniaturadaimagem|529x529px|centro]]<br /> <br /> === Onde verificar o que aconteceu? ===<br /> <br /> # '''Logs do dpServer:''' Para visualizar os logs, basta dar um duplo clique sobre o ícone de status.:[[Arquivo:Logs do DpServer - dpServerService.png|miniaturadaimagem|847x847px|centro]]<br /> # '''No arquivo de texto:''' Abra o arquivo <code>dpServerApp.log</code> localizado diretamente na pasta raiz configurada do cliente[[Arquivo:Logs do DpServer .txt - dpServerService.png|miniaturadaimagem|766x766px|centro]]<br /> # '''E-mail de avisos:''' Diferente dos outros logs, o log de e-mail será '''enviado''' somente quando ocorrerem erros no processamento:[[Arquivo:Logs do DpServer e-mail - dpServerService.png|miniaturadaimagem|766x766px|centro]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=DPServer_-_Servi%C3%A7o&diff=16668 DPServer - Serviço 2026-06-10T14:52:24Z

<p>Vinicius: </p> <hr /> <div>= 📖 MANUAL DE DEPLOY E ATUALIZAÇÃO: Matriz de Responsabilidades (dpServer) =<br /> Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.<br /> <br /> == 💻 1. ESCOPO DO DESENVOLVIMENTO ==<br /> <br /> === Alteração da Versão do Executável (Assembly) ===<br /> <br /> * Incrementar o número da versão física do arquivo sempre que houver modificações.<br /> * '''Como fazer:''' No Visual Studio, acesse as propriedades do projeto <code>dpServerService</code> -> Aba '''Aplicativo''' -> Botão '''Informações do Assembly...''' -> Incremente a '''Versão do assembly''' e '''Versão do arquivo''' (Ex: <code>1.0.0.0</code> para <code>1.1.0.0</code>).[[Arquivo:Mudança de versão - dpServerService.png|miniaturadaimagem|785x785px|centro]]<br /> * ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.<br /> <br /> === Compilação em Modo Release ===<br /> <br /> * Alterar o seletor do Visual Studio de <code>Debug</code> para '''<code>Release</code>''' e executar o comando '''Recompilar Solução''' (''Rebuild Solution'') dos dois projetos.<br /> <br /> === Compilação e Geração do Instalador (.msi) ===<br /> Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.<br /> <br /> O projeto possui um projeto de Setup integrado (usando Microsoft Visual Studio Installer Projects).<br /> <br /> # Na janela do ''Solution Explorer'', localize o projeto de instalação ('''<code>dpServerService.Setup</code>''') .<br /> # Clique com o botão direito sobre o projeto '''<code>dpServerService.Setup</code>'''e selecione '''Compilar''' (''Build'') ou ''Rebuild''.<br /> # O Visual Studio gerará os arquivos de instalação na pasta de saída do setup.<br /> # Navegue até a pasta física do projeto de setup (Ex: <code>...\</code><code>dpServerService.Setup\Release\</code>) e copie o arquivo '''<code>dpServerService.Setup.msi</code>''' (e o <code>setup.exe</code> se houver).<br /> # Disponibilize estes arquivos para a equipe de Atendimento.<br /> ⚠️ '''REGRA:''' '''NUNCA''' inclua o arquivo <code>dpServerService.exe.config</code> (App.Config) no pacote de atualização. O envio deste arquivo destrói as configurações customizadas do cliente, pois é lá que fica configurado o caminho dos arquivos de atualização.<br /> <br /> == 🛠️ 2. ESCOPO DO ATENDIMENTO / SUPORTE ==<br /> O Atendimento é responsável pela implantação no servidor do cliente, configuração dos ambientes, parametrização dos arquivos locais e aplicação de atualizações enviadas pelo desenvolvimento.<br /> <br /> === Primeira Instalação e Configuração do Ambiente ===<br /> <br /> * '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.<br /> * '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente. <br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 1 - dpServerService.png|centro|miniaturadaimagem|471x471px]]<br /> Escolha o caminho de instalação e clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 2 - dpServerService.png|centro|miniaturadaimagem|486x486px]]<br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 3 - dpServerService.png|centro|miniaturadaimagem|496x496px]]<br /> <br /> <br /> Aguarde a instalação concluir e clique em '''fechar'''.<br /> <br /> * 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação Ex: <code>C:\Program Files (x86)\...\dpServerService.Setup</code>. <br /> * 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz acordada (Ex: <code>value="C:\DpServer\"</code>). '''Sugestão:''' pasta de arquivos de instalações dos outros sistemas.<br /> [[Arquivo:AppConfig - dpServerService.png|centro|miniaturadaimagem|711x711px]]<br /> * 4. Verificar se as credenciais do email estão corretas.<br /> * 5. Configurar as informações do banco de dados (dbServer e DataBase).<br /> * 6. Informar o código da empresa ativa. (A empresa configurada servirá como padrão para as regras de negócio que não possuem essa informação).<br /> <br /> === Iniciando o serviço. ===<br /> '''Primeira Instalação:''' > Após concluir as configurações nos arquivos, é válido verificar se o serviço do Windows foi iniciado. Siga os passos abaixo:<br /> <br /> # Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.<br /> # Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").<br /> # Certifique-se de que o status na coluna correspondente está em '''"Em execução"'''. Caso esteja '''"Iniciando"''' aguarde alguns segundos e atualize.[[Arquivo:Serviços - dpServerServico.png|centro|miniaturadaimagem|712x712px]]<br /> <br /> === Aplicação de Atualizações (Update de Versão) ===<br /> * Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>C:\DpServer\Atualizacao</code>).<br /> * Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.<br /> * O serviço detectará os arquivos novos, fará a substituição e reiniciará de forma 100% automatizada em até 5 minutos.<br /> <br /> == 🔍 3. GUIA DE RESOLUÇÃO DE PROBLEMAS ==<br /> Se a atualização falhar ou o serviço não iniciar, o Atendimento deve seguir este roteiro de checagem:<br /> <br /> === O serviço não atualizou automaticamente? ===<br /> <br /> * '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.<br /> * '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png|miniaturadaimagem|529x529px|centro]]<br /> <br /> === Onde verificar o que aconteceu? ===<br /> <br /> # '''Logs do dpServer:''' Para visualizar os logs, basta dar um duplo clique sobre o ícone de status.:[[Arquivo:Logs do DpServer - dpServerService.png|miniaturadaimagem|847x847px|centro]]<br /> # '''No arquivo de texto:''' Abra o arquivo <code>dpServerApp.log</code> localizado diretamente na pasta raiz configurada do cliente[[Arquivo:Logs do DpServer .txt - dpServerService.png|miniaturadaimagem|766x766px|centro]]<br /> # '''E-mail de avisos:''' Diferente dos outros logs, o log de e-mail será '''enviado''' somente quando ocorrerem erros no processamento:[[Arquivo:Logs do DpServer e-mail - dpServerService.png|miniaturadaimagem|766x766px|centro]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=DPServer_-_Servi%C3%A7o&diff=16667 DPServer - Serviço 2026-06-10T14:26:40Z

<p>Vinicius: </p> <hr /> <div>= 📖 MANUAL DE DEPLOY E ATUALIZAÇÃO: Matriz de Responsabilidades (dpServer) =<br /> Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.<br /> <br /> == 💻 1. ESCOPO DO DESENVOLVIMENTO ==<br /> <br /> === Alteração da Versão do Executável (Assembly) ===<br /> <br /> * Incrementar o número da versão física do arquivo sempre que houver modificações.<br /> * '''Como fazer:''' No Visual Studio, acesse as propriedades do projeto <code>dpServerService</code> -> Aba '''Aplicativo''' -> Botão '''Informações do Assembly...''' -> Incremente a '''Versão do assembly''' e '''Versão do arquivo''' (Ex: <code>1.0.0.0</code> para <code>1.1.0.0</code>).[[Arquivo:Mudança de versão - dpServerService.png|miniaturadaimagem|785x785px|centro]]<br /> * ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.<br /> <br /> === Compilação em Modo Release ===<br /> <br /> * Alterar o seletor do Visual Studio de <code>Debug</code> para '''<code>Release</code>''' e executar o comando '''Recompilar Solução''' (''Rebuild Solution'') dos dois projetos.<br /> <br /> === Compilação e Geração do Instalador (.msi) ===<br /> Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.<br /> <br /> O projeto possui um projeto de Setup integrado (usando Microsoft Visual Studio Installer Projects).<br /> <br /> # Na janela do ''Solution Explorer'', localize o projeto de instalação ('''<code>dpServerService.Setup</code>''') .<br /> # Clique com o botão direito sobre o projeto '''<code>dpServerService.Setup</code>'''e selecione '''Compilar''' (''Build'') ou ''Rebuild''.<br /> # O Visual Studio gerará os arquivos de instalação na pasta de saída do setup.<br /> # Navegue até a pasta física do projeto de setup (Ex: <code>...\</code><code>dpServerService.Setup\Release\</code>) e copie o arquivo '''<code>dpServerService.Setup.msi</code>''' (e o <code>setup.exe</code> se houver).<br /> # Disponibilize estes arquivos para a equipe de Atendimento.<br /> ⚠️ '''REGRA:''' '''NUNCA''' inclua o arquivo <code>dpServerService.exe.config</code> (App.Config) no pacote de atualização. O envio deste arquivo destrói as configurações customizadas do cliente, pois é lá que fica configurado o caminho dos arquivos de atualização.<br /> <br /> == 🛠️ 2. ESCOPO DO ATENDIMENTO / SUPORTE ==<br /> O Atendimento é responsável pela implantação no servidor do cliente, configuração dos ambientes, parametrização dos arquivos locais e aplicação de atualizações enviadas pelo desenvolvimento.<br /> <br /> === Primeira Instalação e Configuração do Ambiente ===<br /> <br /> * '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.<br /> * '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente. <br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 1 - dpServerService.png|centro|miniaturadaimagem|471x471px]]<br /> Escolha o caminho de instalação e clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 2 - dpServerService.png|centro|miniaturadaimagem|486x486px]]<br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 3 - dpServerService.png|centro|miniaturadaimagem|496x496px]]<br /> <br /> <br /> Aguarde a instalação concluir e clique em '''fechar'''.<br /> <br /> * 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação Ex: <code>C:\Program Files (x86)\...\dpServerService.Setup</code>. <br /> * 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz acordada (Ex: <code>value="C:\DpServer\"</code>). '''Sugestão:''' pasta de arquivos de instalações dos outros sistemas.<br /> [[Arquivo:AppConfig - dpServerService.png|centro|miniaturadaimagem|711x711px]]<br /> * 4. Verificar se as credenciais do email estão corretas.<br /> * 5. Configurar as informações do banco de dados (dbServer e DataBase).<br /> * 6. Informar o código da empresa ativa. (A empresa configurada servirá como padrão para as regras de negócio que não possuem essa informação).<br /> <br /> === Iniciando o serviço. ===<br /> '''Primeira Instalação:''' > Após concluir as configurações nos arquivos (incluindo o <code>DpSettings.xml</code>), será necessário iniciar o serviço do Windows. Siga os passos abaixo:<br /> <br /> # Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.<br /> # Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").<br /> # Clique em '''Iniciar'''.<br /> # Certifique-se de que o status na coluna correspondente mudou para '''"Em execução"'''.[[Arquivo:Serviços - dpServerServico.png|centro|miniaturadaimagem|712x712px]]<br /> <br /> === Aplicação de Atualizações (Update de Versão) ===<br /> * Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>C:\DpServer\Atualizacao</code>).<br /> * Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.<br /> * O serviço detectará os arquivos novos, fará a substituição e reiniciará de forma 100% automatizada em até 5 minutos.<br /> <br /> == 🔍 3. GUIA DE RESOLUÇÃO DE PROBLEMAS ==<br /> Se a atualização falhar ou o serviço não iniciar, o Atendimento deve seguir este roteiro de checagem:<br /> <br /> === O serviço não atualizou automaticamente? ===<br /> <br /> * '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.<br /> * '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png|miniaturadaimagem|529x529px|centro]]<br /> <br /> === Onde verificar o que aconteceu? ===<br /> <br /> # '''Logs do dpServer:''' Para visualizar os logs, basta dar um duplo clique sobre o ícone de status.:[[Arquivo:Logs do DpServer - dpServerService.png|miniaturadaimagem|847x847px|centro]]<br /> # '''No arquivo de texto:''' Abra o arquivo <code>dpServerApp.log</code> localizado diretamente na pasta raiz configurada do cliente[[Arquivo:Logs do DpServer .txt - dpServerService.png|miniaturadaimagem|766x766px|centro]]<br /> # '''E-mail de avisos:''' Diferente dos outros logs, o log de e-mail será '''enviado''' somente quando ocorrerem erros no processamento:[[Arquivo:Logs do DpServer e-mail - dpServerService.png|miniaturadaimagem|766x766px|centro]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Arquivo:AppConfig_-_dpServerService.png&diff=16666 Arquivo:AppConfig - dpServerService.png 2026-06-10T14:22:57Z

<p>Vinicius: </p> <hr /> <div>AppConfig - dpServerService</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=RN_Integracao_Bling_V3&diff=16646 RN Integracao Bling V3 2026-06-01T13:25:36Z

<p>Vinicius: </p> <hr /> <div>Regra de negócio do tipo habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem o objetivo configurar e manipular a integração entre API Bling na versão 3 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.<br /> <br /> == Acoplamento ==<br /> Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos. Ela está preparada para funcionar com o elemento '''ExecutaOperacao''', sendo seu designador por '''Execução''' e tempo de execução '''Depois'''.<br /> <br /> == Parâmetros ==<br /> '''UrlEcommerce:''' Url do e-commerce https://api.bling.com.br/Api/v3;<br /> <br /> '''IntegracaoMagalu:''' Possui integração com a Magalu (se marcada esta opção, é removido os pontos do código do produto);<br /> <br /> '''ClientId:''' Credencial ClientId do aplicativo;<br /> <br /> '''ClientSecret:''' Credencial ClientSecret do aplicativo;<br /> <br /> '''CodigoStatusPedido:''' Código de status do pedido (do e-commerce) a ser considerado na busca de dados. Mais de um separados por vírgula;<br><br /> Códigos verificados e possíveis para utilização: <br><br /> '''6''': em aberto<br><br /> '''9''': atendido<br><br /> '''12''': cancelado<br><br /> '''15''': em andamento<br><br /> '''18''': venda agenciada<br><br /> '''21''': em digitação<br><br /> '''24''': verificado <br /> <br /> <br /> <br /> '''SituacaoCodigo:''' Código da situação padrão para a gravação dos pedidos;<br /> <br /> '''PortadorCodigo:''' Código do portador padrão para a gravação dos pedidos;<br /> <br /> '''TransportadoraCodigo:''' Código da(s) transportadora(s) (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;<br /> <br /> '''OpSaidaCodigo:''' Código da operação de saída padrão para a gravação dos pedidos;<br /> <br /> '''RepresentanteCodigo:''' Código do(s) representante(s) (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;<br /> <br /> '''TelevendasCodigo:''' Código do(s) televendas (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;<br /> <br /> '''CaracteristicaCodigo:''' Código da característica de venda padrão para a gravação dos pedidos;<br /> <br /> '''DiasPrazoEntrega:''' Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);<br /> <br /> '''TipoFrete:''' Tipo de frete;<br /> <br /> '''StatusCliente:''' Código do status de pessoa para clientes trazidos do e-commerce;<br /> <br /> '''RamoAtividadeCodigo:''' Código do ramo de atividade padrão para a gravação dos clientes;<br /> <br /> '''DefinirEnqFiscal:''' Define o enquadramento fiscal do cliente ao integrá-lo;<br /> <br /> '''EnqFiscalPessoaFisica:''' Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;<br /> <br /> '''EnqFiscalPessoaJuridica:''' Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;<br /> <br /> '''FamiliasKit:''' Define quais famílias serão consideradas para kits na integração;<br /> <br /> '''NumeroListaPrecoProdutos:''' Lista de Preços para realizar o envio dos produtos para o web service;<br /> <br /> '''IdsLojas:''' ID das lojas (separadas por ;), em que cada id corresponde a um canal (Os valores informados serão incluídos na consulta dos pedidos, coletando dados apenas das lojas especificadas.);<br /> <br /> '''PercentualLojas:''' Percentuais (separados por ;) a serem aplicados nos preços da lista de preços para cada loja. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 5; 10; 15;<br /> <br /> '''QtdeEstoque:''' Quantidade de estoque fixa a ser enviada. Se for zero ou vazio, enviará o estoque atual individual de cada produto.<br /> <br /> '''EmpresaReceptora:''' Empresa em que o pedido será integrado.<br /> <br /> '''DepositoId:''' Id do deposito para lançamento de estoque. Se 0 coleta o deposito padrão.<br /> <br /> '''ImpostoCodigoComissao:''' Código do imposto para comissão do marketplace.<br /> <br /> '''ImpostoCodigoFreteCusto:''' Código do imposto para custo de frete que o vendedor paga. <br /> <br /> Sobre os valores separados por ponto e vírgula, eles devem ser informados da seguinte forma:<br /> <br /> Para que o recurso funcione, é preciso informar nos campos RepresentanteCodigo, TelevendasCodigo e TransportadoraCodigo os valores separados por ponto e vírgula (;). A quantidade de valores deve ser a mesma do campo IdsLojas. Caso contrário, será exibida uma mensagem para que o ajuste seja feito.<br /> <br /> '''Exemplo:'''<br /> <br /> * '''RepresentanteCodigo:''' 30179;22610<br /> * '''TelevendasCodigo:''' 30179;22610<br /> * '''IdsLojas:''' 206050338;205992462<br /> <br /> Dessa forma, o RepresentanteCodigo e o TelevendasCodigo (30179) serão utilizados para a loja (206050338).<br /> <br /> O RepresentanteCodigo e o TelevendasCodigo (22610) serão utilizados para a loja (205992462).<br /> <br /> Se não for informado um ID de loja e apenas um representante, televendas ou transportadora for passado, o valor será utilizado para todas as lojas. Porém, se mais de um for informado, o sistema entenderá que a loja correspondente deve ser especificada.<br /> <br /> <br /> Para a versão 3 da API da Bling, foi incluído um novo processo de autenticação de usuário/aplicativo.<br /> <br /> == 1° Passo - Acessar Aplicativos ==<br /> <br /> Acessar Link:<br /> <ref>https://www.bling.com.br/login</ref><br /> <br /> Após acessar a conta, basta ir no Ícone de configurações -> Todas as configurações:<br /> [[Arquivo:Configurações Bling - Preferências.png|centro]]<br /> <br /> Depois basta ir em Cadastro -> Cadastro de Aplicativos: <nowiki>https://www.bling.com.br/login?r=https%3A%2F%2Fwww.bling.com.br%2Fcadastro.aplicativos.php</nowiki><br /> [[Arquivo:Configurações Bling - Cadastro de Aplicativos.png|centro]]<br /> <br /> Depois basta selecionar o aplicativo ou criar um novo:<br /> [[Arquivo:Configurações Bling - Aplicativos.png|centro]]<br /> <br /> Para criar um novo basta seguir as seguintes instruções: <ref>https://developer.bling.com.br/homologacao#inscri%C3%A7%C3%A3o</ref><br /> <br /> Ao criar um novo aplicativo, a URL de Callback será essa: <ref>https://ws32.dataplussistemas.com.br/DataPlusERP.svc/AuthorizationEcommerce</ref>. Será uma URL definida no servidor da DataPlus.<br /> <br /> Após a criação do aplicativo, você poderá obter as credenciais de acesso a API, como o ClientId e o ClientSecret:<br /> [[Arquivo:Configurações Bling - Credenciais de Acesso.png|centro]]<br /> <br /> == 2° Passo - Configuração no ERP ==<br /> <br /> No ERP basta informar as credencias ClientId e ClientSecret e uma identificação para recebimento do Token de autorização temporário '''(O token tem o tempo de expiração de 1 minuto)''' para a configuração do E-commerce:<br /> [[Arquivo:Info configuração e-commerce ERP.png|centro]]<br /> <br /> Após informar o as credenciais e a identificação para recebimento do token, basta clicar no botão '''Gerar Token Autorização''', após o click uma tela na Web será aberta, para a autorização do aplicativo com o ERP:<br /> [[Arquivo:Autorização Aplicativo E-commerce Bling - scopos.png|centro]]<br /> <br /> Basta selecionar autorizar logo abaixo:<br /> [[Arquivo:Autorização Aplicativo E-commerce Bling - Autorizar.png|centro]]<br /> <br /> Após a autorização, você será redirecionado para o webservice da DataPlus, com a mensagem de '''ok''' você pode fechar a página e prosseguir com o segundo passo:<br /> [[Arquivo:Retorno webservice ecommerce.png|centro]]<br /> <br /> '''Lembrando que o token gerado após a aparição da mensagem expira em 1 minuto, caso o token expire será necessário repetir o processo.'''<br /> <br /> Após gerar o token de acesso temporário, basta clicar em '''Gerar Token Acesso''':<br /> [[Arquivo:Mensagem sucesso configuração ecommerce.png|centro]]<br /> <br /> Com a mensagem o ecommerce está configurado corretamente. '''As credenciais de acesso é guardado em um XML na pasta do usuário (C:\Users\Vinicius\AppData\Local) no arquivo ApiConfig no nó <ApiBlingV3>.'''</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=RN_Integracao_Bling_V3&diff=16645 RN Integracao Bling V3 2026-06-01T13:22:50Z

<p>Vinicius: </p> <hr /> <div>Regra de negócio do tipo habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem o objetivo configurar e manipular a integração entre API Bling na versão 3 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.<br /> <br /> == Acoplamento ==<br /> Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos. Ela está preparada para funcionar com o elemento '''ExecutaOperacao''', sendo seu designador por '''Execução''' e tempo de execução '''Depois'''.<br /> <br /> == Parâmetros ==<br /> '''UrlEcommerce:''' Url do e-commerce https://api.bling.com.br/Api/v3;<br /> <br /> '''IntegracaoMagalu:''' Possui integração com a Magalu (se marcada esta opção, é removido os pontos do código do produto);<br /> <br /> '''ClientId:''' Credencial ClientId do aplicativo;<br /> <br /> '''ClientSecret:''' Credencial ClientSecret do aplicativo;<br /> <br /> '''CodigoStatusPedido:''' Código de status do pedido (do e-commerce) a ser considerado na busca de dados. Mais de um separados por vírgula;<br><br /> Códigos verificados e possíveis para utilização: <br><br /> '''6''': em aberto<br><br /> '''9''': atendido<br><br /> '''12''': cancelado<br><br /> '''15''': em andamento<br><br /> '''18''': venda agenciada<br><br /> '''21''': em digitação<br><br /> '''24''': verificado <br /> <br /> <br /> <br /> '''SituacaoCodigo:''' Código da situação padrão para a gravação dos pedidos;<br /> <br /> '''PortadorCodigo:''' Código do portador padrão para a gravação dos pedidos;<br /> <br /> '''TransportadoraCodigo:''' Código da(s) transportadora(s) (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;<br /> <br /> '''OpSaidaCodigo:''' Código da operação de saída padrão para a gravação dos pedidos;<br /> <br /> '''RepresentanteCodigo:''' Código do(s) representante(s) (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;<br /> <br /> '''TelevendasCodigo:''' Código do(s) televendas (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;<br /> <br /> '''CaracteristicaCodigo:''' Código da característica de venda padrão para a gravação dos pedidos;<br /> <br /> '''DiasPrazoEntrega:''' Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);<br /> <br /> '''TipoFrete:''' Tipo de frete;<br /> <br /> '''StatusCliente:''' Código do status de pessoa para clientes trazidos do e-commerce;<br /> <br /> '''RamoAtividadeCodigo:''' Código do ramo de atividade padrão para a gravação dos clientes;<br /> <br /> '''DefinirEnqFiscal:''' Define o enquadramento fiscal do cliente ao integrá-lo;<br /> <br /> '''EnqFiscalPessoaFisica:''' Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;<br /> <br /> '''EnqFiscalPessoaJuridica:''' Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;<br /> <br /> '''FamiliasKit:''' Define quais famílias serão consideradas para kits na integração;<br /> <br /> '''NumeroListaPrecoProdutos:''' Lista de Preços para realizar o envio dos produtos para o web service;<br /> <br /> '''IdsLojas:''' ID das lojas (separadas por ;), em que cada id corresponde a um canal (Os valores informados serão incluídos na consulta dos pedidos, coletando dados apenas das lojas especificadas.);<br /> <br /> '''PercentualLojas:''' Percentuais (separados por ;) a serem aplicados nos preços da lista de preços para cada loja. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 5; 10; 15;<br /> <br /> '''QtdeEstoque:''' Quantidade de estoque fixa a ser enviada. Se for zero ou vazio, enviará o estoque atual individual de cada produto.<br /> <br /> '''EmpresaReceptora:''' Empresa em que o pedido será integrado.<br /> <br /> '''DepositoId:''' Id do deposito para lançamento de estoque. Se 0 coleta o deposito padrão.<br /> <br /> '''ImpostoCodigoComissao:''' Código do imposto para comissão do marketplace.<br /> <br /> '''ImpostoCodigoFreteCusto:''' Código do imposto para custo de frete que o vendedor paga. <br /> <br /> Sobre os valores separados por ponto e vírgula, eles devem ser informados da seguinte forma:<br /> <br /> Para que o recurso funcione, é preciso informar nos campos RepresentanteCodigo, TelevendasCodigo e TransportadoraCodigo os valores separados por ponto e vírgula (;). A quantidade de valores deve ser a mesma do campo IdsLojas. Caso contrário, será exibida uma mensagem para que o ajuste seja feito.<br /> <br /> '''Exemplo:'''<br /> <br /> * '''RepresentanteCodigo:''' 30179;22610<br /> * '''TelevendasCodigo:''' 30179;22610<br /> * '''IdsLojas:''' 206050338;205992462<br /> <br /> Dessa forma, o RepresentanteCodigo e o TelevendasCodigo (30179) serão utilizados para a loja (206050338).<br /> <br /> O RepresentanteCodigo e o TelevendasCodigo (22610) serão utilizados para a loja (205992462).<br /> <br /> Se não for informado um ID de loja e apenas um representante, televendas ou transportadora for passado, o valor será utilizado para todas as lojas. Porém, se mais de um for informado, o sistema entenderá que a loja correspondente deve ser especificada.<br /> <br /> <br /> Para a versão 3 da API da Bling, foi incluído um novo processo de autenticação de usuário/aplicativo.<br /> <br /> == 1° Passo - Acessar Aplicativos ==<br /> <br /> Acessar Link:<br /> <ref>https://www.bling.com.br/login</ref><br /> <br /> Após acessar a conta<br /> [[Arquivo:Configurações Bling - Preferências.png|centro]]<br /> <br /> Depois<br /> [[Arquivo:Configurações Bling - Cadastro de Aplicativos.png|centro]]<br /> <br /> Depois basta selecionar o aplicativo ou criar um novo:<br /> [[Arquivo:Configurações Bling - Aplicativos.png|centro]]<br /> <br /> Para criar um novo basta seguir as seguintes instruções: <ref>https://developer.bling.com.br/homologacao#inscri%C3%A7%C3%A3o</ref><br /> <br /> Ao criar um novo aplicativo, a URL de Callback será essa: <ref>https://ws32.dataplussistemas.com.br/DataPlusERP.svc/AuthorizationEcommerce</ref>. Será uma URL definida no servidor da DataPlus.<br /> <br /> Após a criação do aplicativo, você poderá obter as credenciais de acesso a API, como o ClientId e o ClientSecret:<br /> [[Arquivo:Configurações Bling - Credenciais de Acesso.png|centro]]<br /> <br /> == 2° Passo - Configuração no ERP ==<br /> <br /> No ERP basta informar as credencias ClientId e ClientSecret e uma identificação para recebimento do Token de autorização temporário '''(O token tem o tempo de expiração de 1 minuto)''' para a configuração do E-commerce:<br /> [[Arquivo:Info configuração e-commerce ERP.png|centro]]<br /> <br /> Após informar o as credenciais e a identificação para recebimento do token, basta clicar no botão '''Gerar Token Autorização''', após o click uma tela na Web será aberta, para a autorização do aplicativo com o ERP:<br /> [[Arquivo:Autorização Aplicativo E-commerce Bling - scopos.png|centro]]<br /> <br /> Basta selecionar autorizar logo abaixo:<br /> [[Arquivo:Autorização Aplicativo E-commerce Bling - Autorizar.png|centro]]<br /> <br /> Após a autorização, você será redirecionado para o webservice da DataPlus, com a mensagem de '''ok''' você pode fechar a página e prosseguir com o segundo passo:<br /> [[Arquivo:Retorno webservice ecommerce.png|centro]]<br /> <br /> '''Lembrando que o token gerado após a aparição da mensagem expira em 1 minuto, caso o token expire será necessário repetir o processo.'''<br /> <br /> Após gerar o token de acesso temporário, basta clicar em '''Gerar Token Acesso''':<br /> [[Arquivo:Mensagem sucesso configuração ecommerce.png|centro]]<br /> <br /> Com a mensagem o ecommerce está configurado corretamente. '''As credenciais de acesso é guardado em um XML na pasta do usuário (C:\Users\Vinicius\AppData\Local) no arquivo ApiConfig no nó <ApiBlingV3>.'''</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=RN_Integracao_Bling_V3&diff=16644 RN Integracao Bling V3 2026-06-01T13:21:37Z

<p>Vinicius: </p> <hr /> <div>Regra de negócio do tipo habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem o objetivo configurar e manipular a integração entre API Bling na versão 3 e o DataPlusERP, podendo ser acessada pela tela de integração do sistema.<br /> <br /> == Acoplamento ==<br /> Essa regra de negócio só poder acoplada à entidade Comum.IntegracaoDadosExternos. Ela está preparada para funcionar com o elemento '''ExecutaOperacao''', sendo seu designador por '''Execução''' e tempo de execução '''Depois'''.<br /> <br /> == Parâmetros ==<br /> '''UrlEcommerce:''' Url do e-commerce https://api.bling.com.br/Api/v3;<br /> <br /> '''IntegracaoMagalu:''' Possui integração com a Magalu (se marcada esta opção, é removido os pontos do código do produto);<br /> <br /> '''ClientId:''' Credencial ClientId do aplicativo;<br /> <br /> '''ClientSecret:''' Credencial ClientSecret do aplicativo;<br /> <br /> '''CodigoStatusPedido:''' Código de status do pedido (do e-commerce) a ser considerado na busca de dados. Mais de um separados por vírgula;<br><br /> Códigos verificados e possíveis para utilização: <br><br /> '''6''': em aberto<br><br /> '''9''': atendido<br><br /> '''12''': cancelado<br><br /> '''15''': em andamento<br><br /> '''18''': venda agenciada<br><br /> '''21''': em digitação<br><br /> '''24''': verificado <br /> <br /> <br /> <br /> '''SituacaoCodigo:''' Código da situação padrão para a gravação dos pedidos;<br /> <br /> '''PortadorCodigo:''' Código do portador padrão para a gravação dos pedidos;<br /> <br /> '''TransportadoraCodigo:''' Código da(s) transportadora(s) (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;<br /> <br /> '''OpSaidaCodigo:''' Código da operação de saída padrão para a gravação dos pedidos;<br /> <br /> '''RepresentanteCodigo:''' Código do(s) representante(s) (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;<br /> <br /> '''TelevendasCodigo:''' Código do(s) televendas (separadas por ;) padrão para a gravação dos pedidos. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 1; 2; 3;<br /> <br /> '''CaracteristicaCodigo:''' Código da característica de venda padrão para a gravação dos pedidos;<br /> <br /> '''DiasPrazoEntrega:''' Prazo de entrega padrão, a partir da emissão, para pedidos (quantidade de dias);<br /> <br /> '''TipoFrete:''' Tipo de frete;<br /> <br /> '''StatusCliente:''' Código do status de pessoa para clientes trazidos do e-commerce;<br /> <br /> '''RamoAtividadeCodigo:''' Código do ramo de atividade padrão para a gravação dos clientes;<br /> <br /> '''DefinirEnqFiscal:''' Define o enquadramento fiscal do cliente ao integrá-lo;<br /> <br /> '''EnqFiscalPessoaFisica:''' Código do enquadramento fiscal padrão para Pessoa Fisica ao integrar o cliente;<br /> <br /> '''EnqFiscalPessoaJuridica:''' Código do enquadramento fiscal padrão para Pessoa Jurídica ao integrar o cliente;<br /> <br /> '''FamiliasKit:''' Define quais famílias serão consideradas para kits na integração;<br /> <br /> '''NumeroListaPrecoProdutos:''' Lista de Preços para realizar o envio dos produtos para o web service;<br /> <br /> '''IdsLojas:''' ID das lojas (separadas por ;), em que cada id corresponde a um canal (Os valores informados serão incluídos na consulta dos pedidos, coletando dados apenas das lojas especificadas.);<br /> <br /> '''PercentualLojas:''' Percentuais (separados por ;) a serem aplicados nos preços da lista de preços para cada loja. Deve manter a mesma a sequência da propriedade IdsLojas. Exemplo: 5; 10; 15;<br /> <br /> '''QtdeEstoque:''' Quantidade de estoque fixa a ser enviada. Se for zero ou vazio, enviará o estoque atual individual de cada produto.<br /> <br /> '''EmpresaReceptora:''' Empresa em que o pedido será integrado.<br /> <br /> '''DepositoId:''' Id do deposito para lançamento de estoque. Se 0 coleta o deposito padrão.<br /> <br /> '''ImpostoCodigoComissao:''' Código do imposto para comissão do marketplace.<br /> <br /> '''ImpostoCodigoFreteCusto:''' Código do imposto para custo de frete que o vendedor paga. <br /> <br /> Sobre os valores separados por ponto e vírgula, eles devem ser informados da seguinte forma:<br /> <br /> Para que o recurso funcione, é preciso informar nos campos RepresentanteCodigo, TelevendasCodigo e TransportadoraCodigo os valores separados por ponto e vírgula (;). A quantidade de valores deve ser a mesma do campo IdsLojas. Caso contrário, será exibida uma mensagem para que o ajuste seja feito.<br /> <br /> '''Exemplo:'''<br /> <br /> * '''RepresentanteCodigo:''' 30179;22610<br /> * '''TelevendasCodigo:''' 30179;22610<br /> * '''IdsLojas:''' 206050338;205992462<br /> <br /> Dessa forma, o RepresentanteCodigo e o TelevendasCodigo (30179) serão utilizados para a loja (206050338).<br /> <br /> O RepresentanteCodigo e o TelevendasCodigo (22610) serão utilizados para a loja (205992462).<br /> <br /> Se não for informado um ID de loja e apenas um representante, televendas ou transportadora for passado, o valor será utilizado para todas as lojas. Porém, se mais de um for informado, o sistema entenderá que a loja correspondente deve ser especificada.<br /> <br /> <br /> Para a versão 3 da API da Bling, foi incluído um novo processo de autenticação de usuário/aplicativo.<br /> <br /> == 1° Passo - Acessar Aplicativos ==<br /> <br /> Acessar Link:<br /> <ref>https://www.bling.com.br/login</ref><br /> <br /> Após acessar a conta<br /> [[Arquivo:Configurações Bling - Preferências.png|centro]]<br /> <br /> Depois basta ir em Cadastro -> Cadastro de Aplicativos: https://www.bling.com.br/login?r=https%3A%2F%2Fwww.bling.com.br%2Fcadastro.aplicativos.php<br /> [[Arquivo:Configurações Bling - Cadastro de Aplicativos.png|centro]]<br /> <br /> Depois basta selecionar o aplicativo ou criar um novo:<br /> [[Arquivo:Configurações Bling - Aplicativos.png|centro]]<br /> <br /> Para criar um novo basta seguir as seguintes instruções: <ref>https://developer.bling.com.br/homologacao#inscri%C3%A7%C3%A3o</ref><br /> <br /> Ao criar um novo aplicativo, a URL de Callback será essa: <ref>https://ws32.dataplussistemas.com.br/DataPlusERP.svc/AuthorizationEcommerce</ref>. Será uma URL definida no servidor da DataPlus.<br /> <br /> Após a criação do aplicativo, você poderá obter as credenciais de acesso a API, como o ClientId e o ClientSecret:<br /> [[Arquivo:Configurações Bling - Credenciais de Acesso.png|centro]]<br /> <br /> == 2° Passo - Configuração no ERP ==<br /> <br /> No ERP basta informar as credencias ClientId e ClientSecret e uma identificação para recebimento do Token de autorização temporário '''(O token tem o tempo de expiração de 1 minuto)''' para a configuração do E-commerce:<br /> [[Arquivo:Info configuração e-commerce ERP.png|centro]]<br /> <br /> Após informar o as credenciais e a identificação para recebimento do token, basta clicar no botão '''Gerar Token Autorização''', após o click uma tela na Web será aberta, para a autorização do aplicativo com o ERP:<br /> [[Arquivo:Autorização Aplicativo E-commerce Bling - scopos.png|centro]]<br /> <br /> Basta selecionar autorizar logo abaixo:<br /> [[Arquivo:Autorização Aplicativo E-commerce Bling - Autorizar.png|centro]]<br /> <br /> Após a autorização, você será redirecionado para o webservice da DataPlus, com a mensagem de '''ok''' você pode fechar a página e prosseguir com o segundo passo:<br /> [[Arquivo:Retorno webservice ecommerce.png|centro]]<br /> <br /> '''Lembrando que o token gerado após a aparição da mensagem expira em 1 minuto, caso o token expire será necessário repetir o processo.'''<br /> <br /> Após gerar o token de acesso temporário, basta clicar em '''Gerar Token Acesso''':<br /> [[Arquivo:Mensagem sucesso configuração ecommerce.png|centro]]<br /> <br /> Com a mensagem o ecommerce está configurado corretamente. '''As credenciais de acesso é guardado em um XML na pasta do usuário (C:\Users\Vinicius\AppData\Local) no arquivo ApiConfig no nó <ApiBlingV3>.'''</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=DPServer_-_Servi%C3%A7o&diff=16574 DPServer - Serviço 2026-05-29T13:29:40Z

<p>Vinicius: </p> <hr /> <div>= 📖 MANUAL DE DEPLOY E ATUALIZAÇÃO: Matriz de Responsabilidades (dpServer) =<br /> Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.<br /> <br /> == 💻 1. ESCOPO DO DESENVOLVIMENTO ==<br /> <br /> === Alteração da Versão do Executável (Assembly) ===<br /> <br /> * Incrementar o número da versão física do arquivo sempre que houver modificações.<br /> * '''Como fazer:''' No Visual Studio, acesse as propriedades do projeto <code>dpServerService</code> -> Aba '''Aplicativo''' -> Botão '''Informações do Assembly...''' -> Incremente a '''Versão do assembly''' e '''Versão do arquivo''' (Ex: <code>1.0.0.0</code> para <code>1.1.0.0</code>).[[Arquivo:Mudança de versão - dpServerService.png|miniaturadaimagem|785x785px|centro]]<br /> * ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.<br /> <br /> === Compilação em Modo Release ===<br /> <br /> * Alterar o seletor do Visual Studio de <code>Debug</code> para '''<code>Release</code>''' e executar o comando '''Recompilar Solução''' (''Rebuild Solution'') dos dois projetos.<br /> <br /> === Compilação e Geração do Instalador (.msi) ===<br /> Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.<br /> <br /> O projeto possui um projeto de Setup integrado (usando Microsoft Visual Studio Installer Projects).<br /> <br /> # Na janela do ''Solution Explorer'', localize o projeto de instalação ('''<code>dpServerService.Setup</code>''') .<br /> # Clique com o botão direito sobre o projeto '''<code>dpServerService.Setup</code>'''e selecione '''Compilar''' (''Build'') ou ''Rebuild''.<br /> # O Visual Studio gerará os arquivos de instalação na pasta de saída do setup.<br /> # Navegue até a pasta física do projeto de setup (Ex: <code>...\</code><code>dpServerService.Setup\Release\</code>) e copie o arquivo '''<code>dpServerService.Setup.msi</code>''' (e o <code>setup.exe</code> se houver).<br /> # Disponibilize estes arquivos para a equipe de Atendimento.<br /> ⚠️ '''REGRA:''' '''NUNCA''' inclua o arquivo <code>dpServerService.exe.config</code> (App.Config) no pacote de atualização. O envio deste arquivo destrói as configurações customizadas do cliente, pois é lá que fica configurado o caminho dos arquivos de atualização.<br /> <br /> == 🛠️ 2. ESCOPO DO ATENDIMENTO / SUPORTE ==<br /> O Atendimento é responsável pela implantação no servidor do cliente, configuração dos ambientes, parametrização dos arquivos locais e aplicação de atualizações enviadas pelo desenvolvimento.<br /> <br /> === Primeira Instalação e Configuração do Ambiente ===<br /> <br /> * '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.<br /> * '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente. <br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 1 - dpServerService.png|centro|miniaturadaimagem|471x471px]]<br /> Escolha o caminho de instalação e clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 2 - dpServerService.png|centro|miniaturadaimagem|486x486px]]<br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 3 - dpServerService.png|centro|miniaturadaimagem|496x496px]]<br /> <br /> <br /> Aguarde a instalação concluir e clique em '''fechar'''.<br /> <br /> * 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação <code>C:\Program Files (x86)\...\dpServerService.Setup</code>. <br /> * 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz acordada (Ex: <code>value="C:\DpServer\"</code>). [[Arquivo:Caminho arquivos - dpServerService.png|centro|miniaturadaimagem|661x661px]]<br /> * 4. Verificar se as credenciais do email estão corretas.<br /> <br /> === Gestão do Arquivo DpSettings.xml ===<br /> <br /> * '''O que fazer:''' Garantir que o arquivo de conexão com o banco de dados esteja no local correto determinado pela configuração (Deve ser disponibilizado na pasta de instalação).<br /> '''Como fazer:''' Copiar o arquivo <code>DpSettings.xml</code> do cliente e colá-lo dentro da pasta raiz configurada na chave <code>CaminhoArquivos</code> (Ex: dentro de <code>C:\DpServer\</code>).[[Arquivo:DpSettings - dpServerService.png|miniaturadaimagem|448x448px|centro]]<br /> <br /> === Iniciando o serviço. ===<br /> '''Primeira Instalação:''' > Após concluir as configurações nos arquivos (incluindo o <code>DpSettings.xml</code>), será necessário iniciar o serviço do Windows. Siga os passos abaixo:<br /> <br /> # Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.<br /> # Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").<br /> # Clique em '''Iniciar'''.<br /> # Certifique-se de que o status na coluna correspondente mudou para '''"Em execução"'''.[[Arquivo:Serviços - dpServerServico.png|centro|miniaturadaimagem|712x712px]]<br /> <br /> === Aplicação de Atualizações (Update de Versão) ===<br /> * Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>C:\DpServer\Atualizacao</code>).<br /> * Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.<br /> * O serviço detectará os arquivos novos, fará a substituição e reiniciará de forma 100% automatizada em até 5 minutos.<br /> <br /> == 🔍 3. GUIA DE RESOLUÇÃO DE PROBLEMAS ==<br /> Se a atualização falhar ou o serviço não iniciar, o Atendimento deve seguir este roteiro de checagem:<br /> <br /> === O serviço não atualizou automaticamente? ===<br /> <br /> * '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.<br /> * '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png|nenhum|miniaturadaimagem|529x529px]]<br /> <br /> === Onde verificar o que aconteceu? ===<br /> <br /> # '''Logs do dpServer:''' Para visualizar os logs, basta dar um duplo clique sobre o ícone de status.:[[Arquivo:Logs do DpServer - dpServerService.png|nenhum|miniaturadaimagem|847x847px]]<br /> # '''No arquivo de texto:''' Abra o arquivo <code>dpServerApp.log</code> localizado diretamente na pasta raiz configurada do cliente[[Arquivo:Logs do DpServer .txt - dpServerService.png|nenhum|miniaturadaimagem|766x766px]]<br /> # '''E-mail de avisos:''' Diferente dos outros logs, o log de e-mail será '''enviado''' somente quando ocorrerem erros no processamento:[[Arquivo:Logs do DpServer e-mail - dpServerService.png|nenhum|miniaturadaimagem|766x766px]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=DPServer_-_Servi%C3%A7o&diff=16573 DPServer - Serviço 2026-05-29T13:29:01Z

<p>Vinicius: </p> <hr /> <div>= 📖 MANUAL DE DEPLOY E ATUALIZAÇÃO: Matriz de Responsabilidades (dpServer) =<br /> Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.<br /> <br /> === 💻 1. ESCOPO DO DESENVOLVIMENTO ===<br /> <br /> === Alteração da Versão do Executável (Assembly) ===<br /> <br /> * Incrementar o número da versão física do arquivo sempre que houver modificações.<br /> * '''Como fazer:''' No Visual Studio, acesse as propriedades do projeto <code>dpServerService</code> -> Aba '''Aplicativo''' -> Botão '''Informações do Assembly...''' -> Incremente a '''Versão do assembly''' e '''Versão do arquivo''' (Ex: <code>1.0.0.0</code> para <code>1.1.0.0</code>).[[Arquivo:Mudança de versão - dpServerService.png|miniaturadaimagem|785x785px|centro]]<br /> * ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.<br /> <br /> === Compilação em Modo Release ===<br /> <br /> * Alterar o seletor do Visual Studio de <code>Debug</code> para '''<code>Release</code>''' e executar o comando '''Recompilar Solução''' (''Rebuild Solution'') dos dois projetos.<br /> <br /> === Compilação e Geração do Instalador (.msi) ===<br /> Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.<br /> <br /> O projeto possui um projeto de Setup integrado (usando Microsoft Visual Studio Installer Projects).<br /> <br /> # Na janela do ''Solution Explorer'', localize o projeto de instalação ('''<code>dpServerService.Setup</code>''') .<br /> # Clique com o botão direito sobre o projeto '''<code>dpServerService.Setup</code>'''e selecione '''Compilar''' (''Build'') ou ''Rebuild''.<br /> # O Visual Studio gerará os arquivos de instalação na pasta de saída do setup.<br /> # Navegue até a pasta física do projeto de setup (Ex: <code>...\</code><code>dpServerService.Setup\Release\</code>) e copie o arquivo '''<code>dpServerService.Setup.msi</code>''' (e o <code>setup.exe</code> se houver).<br /> # Disponibilize estes arquivos para a equipe de Atendimento.<br /> ⚠️ '''REGRA:''' '''NUNCA''' inclua o arquivo <code>dpServerService.exe.config</code> (App.Config) no pacote de atualização. O envio deste arquivo destrói as configurações customizadas do cliente, pois é lá que fica configurado o caminho dos arquivos de atualização.<br /> <br /> == 🛠️ 2. ESCOPO DO ATENDIMENTO / SUPORTE ==<br /> O Atendimento é responsável pela implantação no servidor do cliente, configuração dos ambientes, parametrização dos arquivos locais e aplicação de atualizações enviadas pelo desenvolvimento.<br /> <br /> === Primeira Instalação e Configuração do Ambiente ===<br /> <br /> * '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.<br /> * '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente. <br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 1 - dpServerService.png|centro|miniaturadaimagem|471x471px]]<br /> Escolha o caminho de instalação e clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 2 - dpServerService.png|centro|miniaturadaimagem|486x486px]]<br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 3 - dpServerService.png|centro|miniaturadaimagem|496x496px]]<br /> <br /> <br /> Aguarde a instalação concluir e clique em '''fechar'''.<br /> <br /> * 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação <code>C:\Program Files (x86)\...\dpServerService.Setup</code>. <br /> * 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz acordada (Ex: <code>value="C:\DpServer\"</code>). [[Arquivo:Caminho arquivos - dpServerService.png|centro|miniaturadaimagem|661x661px]]<br /> * 4. Verificar se as credenciais do email estão corretas.<br /> <br /> === Gestão do Arquivo DpSettings.xml ===<br /> <br /> * '''O que fazer:''' Garantir que o arquivo de conexão com o banco de dados esteja no local correto determinado pela configuração (Deve ser disponibilizado na pasta de instalação).<br /> '''Como fazer:''' Copiar o arquivo <code>DpSettings.xml</code> do cliente e colá-lo dentro da pasta raiz configurada na chave <code>CaminhoArquivos</code> (Ex: dentro de <code>C:\DpServer\</code>).[[Arquivo:DpSettings - dpServerService.png|miniaturadaimagem|448x448px|centro]]<br /> <br /> === Iniciando o serviço. ===<br /> '''Primeira Instalação:''' > Após concluir as configurações nos arquivos (incluindo o <code>DpSettings.xml</code>), será necessário iniciar o serviço do Windows. Siga os passos abaixo:<br /> <br /> # Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.<br /> # Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").<br /> # Clique em '''Iniciar'''.<br /> # Certifique-se de que o status na coluna correspondente mudou para '''"Em execução"'''.[[Arquivo:Serviços - dpServerServico.png|centro|miniaturadaimagem|712x712px]]<br /> <br /> === Aplicação de Atualizações (Update de Versão) ===<br /> * Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>C:\DpServer\Atualizacao</code>).<br /> * Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.<br /> * O serviço detectará os arquivos novos, fará a substituição e reiniciará de forma 100% automatizada em até 5 minutos.<br /> <br /> == 🔍 3. GUIA DE RESOLUÇÃO DE PROBLEMAS ==<br /> Se a atualização falhar ou o serviço não iniciar, o Atendimento deve seguir este roteiro de checagem:<br /> <br /> === O serviço não atualizou automaticamente? ===<br /> <br /> * '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.<br /> * '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png|nenhum|miniaturadaimagem|529x529px]]<br /> <br /> === Onde verificar o que aconteceu? ===<br /> <br /> # '''Logs do dpServer:''' Para visualizar os logs, basta dar um duplo clique sobre o ícone de status.:[[Arquivo:Logs do DpServer - dpServerService.png|nenhum|miniaturadaimagem|847x847px]]<br /> # '''No arquivo de texto:''' Abra o arquivo <code>dpServerApp.log</code> localizado diretamente na pasta raiz configurada do cliente[[Arquivo:Logs do DpServer .txt - dpServerService.png|nenhum|miniaturadaimagem|766x766px]]<br /> # '''E-mail de avisos:''' Diferente dos outros logs, o log de e-mail será '''enviado''' somente quando ocorrerem erros no processamento:[[Arquivo:Logs do DpServer e-mail - dpServerService.png|nenhum|miniaturadaimagem|766x766px]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=DPServer_-_Servi%C3%A7o&diff=16572 DPServer - Serviço 2026-05-29T13:28:01Z

<p>Vinicius: /* 💻 1. ESCOPO DO DESENVOLVIMENTO */</p> <hr /> <div>= 📖 MANUAL DE DEPLOY E ATUALIZAÇÃO: Matriz de Responsabilidades (dpServer) =<br /> Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.<br /> <br /> == 💻 1. ESCOPO DO DESENVOLVIMENTO ==<br /> <br /> === Alteração da Versão do Executável (Assembly) ===<br /> <br /> * Incrementar o número da versão física do arquivo sempre que houver modificações.<br /> * '''Como fazer:''' No Visual Studio, acesse as propriedades do projeto <code>dpServerService</code> -> Aba '''Aplicativo''' -> Botão '''Informações do Assembly...''' -> Incremente a '''Versão do assembly''' e '''Versão do arquivo''' (Ex: <code>1.0.0.0</code> para <code>1.1.0.0</code>).[[Arquivo:Mudança de versão - dpServerService.png|miniaturadaimagem|785x785px|centro]]<br /> * ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.<br /> <br /> === Compilação em Modo Release ===<br /> <br /> * Alterar o seletor do Visual Studio de <code>Debug</code> para '''<code>Release</code>''' e executar o comando '''Recompilar Solução''' (''Rebuild Solution'') dos dois projetos.<br /> <br /> === Compilação e Geração do Instalador (.msi) ===<br /> Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.<br /> <br /> O projeto possui um projeto de Setup integrado (usando Microsoft Visual Studio Installer Projects).<br /> <br /> # Na janela do ''Solution Explorer'', localize o projeto de instalação ('''<code>dpServerService.Setup</code>''') .<br /> # Clique com o botão direito sobre o projeto '''<code>dpServerService.Setup</code>'''e selecione '''Compilar''' (''Build'') ou ''Rebuild''.<br /> # O Visual Studio gerará os arquivos de instalação na pasta de saída do setup.<br /> # Navegue até a pasta física do projeto de setup (Ex: <code>...\</code><code>dpServerService.Setup\Release\</code>) e copie o arquivo '''<code>dpServerService.Setup.msi</code>''' (e o <code>setup.exe</code> se houver).<br /> # Disponibilize estes arquivos para a equipe de Atendimento.<br /> ⚠️ '''REGRA:''' '''NUNCA''' inclua o arquivo <code>dpServerService.exe.config</code> (App.Config) no pacote de atualização. O envio deste arquivo destrói as configurações customizadas do cliente, pois é lá que fica configurado o caminho dos arquivos de atualização.<br /> <br /> == 🛠️ 2. ESCOPO DO ATENDIMENTO / SUPORTE ==<br /> O Atendimento é responsável pela implantação no servidor do cliente, configuração dos ambientes, parametrização dos arquivos locais e aplicação de atualizações enviadas pelo desenvolvimento.<br /> <br /> === Primeira Instalação e Configuração do Ambiente ===<br /> <br /> * '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.<br /> * '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente. <br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 1 - dpServerService.png|centro|miniaturadaimagem|471x471px]]<br /> Escolha o caminho de instalação e clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 2 - dpServerService.png|centro|miniaturadaimagem|486x486px]]<br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 3 - dpServerService.png|centro|miniaturadaimagem|496x496px]]<br /> <br /> <br /> Aguarde a instalação concluir e clique em '''fechar'''.<br /> <br /> * 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação <code>C:\Program Files (x86)\...\dpServerService.Setup</code>. <br /> * 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz acordada (Ex: <code>value="C:\DpServer\"</code>). [[Arquivo:Caminho arquivos - dpServerService.png|centro|miniaturadaimagem|661x661px]]<br /> * 4. Verificar se as credenciais do email estão corretas.<br /> <br /> === Gestão do Arquivo DpSettings.xml ===<br /> <br /> * '''O que fazer:''' Garantir que o arquivo de conexão com o banco de dados esteja no local correto determinado pela configuração (Deve ser disponibilizado na pasta de instalação).<br /> '''Como fazer:''' Copiar o arquivo <code>DpSettings.xml</code> do cliente e colá-lo dentro da pasta raiz configurada na chave <code>CaminhoArquivos</code> (Ex: dentro de <code>C:\DpServer\</code>).[[Arquivo:DpSettings - dpServerService.png|miniaturadaimagem|448x448px|centro]]<br /> <br /> === Iniciando o serviço. ===<br /> '''Primeira Instalação:''' > Após concluir as configurações nos arquivos (incluindo o <code>DpSettings.xml</code>), será necessário iniciar o serviço do Windows. Siga os passos abaixo:<br /> <br /> # Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.<br /> # Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").<br /> # Clique em '''Iniciar'''.<br /> # Certifique-se de que o status na coluna correspondente mudou para '''"Em execução"'''.[[Arquivo:Serviços - dpServerServico.png|centro|miniaturadaimagem|712x712px]]<br /> <br /> === Aplicação de Atualizações (Update de Versão) ===<br /> * Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>C:\DpServer\Atualizacao</code>).<br /> * Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.<br /> * O serviço detectará os arquivos novos, fará a substituição e reiniciará de forma 100% automatizada em até 5 minutos.<br /> <br /> == 🔍 3. GUIA DE RESOLUÇÃO DE PROBLEMAS ==<br /> Se a atualização falhar ou o serviço não iniciar, o Atendimento deve seguir este roteiro de checagem:<br /> <br /> === O serviço não atualizou automaticamente? ===<br /> <br /> * '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.<br /> * '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png|nenhum|miniaturadaimagem|529x529px]]<br /> <br /> === Onde verificar o que aconteceu? ===<br /> <br /> # '''Logs do dpServer:''' Para visualizar os logs, basta dar um duplo clique sobre o ícone de status.:[[Arquivo:Logs do DpServer - dpServerService.png|nenhum|miniaturadaimagem|847x847px]]<br /> # '''No arquivo de texto:''' Abra o arquivo <code>dpServerApp.log</code> localizado diretamente na pasta raiz configurada do cliente[[Arquivo:Logs do DpServer .txt - dpServerService.png|nenhum|miniaturadaimagem|766x766px]]<br /> # '''E-mail de avisos:''' Diferente dos outros logs, o log de e-mail será '''enviado''' somente quando ocorrerem erros no processamento:[[Arquivo:Logs do DpServer e-mail - dpServerService.png|nenhum|miniaturadaimagem|766x766px]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=DPServer_-_Servi%C3%A7o&diff=16568 DPServer - Serviço 2026-05-29T13:05:29Z

<p>Vinicius: </p> <hr /> <div>= 📖 MANUAL DE DEPLOY E ATUALIZAÇÃO: Matriz de Responsabilidades (dpServer) =<br /> Este documento define claramente o escopo de atuação da equipe de '''Desenvolvimento''' e da equipe de '''Atendimento/Suporte''' no processo de geração de versões, instalação e atualização do serviço <code>dpServer</code>.<br /> <br /> == 💻 1. ESCOPO DO DESENVOLVIMENTO ==<br /> <br /> === 1.1. Alteração da Versão do Executável (Assembly) ===<br /> <br /> * Incrementar o número da versão física do arquivo sempre que houver modificações.<br /> * '''Como fazer:''' No Visual Studio, acesse as propriedades do projeto <code>dpServerService</code> -> Aba '''Aplicativo''' -> Botão '''Informações do Assembly...''' -> Incremente a '''Versão do assembly''' e '''Versão do arquivo''' (Ex: <code>1.0.0.0</code> para <code>1.1.0.0</code>).[[Arquivo:Mudança de versão - dpServerService.png|miniaturadaimagem|785x785px|centro]]<br /> * ''Nota:'' Nunca utilize a aba "Publicar" (ClickOnce), pois o serviço não lê essa numeração.<br /> <br /> === 1.2. Compilação em Modo Release ===<br /> <br /> * Alterar o seletor do Visual Studio de <code>Debug</code> para '''<code>Release</code>''' e executar o comando '''Recompilar Solução''' (''Rebuild Solution'') dos dois projetos.<br /> <br /> === 1.3. Compilação e Geração do Instalador (.msi) ===<br /> Separar apenas os arquivos necessários para a atualização e disponibilizá-los para a equipe de Atendimento.<br /> <br /> O projeto possui um projeto de Setup integrado (usando Microsoft Visual Studio Installer Projects).<br /> <br /> # Na janela do ''Solution Explorer'', localize o projeto de instalação ('''<code>dpServerService.Setup</code>''') .<br /> # Clique com o botão direito sobre o projeto '''<code>dpServerService.Setup</code>'''e selecione '''Compilar''' (''Build'') ou ''Rebuild''.<br /> # O Visual Studio gerará os arquivos de instalação na pasta de saída do setup.<br /> # Navegue até a pasta física do projeto de setup (Ex: <code>...\</code><code>dpServerService.Setup\Release\</code>) e copie o arquivo '''<code>dpServerService.Setup.msi</code>''' (e o <code>setup.exe</code> se houver).<br /> # Disponibilize estes arquivos para a equipe de Atendimento.<br /> ⚠️ '''REGRA:''' '''NUNCA''' inclua o arquivo <code>dpServerService.exe.config</code> (App.Config) no pacote de atualização. O envio deste arquivo destrói as configurações customizadas do cliente, pois é lá que fica configurado o caminho dos arquivos de atualização.<br /> <br /> == 🛠️ 2. ESCOPO DO ATENDIMENTO / SUPORTE ==<br /> O Atendimento é responsável pela implantação no servidor do cliente, configuração dos ambientes, parametrização dos arquivos locais e aplicação de atualizações enviadas pelo desenvolvimento.<br /> <br /> === 2.1. Primeira Instalação e Configuração do Ambiente ===<br /> <br /> * '''O que fazer:''' Instalar o serviço e parametrizar o arquivo (<code>dpServerService.exe.config</code>) de configuração de acordo com a realidade de cada cliente.<br /> * '''Como fazer:''' 1. Executar o instalador <code>.msi</code> padrão no servidor do cliente. <br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 1 - dpServerService.png|centro|miniaturadaimagem|471x471px]]<br /> Escolha o caminho de instalação e clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 2 - dpServerService.png|centro|miniaturadaimagem|486x486px]]<br /> Clique em '''avançar''':<br /> [[Arquivo:Instalação setup .msi 3 - dpServerService.png|centro|miniaturadaimagem|496x496px]]<br /> <br /> <br /> Aguarde a instalação concluir e clique em '''fechar'''.<br /> <br /> * 2. Abrir o arquivo <code>dpServerService.exe.config</code> com o Bloco de Notas na pasta de instalação <code>C:\Program Files (x86)\...\dpServerService.Setup</code>. <br /> * 3. Configurar a chave '''<code>CaminhoArquivos</code>''' apontando para a pasta raiz acordada (Ex: <code>value="C:\DpServer\"</code>). [[Arquivo:Caminho arquivos - dpServerService.png|centro|miniaturadaimagem|661x661px]]<br /> * 4. Verificar se as credenciais do email estão corretas.<br /> <br /> === 2.2. Gestão do Arquivo DpSettings.xml ===<br /> <br /> * '''O que fazer:''' Garantir que o arquivo de conexão com o banco de dados esteja no local correto determinado pela configuração (Deve ser disponibilizado na pasta de instalação).<br /> '''Como fazer:''' Copiar o arquivo <code>DpSettings.xml</code> do cliente e colá-lo dentro da pasta raiz configurada na chave <code>CaminhoArquivos</code> (Ex: dentro de <code>C:\DpServer\</code>).[[Arquivo:DpSettings - dpServerService.png|miniaturadaimagem|448x448px|centro]]<br /> <br /> === 2.3. Iniciando o serviço. ===<br /> '''Primeira Instalação:''' > Após concluir as configurações nos arquivos (incluindo o <code>DpSettings.xml</code>), será necessário iniciar o serviço do Windows. Siga os passos abaixo:<br /> <br /> # Pressione '''Win + R''', digite <code>services.msc</code> e pressione '''Enter'''.<br /> # Procure pelo serviço '''dpServer''' (caso não o encontre, clique em "Atualizar").<br /> # Clique em '''Iniciar'''.<br /> # Certifique-se de que o status na coluna correspondente mudou para '''"Em execução"'''.[[Arquivo:Serviços - dpServerServico.png|centro|miniaturadaimagem|712x712px]]<br /> <br /> === 2.4. Aplicação de Atualizações (Update de Versão) ===<br /> * Certificar-se de que a subpasta '''<code>Atualizacao</code>''' existe (caso não exista, criar exatamente com esse nome) dentro da pasta raiz do cliente (Ex: <code>C:\DpServer\Atualizacao</code>).<br /> * Pegar os arquivos liberados pelo desenvolvimento (<code>.exe</code> e <code>.dlls</code>) e colá-los '''dentro''' dessa pasta <code>\Atualizacao</code>.<br /> * O serviço detectará os arquivos novos, fará a substituição e reiniciará de forma 100% automatizada em até 5 minutos.<br /> <br /> == 🔍 3. GUIA DE RESOLUÇÃO DE PROBLEMAS ==<br /> Se a atualização falhar ou o serviço não iniciar, o Atendimento deve seguir este roteiro de checagem:<br /> <br /> === O serviço não atualizou automaticamente? ===<br /> <br /> * '''Causa 1:''' Os arquivos foram colocados na pasta errada. Certifique-se de que estão dentro da subpasta <code>\Atualizacao</code>.<br /> * '''Causa 2:''' O Desenvolvimento esqueceu de mudar a versão do Assembly. Abra as propriedades do arquivo <code>.exe</code> enviado pelo Dev, vá na aba ''Detalhes'' e verifique se a versão é realmente maior do que a que já está rodando.[[Arquivo:Propriedades - dpServerService.png|nenhum|miniaturadaimagem|529x529px]]<br /> <br /> === Onde verificar o que aconteceu? ===<br /> <br /> # '''Logs do dpServer:''' Para visualizar os logs, basta dar um duplo clique sobre o ícone de status.:[[Arquivo:Logs do DpServer - dpServerService.png|nenhum|miniaturadaimagem|847x847px]]<br /> # '''No arquivo de texto:''' Abra o arquivo <code>dpServerApp.log</code> localizado diretamente na pasta raiz configurada do cliente[[Arquivo:Logs do DpServer .txt - dpServerService.png|nenhum|miniaturadaimagem|766x766px]]<br /> # '''E-mail de avisos:''' Diferente dos outros logs, o log de e-mail será '''enviado''' somente quando ocorrerem erros no processamento:[[Arquivo:Logs do DpServer e-mail - dpServerService.png|nenhum|miniaturadaimagem|766x766px]]</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Arquivo:Servi%C3%A7os_-_dpServerServico.png&diff=16567 Arquivo:Serviços - dpServerServico.png 2026-05-29T13:01:48Z

<p>Vinicius: </p> <hr /> <div>Serviços - dpServerServico</div>

Vinicius https://wiki.dataplussistemas.com.br/index.php?title=Arquivo:Caminho_arquivos_-_dpServerService.png&diff=16565 Arquivo:Caminho arquivos - dpServerService.png 2026-05-29T12:55:12Z

<p>Vinicius: </p> <hr /> <div>Caminho arquivos - dpServerService</div>

Vinicius