Mudanças entre as páginas "Registro 1601" e "Servidor de Aplicação"

(Diferenças entre páginas)
 
(→‎Bases de Dados)
 
Linha 1: Linha 1:
 
==='''Conceito'''===
 
==='''Conceito'''===
 +
O servidor de aplicação desempenha um papel fundamental no controle de todas as interações entre o cliente, o servidor e o banco de dados. Essas interações podem se originar de aplicativos desktop, web, mobile ou outros meios de integração. Ele é responsável por gerenciar todas as requisições recebidas, identificar o usuário, a base de dados e executar os procedimentos necessários, além de controlar as transações do banco de dados para garantir a integridade das informações.
  
−
O registro 1601 do SPED é utilizado para informar operações com instrumentos de pagamento eletrônicos, como cartão de crédito/débito, pix e outros.
+
Além disso, ele não apenas lida com as requisições, mas também gerencia um conjunto de conexões pré-estabelecidas, conhecido como '''[[Pool de Conexões|pool de conexões]]'''. Essa abordagem permite reutilizar conexões existentes, minimizando o tempo de estabelecimento de conexões e maximizando a eficiência e o desempenho geral do sistema. Assim, o servidor de aplicação desempenha um papel vital no controle das interações, no gerenciamento das transações e no eficiente uso do pool de conexões.
  
−
==='''Forma de fazer'''===
+
É necessária a '''[https://wiki.phsys.com.br/index.php/Instala%C3%A7%C3%A3o_do_Servi%C3%A7o_PHSServer instalação do serviço]''' responsável pela execução do servidor de aplicação, seguindo as orientações de configuração para o correto funcionamento, assim como o acesso através da ferramenta de configuração PHServerConf.
  
−
Inicialmente é necessário que as instituições financeiras, tais como bancos e intermediadores envolvidos, estejam incluídos junto ao cadastro de [[Cadastro_de_Fornecedores|fornecedores]]. Para parametrização do registro 1601 do SPED, deve ser informado em cada um dos bancos utilizados pelo cliente, a instituição financeira, assim como nas formas de pagamento envolvendo intermediador (Marketplace/Delivery e Outros). Na forma de pagamento, caso exista um intermediador na transação, como por exemplo: Mercado Livre, Maquina de cartão, entre outros, dever ser informada a instituição financeira responsável por intermediar o recebimento. Sendo assim se faz necessária criação de formas de pagamento exclusivas para estes casos. Ainda na forma de pagamento, temos o meio de pagamento, que identifica a forma de pagamento perante o fisco e se está é considerada um meio de pagamento eletrônico (PIX, cartão de crédito/débito, boleto bancário, entre outros).
+
==='''PHServerConf'''===
 +
O PHServerConf é a solução com interface web que permite o gerenciamento das configurações do servidor de aplicação, desempenhando um papel fundamental como ferramenta para cadastrar bases de dados e configurar o sistema. É de extrema importância que o PHServerConf esteja configurado corretamente, a fim de garantir o funcionamento adequado do sistema ERP PHSYS nas estações de trabalho.
  
−
==='''O que é'''===
+
Através do PHServerConf, é possível realizar o cadastro das bases de dados necessárias para o sistema, bem como realizar as configurações adequadas para atender às necessidades específicas do ambiente. Ao garantir uma configuração correta do PHServerConf, é possível assegurar uma integração perfeita entre o sistema ERP PHSYS e as estações de trabalho, evitando possíveis falhas ou erros.
  
−
O registro destina-se a identificar o valor total das operações realizadas pelo declarante por meio de instrumentos de pagamentos eletrônicos, discriminado por instituição financeira e de pagamento, integrante ou não do Sistema de Pagamentos Brasileiro – SPB (Convênio ICMS nº 134/2016). Deve-se consultar o contrato firmado entre a instituição e o informante do arquivo, para se ratificar a existência da prestação do serviço, quando couber. Deve ser informado o valor total destas operações, excluídos os estornos e cancelamentos.
+
Portanto, é altamente recomendado que seja dada a devida atenção à configuração precisa e correta do PHServerConf, a fim de estabelecer um ambiente estável e funcional para o sistema ERP PHSYS operar de maneira eficiente e confiável.
  
−
==='''Exemplos'''===
+
Devido ao servidor de aplicação suportar diferentes bases de dados, é necessário o cadastro das bases de dados correspondentes a cada sistema PHERP que será gerenciado pelo servidor de aplicação. 
  
