Module: FocusNfe::Recursos::Concerns::Visualizavel

Included in:
Nfe
Defined in:
lib/focus_nfe/recursos/concerns/visualizavel.rb

Overview

Comportamento de prévia/visualização (+POST /<base_previa>+ com o payload no corpo). Gera o PDF apenas para conferência visual — sem valor fiscal e sem emitir o documento. O caminho é declarado por Base.caminho_base_previa em cada recurso (ex.: "nfe/danfe"), para que outros documentos com prévia o adotem sem alterar o mixin. A validação opt-in reaproveita o schema via Emitivel.

Instance Method Summary collapse

Instance Method Details

#previa(dados:, validar: false) ⇒ String?

Gera a prévia do documento a partir do payload, devolvendo os bytes do PDF.

Parameters:

  • dados (Hash) —

    payload do documento (mesmos campos da emissão)

  • validar (Boolean) (defaults to: false) —

    se true, valida dados contra o schema empacotado antes do envio

Returns:

  • (String, nil) —

    bytes crus do PDF da prévia

Raises:



20
21
22
23
24
 
# File 'lib/focus_nfe/recursos/concerns/visualizavel.rb', line 20

def previa(dados:, validar: false)
  validar_dados!(dados) if validar

  connection.post(caminho_base_previa, body: dados).raw_body
end