Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


CONTEÚDO

  1. Premissas e configurações iniciais
  2. Visão Geral
  3. Exemplo de utilização
  4. Tela - Lista de clientes
  5. Tela - Inclusão de um cliente
  6. Tela  Tela - Edição de um cliente
  7. Exportar dados para o Excel
  8. Campos Customizados
  9. Demais informações


01. PREMISSAS E CONFIGURAÇÕES INICIAIS


1 - Aplicação do pacote de expedição contínua.


Card documentos
InformacaoAplicar o pacote de expedição contínua com data igual ou superior a 26/10/2023.
TituloIMPORTANTE!


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.

Image Added

Crie uma nova configuração, conforme a imagem abaixo (Importante que a chamada do programa seja PFSAPPCLI).

Image Added


Como sugestão é indicado que seja criado um novo grupo e colocado esse grupo na primeira posição do menu, conforme imagem abaixo.

Image Added

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


Card documentos
InformacaoA partir da ativação dos parâmetros MV_APIFOR e MV_APICCGC, e com acesso liberado ao endereço https://app.carol.ai/api, as informações cadastrais são preenchidas após o preenchimento do CNPJ. Os recursos de preenchimento são os mesmos do Portal da Receita Federal > Dados Públicos CNPJ que são atualizados a cada 3 meses.
TituloIMPORTANTE! Preenchimento automático a partir do CNPJ!

02. VISÃO GERAL

Esta rotina permite o acesso à listagem de clientes, possibilitando ações como editar, anexar, visualizar os contatos e inserir os anexos. Inclusão e edição de clientes, visualização de contatos e inserção de anexos.

Também é possível realizar o filtro filtros por indicadores ou palavra-chave e por último carregar mais resultados.

...


03.

...

EXEMPLO DE UTILIZAÇÃO

Esta funcionalidade permite:

1 -  Filtrar um cliente por palavra-chave

Por exemplo:

clientes por indicador

É necessário que o usuário insira uma palavra no campo de filtro selecione um dos indicadores disponíveis para seleção e, em seguida , clique no botão de pesquisa Filtrar.


Image Added


Ao utilizar essa funcionalidade, o usuário é capaz de aplicar um filtro do termo listar na tabela que lista de clientes apenas os clientes . Os critérios de pesquisa abrangem: código, nome da loja/empresa, razão social, CNPJ, nome fantasia e sócio responsável.que atendem ao indicador selecionado.

Image Added


Existe a opção de reverter a pesquisa efetuada, a qual pode ser realizada ao clicar no botão "Limpar",

Image Added

       

          Após ser clicado, o botão "Limpar" a tela será recarregada e as configurações iniciais serão restauradas.

         Image Added

O indicador Clientes abertos no mês exibirá todos os clientes que possuem a informação de Empresa E-billing preenchida, já o Clientes abertos no mês considerará aqueles cuja data de cadastro ocorreu no mês corrente. Ambos consideram apenas clientes ativos.

O indicador de Clientes inativados no mês verifica a data de encerramento no mês corrente. 

Para o indicador de Clientes provisórios é verificada apenas a situação de cadastro.


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. 

Image Added


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.

Image Added


Como no item anterior, aqui também Além disso, existe a opção de reverter a pesquisa efetuada, a qual pode ser realizada ao clicar no botão "Limpar", restaurando assim

Image Added

       

          Após ser clicado, o botão "Limpar" a tela será recarregada e as configurações iniciais serão restauradas.

Image Removed

         Image Added

3 2 - Carregar mais resultados

Por exemplo:

Ao selecionar a opção "Carregar mais resultados", o usuário efetuará uma solicitação para obter a próxima página de resultados, a qual conterá um máximo de 10 itens. Estes serão subsequentemente acrescentados à exibição atual na tabela de listagem.

Image Removed

3 - Visualizar contatos

Por exemplo:

         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.



                                                                        Image Added


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.

Image Added

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.


                                         Image Added


3 - Visualizar contatos


Ao clicar em 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.

Image Modified

Image RemovedImage Added

...


04.

...

TELA LISTA DE CLIENTES


Image Removed


Image Added

Esta é a tela de Listagem de clientes. 

