CONTEÚDO
- Premissas e configurações iniciais
- Visão Geral
- Exemplo de utilização
- Tela - Lista de clientes
- Tela - Inclusão de um cliente
- Tela - Edição de um cliente
- Exportar dados para o Excel
- Campos Customizados
- Demais informações
01. PREMISSAS E CONFIGURAÇÕES INICIAIS
1 - Aplicação do pacote de expedição contínua.
Aplicar o pacote de expedição contínua com data igual ou superior a 26/10/2023.
IMPORTANTE!
2 - Configuração do appserver.ini
- Incluir a chave app_environment na sessão general do appserver.ini.
[General]
app_environment={nome do ambiente}
- Incluir a tag MPP para utilização da porta multiprotocolo.
[MPP]
SSL_Method=SSL/TLS
SSL_Certificate={caminho do diretório appserver} + \totvs_certificate.crt
SSL_Key={caminho do diretório appserver} + \totvs_certificate_key.pem
- Na tag Drivers incluir a configuração multiprotocolo.
[Drivers]
Active=TCP
MultiProtocolPort=1
MultiProtocolPortSecure=0
3 - Configuração do menu
Além do pacote de expedição contínua, provisoriamente é necessária a configuração manual da nova rotina no menu do Protheus.
Acesse o Configurador do Protheus (SIGACFG), em Cadastros > Menus, selecione o menu do módulo Pré-faturamento de Serviços e confirme.
Crie uma nova configuração, conforme a imagem abaixo (Importante que a chamada do programa seja PFSAPPCLI).
Como sugestão é indicado que seja criado um novo grupo e colocado esse grupo na primeira posição do menu, conforme imagem abaixo.
Após realizar essa configuração a rotina estará disponível para o uso.
4 - Configuração de parâmetros
MV_JDOCUME (Informa qual é o tipo de integração de anexos. 1-Worksite; 2- Base de Conhecimento; 3 - Fluig; 4 - IManage API) = 2
MV_JFTJURI (Habilita integração entre os módulos SIGAJURI/SIGAPFS: 1 = PFS x Juri Integrados - Escritórios; 2 = Apenas Juri - Depto. Jurídicos.) = 1
02. VISÃO GERAL
Esta rotina permite o acesso à listagem de clientes, possibilitando ações como Inclusão e edição de clientes, visualização de contatos e inserção de anexos.
Também é possível realizar filtros por indicadores ou palavra-chave e por último carregar mais resultados.
03. EXEMPLO DE UTILIZAÇÃO
Esta funcionalidade permite:
1 - Filtrar clientes por indicador
É necessário que o usuário selecione um dos indicadores disponíveis para seleção e, em seguida clique no botão Filtrar.
Ao utilizar essa funcionalidade, o usuário é capaz de listar na tabela de clientes apenas os clientes que atendem ao indicador selecionado.
Existe a opção de reverter a pesquisa efetuada, a qual pode ser realizada ao clicar no botão "Limpar",
Após ser clicado, o botão "Limpar" a tela será recarregada e as configurações iniciais serão restauradas.
2 - Filtrar um cliente por palavra-chave
É necessário que o usuário insira uma palavra no campo de filtro, para verificar os campos disponíveis para aplicação de filtro, basta "posicionar" o mouse sobre o campo de filtro por palavra-chave.
Após preencher o campo de Filtro por palavra-chave e clicar sobre o botão Filtrar, o usuário é capaz de listar na tabela de clientes apenas os clientes que atendam a palavra-chave pesquisada.
Como no item anterior, aqui também existe a opção de reverter a pesquisa efetuada, a qual pode ser realizada ao clicar no botão "Limpar",
Após ser clicado, o botão "Limpar" a tela será recarregada e as configurações iniciais serão restauradas.
3 - Carregar mais resultados
Na tela de listagem de contatos, são listados 10 registros em cada página, sempre ordenados por ordem do código do cliente, para carregar mais registros basta clicar sobre o botão carregar mais.
Após ser clicado o botão carregar mais, a tabela de listagem de clientes é recarregada e são apresentados além dos registros anteriores, os próximos 10 registros.
Em cada momento em que é clicado o botão carregar mais, a tabela continuará sendo recarregada, sempre carregando os próximos 10 registros disponíveis, Caso não hajam mais registros disponíveis ou se caso o usuário possuir menos de 10 registros cadastrados, o botão carregar mais ficará bloqueado para utilização.
3 - Visualizar contatos
Ao clicar em Contatos nas ações na página de um cliente, abrirá um slide do canto direito da tela do usuário onde será possível visualizar o nome e o e-mail desse cliente específico.
04. TELA LISTA DE CLIENTES
| Esta é a tela de Listagem de clientes. Na tela, marcado pelo box verde, é possível encontrar os filtros disponíveis.
Marcado pelo box azul, é possível encontrar as ações da tabela.
Marcado pelo box amarelo, é possível encontrar a ação de carregar mais resultados.
|
05. TELA INCLUSÃO DE UM CLIENTE
1 - Acessar a listagem e clicar em novo
Para realizar a criação de um novo cliente, é necessário acessar a lista de clientes e clicar no botão Novo cliente, após isso você será redirecionado para a tela de inclusão de um cliente.
2 - Tela de inclusão de um cliente
Ao se acessar a tela de inclusão de um novo cliente, o primeiro passo a ser preenchido para o cadastro será o passo de Dados gerais.
Para garantir uma criação de cliente bem-sucedida, é fundamental preencher todos os campos marcados com um asterisco (*) ao final.
3 - Tela de inclusão de um cliente Passo Dados gerais
Ainda no passo de dados gerais é possível verificar um sub menu de navegação, onde o usuário poderá navegar entre as divisões do formulário de inclusão do cliente, no passo Dados gerais.
Na aba Geral, além dos campos obrigatórios, é importante observar o campo Tipo.
Ao escolher a opção "X – Exportação" exige que o campo "Endereço Internacional" seja preenchido.
A próxima aba para a inclusão do cliente, no passo de Dados gerais, será a aba de Faturamento,
Nesta aba existe a seleção de Mesmo escritório de origem e faturamento, Se o usuário optar por Sim, o campo Escritório exibirá uma lista de escritórios disponíveis e esse escritório será definido como padrão para origem e faturamento.
Se a escolha for Não, os campos Escritório Origem e Escritório Faturamento serão exibidos e isso permitirá que o usuário defina esses escritórios separadamente.
Também localizado na aba de Faturamento, e dentro da sessão Relatórios e E-Billing encontra-se o campo Idioma Relatórios e cartas?.
Se o usuário optar por Sim, o campo Idioma exibirá uma lista de idiomas disponíveis e esse idioma será definido como padrão para relatórios e cartas.
Se a escolha for Não, os campos Idioma do relatório e Idioma da carta serão exibidos e isso permitirá que você defina esses idiomas separadamente.
Também localizado na aba de Faturamento e dentro da sessão Dados financeiros/Cobrança, é necessário preencher a forma de pagamento.
A próxima aba para a inclusão do cliente, no passo de Dados gerais, será a aba de Comunicação, onde é necessário informar se o e-mail de envio da fatura será agrupado no momento de envio,
ou se o envio de e-mails não serão enviados.
Após serem preenchidos os campos obrigatórios do passo de Dados gerais, para continuar a inclusão do novo cliente, é necessário selecionar o próximo passo na parte superior da tela o passo de Contatos.
4 - Tela de inclusão de um cliente Passo Contatos
Ao ser selecionado o passo de Contatos, a parte inferior do formulário de inclusão será redirecionada para a tela de listagem de contatos vinculados ao cliente.
Para vincular um novo contato ao cliente basta clicar sobre o botão Vincular.
No momento que o usuário clicar sobre o botão Vincular, o sistema apresentará a tela de seleção de contatos disponíveis para serem vinculados ao cliente.
Após ser escolhido um contato para ser vinculado ao cliente, o usuário deverá clicar sobre o botão Salvar, neste momento o sistema informará que o contato foi incluído com sucesso.
Após confirmar a inclusão do novo contato o sistema retornará para passo de Contatos, agora com o novo contato presente na listagem.
Um cliente precisa obrigatoriamente possuir ao menos um contato vinculado, após vincular um contato ao cliente, para continuar a inclusão é necessário selecionar o próximo passo na parte superior da tela o passo de Participação.
5 - Tela de inclusão de um cliente Passo Participação
No passo de participação é preenchido os dados do participante do contrato vinculado ao cliente.
Na divisão de participação(vinculo de participante ao contrato do cliente), a maioria dos campos são marcados como obrigatórios, a exceção a este item do cadastro é apenas a data final da participação.
6 - Botões de Ações
No topo da estrutura de abas, três botões de ação estão disponíveis:
Salvar: Após preencher todos os campos obrigatórios, o novo cliente será criado e você será redirecionado para a tela de listagem de clientes.
Salvar e criar novo: Após preencher todos os campos obrigatórios, o novo cliente será criado, e você permanecerá na tela de inclusão do cliente, facilitando a inserção de outro cliente.
Fechar: Esse botão exibirá uma confirmação em pop-up para garantir que você realmente deseja retornar à tela de listagem de clientes, prevenindo cliques acidentais.
06. TELA EDIÇÃO DE UM CLIENTE
1 - Acessar a tela de edição de um cliente
Para alterar um cliente cadastrado anteriormente, basta na tela de listagem de clientes, localizar o cliente que deseja editar na lista e ao lado do nome do cliente, você verá um ícone de lápis.
Após se clicado sobre o ícone de edição será apresentado uma tela semelhante a tela de inclusão de clientes(item 05), porém neste momento todos os campos do formulário do cliente já estarão preenchidos, conforme os dados do cliente selecionado anteriormente.
1 - Informações exibidas no título
Ao acessar a tela de edição de um cliente, você notará algumas informações importantes exibidas no topo da página. Isso inclui:
Ações disponíveis: Botões de ação para salvar as alterações, salvar e criar um novo cliente ou fechar a tela de edição.
Abas de navegação: Abas que facilitam a transição entre diferentes seções da edição do cliente.
Título do Cliente: O título do cliente é composto pelo Nome do Cliente e pelo Código/Endereço correspondente.
2 - Navegando entre sessões
Assim como na inclusão de um cliente, a tela de edição também possui abas de navegação para simplificar a transição entre diferentes seções de edição.
Ao clicar em uma aba específica, você será automaticamente direcionado para a sessão correspondente.
Para garantir uma edição de cliente bem-sucedida, é essencial prestar atenção aos campos que possuem particularidades na escolha, conforme já explicado na sessão 04 de inclusão de um cliente.
Botões de Ação:
No topo da tela de edição, você encontrará os seguintes botões de ação:
Salvar: Após preencher todas as alterações necessárias, clique neste botão para salvar as modificações feitas no cliente. Após a salvamento, você será redirecionado de volta à lista de clientes.
Salvar e Criar Novo: Semelhante ao botão Salvar, este botão também salvará as alterações feitas, mas manterá você na tela de edição, permitindo que você crie outro cliente sem precisar acessar novamente a lista.
Fechar: Caso você queira sair da tela de edição sem salvar as alterações, este botão exibirá uma confirmação em pop-up para evitar cliques acidentais.
Lembre-se de que para uma edição bem-sucedida, é crucial preencher todos os campos obrigatórios e seguir as orientações fornecidas na tela.
Com essas instruções, você estará pronto para efetuar edições nos clientes de forma eficaz e precisa.
3 - Tela de edição de um cliente
Ao se acessar a tela de edição de um cliente, o primeiro passo a ser preenchido para o cadastro será o passo de Dados gerais.
Para garantir uma criação de cliente bem-sucedida, é fundamental preencher todos os campos marcados com um asterisco (*) ao final.
A tela de edição do cliente obedecerá as mesmas validações já apresentadas no item 05 deste documento, sempre dividindo a edição em passos, neste momento iremos citar itens não mencionados anteriormente.
3.1 - Passo dados gerais, aba Comunicação
No passo de dados gerais da edição do cliente, ao se localizar a aba comunicação será mostrado o formulário de inclusão de um contato para envio de faturas relacionadas ao cliente.
Conforme mostrado no item 5 deste documento os dados obrigatórios para esta divisão é apenas o item que informa se o usuário deseja ou não agrupar o envio de e-mails, os demais itens passiveis de inclusão são os seguintes campos:
Recebe via Correios: Indica se o cliente receberá faturas e demais cobranças via correios.
Recebe e-mail: Indica se o cliente receberá faturas e demais cobranças via e-mail.
E-mail para envio de minuta: E-mail responsável para o envio de minutas e faturas.
E-mail para cópia: E-mail secundário para encaminhamento de minutas e faturas.
3.2 - Passo dados gerais, aba Dados de GROSS UP
No passo de dados gerais da edição do cliente, logo abaixo da divisão de comunicação, encontrasse a próxima aba Dados de Gross UP.
Nesta divisão não existem campos obrigatórios, mas se o usuário desejar podem ser inseridos ou editados os seguintes campos:
Gross up Honorários: Indica se será adicionada uma alíquota de IR à rentabilidade de investimentos que não possuem, originalmente, essa tributação.
%Gross up Honorários: % da alíquota a ser adicionada.
%Gross up despesas: % da alíquota da despesa a ser adicionada ao cliente.
%Taxa administrativa: % das taxas administrativas a serem adicionadas a fatura.
3.3 - Passo dados gerais, aba Dados fiscais
A última divisão do passo dados gerais disponíveis para edição de um cliente é a divisão DADOS FISCAIS
Nesta divisão novamente não existem campos obrigatórios, mas se o usuário desejar podem ser preenchidos ou editados os seguintes campos:
Emite NF de despesas: Indica se a nota fiscal das despesas da fatura serão emitidas.
NIRE: Número de identificação do registro da empresa, ou do cliente.
Código NIF: Número de identificação fiscal.
Motivo NIF: Motivo do NFI preenchido anteriormente.
Tipo NIF: Tipo de NIF, este campo apresenta uma seleção de tipos para serem inseridos.
4 - Step Não cobráveis
O próximo passo passível de alteração Não cobráveis indica as atividades ou despesas relacionadas ao cliente não passíveis de cobrança, nesta tela é possível visualizar a listagem das atividades e despesas não cobráveis vinculadas ao usuário.
Ainda no passo de não cobráveis, é possível vincular um novo tipo de despesa ou tipo de atividade através dos botões na parte superior
Para desvincular uma atividade ou despesa basta clicar sobre o botão Desvincular na linha do item a qual se deseja desvincular.
5 - Passo Exceção por tipo de atividade
O próximo passo passível de alteração Exceção por tipo de atividade indica o período de exceção para um determinado tipo de atividade, indicando o ano mês de início e final da exceção, o tipo da atividade, regra e valores de ajuste para a atividade.
6 - Passo Anexos
Este passo conforme mencionado estará disponível apenas na edição de um cliente (na inclusão o passo Anexos não será demonstrado). Nessa tela serão demonstrados todos os arquivos anexados no cliente e também será possível vincular novos documentos.
Observações:
- Ao selecionar os arquivos ou arrasta-los para a área de drag-and-drop, o processamento de envio do anexo será disparado automaticamente.
- Durante a inclusão de um novo cliente, a opção de anexos não estará disponível.
07. EXPORTAR DADOS PARA O EXCEL
No topo da tela principal, foi disponibilizada a funcionalidade de exportar a listagem de clientes para o Excel.
Caso o filtro por palavra-chave ou o filtro por indicador estiverem preenchidos, a rotina exportará apenas os resultados exibidos no grid (conforme exemplo abaixo).
Caso nenhum filtro seja aplicado, será exportada a listagem completa de clientes da base.
08. Campos Customizados
Os campos customizados do tipo Caractere, Numérico e Memo foram implementados a partir do pacote de expedição contínua com data igual ou superior a .
Os campos customizados do tipo Data ainda não foram implementados e estão no nosso backlog.
09. DEMAIS INFORMAÇÕES
FwCallApp - Abrindo aplicativos Web no Protheus
Porta Multiprotocolo - Geração de Certificado
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas