OdooWiki OCA HUB
Localisation Licencia: AGPL-3

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

Más específicamente:

  • mapea los campos de MDF-e del módulo l10n_br_mdfe_spec con los campos Odoo.
  • 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 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
  • tiene wizards para implementar la comunicación SOAP de MDF-e con la SEFAZ (Autorización, Cancelación, Cierre...)

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 y gestionar documentos de transporte MDF-e (manifiestos electrónicos de carga) dentro de Odoo, incluidos los detalles del modal de transporte, los totales, la generación de XML, la firma digital y el PDF DAMDFE.

Este módulo añade el documento de transporte MDF-e (Manifesto Eletrônico de Documentos Fiscais) a los documentos fiscales brasileños de Odoo. Los usuarios lo encuentran en el menú de documentos fiscales, en una nueva entrada «MDF-e».

En la pantalla de MDF-e el usuario rellena la información de transporte: versión, entorno, tipo de emisor, tipo de transmisión, modal de transporte (carretera, aéreo, fluvial o ferroviario), estados inicial y final, ciudades de carga y estados de la ruta. El módulo construye entonces automáticamente la estructura XML oficial y rellena la clave del documento, los códigos de estado, las listas de carga y ruta, y los totales de los documentos NF-e, CT-e y MDF-e vinculados (recuento, peso de la carga y valor de la carga).

Cada modal de transporte tiene sus propias pantallas de detalle: para el transporte por carretera, matrícula del vehículo, tara, tipo de rueda y de carrocería, conductores, propietario, RNTRC, etiquetas de peaje, CIOT e información de pago; para el fluvial, embarcación, puertos, terminales de carga/descarga y convoyes; para el ferroviario, datos del tren y vagones; para el aéreo, datos de la aeronave y del vuelo. Las ciudades de descarga se registran con los documentos NF-e, CT-e o MDF-e que se entregan allí.

Antes del envío, el módulo comprueba que los campos obligatorios estén rellenos (CNPJ de la empresa, estado, certificado digital, tipo de documento, serie, número, fechas, modal, estados, ciudades y documentos vinculados) y lanza un error claro que enumera lo que falta. Para el transporte por carretera también comprueba los datos del vehículo, el nombre y el CPF del conductor, y las reglas de RNTRC del propietario.

Genera y firma el XML con el certificado de la empresa, lo valida contra el esquema oficial y produce el informe PDF DAMDFE.

Menús que añade

