1 - Aplicação do pacote de expedição contínua.
2 - Configuração do appserver.ini
[General]
app_environment={nome do ambiente}
[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
[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
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.
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.
![]()

| 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.
|
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 cadastro será redirecionada para a tela de listagem de contatos do cliente
Neste momento é possível para o usuário vincular um novo contato ao cliente que está sendo cadastrado, para tal operação 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 vinculado com sucesso ao cliente, e novamente será apresentado o passo de Contatos, agora com o novo contato presente na listagem.

5 - Tela de inclusão de um cliente Passo Participantes
0 - 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.
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.
Localize o cliente que deseja editar na lista.
Ao lado do nome do cliente, você verá um ícone de lápis. Clique nesse ícone para iniciar a edição do cliente.
Você será redirecionado para a tela de edição de um cliente.

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

4 - 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.
5 - Step Anexos
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:

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.
FwCallApp - Abrindo aplicativos Web no Protheus
Porta Multiprotocolo - Geração de Certificado