infSolicNFF: solicitação original da Nota Fiscal Fácil

infSolicNFF reúne as informações da solicitação da Nota Fiscal Fácil (NFF), dentro de infNFe. Seu filho xSolic contém os campos e valores do pedido gerado pelo aplicativo da NFF, em formato JSON. Não é um campo genérico para descrever uma venda nem substitui os grupos estruturados da NF-e.

Caminho desta página: /nfeProc/NFe/infNFe/infSolicNFF. O prefixo nfeProc identifica a nota processada; a informação estudada pertence ao conteúdo da NF-e, dentro de NFe/infNFe.

Quando o grupo pertence ao fluxo NFF

A NT 2021.002 v1.12 descreve o pedido de emissão somente na hipótese tpEmis=3, NFF, gerado exclusivamente pelo aplicativo emissor. O pedido preserva os campos e valores enviados pelo aplicativo para a emissão; a estrutura também aparece na documentação de pedidos de evento, em contexto próprio.

Uma NF-e gerada por software comum não passa a integrar o regime NFF por receber esta tag. A aplicação do fluxo depende do regime e da autorização correspondentes, não da presença opcional do elemento no XSD. A página explica a leitura e integração do pedido, sem atribuir habilitação a qualquer contribuinte pela simples presença do grupo. NT 2021.002, p. 8–9.

Estrutura: JSON dentro de um campo textual XML

O grupo é opcional no XSD; quando existe, exige um único xSolic, texto entre 2 e 5.000 caracteres. O limite atual consta na NT e no PL 010f v1.04; confira se o gerador conserva algum limite menor herdado de versões anteriores.

O JSON é o conteúdo textual de xSolic, não uma árvore de novas tags. Há duas validações diferentes: XML bem formado e compatível com o XSD; JSON íntegro e coerente com a solicitação original. O tipo textual do XSD não analisa os membros do objeto JSON e não demonstra que o conteúdo veio do aplicativo autorizado.

Exemplo somente de envelope e serialização

Para demonstrar a estrutura sem inventar contrato de pedido fiscal, use um objeto vazio de JSON:

<infSolicNFF xmlns="http://www.portalfiscal.inf.br/nfe">
  <xSolic>{}</xSolic>
</infSolicNFF>

O fragmento é parcial e não é um pedido NFF válido de emissão nem XML completo da NF-e. {} serve apenas para explicar que o conteúdo está dentro de um campo textual; não substitui os campos e valores reais do pedido do aplicativo.

Em uma solicitação real, caracteres reservados do XML, como &, precisam ser escapados pelo serializador, ou preservados em seção CDATA adequada. O leitor XML deve recuperar o texto JSON original, que então pode ser analisado por um leitor JSON. Não confunda aspas do JSON com delimitadores de atributos XML.

Pedido, documento e protocolo são evidências distintas

A solicitação registra o que foi pedido ao fluxo NFF. A NF-e contém a representação fiscal gerada e o protocolo registra o resultado de processamento. Encontrar infSolicNFF não prova autorização; um pedido pode existir antes da resposta do autorizador.

Para conferir uma diferença, compare a solicitação original do aplicativo, o texto recuperado de xSolic, os campos correspondentes da NF-e e o retorno do serviço correto. Não reescreva o pedido para fazê-lo coincidir com uma nota sem identificar a origem da divergência. Eventuais regras de evento têm seu próprio serviço e não devem ser transplantadas automaticamente para a autorização.

Diagnóstico de truncamento ou JSON inválido

Se o texto foi cortado, confira limites de coluna, importação e gerador, especialmente limites menores herdados por implementações antigas. Se o XML falha, examine caracteres reservados, conteúdo vazio e posição de xSolic. Se o XML passa e o JSON falha, confira o texto após a leitura XML, não somente a aparência no arquivo bruto.

Preserve o pedido original, a identidade do emitente, ambiente e correlação da operação. A correção deve ocorrer no mapeamento ou geração comprovadamente incorretos; não complete campos desconhecidos do pedido por estimativa. A avaliação dos dados fiscais mantém suas regras próprias e a responsabilidade do emissor.

Fontes oficiais

• Leiaute NF-e/NFC-e — PL_010f_v1.04: infSolicNFF/xSolic l6483–6503; TString2–5000
• Tipos básicos NF-e/NFC-e — PL_010f_v1.04: TString e restrições textuais.
• NT 2021.002 — Nota Fiscal Fácil — 1.12, janeiro/2025: Pedido NFF, tpEmis=3 e JSON em xSolic: p. 8–9; exceção de QR-Code: p. 15.