MDF-e
Modelos y campos (30)
  • res.city · amplía un modelo existente
  • res.company · modelo nuevomdfe30_IE, mdfe30_CPF, mdfe30_CNPJ, mdfe30_fone, mdfe30_xFant, mdfe30_xNome, mdfe_version (MDFe Version), mdfe_emit_type (MDFe Emit Type), mdfe30_enderEmit (Endereço Emitente - MDFe), mdfe_environment (MDFe Environment), mdfe_transp_type (MDFe Transp Type), damdfe_margin_top, mdfe_transmission (MDFe Transmission), damdfe_margin_left, mdfe30_choice_emit (MDFe emit CNPJ/CPF), damdfe_margin_right, damdfe_margin_bottom, mdfe_authorize_accountant_download_xml (Include Accountant Partner data in persons authorized to download MDFe XML)
  • res.partner · modelo nuevomdfe30_IE, mdfe30_UF, mdfe30_CEP (CEP - MDFe), mdfe30_CPF, mdfe30_nro (Número - MDFe), mdfe30_CNPJ, mdfe30_cMun (Código do Município - MDFe), mdfe30_fone (Telefone MDFe), mdfe30_xCpl (Complemento - MDFe), mdfe30_xLgr (Logradouro - MDFe), mdfe30_xMun (Nome do Município - MDFe), mdfe30_xSeg, mdfe30_cPais (Código do País - MDFe), mdfe30_email, mdfe30_xFant (Nome Fantasia - MDFe), mdfe30_xNome (Nome - MDFe), mdfe30_xPais (Nome do País - MDFe), mdfe30_tpProp, mdfe30_respSeg, mdfe30_xBairro (Bairro - MDFe), mdfe30_xContato, mdfe30_choice_emit (CNPJ/CPF do Emitente - MDFe), mdfe30_choice_autxml (CNPJ/CPF do Parceiro Autorizado - MDFe), mdfe30_idEstrangeiro, mdfe30_choice_insurer (CNPJ/CPF do Responsável pelo Seguro da Carga), mdfe30_choice_contractor (CNPJ/CPF do Contratante), mdfe30_choice_tcontractor (CNPJ/CPF/Id Estrangeiro do Contratante), mdfe30_choice_trailer_owner (CNPJ/CPF do Proprietário do Reboque)
  • product.product · modelo nuevomdfe30_NCM, mdfe30_cEAN, mdfe30_xProd, mdfe30_tpCarga, mdfe30_infLotacao
  • ir.actions.report · amplía un modelo existente
  • res.country.state · amplía un modelo existente
  • res.config.settings · amplía un modelo existentemdfe_version (MDF-e Version), mdfe_environment (MDF-e Environment), mdfe_transmission (MDF-e Transmission), mdfe_version_name (MDF-e Proc Version)
  • l10n_br_fiscal.document · modelo nuevomdfe30_Id, mdfe30_UF, mdfe30_cDV, mdfe30_cUF, mdfe30_mod, mdfe30_nac (Nacionalidade da Aeronave), mdfe30_seg (Seguros da Carga), mdfe30_vag, mdfe_modal (Transport Modal), mdfe30_cInt (Código do Veículo), mdfe30_cMDF (Código Numérico MDFe), mdfe30_dVoo (Data do Voo), mdfe30_disp, mdfe30_emit, mdfe30_irin (IRIN da Embarcação), mdfe30_matr (Matrícula da Aeronave), mdfe30_nMDF, mdfe30_nVoo (Número do Voo), mdfe30_prop (Proprietário do Veículo), mdfe30_qCTe, mdfe30_qNFe, mdfe30_qVag (Quantidade de Vagões), mdfe30_tara (Tara em KG), mdfe30_xOri (Origem do Trem), mdfe30_RNTRC (RNTRC), mdfe30_UFFim, mdfe30_UFIni, mdfe30_cUnid, mdfe30_capKG (Capacidade em KG), mdfe30_capM3 (Capacidade em M3)
  • l10n_br_mdfe.transporte · modelo nuevomdfe30_peri, mdfe30_chMDFe, mdfe30_infUnidTransp
  • l10n_br_mdfe.modal.aereo · modelo nuevomdfe30_nac, document_id, mdfe30_dVoo, mdfe30_matr, mdfe30_nVoo, mdfe30_cAerDes, mdfe30_cAerEmb
  • l10n_br_mdfe.seguro.carga · modelo nuevodocument_id, mdfe30_infSeg, mdfe30_infResp
  • l10n_br_mdfe.transporte.inf · modelo nuevomdfe30_idUnidTransp, mdfe30_infUnidCarga, mdfe30_tpUnidTransp, mdfe30_lacUnidTransp
  • l10n_br_mdfe.product.lotacao · modelo nuevoproduct_id, mdfe30_infLocalCarrega, mdfe30_infLocalDescarrega
  • l10n_br_mdfe.modal.aquaviario · modelo nuevodocument_id, mdfe30_irin, mdfe30_nViag, mdfe30_tpEmb, mdfe30_tpNav, mdfe30_cEmbar, mdfe30_xEmbar, mdfe30_cPrtEmb, mdfe30_cPrtDest, mdfe30_prtTrans, mdfe30_infEmbComb, mdfe30_infTermCarreg, mdfe30_infTermDescarreg, mdfe30_infUnidCargaVazia, mdfe30_infUnidTranspVazia
  • l10n_br_mdfe.modal.rodoviario · modelo nuevomdfe30_UF, document_id, mdfe30_cInt, mdfe30_disp, mdfe30_prop, mdfe30_tara, mdfe30_RNTRC, mdfe30_capKG, mdfe30_capM3, mdfe30_placa, mdfe30_tpCar, mdfe30_tpRod, mdfe30_infPag, mdfe30_RENAVAM, mdfe30_infCIOT, mdfe30_lacRodo, mdfe30_condutor, mdfe30_codAgPorto, mdfe30_veicReboque, mdfe30_categCombVeic, mdfe30_infContratante
  • l10n_br_mdfe.transporte.lacre · modelo nuevodocument_id, mdfe30_nLacre
  • l10n_br_mdfe.modal.ferroviario · modelo nuevomdfe30_vag, document_id, mdfe30_qVag, mdfe30_xOri, mdfe30_xDest, mdfe30_xPref, mdfe30_dhTrem
  • l10n_br_fiscal.document.related · modelo nuevomdfe30_peri, mdfe30_chCTe, mdfe30_chNFe, mdfe30_chMDFe, mdfe30_infUnidTransp
  • l10n_br_mdfe.municipio.descarga · modelo nuevocity_id (City), cte_ids, nfe_ids, mdfe_ids, state_id (State), document_id, document_type, mdfe30_infCTe, mdfe30_infNFe, mdfe30_cMunDescarga, mdfe30_xMunDescarga, mdfe30_infMDFeTransp
  • l10n_br_mdfe.transporte.perigoso · modelo nuevomdfe30_nONU, mdfe30_qTotProd
  • l10n_br_mdfe.transporte.carga.inf · modelo nuevomdfe30_idUnidCarga, mdfe30_tpUnidCarga, mdfe30_lacUnidCarga
  • l10n_br_fiscal.document.supplement · modelo nuevomdfe30_qrCodMDFe
  • l10n_br_mdfe.modal.rodoviario.ciot · modelo nuevois_company (É empresa?), mdfe30_CPF (CPF do responsável), document_id, mdfe30_CIOT, mdfe30_CNPJ (CNPJ do responsável), mdfe30_choice_responsible (CNPJ/CPF do responsável)
  • l10n_br_mdfe.product.lotacao.local · modelo nuevolocal_type, mdfe30_choice_tlocal (Tipo de Local)
  • l10n_br_mdfe.modal.rodoviario.lacre · modelo nuevodocument_id, mdfe30_nLacre
  • l10n_br_mdfe.modal.ferroviario.vagao · modelo nuevomdfe30_TU, document_id, mdfe30_nVag, mdfe30_pesoR, mdfe30_serie, mdfe30_pesoBC
  • l10n_br_fiscal.document.import.wizard · amplía un modelo existente
  • l10n_br_mdfe.modal.aquaviario.comboio · modelo nuevodocument_id, mdfe30_xBalsa, mdfe30_cEmbComb
  • l10n_br_mdfe.modal.rodoviario.reboque · modelo nuevodocument_id, mdfe30_cInt, mdfe30_prop, mdfe30_tara, mdfe30_capKG, mdfe30_placa, mdfe30_tpCar, mdfe30_RENAVAM
  • l10n_br_mdfe.modal.rodoviario.pagamento · modelo nuevomdfe30_CPF, partner_id (Responsável pelo pagamento), document_id, mdfe30_CNPJ, mdfe30_comp, mdfe30_xNome, payment_type (Meio de Pagamento), mdfe30_indPag, mdfe30_infPrazo, mdfe30_vContrato, mdfe30_choice_tpayment (Método de Pagamento), mdfe30_choice_tresponsible (CNPJ/CPF/Id Estrangeiro do responsável pelo pagamento)

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: 5 confirmadas, 4 sin información de 9 versiones.

