Nova Rotina de Faturamento Antecipado

Características do Requisito

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

• Tabela BGD - Prod x Cob x Proc x Co-Part:

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

5.  Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

• Pesquisa B05PLS:

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

• Tabela BD5 – Contas Médicas:

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Procedimento para Utilização

• Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
• Localização da rotina no menu;
• Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
• Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

Vídeo

• Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

Descrição

Implementada uma nova tela de Faturamento Antecipado para contemplar diversas opções de filtro para a seleção dos documentos, possibilitando assim a junção das funcionalidades das duas telas de Faturamento Antecipado - Antecipação – Sem DS e Antecipação – DS Liberado. 

Nesta tela serão listados todos os lotes em regime de Importação e Exportação, que possuam ou não documento de saída vinculado e liberado.

Image Added

FATURAMENTO_ANTECIPADO_UNIFICADO

Importante!

• O parâmetro FATURAMENTO_ANTECIPADO_UNIFICADO (S/N) será apresentado com o valor padrão S (Sim).

• Quando este parâmetro apresentar o valor S, a nova tela de Faturamento Antecipado permanecerá visível no menu e no botão de acesso rápido, sendo que as duas telas anteriores serão desabilitadas. 

• Quando o parâmetro apresentar o valor N, as duas telas antigas permanecerão habilitadas e a nova será desabilitada.

Observação:

• O Suporte às duas telas de Faturamento Antecipado, Antecipação – Sem DS e Antecipação – DS Liberado, será mantido até o dia 09/11/2016, data da publicação do pacote SARA 12.1.27.

• Após esta data as mesmas serão descontinuadas do sistema e permanecerão indisponíveis para acesso, sendo que apenas a nova tela de Faturamento Antecipado estará disponível.

Pasta Parâmetros da Tela:

• Foram criados dois parâmetros para definir os dias mínimos de armazenagem:

Image Added

• Estes parâmetros permitem que o sistema liste automaticamente as informações em tela, sendo um destinado aos lotes em regime de Exportação e outro aos lotes em regime de Importação.

• Tal parametrização não será obrigatória no sistema. Na inexistência dos parâmetros, o sistema não considerará os dias de armazenagem para listar as informações em tela e os campos filtros em tela permanecerão em branco. 

• Caso seja parametrizado pelo usuário, os mesmos serão carregados automaticamente na pasta Parâmetros do Filtro.

• Caso não seja necessário visualizar todas as colunas no grid, pelo botão Config. Grid o usuário poderá parametrizar as colunas que deseja visualizar.
  
  

Image Added

Pasta Parâmetros do Filtro Para o Grid

Período (De - até) – Intervalo de data pela entrada do Lote:

Image Added

Regime:

Image Added

Lote:

Image Added

• Será possível realizar a pesquisa do Lote pelo número do Lote, Doc. Saída e Conhecimento:

Image Added

Beneficiário

Image Added

• Ao abrir a tela sempre será apresentado como padrão o Beneficiário Genérico.
• Quando for informado o Beneficiário Genérico serão apresentados todos os registros no grid.
• Também será possível realizar a pesquisa de beneficiários:

Image Added

Comissária:

Image Added

• Ao abrir a tela será apresentado como padrão a Comissária Genérica.
• Quando for informada a Comissária Genérica serão apresentados todos os registros no Grid.
• Será possível realizar a pesquisa de comissárias:

Image Added

Lotes Com Doc. Saída Liberado: 

Image Added

• Todos: são apresentados todos os Lotes.
• Sim: são apresentados apenas os Lotes que possuem Documento Saída Liberado.
• Não: são apresentados apenas os Lotes que não possuem Documento Saída Liberado.

Lotes com Liberação Ant./Frac (utilizado nos processos de liberação antecipada ou fracionada):

Image Added

• Todos: são apresentados todos os Lotes.
• Sim: são apresentados apenas os Lotes que possuem Liberação Antecipada/Fracionada.
• Não: são apresentados apenas os Lotes que não possuem Liberação Antecipada/Fracionada.

Lotes com Apreensão: 

Image Added

• Todos: são apresentados todos os Lotes.
• Sim: são apresentados apenas os Lotes que possuem Apreensão.
• Não: são apresentados apenas os Lotes que não possuem Apreensão.

Lotes Vencidos: 

Image Added

• Todos: são apresentados todos os Lotes.
• Sim: são apresentados apenas os Lotes vencidos.
• Não: são apresentados apenas os Lotes que não estão vencidos.

Filtro Conforme Parâmetro PADRAO_LIBERA_FATURAMENTO_ANTECIPADO

A regra do parâmetro PADRAO_LIBERA_FATURAMENTO_ANTECIPADO continua exatamente igual, conforme as duas telas Antecipado: Antecipação – Sem DS e Antecipação – DS Liberado, porém,foi implementada uma funcionalidade a mais com relação à Comissária.

