OdooWiki OCA HUB
Localisation License: AGPL-3

Este módulo permite a emissão de NF-e.

Mais especificamente ele:

  • mapea os campos de NF-e do módulo l10n_br_nfe_spec com os campos Odoo em especial os campos dos módulos l10n_br_base e l10n_br_fiscal
  • usa a logica do módulo spec_driven_model para realizar esse mapeamento de forma dinâmica, em especial ele usa o sistema de modelos com várias camadas, ou StackedModel, com os modelos l10n_br_fiscal.document, l10n_br_fiscal.document.line e l10n_br_fiscal.document.related que tem varios niveis hierarquicos de elementos XML que estão sendo denormalizados dentro desses modelos Odoo
  • permite a exportação e importação de XML de NF-e
  • tem wizards para implementar a comunicação SOAP de NF-e com a SEFAZ (Autorização, Cancelamento, Inutilização...)
  • implementa a autorização, inutilização e contingência de documentos NFC-e

Módulos relacionados:

  • este módulo não depende do módulo account do Odoo. A integração com o financeiro do módulo account é realizada no módulo l10n_br_account_nfe (tags dup e pag em especial)
  • existe também o módulo l10n_br_delivery_nfe que faz a integração do módulo l10n_br_nfe com o módulo delivery do Odoo (tags de transportadora e de frete em especial)

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Lets Brazilian companies issue, transmit and print electronic invoices (NF-e and NFC-e) directly from Odoo, including sending them to the tax authority (SEFAZ), cancelling them, importing supplier XML files and printing the DANFE.

This module turns Odoo's fiscal documents into official Brazilian electronic invoices (NF-e and NFC-e). It maps the invoice data to the official government XML layout and adds the screens and buttons needed to work with them.

What users can do: - Prepare an NF-e/NFC-e from a fiscal document, with the invoice key, series, number, environment (production or test) and transmission mode filled in automatically. - Send the invoice to SEFAZ, check its status, cancel it and print the DANFE (the printable invoice document) or the NFC-e receipt with QR code. - Import a supplier's NF-e XML file, which creates the document, its lines, partners and products, and can create supplier product references. - Record recipient manifestation events (such as confirming or rejecting a received invoice) and send them to SEFAZ. - Configure DANFE print profiles: margins, fonts, receipt position, carrier receipt, lot/ANP/ANVISA data, footer logo and text.

Automatic rules and checks: - Products on an NF-e must have a default code or a product code on the line, otherwise the document is blocked. - The document date must match the month and year encoded in the invoice access key. - The destination indicator (inside/outside state, abroad) is computed from the company and customer addresses. - Tax totals (ICMS, IPI, PIS, COFINS, IBS/CBS and others) are pulled from the document lines. - Partners, companies and cities are matched or created when importing XML.

Settings include NF-e version, environment, transmission mode, DANFE layouts and whether accountant or technical support contacts are authorised to download XML.

Menus it adds