−
Um produto vendido por R$ 1.000,00 reais, acaba sendo pago R$ 600,00 em dinheiro e R$ 400,00 no cartão da Instituição "X". Deve-se reportar no 1601, no participante "X", os R$ 400,00. E somente se houver o depósito dos R$ 600,00 no Banco "Y" deve ser reportado, no participante "Y".
+
O servidor de aplicação possui uma base de dados própria junto ao banco de dados, e também oferece suporte a diferentes bancos de dados:
 +
*0 = SQLIte
 +
*1 = SQLServer
 +
*2 = Oracle
 +
*3 = Firebird
 +
*4 = PostgreSQL
  
−
==='''Telas / Campos'''===
+
As informações sobre o banco de dados utilizado pelo servidor de aplicação, devem estar informadas no arquivo Parametros.ini, no mesmo diretório do PHServer.exe. Abaixo exemplo com banco de dados PostgreSQL:
−
'''COD_PART_IP:''' Informado o CNPJ e o código da instituição financeira vinculada ao banco da conta realizada no recebimento.
 
  
−
'''COD_PART_IT:''' Informado o CNPJ e o código do intermediador da transação (agenciador, plataforma de delivery e similar) de serviços e de negócios. As informações de intermediador deve ser informado junto a forma de pagamento no campo Instituição Financeira, sendo necessário uma forma de pagamento diferente para cada intermediador.
+
'''[CONEXAOBASESDADOS]'''
 +
TipoConexao=4
 +
Servidor=LOCALHOST
 +
Porta=5433
 +
DataBase=serverconf
 +
Usuario=usuario
 +
Senha=*****
  
−
'''TOT_VS:''' Será informado o Valor total da base de cálculo do ICMS das vendas e/ou prestações de serviços, ainda que a venda ou prestação seja considerada imune, isenta ou não tributada, independente do meio de pagamento utilizado.
+
==='''Bases de Dados'''===
 +
O servidor de aplicação suporta a utilização de diversas bases de dados, estas que são responsáveis por armazenar as informações do ERP PHSYS, sendo assim, na tela <b>Bases de Dados</b> disponibilizada no cabeçalho do servidor de aplicação é possível realizar o cadastro destas. O cadastro de base de dados é a ferramenta que possibilita adicionar os sistemas com os respectivos bancos de dados que serão utilizadas no ERP PHSYS.
  
−
'''TOT_ISS:''' Será informado o valor total da base de cálculo do ISSQN das prestações de serviços, ainda que a prestação seja considerada imune, isenta ou não tributada, independente do meio de pagamento utilizado.
+
O cadastro de base de dados é realizado na tela <b>Base de Dados</b> disponibilizada no cabeçalho do servidor de aplicação. Nesta tela deve ser selecionado o botão <b>Nova Base de Dados</b>, após será aberto um formulário, no qual será possível preencher as informações necessárias para o cadastro da nova base de dados, após é necessário realizar a confirmação do cadastro através do botão <b>Salvar</b>.
  
−
'''TOT_OUTROS:''' Será informado o valor total bruto das demais operações que não estejam no campo de base de cálculo do ICMS ou ISS, independente do meio de pagamento utilizado. Incluem neste caso compras de cartão presente, saques, pagamentos de fatura de telefone etc.
+
*'''Código:''' identificação numérica da base de dados.
 +
*'''Nome:''' Nome da base de dados.
 +
*'''Legenda:''' Legenda da base de dados.
 +
*'''Ativo:''' Situação da base de dados, caso não esteja ativa, não será possível realizar o acesso da base de dados através do ERP PHSYS.
 +
*'''Servidor de Banco:''' Corresponde ao '''servidor de banco de dados''' que será utilizado para realizar a conexão com a base de dados, caso não exista nenhum cadastrado, será necessário realizar o cadastro.
 +
*'''Diretório Instalação:''' Diretório que está instalado o sistema no servidor de aplicação. 
 +
*'''Pool de Conexões:''' Número máximo de conexões no pool de conexões.
 +
*'''Minutos Permanência Pool:''' Tempo de permanência em minutos que a conexão permanece no pool após a última requisição.
 +
*'''Máximo Registro Consulta:''' Número máximo de registros que serão retornados nas consultas do campo de lista.
 +
*'''Data Base:''' Nome que a base de dados junto ao banco de dados.
 +
