.

Sobre a Melhoria.

A Primary Key (PK), ou Chave Primária dos documentos fiscais (Tabelas SF1 e SF2), desde a criação do Protheus  é composta pelos campos: 

...

Para cada campo _SERIE no sistema, foi criado um respectivo _SDOC, baseado na nomenclatura do original.

Exemplo:

Tabela SD2 

 ! Os novos campos, têm as mesmas características dos campos _SERIE atuais, tamanho, título, descrição, etc.

...

Lista de Tabelas e Campos Tratados no Sistema.

Funcionamento da Função NewSerieNfd().

Importante!

Esta funcionalidade está disponível somente na versão 12.1.2510 e superiores.

Lembrando que esta função só terá efeito para as tabelas PADRAO do sistema, não podendo ser utilizada em tabelas CUSTOMIZADAS.

E as tabelas a serem utilizadas, deverão estar posicionadas no registro desejado, a função não faz nenhum tipo de posicionamento, somente retorna o conteúdo, tamanho, demais características, dos registros posicionados.

A função NewSerieNFd() é responsável por retornar o formato e estrutura do campo série, tendo em vista compatibilizar a função SerieNFID().

NewSerieNFd(cAlias as character ,nOpcao as numeric ,cCpoOrig as character ,cSerieGrv as character)

LISTA DE PARÂMETROS.

cAlias       -> Alias da tabela do campo _SERIE