Fuentes · Odoo 15.0

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

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Para configurar este módulo necesita establecer un certificado digital en la compañía, y también establecer el procesador edoc de la compañía.

Para utilizar el módulo l10n_br_mdfe junto con el módulo l10n_br_account, es necesario configurar una línea de operación fiscal que no añada valor al importe del documento, ya que el MDF-e (Manifiesto Electrónico de Documentos Fiscales) no posee valor financiero.

Paso a Paso:

  • Crear una Factura:
  • Defina el tipo de documento como 58 (MDFe).
  • Configurar el Socio de la Factura:
  • Configure el socio para que sea el mismo de la empresa emisora del MDF-e.
  • Añadir una Línea en la Pestaña Productos:
  • Añada una línea de factura con la operación fiscal previamente configurada.
  • No recomendamos que informe un producto o utilice un producto que no posea CFOP (Código Fiscal de Operaciones y Prestaciones), o que el CFOP esté configurado para no generar valor financiero y esté atento a datos como impuestos y afines.
  • Acceda a los detalles fiscales de la factura e informe los demás datos necesarios para la emisión del MDF-e:
  • Complete los campos obligatorios para la emisión del MDF-e, como UF de descarga, municipio de descarga, etc.
  • Valide el MDF-e, verifique los datos del XML y envíe a la SEFAZ:
  • Tras completar todos los datos necesarios, valide el MDF-e y envíe a la SEFAZ.

Consideraciones Adicionales

  • Operación Fiscal: Asegúrese de que la operación fiscal esté parametrizada correctamente para evitar la adición de valores financieros al documento.
  • CFOP: En el caso de utilización de un producto registrado y que cargue el CFOP a la línea de la factura, verifique la configuración del CFOP para garantizar que no genere impacto financiero en el importe de la factura.

Siguiendo estos pasos, el módulo l10n_br_mdfe funcionará correctamente junto con el l10n_br_account, permitiendo la emisión de MDF-e sin valores financieros asociados.

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.