*'''Identificação do Servidor:''' Identificação do servidor criado no sistema. A identificação é utilizada pelo serviço de agendamento, que considera apenas os agendamentos com o mesmo servidor especificado aqui.
 +
*'''Agendamento:''' Quando marcado, serão iniciados junto ao servidor de aplicação, os servidor responsáveis pela execução dos processos agendados. 
 +
*'''Desconectar Após:''' Quantidade de minutos para encerramento da sessão sem uso.
 +
*'''Monitorar Procedimentos:''' Ativa o monitoramento de todas as requisições processadas. As informações são armazenadas junto a tabela db_sessaoprocedimentos da base de dados do PHServerConf.
  
−
=='''Conclusão'''==
+
----
−
Concluindo assim, que deve ser reportado apenas os recursos que transitam por instituições financeiras, instituições de pagamento e plataformas intermediadoras de transações. Os recursos que são recebidos em dinheiro/cheque não são declarados caso não sejam depositados na conta do estabelecimento.
 
  
−
===Referencia===
+
==='''Servidores de Banco de Dados'''===
−
Guia Prático EFD ICMS IPI- versão 3.1.2 -
+
 
−
http://sped.rfb.gov.br/estatico/D6/01D9D1F3CDA056218D8171315949A451494EA3/Guia_Pratico_EFD_Versao_312.pdf
+
Os servidores são responsáveis por definir os parâmetros necessários para o servidor de aplicação realizar a comunicação com o banco de dados. No cadastro da base de dados será definido o servidor de banco de dados.
 +
 
 +
O cadastro de base de dados é realizado na tela <b>Servidores</b> disponibilizada no cabeçalho do servidor de aplicação. Nesta tela deve ser selecionado o botão <b>Novo Servidor</b>, após será aberto um formulário, no qual será possível preencher as informações necessárias para o cadastro do novo servidor de banco de dados, após é necessário realizar a confirmação do cadastro através do botão <b>Salvar</b>.
 +
 
 +
*'''Legenda:''' Texto de identificação do servidor de banco.
 +
*'''Conexão:''' Tipo de banco de dados o servidor de banco vai realizar a conexão (SQLSrever, Oracle, Firebird ou PostgreSQL).
 +
*'''Endereço Interno:''' Endereço interno do banco de dados.
 +
*'''Endereço Externo:''' Endereço externo, caso esteja preenchido este será utilizado para realizar a conexão com o banco de dados.
 +
*'''Porta:''' Porta que está sendo disponibilizada para o acesso ao banco de dados.
 +
*'''Usuário:''' Login do usuário do banco de dados.
 +
*'''Senha:''' Senha do usuário do banco de dados.
 +
 
 +
----
 +
 
 +
==='''Usuários do Servidor de Aplicação'''===
 +
 
 +
O servidor de aplicação suporta a utilização de diversos usuários, sendo assim, na tela <b>Usuários</b> disponibilizada no cabeçalho do servidor de aplicação é possível realizar o cadastro destes. Nesta tela deve ser selecionado o botão <b>Novo Usuário</b>, após será aberto um formulário, no qual será possível preencher as informações necessárias para o cadastro do novo usuário, após é necessário realizar a confirmação do cadastro através do botão <b>Salvar</b>.
 +
 
 +
*'''Nome:''' Nome da pessoa que está sendo adicionada como usuário.
 +
*'''Usuário:''' Login do usuário que será utilizado para o acesso ao PHServerConf.
 +
*'''Senha:''' Senha do usuário que será utilizada para o acesso ao PHServerConf.
 +
*'''Ativo:''' Situação do usuário, caso não esteja ativo, não será possível realizar o acesso ao PHServerConf.
 +
----
 +
 
 +
==='''Configurações do Servidor de Aplicação'''===
 +
No servidor de aplicação é possível alterar alguns parâmetros que são utilizados durante as conexões entre o servidor de aplicação e banco de dados.
 +
 
 +
O processo de alteração de configurações do servidor de aplicação é realizado na tela '''Configurações''' disponibilizada no cabeçalho do servidor de aplicação. Quando selecionada, será aberto um formulário, no qual será possível alterar as informações de configurações, após alteradas é necessário realizar a confirmação da alteração através do botão <b>Salvar</b>.
 +
 
 +
'''É necessário reiniciar o serviço da aplicação após alteração destes parâmetros.'''
 +
 
 +