nOpcao    -> 1 - Gravação (sempre gravará 2 campos o _SERIE e o correspondente _SDOC quando existir no dicionário de dados)

                      2 - Visualização (Retorna o conteúdo gravado nos campos _SERIE ou _SDOC

                      3 - Retorna o nome do campo série a ser utilizado em querys. Exemplo: F1_SERIE ou F1_SDOC

                      4 - Retorna a chave de pesquisa ID ou serie Real para utilizar em validações dbSeek() ANTES da gravação dos dados editados

                      5 - Retorna o Criavar do campo _SDOC em casos onde o campos _SERIE já esteja com tamanho 14 para gravar o novo modelo

                      6 -  Retorna o TamSX3 do campo _SDOC em casos onde o campos _SERIE já esteja com tamanho 14 para gravar o novo modelo

                      7 -  Retorna o RetTitle do campo _SDOC em casos onde o campos _SERIE já esteja com tamanho 14 para gravar o novo modelo

cCpoOrig -> String contendo o nome do campo da serie Original da tabela padrão Exemplo: F1_SERIE

cSerieGrv -> Variável Conteúdo da Serie do documento fiscal  a ser gravada (OPCIONAL Usar somente com opção "1" - Gravação e "4"  - Validação)

O retorno será de acordo com a opção enviada (nOpcao).

nOpcao = 1 -> Nil
nOpcao = 2 -> Conteudo do Campo Serie a ser Utilizado
nOpcao = 3 -> Nome do Campo Serie a ser utilizado
nOpcao = 4 -> Chave de Pesquisa ID ou Serie Real sempre encima do conteudo gravados nos campos _SERIE
nOpcao = 5 -> retorna o CriaVar do campo
nOpcao = 6 -> retorna o TamSX3 do campo
nOpcao = 7 -> retorna o X3Titulos do campo

Detalhamento de uso da função utilizando cada opção.

OPÇÃO 1 - GRAVAÇÃO -  Uso em rotina de gravação do campo série utilizando a função SerieNfId(), substituir a gravação direta do campo F1_SERIE onde a função gravará os 2 campos F1_SERIE e F1_SDOC

A gravação direta do campo F1_SERIE é substituída pela utilização da função com a opção 1.

Ao passar os parâmetros necessários, a função se encarrega de montar o ID e realizar a gravação nos campos F1_SERIE e F1_SDOC simultaneamente

OPÇÃO 2 - VISUALIZAÇÃO – Rotina de geração de um arquivo magnético onde a serie do documento fiscal faz parte do layout da obrigação.

A opção 2 retorna o CONTEÚDO do campo que possui o valor da série REAL, ou seja a série de tamanho 3.

Esta opção pode ser utilizada em relatórios, arquivos magnéticos, ou em qualquer momento em que o conteúdo da série real tenha de ser apresentado.

OPÇÃO 3 – NOME DO CAMPO - Exemplo de substituição de Query em filtro de uma Pergunte com parâmetro Série utilizando a função SerieNfId() com a opção 3

Image Added

Image Added

O usuário digita a série real nos parâmetros MV_PAR14 e MV_PAR15, porém a busca deve ser feita no campo onde ela foi gravada, e a opção 3 retorna qual o campo contém a série real.

OPÇÃO 4 – NOVO ID ou SERIE  – Retorna o novo ID ou a Serie Real do documento fiscal conforme o cenário utilizado pelo usuário através da passagem dos parâmetros necessários. 

Utilizar esta opção quando for necessário montar um ID, para que não haja a necessidade de montar manualmente.

Exemplo: validar a inclusão de documento na tabela ANTES da gravação do mesmo.

OPÇÃO 5 – CRIAVAR – Em caso de necessidade de se obter o CriaVar() do campo que contenha a serie real do documento fiscal mesmo estando com o novo formato de gravação do ID de Controle ativo.

OPÇÃO 6 – TAMSX3()[1]- Exemplo de substituição da função TamSX3()[1] para obter o tamanho do campo Série real, utilizar somente quando houver a necessidade de obter o tamanho da serie real em qualquer cenário de configuração.

OPÇÃO 7 – RETTITLE - Exemplo para obter o LABEL do campo _SDOC estando o cliente utilizando o novo formato de gravação do Id de Controle ou não.

Image Added

Funcionamento da Função RetTypeDoc().

Importante!

Esta funcionalidade está disponível somente na versão 12.1.2510 e superiores.

Lembrando que esta função só terá efeito para as tabelas PADRAO do sistema, não podendo ser utilizada em tabelas CUSTOMIZADAS.

E as tabelas a serem utilizadas, deverão estar posicionadas no registro desejado, a função não faz nenhum tipo de posicionamento, somente retorna o conteúdo, tamanho, demais características, dos registros posicionados.

A função RetTypeDoc() é responsável por retornar o tamanho do modelo ou da série do documento.

RetTypeDoc(cModelo as character, nTipo as numeric, lEmissor as logical)

LISTA DE PARÂMETROS.

cModelo  → Indica o modelo do documento fiscal

nTipo       → Indica qual tamanho será retornado 

                     1 - Tamanho do campo documento

                      2 - Tamanho do campo série

                      3 - Código do modelo de documento

                      4 - Opções de comboBox

lEmissor → Indica se para a operação 1 ou 2 está gerando pelo sistema a numeração de nota fiscal

O retorno será de acordo com a opção enviada (nTipo).

Detalhamento de uso da função utilizando cada opção.

Tipo 1 - Tamanho documento 

Onde:

Modelo = "SPED"
Tipo = 1
Emissor = .F.

Retorno será 9, o tamanho do documento.

Tipo 2 - Tamanho série

Onde:

Modelo = "NFCE"
Tipo = 2
Emissor = .F.

Retorno será 3, o tamanho da série utilizada.

Tipo 3 - Código do modelo

Onde:

Modelo = "SPED"
Tipo = 3
Emissor = .F.

Retorno será 55, o modelo do documento utilizado.

Tipo 4 - ComboBox

Onde:

Modelo = "NF"
Tipo = 4
Emissor = .F.

Retorno será a string abaixo:

"ACT=Autorização de Carregamento e Transporte;BPA=Bilhete de Passagem Aquaviário;BPE=Bilhete de passagem eletrônico - BP-e;BPECF=Bilhete de Passagem emitido por ECF;BPF=Bilhete de Passagem Ferroviário;BPNB=Bilhete de Passagem e Nota de Bagagem;BPR=Bilhete de passagem rodoviário;BRPA=Bilhete/Recibo do Passageiro;CA=Conh. Aéreo;CF=Cupon Fiscal;CFECF=Cupom Fiscal emitido por ECF;CFEECF=Cupom Fiscal Eletrônico CF-e-ECF;CTA=Conh.Transp. Aquaviário de Cargas;CTCA=Conh.Transp. Cargas Avulso;CTE=Conh.Transp. Eletrônico;CTEOS=Conh.Transp. Eletrônico - CT-e OS;CTF=Conh.Transp.Ferroviario de Cargas;CTM=Conh.Transp.Multimodal;CTR=Conh.Transp.Rodoviario de Cargas;DT=Despacho de Transporte;ECF=Cupon Fiscal gerado pelo SIGALOJA;GNRE=GNRE;MC=Manifesto de Carga;NF=Nota Fiscal;NF3E=NF Energia Eletrica Eletrônica;NFA=NF Avulsa;NFCE=NF Eletrônica Consumidor Final NFC-e;NFCEE=Nota Fiscal/Conta de Energia Elétrica;NFCF=NF de venda a Consumidor Final;NFCFG=NF/conta de fornecimento de gas;NFCOM=NF Fatura de Serviços de Comunicação;NFE=NF Entrada;NFFA=NF/Conta de fornecimento de Água;NFP=NF de Produtor;NFSC=NF Servico de Comunicacao;NFST=NF Servico de Transporte;NFTFC=NF Transp.Ferroviário de Cargas;NTSC=NF Servico de Comunicacao;NTST=NF Servico de Telecomunicacoes;OCC=Ordem de Coleta de Carga;RMD=Resumo Movimento Diario;SATCE=Cupom Fiscal Eletrônico - SAT;SPED=NF Eletrônica do SEFAZ.;3A=NF de Servico Simplificada;NFPS=NF Prestacao de Servico;NFS=NF Servico;NFSE=NF Servico Eletrônica;RPS=Recibo Provisorio de Servicos"