NF-eRecipient ManifestationImportImported DocumentDANFE Profiles
Models and fields (23)
  • uom.uom · extends an existing model
  • res.city · extends an existing model
  • nfe.40.di · extends an existing modelnfe40_CNPJ, nfe40_UFDesemb (Customs Clearance Code), nfe40_UFTerceiro, nfe40_tpViaTransp, nfe40_tpIntermedio, state_clearance_id (State Customs Clearance), partner_acquirer_id (Partner Acquirer)
  • res.company · new modelnfe40_IE, nfe40_CPF, nfe40_CRT, nfe40_CNPJ, nfe40_fone, nfe40_xFant, nfe40_xNome, nfe_version (NFe Version), nfce_csc_code (CSC Code), nfce_csc_token (CSC Token), nfe40_enderEmit, nfe_environment (NFe Environment), danfe_profile_id (DANFE Profile), nfe_danfe_layout (NFe Layout), nfe_transmission (Transmission Type), processador_edoc, nfce_danfe_layout (NFCe Layout), nfe40_choice_emit (CNPJ ou CPF?), nfce_qrcode_version (QRCode Version), nfe_default_serie_id (NF-e Default Serie), nfe_enable_contingency_ws, nfe_separate_async_process (Separate NF-e Send and Consult), nfe_enable_sync_transmission, nfe_authorize_technical_download_xml (Include Technical Support Partner data in persons authorized to download NFe XML), nfe_authorize_accountant_download_xml (Include Accountant Partner data in persons authorized to download NFe XML)
  • res.country · extends an existing model
  • res.partner · new modelnfe40_IE, nfe40_UF, nfe40_CEP, nfe40_CPF, nfe40_nro, nfe40_CNPJ, nfe40_ISUF, nfe40_cMun, nfe40_fone, nfe40_xCpl, nfe40_xLgr, nfe40_xMun, nfe40_cPais, nfe40_email, nfe40_xFant (Nome Fantasia), nfe40_xNome, nfe40_xPais, nfe40_xEnder, nfe40_xBairro, nfe40_xContato, nfe40_enderDest, nfe40_indIEDest, nfe40_choice_dest (CNPJ/CPF/idEstrangeiro), nfe40_choice_emit (CNPJ/CPF do Emitente), nfe40_choice_tlocal (CNPJ/CPF do Parceiro), is_anonymous_consumer, nfe40_choice_transporta (CNPJ or CPF)
  • product.product · extends an existing model
  • ir.actions.report · extends an existing model
  • res.country.state · extends an existing model
  • l10n_br_nfe.autxml · new modelnfe40_CPF, nfe40_CNPJ, partner_id (Authorized Partner)
  • l10n_br_fiscal.cest · extends an existing model
  • res.config.settings · extends an existing modelnfe_version (NF-e Version), nfe_environment (NFe Environment), nfe_danfe_layout (NFe Layout), nfe_transmission (NFe Transmission), nfe_version_name (NFe Proc Version), nfce_danfe_layout (NFCe Layout), nfe_enable_sync_transmission, nfe_authorize_technical_download_xml (Include Technical Support Partner data in persons authorized to download NFe XML), nfe_authorize_accountant_download_xml (Include Accountant Partner data in persons authorized to download NFe XML)
  • l10n_br_nfe.md_event · new modelserie, state, protocol, access_key, company_id (Company), event_type (Manifestation Type), environment, response_xml (Response XML), document_type, protocol_date (Registration Date), document_number
  • product.supplierinfo · extends an existing modelpartner_uom_id (Partner Unit of Measure), partner_uom_factor (Partner UOM Factor)
  • l10n_br_fiscal.document · new modelnfe40_Id, nfe40_CRT (Código de Regime Tributário (NFe)), nfe40_cUF (nfe40_cUF), nfe40_det, nfe40_mod (nfe40_mod), nfe40_nNF, nfe40_vBC (BC do ICMS), nfe40_vII, nfe40_vNF, nfe40_vST, nfe_xJust, nfe40_dest (Dest), nfe40_emit (Emit), nfe40_nFat, nfe40_tpNF, nfe40_vCBS (Valor total da CBS), nfe40_vIBS (Valor total do IBS), nfe40_vIPI, nfe40_vLiq, nfe40_vPIS (Valor do PIS (NFe)), nfe40_vSeg, nfe_dhCont, nfe40_NFref, nfe40_dhEmi, nfe40_natOp, nfe40_serie, nfe40_tpAmb, nfe40_tpImp, nfe40_vBCST, nfe40_vDesc (Montante de Desconto)
  • l10n_br_nfe.danfe.profile · new modelname, active, font_size, font_type, lot_prefix (Lot Data Prefix), margin_top, company_ids (Companies), display_anp (Display ANP Data), display_lot (Display Lot Data), margin_left, margin_right, margin_bottom, display_anvisa (Display ANVISA Data), carrier_receipt, invoice_display, price_precision (Unit Price Precision), receipt_position, footer_stamp_logo, footer_stamp_text, display_pis_cofins (Display PIS/COFINS), quantity_precision, infcpl_semicolon_newline (Break Additional Info on Semicolons), display_product_additional_info
  • l10n_br_fiscal.document.line · new modelnfe40_NCM, nfe40_vII, nfe40_CEST (CEST code), nfe40_CFOP, nfe40_cEAN, nfe40_cEnq, nfe40_cMun, nfe40_orig, nfe40_pIPI (pIPI), nfe40_pPIS (nfe40_pPIS), nfe40_qCom (nfe40 qCom), nfe40_uCom, nfe40_vIOF (vIOF), nfe40_vIPI, nfe40_vPIS (Valor do PIS (NFe)), nfe40_vSeg, nfe40_xPed, nfe40_cPais, nfe40_modBC, nfe40_pICMS (pICMS), nfe40_qTrib (nfe40_qTrib), nfe40_uTrib, nfe40_vBCST, nfe40_vDesc, nfe40_vICMS, nfe40_vProd, nfe40_EXTIPI, nfe40_IBSCBS (Grupo de informações dos tributos IBS, CBS), nfe40_cBenef, nfe40_cMunFG
  • l10n_br_fiscal.document.related · new modelnfe40_refCTe, nfe40_refNFe, nfe40_choice_nfref
  • l10n_br_nfe.import_xml.products · new modeltotal, ncm_xml (XML NCM Code), uom_com (UOM Comercial), cfop_xml (XML CFOP), uom_trib (UOM Fiscal), ipi_value (IPI Value), icms_value (ICMS Value), product_id (Product Internal Reference), ipi_percent (Alíquota IPI), new_cfop_id (Change CFOP), icms_percent (Alíquota ICMS), ncm_internal (Internal NCM Code), product_code (XML Product Code), product_name, quantity_com (Comercial Quantity), uom_internal, import_xml_id, quantity_trib, price_unit_com (Comercial Price Unit), price_unit_trib (Fiscal Price Unit), imported_partner_id, product_supplier_id (Product Supplier), uom_conversion_factor (UOM Conversion Factor)
  • l10n_br_fiscal.tax.ipi.guideline · extends an existing model
  • l10n_br_fiscal.document.supplement · new modelnfe40_qrCode, nfe40_urlChave
  • l10n_br_fiscal.document.import.wizard · extends an existing modelnat_op (Natureza da Operação), imported_products_ids (Imported Products)
  • nfe_recipient_manifestation_event.wizard · new modelaccess_key, event_type

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 6 confirmed, 3 with no information of 9 versions.

Sources · Odoo 17.0

Confirmed on 2026-11-03 in branch 17.0 of OCA/l10n-brazil.

terminal Installation and usage

OCA documentation · Odoo 18.0

As opções de impressão da DANFE ficam em perfis, em Fiscal > Configuração > Outros > Perfis de DANFE: margens, posição do canhoto, canhoto de coleta da transportadora, fonte, casas decimais, dados exibidos na descrição do produto e carimbo de rodapé, entre outras. Cada empresa usa o perfil escolhido no campo Perfil de DANFE, na aba Fiscal > NF-e do cadastro da empresa.

O menu de NF-e se encontra dentro do menu fiscal.

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.