*'''Pool de Conexões:''' Número conexões que serão mantidas no pool de conexões para a base de dados do PHServerConf.
 +
*'''Minutos Permanência Pool:''' Tempo em minutos que a conexão permanecerá disponível no pool de conexões do PHServerConf, após a última requisição.
 +
 
 +
----
 +
 
 +
 
 +
'''Assuntos Relacionados'''
 +
 
 +
[[Processos|Execução de Processos no Servidor de Aplicação]]
 +
 
 +
[[Agendamento_de_Processos|Agendamento de Processos]]

Edição das 14h52min de 19 de maio de 2023

Conceito

O servidor de aplicação desempenha um papel fundamental no controle de todas as interações entre o cliente, o servidor e o banco de dados. Essas interações podem se originar de aplicativos desktop, web, mobile ou outros meios de integração. Ele é responsável por gerenciar todas as requisições recebidas, identificar o usuário, a base de dados e executar os procedimentos necessários, além de controlar as transações do banco de dados para garantir a integridade das informações.

Além disso, ele não apenas lida com as requisições, mas também gerencia um conjunto de conexões pré-estabelecidas, conhecido como pool de conexões. Essa abordagem permite reutilizar conexões existentes, minimizando o tempo de estabelecimento de conexões e maximizando a eficiência e o desempenho geral do sistema. Assim, o servidor de aplicação desempenha um papel vital no controle das interações, no gerenciamento das transações e no eficiente uso do pool de conexões.

É necessária a instalação do serviço responsável pela execução do servidor de aplicação, seguindo as orientações de configuração para o correto funcionamento, assim como o acesso através da ferramenta de configuração PHServerConf.

PHServerConf

O PHServerConf é a solução com interface web que permite o gerenciamento das configurações do servidor de aplicação, desempenhando um papel fundamental como ferramenta para cadastrar bases de dados e configurar o sistema. É de extrema importância que o PHServerConf esteja configurado corretamente, a fim de garantir o funcionamento adequado do sistema ERP PHSYS nas estações de trabalho.

Através do PHServerConf, é possível realizar o cadastro das bases de dados necessárias para o sistema, bem como realizar as configurações adequadas para atender às necessidades específicas do ambiente. Ao garantir uma configuração correta do PHServerConf, é possível assegurar uma integração perfeita entre o sistema ERP PHSYS e as estações de trabalho, evitando possíveis falhas ou erros.

Portanto, é altamente recomendado que seja dada a devida atenção à configuração precisa e correta do PHServerConf, a fim de estabelecer um ambiente estável e funcional para o sistema ERP PHSYS operar de maneira eficiente e confiável.

Devido ao servidor de aplicação suportar diferentes bases de dados, é necessário o cadastro das bases de dados correspondentes a cada sistema PHERP que será gerenciado pelo servidor de aplicação.

O servidor de aplicação possui uma base de dados própria junto ao banco de dados, e também oferece suporte a diferentes bancos de dados:

  • 0 = SQLIte
  • 1 = SQLServer
  • 2 = Oracle
  • 3 = Firebird
  • 4 = PostgreSQL

As informações sobre o banco de dados utilizado pelo servidor de aplicação, devem estar informadas no arquivo Parametros.ini, no mesmo diretório do PHServer.exe. Abaixo exemplo com banco de dados PostgreSQL: 

[CONEXAOBASESDADOS]
TipoConexao=4
Servidor=LOCALHOST
Porta=5433
DataBase=serverconf
Usuario=usuario
Senha=*****

Bases de Dados

O servidor de aplicação suporta a utilização de diversas bases de dados, estas que são responsáveis por armazenar as informações do ERP PHSYS, sendo assim, na tela Bases de Dados disponibilizada no cabeçalho do servidor de aplicação é possível realizar o cadastro destas. O cadastro de base de dados é a ferramenta que possibilita adicionar os sistemas com os respectivos bancos de dados que serão utilizadas no ERP PHSYS.