Foi realizada uma melhoria no cadastro de Instrução Cliente -Fat. Antecipado, do módulo Comercial, no qual será possível informar, além do Beneficiário, os dados da Comissária.

Image Added

Exemplo 1:

• Se nenhum processo de cliente deve ser apresentado na tela Faturamento Antecipado, então, PADRAO_LIBERA_FATURAMENTO_ANTECIPADO = 'N'.
• Se for necessária uma exceção para que sejam apesentados os processos de um ou mais clientes, no módulo Comercial, na tela Instrução Cliente - Fat. Antecipado, parâmetro Libera faturamento Antecipado, deve ser informado o cliente para o qual se deseja fatura antecipada marcando [Sim].
• Esta combinação poderá ser realizada também para uma Comissária Específica ou Comissária Genérica, tais como:

1. 1. Beneficiário Específico e Comissária Específico
   2. Beneficiário Específico e Comissária Genérico
   3. Beneficiário Genérico e Comissária Específico

Exemplo 2:

• Caso queira que o processo de um ou mais clientes seja apresentado na tela Faturamento Antecipado, então, PADRAO_LIBERA_FATURAMENTO_ANTECIPADO = 'S'.
• Se for necessária uma exceção para não aparecerem os processos de um ou mais clientes, no módulo Comercial, na tela Instrução Cliente - Fat. Antecipado, parâmetro Libera faturamento Antecipado deve ser marcado [Não] para o cliente em questão.
• Esta combinação poderá ser realizada também para uma Comissária Específica, tais como:

1. 1. Beneficiário Específico e Comissária Específico
   2. Beneficiário Específico e Comissária Genérico
   3. Beneficiário Genérico e Comissária Específico

Campos no Grid (Tela Nova)

A nova tela para o faturamento antecipado terá as seguintes colunas na grade de informações:

• DS Liberado: Indicador se o lote possui Doc. Saída liberado.
• Lib. Ant./Frac: Indicador se o lote possui liberação antecipada/fracionada.
• Vencido: Indicador se o lote está vencido.
• Apreensão: Indicador se o lote tem apreensão.
• Conhecimento.
• Lote.
• Tipo: Tipo Doc. Saída (DI, DDE, DTA, entre outros).
• Documento Saída (Ano/Número).
• Lib. Doc. Saida: Data de liberação do documento de saída.
• Lib. Ant./Fra: Data de liberação antecipada/fracionada.
• Apreensão: Data apreensão (quando houver, apresentará a data da primeira apreensão lote/item).
• Venc. Lote: Data do Vencimento do lote (Conforme vencimento do regime).
• Regime.
• Beneficiário (Código, Nome, CNPJ).
• Responsável do Lote (Conforme informado no Documento de entrada no Módulo Expedição).
• Comissária (Código, Nome, CNPJ) - obtida conforme regra parâmetro abaixo:

Se (FORMA_BUSCA_COMISSARIA_FAT_ANT = 1)

• • • Documento de saída - quando possuir.
    • Documento de entrada - quando informado.
    • Do último faturamento antecipado do lote, se houver.
    • Senão, Comissária genérica.

Se FORMA_BUSCA_COMISSARIA_FAT_ANT = 2

• • Buscar a primeira comissária da opção de tarifa para o beneficiário do Lote.
• Data Entrada: Data entrada da carga (Data de entrada do primeiro CESV do Lote).
• Data Ini. fat: Data do início do faturamento (de acordo com a regra da opção de tarifa).
• Últ. Per. Fat: Data do último período faturado.
• Dias Arm. (Quantidade de dias desde a entrada do Lote até a data atual).
• Dias Pend (Quantidade de dias pendentes de faturamento, desde o final do último período de faturamento até o dia atual; ou da data de entrada até o dia atual, se não houve faturamento antecipado).
• Períodos (Quantidade de períodos pendentes a faturar, com base na data Dias Pend.).
• Dias Pró-Rata Pendente (Quantidade de dias Pro-Rata, de acordo com configurado na Opção de Tarifa).
• Fim Período: Data do final do período atual de Faturamento, de acordo com a quantidade de Períodos calculados e considerando a data do último faturamento.
• Opção Tarifa (Código da opção de tarifa localizada pelo sistema).

Segue a forma de busca para a opção de tarifa:

• • • Se (BUSCA_TARIFA_ULT_FAT = S), então, busca a opção de tarifa do último cálculo do lote.
    • Caso não encontre, o sistema pesquisará uma opção de tarifa, sendo única para o cliente e sem validação.
    • Caso não encontre, o sistema validará as opções de tarifas encontradas para o cliente e apresentará a primeira opção validada.
    • Caso não encontre,  o sistema retornará a opção de tarifa genérica.
