OdooWiki OCA HUB

NF-e

l10n_br_nfe folder_open OCA/l10n-brazil open_in_new
Localisation Licencia: AGPL-3

Este módulo permite la emisión de NF-e.

Más específicamente:

  • mapea los campos de NF-e del módulo l10n_br_nfe_spec con los campos Odoo, en especial los campos de los módulos l10n_br_base y l10n_br_fiscal
  • usa la lógica del módulo spec_driven_model para realizar ese mapeo de forma dinámica, en especial usa el sistema de modelos con varias capas, o StackedModel, con los modelos l10n_br_fiscal.document, l10n_br_fiscal.document.line y l10n_br_fiscal.document.related que tienen varios niveles jerárquicos de elementos XML que están siendo denormalizados dentro de esos modelos Odoo
  • permite la exportación e importación de XML de NF-e
  • tiene wizards para implementar la comunicación SOAP de NF-e con la SEFAZ (Autorización, Cancelación, Inutilización...)
  • implementa la autorización, inutilización y contingencia de documentos NFC-e

Módulos relacionados:

  • este módulo no depende del módulo account de Odoo. La integración con el financiero del módulo account se realiza en el módulo l10n_br_account_nfe (tags dup y pag en especial)
  • existe también el módulo l10n_br_delivery_nfe que hace la integración del módulo l10n_br_nfe con el módulo delivery de Odoo (tags de transportadora y de flete en especial)

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Permite a las empresas brasileñas emitir, transmitir e imprimir facturas electrónicas (NF-e y NFC-e) directamente desde Odoo, incluido el envío a la autoridad fiscal (SEFAZ), su cancelación, la importación de archivos XML de proveedores y la impresión del DANFE.

Este módulo convierte los documentos fiscales de Odoo en facturas electrónicas oficiales brasileñas (NF-e y NFC-e). Asigna los datos de la factura al formato XML oficial del gobierno y añade las pantallas y botones necesarios para trabajar con ellos.

Qué pueden hacer los usuarios: - Preparar una NF-e/NFC-e a partir de un documento fiscal, con la clave de la factura, la serie, el número, el entorno (producción o prueba) y el modo de transmisión rellenados automáticamente. - Enviar la factura a SEFAZ, consultar su estado, cancelarla e imprimir el DANFE (el documento imprimible de la factura) o el recibo de la NFC-e con código QR. - Importar el archivo XML de una NF-e de un proveedor, que crea el documento, sus líneas, contactos y productos, y puede crear referencias de productos del proveedor. - Registrar eventos de manifestación del destinatario (como confirmar o rechazar una factura recibida) y enviarlos a SEFAZ. - Configurar perfiles de impresión del DANFE: márgenes, fuentes, posición del recibo, recibo del transportista, datos de lote/ANP/ANVISA, logotipo y texto del pie de página.

Reglas y comprobaciones automáticas: - Los productos de una NF-e deben tener un código predeterminado o un código de producto en la línea; de lo contrario, el documento se bloquea. - La fecha del documento debe coincidir con el mes y el año codificados en la clave de acceso de la factura. - El indicador de destino (dentro/fuera del estado, extranjero) se calcula a partir de las direcciones de la empresa y del cliente. - Los totales de impuestos (ICMS, IPI, PIS, COFINS, IBS/CBS y otros) se toman de las líneas del documento. - Los contactos, las empresas y las ciudades se emparejan o se crean al importar el XML.

Los ajustes incluyen la versión de la NF-e, el entorno, el modo de transmisión, los diseños del DANFE y si los contactos del contador o del soporte técnico están autorizados a descargar el XML.

Depende de

l10n_br_fiscal_edil10n_br_fiscal_certificatel10n_br_nfe_specspec_driven_model

Lo necesitan otros módulos

l10n_br_account_nfel10n_br_delivery_nfel10n_br_ie_searchl10n_br_nfe_dfel10n_br_pos_nfce

Menús que añade

NF-eRecipient ManifestationImportImported DocumentDANFE Profiles
Modelos y campos (23)
  • uom.uom · amplía un modelo existente
  • res.city · amplía un modelo existente
  • nfe.40.di · amplía un modelo existentenfe40_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 · modelo nuevonfe40_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 · amplía un modelo existente
  • res.partner · modelo nuevonfe40_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 · amplía un modelo existente
  • ir.actions.report · amplía un modelo existente
  • res.country.state · amplía un modelo existente
  • l10n_br_nfe.autxml · modelo nuevonfe40_CPF, nfe40_CNPJ, partner_id (Authorized Partner)
  • l10n_br_fiscal.cest · amplía un modelo existente
  • res.config.settings · amplía un modelo existentenfe_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 · modelo nuevoserie, 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 · amplía un modelo existentepartner_uom_id (Partner Unit of Measure), partner_uom_factor (Partner UOM Factor)
  • l10n_br_fiscal.document · modelo nuevonfe40_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 · modelo nuevoname, 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 · modelo nuevonfe40_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 · modelo nuevonfe40_refCTe, nfe40_refNFe, nfe40_choice_nfref
  • l10n_br_nfe.import_xml.products · modelo nuevototal, 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 · amplía un modelo existente
  • l10n_br_fiscal.document.supplement · modelo nuevonfe40_qrCode, nfe40_urlChave
  • l10n_br_fiscal.document.import.wizard · amplía un modelo existentenat_op (Natureza da Operação), imported_products_ids (Imported Products)
  • nfe_recipient_manifestation_event.wizard · modelo nuevoaccess_key, event_type

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 6 confirmadas, 3 sin información de 9 versiones.

Fuentes · Odoo 17.0

Confirmado el 2026-11-03 en la rama 17.0 de OCA/l10n-brazil.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Configuración

Fuente · Odoo 18.0

Las opciones de impresión de la DANFE se encuentran en perfiles, en Fiscal > Configuración > Otros > Perfiles de DANFE: márgenes, posición del canhoto, canhoto de recogida de la transportadora, fuente, decimales, datos mostrados en la descripción del producto y sello de pie de página, entre otras. Cada empresa usa el perfil elegido en el campo Perfil de DANFE, en la pestaña Fiscal > NF-e del registro de la empresa.

Uso

Fuente · Odoo 18.0

El menú de NF-e se encuentra dentro del menú fiscal.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.