O cadastro de base de dados é realizado na tela Base de Dados disponibilizada no cabeçalho do servidor de aplicação. Nesta tela deve ser selecionado o botão Nova Base de Dados, após será aberto um formulário, no qual será possível preencher as informações necessárias para o cadastro da nova base de dados, após é necessário realizar a confirmação do cadastro através do botão Salvar.

  • Código: identificação numérica da base de dados.
  • Nome: Nome da base de dados.
  • Legenda: Legenda da base de dados.
  • Ativo: Situação da base de dados, caso não esteja ativa, não será possível realizar o acesso da base de dados através do ERP PHSYS.
  • Servidor de Banco: Corresponde ao servidor de banco de dados que será utilizado para realizar a conexão com a base de dados, caso não exista nenhum cadastrado, será necessário realizar o cadastro.
  • Diretório Instalação: Diretório que está instalado o sistema no servidor de aplicação.
  • Pool de Conexões: Número máximo de conexões no pool de conexões.
  • Minutos Permanência Pool: Tempo de permanência em minutos que a conexão permanece no pool após a última requisição.
  • Máximo Registro Consulta: Número máximo de registros que serão retornados nas consultas do campo de lista.
  • Data Base: Nome que a base de dados junto ao banco de dados.
  • Identificação do Servidor: Identificação do servidor criado no sistema. A identificação é utilizada pelo serviço de agendamento, que considera apenas os agendamentos com o mesmo servidor especificado aqui.
  • Agendamento: Quando marcado, serão iniciados junto ao servidor de aplicação, os servidor responsáveis pela execução dos processos agendados.
  • Desconectar Após: Quantidade de minutos para encerramento da sessão sem uso.
  • Monitorar Procedimentos: Ativa o monitoramento de todas as requisições processadas. As informações são armazenadas junto a tabela db_sessaoprocedimentos da base de dados do PHServerConf.

Servidores de Banco de Dados

Os servidores são responsáveis por definir os parâmetros necessários para o servidor de aplicação realizar a comunicação com o banco de dados. No cadastro da base de dados será definido o servidor de banco de dados.

O cadastro de base de dados é realizado na tela Servidores disponibilizada no cabeçalho do servidor de aplicação. Nesta tela deve ser selecionado o botão Novo Servidor, após será aberto um formulário, no qual será possível preencher as informações necessárias para o cadastro do novo servidor de banco de dados, após é necessário realizar a confirmação do cadastro através do botão Salvar.

  • Legenda: Texto de identificação do servidor de banco.
  • Conexão: Tipo de banco de dados o servidor de banco vai realizar a conexão (SQLSrever, Oracle, Firebird ou PostgreSQL).
  • Endereço Interno: Endereço interno do banco de dados.
  • Endereço Externo: Endereço externo, caso esteja preenchido este será utilizado para realizar a conexão com o banco de dados.
  • Porta: Porta que está sendo disponibilizada para o acesso ao banco de dados.
  • Usuário: Login do usuário do banco de dados.
  • Senha: Senha do usuário do banco de dados.

Usuários do Servidor de Aplicação

O servidor de aplicação suporta a utilização de diversos usuários, sendo assim, na tela Usuários disponibilizada no cabeçalho do servidor de aplicação é possível realizar o cadastro destes. Nesta tela deve ser selecionado o botão Novo Usuário, após será aberto um formulário, no qual será possível preencher as informações necessárias para o cadastro do novo usuário, após é necessário realizar a confirmação do cadastro através do botão Salvar.

  • Nome: Nome da pessoa que está sendo adicionada como usuário.
  • Usuário: Login do usuário que será utilizado para o acesso ao PHServerConf.
  • Senha: Senha do usuário que será utilizada para o acesso ao PHServerConf.
  • Ativo: Situação do usuário, caso não esteja ativo, não será possível realizar o acesso ao PHServerConf.

Configurações do Servidor de Aplicação

No servidor de aplicação é possível alterar alguns parâmetros que são utilizados durante as conexões entre o servidor de aplicação e banco de dados.

O processo de alteração de configurações do servidor de aplicação é realizado na tela Configurações disponibilizada no cabeçalho do servidor de aplicação. Quando selecionada, será aberto um formulário, no qual será possível alterar as informações de configurações, após alteradas é necessário realizar a confirmação da alteração através do botão Salvar.

É necessário reiniciar o serviço da aplicação após alteração destes parâmetros.

  • Pool de Conexões: Número conexões que serão mantidas no pool de conexões para a base de dados do PHServerConf.
  • Minutos Permanência Pool: Tempo em minutos que a conexão permanecerá disponível no pool de conexões do PHServerConf, após a última requisição.


Assuntos Relacionados

Execução de Processos no Servidor de Aplicação

Agendamento de Processos

Disponível em "http://wiki.phsys.com.br/index.php?title=Registro_1601&oldid=2682"