Na tela, marcado pelo box verde, é possível encontrar os filtros disponíveis

  • Filtro por indicador: Nesse filtro
  • é possível pesquisar pelos indicadores disponíveis para consulta.
  • Filtro por palavra-chave: Nesse filtro é possível pesquisar por: código, nome da loja/empresa, razão social, CNPJ, nome fantasia e sócio responsável.
  • Ao clicar em limpar, ocorrerá a restauração das configurações iniciais.

Marcado pelo box azul, é possível encontrar as ações da tabela. 

  • Em contatos ( ), é possível abrir um slide em que mostrará o nome e o e-mail relacionados ao cliente selecionado.
  • Em Anexar (), será aberto um slide demonstrando os arquivos anexados no cliente, além disso será disponibilizado uma área de drag-and-drop para vincular novos arquivos.

Marcado pelo box amarelo, é possível encontrar a ação de carregar mais resultados. 

  • "Carregar mais" faz a requisição dos próximos 10 itens da página e adiciona na tabela.

...


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.

Image RemovedImage Added

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 -  Navegando entre as sessões

Ao acessar a tela de criação de cliente, você encontrará abas de navegação que simplificam a transição entre as diversas seções. Ao clicar em uma aba específica, você será automaticamente direcionado para a sessão correspondente.

Image Removed

Para facilitar a navegação pela página, um botão flutuante está disponível. Ao ser acionado, ele levará você de volta ao topo da página com um único clique.

Image Removed

         Image Added



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.  

Image Added


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.

Image Modified

Na aba Faturamento, e dentro da sessão Faturamento e Cobrança encontra-se o campo Escritório Origem e Faturamento?.


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 Se você 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.

Image RemovedImage Added

Se a escolha for Não, os campos Escritório Origem e Escritório Faturamento serão exibidos e isso permitirá que você o usuário defina esses escritórios separadamente.

Image RemovedImage Added


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 você 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.

Image RemovedImage Added


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.

Image Added


Também localizado na aba de Faturamento e dentro da sessão Dados financeiros/Cobrança, é necessário preencher a forma de pagamento.

                Image Added

            

                  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.

...

  

                  Image Added


               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.

        Image Added

     

 Para vincular um novo contato ao cliente basta clicar sobre o botão Vincular.


                                                                  Image Added                                 

                                  

       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.

                 Image Added                                                                                                       

                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.

                Image Added

                Após confirmar a inclusão do novo contato o sistema retornará para passo de Contatos, agora com o novo contato presente na listagem.

           Image Added

           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.

      Image Added

        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 - 

Image Removed

4 -  Botões de Ações

No topo da estrutura de abas, três botões de ação estão disponíveis:

Image Removed        Image Added

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.

...

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 listagem e clicar editar

Para realizar a edição de um cliente, siga os passos abaixo:

Acesse a lista de clientes através do sistema.

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

...

Você será redirecionado para a tela de edição de um cliente.

Image Removed

2 -  Tela de edição de um cliente

Ao entrar na tela de edição de um cliente, você precisará prestar atenção aos campos obrigatórios marcados com um asterisco (*).

.

Image Added

        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 3 -  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.

Image Modified


4 2 -  Navegando entre sessões

...

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.

5 - Step Anexos

Image Removed

Essa opção estará disponível apenas na edição de um cliente (na inclusão o step 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:

...

de

...

um

...

cliente

...

.


Botões de Ação:

No  No topo da tela de edição, você encontrará os seguintes botões de ação:

Image Added

Salvar 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  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 acessar   novamente a lista.

Fechar 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.

...

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.

         Image Added

     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.


      Image Added

    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.

     Image Added

   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

     Image Added

   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.

  Image Added



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.

 Image Added

 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 

    Image Added 

Para desvincular uma atividade ou despesa basta clicar sobre o botão Desvincular na linha do item a qual se deseja desvincular.

  Image Added

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.

Image Added


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.

      Image Added

07. EXPORTAR DADOS PARA O EXCEL

No topo da tela principal, foi disponibilizada a funcionalidade de exportar a listagem de clientes para o Excel.

Image Added

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).

Image Added

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