• Documento de entrada (caso haja mais de um, informar o primeiro com base na data de entrada).
• Valor FOB U$.
• Valor FOB R$.
• Peso Bruto.
• Peso Total.
• M3 Total.

Data Final do Período no Momento do Cálculo

Na nova tela de Faturamento Antecipado, quando o usuário solicitar o cálculo de um processo, o sistema utilizará como data para o final do período o campo do grid Data Final do período atual, sugerido pelo sistema  automaticamente.

Será criado um botão pra permitir alterar a data final do período sugerido pelo sistema no grid.

Image Added

Este botão somente será habilitado se o parâmetro ALTERAR_DATA_FIM_PER_FAT_ANT = S.

Ao selecionar um registro no grid e clicar no botão Alterar Data Fim Per, será aberta a seguinte tela:

Image Added

O campo Data Fim Período será carregado conforme informação no grid, bem como, o campo Dias será carregado de acordo com a quantidade de dias pendentes até o final do período.

Será possível manipular ambas as informações, sendo que ambos serão sincronizados à medida em que forrem sendo alterados.

Exemplo:

Se a quantidade de dias for alterada para 46, o campo  será alterado automaticamente para o dia 18/09/2016.

Se alterar a Data Fim Período para 16/09/2016, o campo Dias será alterado automaticamente para 44. Isto facilitará, caso seja necessário acrescentar à data mais um período de cálculo (exemplo: mais 10 ou 15 dias, entre outros).

 Ao selecionar mais de um registro no grid e clicar no botão Alterar Data Fim Per, abrirá a tela apresentada a seguir.

Neste cenário, o campo Dias não será habilitado, por se tratar de múltipla seleção.

Image Added

Ao clicar no botão Fechar será alterada a data final do período para o(s) registro(s) selecionado(s) no Grid.

Para cada um dos registros selecionados no Grid (múltipla seleção), será validado se a data informada manualmente pelo usuário é inferior a data de entrada do lote ou inferior a data do último período faturado.

Caso seja, não será alterada a data deste registro no Grid, sendo emitida a seguinte mensagem em tela: “Lote 2016XXXXXXXX. A data informada pelo usuário não pode ser menor que a data de entrada do Lote ou menor que a data do último período faturado."

A Data Informada poderá ser maior que a Data Fim Período sugerida pelo sistema no Grid, exceto:

Se o registro estiver em apreensão; se a Data informada for maior que a data apreensão será emitida ou não uma mensagem para o usuário, conforme parametrização: 

“CONSISTE_APRENSAO_FAT_ANT = 1” – Não emite nenhuma mensagem.

 “CONSISTE_APRENSAO_FAT_ANT = 2” – Emite mensagem informativa: “Lote 2016XXXXXXX em apreensão. Confirma a Alteração da data fim do Período?”.

 “CONSISTE_APRENSAO_FAT_ANT = 3” – Bloqueia o processo: “Lote “2016XXXXXXX em apreensão não pode ser alterado data fim do Período!”.

 Este parâmetro será validado registro a registro do Grid (múltipla seleção).

 Se o registro estiver com lote Vencido; se a Data informada for maior que a data do vencimento será emitida ou não uma mensagem para o usuário, conforme parametrização: 

“CONSISTE_VENC_LOTE_FAT_ANT = 1” – Não emite nenhuma mensagem.

CONSISTE_VENC_LOTE_FAT_ANT = 2” – “Lote 2016XXXXXXX Vencido. Confirma a Alteração da data fim do Período?”.

“CONSISTE_VENC_LOTE_FAT_ANT = 3” – Bloqueia o processo de cálculo: “Lote “2016XXXXXXX Vencido não pode ser calculado!"

Este parâmetro será validado registro a registro do Grid (múltipla seleção).

Confirmação da Comissária no Momento do Cálculo

Será incluído na tela o botão Altera Comissária, para que o usuário possa informar uma outra Comissária, caso o sistema tenha sugerido a Comissária genérica.

Image Added

Este botão somente será habilitado se o parâmetro ALTERAR_COM_FAT_ANT = S.

Ao selecionar um ou mais registros no Grid (múltipla seleção) e clicar no botão Alterar Comissária, será aberta uma tela de pesquisa para que seja possível selecionar uma Comissária:

Image Added

Após selecionar a nova Comissária será alterada a informação da Comissária nos registros selecionados no grid.

Caso o registro tenha tido cálculo anterior, DI cadastrada ou Comissária informada no Documento de Entrada, será emitida a mensagem: “Não é possível alterar a Comissária para o Lote 2016XXXXXXXX, pois já houve faturamento antecipado ou existe DI cadastrada ou foi informado comissária no Documento de Entrada!”. 

Consistências do Processo de Cálculo

Ao calcular um processo em apreensão, botão Processar, se a Data Final do período atual for maior que a data de apreensão será emitida ou não uma mensagem para o usuário, conforme parametrização:

“CONSISTE_APRENSAO_FAT_ANT = 1” – Não emite nenhuma mensagem.

“CONSISTE_APRENSAO_FAT_ANT = 2” – Emite mensagem confirmativa(S/N): “Confirma o cálculo do Lote em apreensão 2016XXXXXXX?”.

“CONSISTE_APRENSAO_FAT_ANT = 3” – Bloqueia o processo de cálculo: “Lote “2016XXXXXXX em apreensão não pode ser calculado!”.

Este parâmetro será validado mesmo que esteja selecionado no Grid um ou mais registros (múltipla seleção).

Ao Calcular um processo de lote Vencido, botão [processar], se a “Data Final do período atual” for maior que a data do vencimento será emitida ou não uma mensagem para o usuário conforme parametrização:

“CONSISTE_VENC_LOTE_FAT_ANT = 1” – Não emite nenhuma mensagem.

“CONSISTE_VENC_LOTE_FAT_ANT = 2” – Emite mensagem confirmativa (S/N): “Confirma o cálculo do Lote Vencido 2016XXXXXXX?”.

“CONSISTE_VENC_LOTE_FAT_ANT = 3” – Bloqueia o processo de cálculo: “Lote “2016XXXXXXX Vencido não pode ser calculado!”

Este parâmetro será validado mesmo que esteja selecionado no Grid um ou mais registros (múltipla seleção).

Parametrização

BUSCA_TARIFA_ULT_FAT (Padrão = N):

Busca a opção de tarifa do último faturamento do lote na tela de Faturamento Antecipado Unificado:

• S - Sim
• N - Não.

DOC_ORDEM_FAT_ANT: 

Lista dos DOC_ORDEM que devem aparecer na tela de Faturamento Antecipado. Exemplo: 1, 2, 4, 7 ,A, C.

Observação:

• No Script do parâmetro serão carregados todos os DOC_ORDEM1 de regime Alfandegado e os DOC_ORDEM1 da Família NF.
• Caso a unidade deseje mais algum DOC_ORDEM1, deverá ser editado o parâmetro e incluído manualmente pelo módulo Sistema.
• Caso deseje que sempre pesquise todos os tipos de documentos, parametrizar com o valor Todos.
  

FORMA_BUSCA_COMISSARIA_FAT_ANT (Padrão = 1):

Forma de busca da Comissária na tela de Faturamento Antecipado Unificado:

1. Busca "Doc. Saída" senão "Doc. Entrada" senão "Ult. Fat." senão Comissária genérica.
2. Busca primeira Comissária para o beneficiário das opções de tarifa).

REVALIDA_OP_TARIFA_FAT_ANT (Padrão = 1):

Forma de revalidação de opção de tarifa de faturamento antecipado unificado:

1. Revalida apenas a opção validada. Caso negativo, refaz uma nova pesquisa das opções do cliente até validar uma opção de tarifa.
2. Sempre validar todas as opções de tarifa do cliente.
3. Valida apenas os processos que não possuem opção definida.

Observação:

• Este processo é realizado na primeira pesquisa na tela de Faturamento Antecipado, sendo este necessário para garantir que os processos tenham credibilidade nos dados.

ALTERAR_COM_FAT_ANT ( Padrão = S):

Habilita o botão para permitir a alteração da Comissária na tela de Faturamento Antecipado Unificado:

• S - Sim
• N - Não.

ALTERAR_DATA_FIM_PER_FAT_ANT (Padrão = S).

Habilita o botão para permitir a alteração da data do fim do período de cálculo na tela de Faturamento Antecipado Unificado:

•  S - Sim
• N - Não.

CONSISTE_APRENSAO_FAT_ANT (Padrão = 3): 

Forma de consistência nos processos de apreensão na tela de Faturamento Antecipado Unificado:

1. Não exibe mensagem.
2. Exibe mensagem confirmativa (S/N).
3. Bloqueia o processo de cálculo.

CONSISTE_VENC_LOTE_FAT_ANT (Padrão = 3):

Forma de consistência nos processos de lotes vencidos na tela de Faturamento Antecipado Unificado:

1. Não exibe mensagem.
2. Exibe mensagem confirmativa (S/N).
3. Bloqueia o processo de cálculo.

Procedimento para Implantação

• Atualização do banco de dados por meio do AtualizaDB.

• Atualização dos executáveis do pacote.

• Execução dos scripts do pacote.

Procedimento para Utilização

1. No SARA, módulo Faturamento, acesse o menu Cálculo / Faturamento Antecipado.

Image Added 
ou utilize o menu rápido Image Added

2. Defina o filtro necessário e clique em Filtrar, para carregar os processos dos Lotes.

3. Selecione o(s) lote(s) desejado(s) no grid.

4. Clique em Processar para efetuar o cálculo.

Ponto de Entrada

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf