OdooWiki OCA HUB

SPED Base

l10n_br_sped_base folder_open OCA/l10n-brazil open_in_new
Sin categoría Licencia: AGPL-3

Este módulo contiene algunas abstracciones utilizadas por los módulos de SPED

No hace nada por sí solo, pero sirve dentro de los 4 módulos:

  • l10n_br_sped_ecd
  • l10n_br_sped_efd_icms_ipi
  • l10n_br_sped_efd_pis_cofins
  • l10n_br_sped_ecf

En especial, cada registro de los módulos de SPED hereda del objeto abstracto l10n_br_sped.mixin que cuenta con vistas automáticas y métodos para importar o escribir registros de los SPED de forma recursiva.

Para cada tipo de archivo SPED, el registro de apertura 0000 hereda también del objeto abstracto l10n_br_sped.declaration que cuenta con métodos para poblar los registros del SPED a partir de las transacciones de Odoo entre las fechas DT_INI y DT_FIN y permite así gestionar los archivos del SPED.

Para gestionar el SPED, basta con crear una declaración del SPED en el menú apropiado. Luego hacer clic en Puxar os Dados do Odoo. Esto va a recorrer el árbol de los registros del SPED y para cada registro va a usar _odoo_domain o _odoo_query para ver si tiene records Odoo para mapear. En caso de que tenga va a llamar al método _map_from_odoo del registro. Luego va a repetir la operación con los registros hijos. En la declaración es posible elegir si usted quiere un único archivo SPED o si usted quiere quebrar el archivo bloque por bloque.

En cada módulo de SPED, existen 2 archivos principales:

  • un archivo con el número del leiaute que contiene los modelos abstractos de todos los registros del SPED con todos los campos. Este archivo es gestionado gestionado por la herramienta spedextractor a partir de los pdf de las especificaciones y no debe ser editado manualmente.
  • un segundo archivo que contiene la lista de todos registros concretos que heredan de esos primeros modelos abstractos y contiene así todos los campos. Como el mixin de cada registro contiene la versión del leiaute dentro de su nombre, tenemos una forma de soportar varias versiones de los leiautes. Ese archivo de los registros concretos sí debe ser editado manualmente para completar los mappings. Para mapear un registro, se debe implementar el override de esos 3 métodos:
  • def _odoo_domain(self, parent_record, declaration): debe retornar un domain que permite la selección de los records Odoo a ser mapeados de acuerdo con el record parente y los datos de la declaración (donde tiene las fechas y la empresa por ejemplo). Para usar ese método _odoo_domain, se debe definir también el atributo _odoo_model
  • def _odoo_query(self, parent_record, declaration): en caso de que la selección de los records a ser mapeados no pueda ser obtenida por un domain, puede ser implementado ese override para retornar la query SQL para seleccionar un result set a mapear. En este caso, el record del método _map_from_odoo es un result set de la query Postgres. Si usted no implementa ni _odoo_domain ni _odoo_query e implementa el método _map_from_odoo, el registro va a tener una instancia gestionada para cada declaración. Es el caso del registro I010 de la ECD por ejemplo.
  • _map_from_odoo(self, record, parent_record, declaration, index=0) para facilitar, los overrides de los métodos _map_from_odoo de todos los registros, ese ya viene gestionado de forma comentada con todos los campos del registro. Así basta con descomentar el método e implementar cómo es mapeado cada campo a partir del record, parent_record y de los datos de la declaración.

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

Añade un menú SPED y un marco compartido para los archivos fiscales/contables SPED brasileños, permitiendo a los usuarios crear una declaración SPED, extraer los datos fiscales relacionados de Odoo y generar el archivo de texto SPED como un adjunto.

Este módulo es una base técnica: no produce por sí mismo un archivo SPED, pero proporciona las pantallas y los botones que utilizan los módulos específicos de SPED (ECD, ECF, EFD ICMS/IPI, EFD PIS/COFINS).

Añade un nuevo menú SPED para usuarios fiscales y gerentes. En él, los usuarios crean una declaración SPED con una compañía, una fecha de inicio y una fecha de fin (por defecto, el año pasado y el próximo año). La declaración recopila automáticamente los documentos fiscales de esa compañía y periodo (autorizados, cancelados, denegados o no utilizados), junto con sus contactos, líneas, productos, operaciones fiscales, comentarios y unidades de medida.

En la pantalla de la declaración, los botones permiten a los usuarios: - Pull Registers from Odoo: rellena los registros SPED a partir de los datos de Odoo y publica un resumen en el chatter. - Flush Registers: elimina los registros de la declaración. - Set to Done / Reset to Draft: bloquea o desbloquea la declaración. - Generate SPED File: crea el archivo de texto como adjunto, opcionalmente dividido por bloque.

Una opción de depuración recopila documentos en borrador y una muestra más amplia para ayudar a los desarrolladores. El módulo también añade campos de contador (Is accountant?, CRC Code, CRC State) al formulario de contacto. Todos los registros llevan una compañía, una moneda contable (BRL), una marca de importado y un enlace de vuelta al registro de Odoo del que provienen.

Depende de

Menús que añade

SPED
Modelos y campos (3)
  • res.partner · amplía un modelo existentecrc_code (CRC Code), crc_state_id (CRC State), is_accountant (Is accountant?)
  • l10n_br_sped.mixin · modelo nuevores_id (Record ID), reference (Odoo Reference), res_model (Odoo Model), company_id, is_imported, brl_currency_id (Bookkeeping Currency), is_generated_from_odoo
  • l10n_br_sped.declaration · modelo nuevodebug, state, DT_FIN (End Date), DT_INI (Start Date), company_id (Company), fiscal_uom_ids, fiscal_comment_ids, fiscal_product_ids, fiscal_document_ids, split_sped_by_bloco, fiscal_operation_ids, fiscal_document_line_ids, fiscal_document_partner_ids

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

Fuentes · Odoo 18.0

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

terminal Instalación y uso

Sin información verificada

Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versió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.