Identificador de Regra

VEN-140ALCHVIT

Finalidade: Permitir alterar a chave de acesso e a sequência do item do documento referenciado que serão gravadas no grupo DFeReferenciado de cada item do documento eletrônico.

Módulo: VEN - Vendas.

Tela: Rotinas de emissão de documentos eletrônicos que geram o grupo DFeReferenciado nos itens, no momento da montagem do XML.

Transação: Não se aplica.

Características:

• O identificador é acionado uma vez por item do documento, no momento em que a chave de acesso e a sequência do item referenciado são carregadas.
• As duas variáveis de retorno (VenAChaveAcesso e VenASeqIteReferenciado) chegam preenchidas com os valores que o sistema localizou. Quando a regra devolve conteúdo, esse conteúdo substitui o valor original.
• O identificador atende os documentos NF-e, NFCom, CT-e, CT-e Simplificado e CT-e OS, identificados pela variável VenATipoDocumento.

Observações:

A referência ao documento de origem pode ser informada em dois locais distintos no XML, conforme a finalidade de emissão da nota:

• NfRef: grupo de referência informado nos dados gerais (cabeçalho) do documento.
• DFeReferenciado: grupo de referência informado item a item, previsto pela NT 2025.002.

A decisão do local da tag segue a matriz abaixo. O identificador permite intervir nessa decisão:

Variáveis Disponibilizadas:

Regra:

Exemplo de regra — informar a chave de acesso e a sequência do item referenciado a partir de um campo de usuário, apenas para NF-e de devolução:

Definir Alfa VenAChaveAcesso;
Definir Alfa VenASeqIteReferenciado;
Definir Alfa VenATipoDocumento;
Definir Numero VenNFinalidadeNota;
Definir Alfa xChaveUsuario;

xChaveUsuario = E140IPV.USU_CHVREF;

Se ((VenATipoDocumento = "NFE") e (VenNFinalidadeNota = 4) e (xChaveUsuario <> ""))
Inicio
  VenAChaveAcesso = xChaveUsuario;
  VenASeqIteReferenciado = "1";
Fim;

A chave devolvida pela regra é utilizada tal como informada, sem validação de existência. Uma chave inválida gera rejeição na transmissão do documento. O campo de usuário citado no exemplo é ilustrativo e deve ser substituído pela origem real do dado no ambiente.