Skip to main content

parse_nfe

Parse a Nota Fiscal Eletrônica (NFe) document using AI-powered OCR to extract comprehensive fiscal information from Brazilian electronic invoices including company data, product details, tax calculations, and transportation info. The parser extracts 70+ fields including: Company Information:

  • chave_acesso: Access key for verification (44 characters)
  • numero_nota: Invoice number (string)
  • serie: Series number
  • cnpj_emitente/razao_social_emitente: Issuer company CNPJ and name
  • cpf_cnpj_destinatario/nome_destinatario/razao_social_destinatario: Recipient tax ID and names
  • endereco_emitente/endereco_destinatario: Full addresses
  • bairro_emitente/bairro_distrito_destinatario: Districts/neighborhoods
  • cep_emitente/cep_destinatario: ZIP codes
  • municipio_emitente/municipio_destinatario: Cities
  • uf_emitente/uf_destinatario: States
  • telefone_emitente/telefone_destinatario: Phone numbers
  • inscricao_estadual_emitente/inscricao_estadual_destinatario: State registrations
  • inscricao_municipal: Municipal registration Financial Information:
  • data_emissao/data_entrada_saida: Issue and entry/exit timestamps
  • data_protocolo_autorizacao/protocolo_autorizacao: Authorization data
  • valor_produtos/valor_total: Product and total amounts
  • valor_icms/valor_ipi/valor_issqn: Tax amounts (ICMS, IPI, ISSQN)
  • valor_frete/valor_seguro/outras_despesas: Additional costs
  • valor_fcp_st/valor_tributos: Additional tax values
  • desconto: Discount amount Product Information:
  • descricao_produto/codigo_produto: Product description and code
  • quantidade/unidade/valor_unitario: Product quantity, unit, unit value
  • ncm_sh: NCM/SH classification code
  • cfop: Fiscal operation code
  • cst: Tax situation code
  • aliquota_icms/base_calculo_icms: ICMS tax rate and calculation base
  • aliquota_ipi/base_calculo_icms_st: IPI rate and ICMS-ST base Transportation Information:
  • natureza_operacao: Nature of operation
  • razao_social_transportadora/cnpj_transportadora: Carrier info
  • endereco_transportadora/municipio_transportadora/uf_transportadora: Carrier location
  • inscricao_estadual_transportadora: Carrier state registration
  • placa_veiculo/uf_veiculo: Vehicle plate and state
  • codigo_antt: ANTT code
  • frete_por_conta: Freight responsibility
  • peso_bruto_kg/peso_liquido_kg: Gross/net weight in kg
  • numero_volumes/quantidade_volumes: Volume count
  • marca_volumes/especie: Volume marking and type
  • hora_saida: Departure time
  • informacoes_adicionais: Additional information text

Parameters​

NameDescriptionTypeDefault
document_path (required)The path to the NFe document to be parsed. dict: The parsed NFe data. ValueError: If document path is invalid or parsing fails.Union[Path, str]None

Return Value​

abstra_internals.contracts_generated.CloudApiCliModelsNfeResponse