OdooWiki OCA HUB

Paraguay - Accounting Extensions

l10n_py_account folder_open OCA/l10n-paraguay open_in_new
Accounting/Localizations Licencia: LGPL-3

Paraguay - Extensiones de contabilidad

Este módulo amplía la localización contable paraguaya base con funcionalidad específica requerida para el cumplimiento fiscal paraguayo.

Características

  • Extensiones de diario: Configuración de diario mejorada con campos específicos de Paraguay
  • Establecimiento (punto de expedición)
  • Punto de venta (punto de emisión)
  • Timbrado (autorización de timbrado fiscal)
  • Gestión de autorizaciones: Gestión completa del ciclo de vida del timbrado
  • Seguimiento del número de autorización
  • Control del período de validez
  • Gestión del rango de numeración de documentos
  • Generación automática de secuencias
  • Extensiones de asiento contable: Características mejoradas de facturas/facturas de proveedor
  • Asignación automática de timbrado
  • Formato del número de documento
  • Validaciones fiscales
  • Validaciones fiscales:
  • Verificación de timbrado válido
  • Validación del rango de numeración de documentos
  • Comprobación de la fecha de vencimiento

Propósito

Este módulo cubre la brecha entre la contabilidad estándar de Odoo y los requisitos fiscales paraguayos, centrándose particularmente en la gestión del timbrado, que es obligatoria para todos los documentos fiscales en Paraguay.

Dependencias

  • account: Contabilidad central de Odoo
  • l10n_py_base: Localización paraguaya base

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 20.0

Gestiona autorizaciones de timbrado de impuestos paraguayos (timbrados) y numera automáticamente facturas de venta y notas de crédito según el rango autorizado, con validaciones fiscales y campos de desglose de IVA de SIFEN.

Este módulo añade una nueva pantalla para las autorizaciones de timbrado paraguayas (timbrados) en Contabilidad > Configuración > Paraguay > Timbrados. Cada timbrado registra el número de autorización, las fechas de validez, el establecimiento, el punto de expedición, la serie, el tipo de documento y el rango de números de factura autorizados. Odoo muestra automáticamente si está vigente, próximo a vencer o vencido, el siguiente número a utilizar, cuántos números se han utilizado y el porcentaje de uso.

En los diarios de ventas puede establecer el establecimiento, el punto de expedición y el timbrado; Odoo comprueba que los códigos tengan 3 dígitos y que el timbrado coincida con el establecimiento y el punto del diario.

En las facturas de cliente y las notas de crédito selecciona el timbrado. Al confirmar la factura, Odoo asigna el siguiente número libre del rango autorizado y bloquea la confirmación si no se ha seleccionado ningún timbrado, si el timbrado está vencido o inactivo, si el número está fuera del rango o si el rango está agotado. El número completo se muestra como 001-001-0000001.

Una nueva pestaña 'Información Fiscal Paraguay' muestra el desglose de IVA del SIFEN (totales gravados exentos, al 5% y al 10%, bases e importes de IVA, total de la operación), el tipo de cambio, el total en guaraníes y el total en letras. Los impuestos también incorporan un campo de afectación al IVA (gravado, exento, exonerado, parcialmente gravado).

Depende de

accountl10n_pyl10n_py_basel10n_latam_invoice_document

Lo necesitan otros módulos

l10n_py_edi_basel10n_py_libros

Menús que añade

ParaguayTimbrados
Modelos y campos (5)
  • account.tax · amplía un modelo existentel10n_py_iva_affectation (Afectación IVA (SIFEN))
  • account.move · amplía un modelo existentel10n_py_base_5 (Base Gravada 5% (F018)), l10n_py_base_10 (Base Gravada 10% (F019)), l10n_py_base_total (Total Base Gravada (F020)), l10n_py_amount_iva_5 (Liquidación IVA 5% (F015)), l10n_py_amount_exempt (Total Exento (F003)), l10n_py_amount_iva_10 (Liquidación IVA 10% (F016)), l10n_py_exchange_rate (Tipo de Cambio), l10n_py_invoice_number (Número de Factura), l10n_py_total_operation (Total Operación (F008)), l10n_py_amount_exonerado (Total Exonerado), l10n_py_amount_iva_total (Total IVA (F014)), l10n_py_amount_total_pyg (Total en Guaraníes (F023)), l10n_py_authorization_id (Timbrado), l10n_py_amount_subtotal_5 (Total Gravado 5% (F004)), l10n_py_amount_subtotal_10 (Total Gravado 10% (F005)), l10n_py_amount_total_words (Total en Letras), l10n_py_full_invoice_number (Número Completo)
  • account.journal · amplía un modelo existentel10n_py_point (Punto de Expedición), l10n_py_establishment (Establecimiento), l10n_py_authorization_id (Timbrado), l10n_py_authorization_validity (Vencimiento del Timbrado)
  • account.authorization · modelo nuevoname (Número de Timbrado), state (Estado), active (Activo), series (Serie), date_to (Fecha de Vencimiento), date_from (Fecha de Inicio), company_id (Compañía), next_number (Próximo Número), used_numbers (Números Utilizados), establishment (Establecimiento), expedition_point (Punto de Expedición), usage_percentage (Porcentaje de Uso), invoice_number_to (Número Hasta), remaining_numbers (Números Disponibles), invoice_number_from (Número Desde), l10n_latam_document_type_id (Tipo de Documento)
  • account.fiscal.position · amplía un modelo existente

Texto generado por IA (DeepSeek) al leer el código de la versión 20.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: 4 confirmadas, 5 sin información de 9 versiones.

Fuentes · Odoo 19.0

Confirmado el 2026-11-03 en la rama 19.0 de OCA/l10n-paraguay.

terminal Instalación y uso

Documentación de OCA · Odoo 20.0

Instalación

Fuente · Odoo 20.0

Instalación

Requisitos previos

  • Odoo 16.0
  • Módulo account (núcleo de Odoo)
  • Módulo l10n_py_base instalado
  • Timbrado válido de SET (para uso en producción)

Pasos de instalación

  • Instalar módulo base: Asegúrese de que l10n_py_base esté instalado primero
  • Instalar módulo:
  • Vaya a Aplicaciones
  • Haga clic en Actualizar lista de aplicaciones
  • Busque "Paraguay - Accounting Extensions"
  • Haga clic en Instalar
  • Verificar instalación: Compruebe que aparezcan los nuevos menús:
  • Contabilidad > Configuración > Timbrados
  • Opciones mejoradas de configuración de diarios

Configuración posterior a la instalación

Paso 1: Configurar compañía

Asegúrese de que los datos fiscales de la compañía estén completos en l10n_py_base

Paso 2: Crear el primer timbrado

  • Vaya a Contabilidad > Configuración > Timbrados
  • Haga clic en Crear
  • Introduzca la autorización proporcionada por SET:
  • Número de autorización
  • Fechas de validez
  • Rango de numeración de documentos
  • Códigos de establecimiento y punto de venta

Paso 3: Configurar diario de ventas

  • Vaya a Contabilidad > Configuración > Diarios
  • Edite su diario de ventas
  • Configure:
  • Código de establecimiento
  • Código de punto de venta
  • Enlace al timbrado
  • Guarde

Paso 4: Probar la creación de facturas

  • Cree una factura de prueba
  • Verifique el formato del número de documento: XXX-XXX-NNNNNNN
  • Compruebe que la información del timbrado aparezca correctamente
  • Cancele la factura de prueba si está en producción

Datos de demostración

El módulo incluye datos de demostración:

  • Timbrados de ejemplo
  • Diarios configurados

Nota: Elimine los datos de demostración antes de usarlos en producción:

  • Vaya a Ajustes > Técnico > Estructura de la base de datos > Datos de demostración
  • Elimine los timbrados y las configuraciones de diarios de demostración

Lista de verificación de la configuración

Antes de salir a producción:

  • [ ] Datos fiscales de la compañía completos
  • [ ] Timbrado válido de SET
  • [ ] Registro de timbrado creado en el sistema
  • [ ] Diarios de ventas configurados
  • [ ] Diarios de compras configurados (si es necesario)
  • [ ] Secuencias de numeración de documentos probadas
  • [ ] Permisos de usuario configurados

Información requerida de SET

Antes de poder usar este módulo en producción, obtenga de SET:

  • Número de timbrado: Número de autorización
  • Período de validez: Fechas de inicio y fin
  • Rango de documentos: Números desde/hasta autorizados
  • Código de establecimiento: Su código de establecimiento
  • Código de punto de venta: Su código de punto de emisión

Dependencias

Este módulo requiere:

  • account: Funcionalidad contable principal
  • l10n_py_base: Localización base paraguaya

Módulos opcionales

Para una funcionalidad completa, considere:

  • l10n_py: Plan de cuentas paraguayo
  • l10n_py_edi_base: Facturación electrónica

Solución de problemas de instalación

Los elementos del menú no aparecen

Si los menús de configuración no se muestran:

  • Actualice el navegador
  • Compruebe los permisos de usuario (Contabilidad / Manager)
  • Verifique que el módulo esté completamente instalado

Los campos de timbrado no aparecen en el diario

Si los campos de timbrado no aparecen en los diarios:

  • Actualice el módulo
  • Reinicie el servidor de Odoo
  • Borre la caché del navegador

Configuración

Fuente · Odoo 20.0

Configuración

Configuración de diarios

Configure los diarios para documentos fiscales paraguayos:

  • Vaya a Accounting > Configuration > Journals
  • Seleccione o cree un diario de ventas/compras
  • Configure los campos paraguayos:
  • Establishment (Punto de Expedición): p. ej., "001"
  • Point of Sale (Punto de Emisión): p. ej., "001"
  • Vincule al Timbrado activo

Gestión de Timbrado (Autorización)

Creación de un nuevo Timbrado

  • Vaya a Accounting > Configuration > Timbrados
  • Haga clic en Create
  • Complete la información requerida:
  • Authorization Number (Timbrado): p. ej., "12345678"
  • Start Date: fecha de inicio de la autorización
  • End Date: fecha de vencimiento de la autorización
  • Document Range: números From y To
  • Establishment: p. ej., "001"
  • Point of Sale: p. ej., "001"
  • Haga clic en Save

Campos del Timbrado explicados

  • Authorization Number: el número de timbrado emitido por la SET
  • Start/End Date: período de validez de la autorización
  • From Number: número de documento inicial (p. ej., 1)
  • To Number: número de documento final (p. ej., 50000)
  • Establishment: código de ubicación física (001, 002, etc.)
  • Point of Sale: código de punto de emisión (001, 002, etc.)

Activación de un Timbrado

  • Los Timbrados están activos automáticamente si:
  • La fecha actual está entre las fechas de inicio y fin
  • Los números de documento no se han agotado
  • El sistema muestra el estado activo con indicadores

Vinculación del Timbrado al diario

  • Vaya a Accounting > Configuration > Journals
  • Edite el diario
  • Seleccione el timbrado activo en el desplegable
  • El sistema utilizará este timbrado para todos los documentos de este diario

Secuencias de numeración de documentos

El módulo gestiona las secuencias automáticamente:

  • Las secuencias se crean según la configuración del timbrado
  • Formato: XXX-XXX-NNNNNNN (Establishment-Point of Sale-Number)
  • Los números se incrementan automáticamente
  • El sistema avisa cuando se acerca al límite

Validaciones automáticas

El sistema valida:

  • Que el Timbrado esté activo y no vencido
  • Que los números de documento estén dentro del rango autorizado
  • Que el establishment y el point of sale coincidan
  • Que la fecha esté dentro del período de autorización

Múltiples Timbrados

Puede tener múltiples timbrados:

  • Diferentes establishments
  • Diferentes points of sale
  • Períodos superpuestos (para la transición)

Mejor práctica:

  • Cree un nuevo timbrado antes de que venza el actual
  • Active el nuevo timbrado cuando esté listo
  • El timbrado antiguo se vuelve inactivo automáticamente

Uso

Fuente · Odoo 20.0

Uso

Creación de facturas con timbrado

Flujo estándar de facturación

  • Vaya a Contabilidad > Clientes > Facturas
  • Haga clic en Crear
  • Seleccione el cliente y añada líneas de factura
  • El sistema automáticamente:
  • Asigna el timbrado activo del diario
  • Genera el siguiente número de documento
  • Valida el estado del timbrado
  • Haga clic en Confirmar

Formato del número de factura

Las facturas tendrán el formato:

XXX-XXX-NNNNNNN
  • XXX: Establecimiento (p. ej., 001)
  • XXX: Punto de venta (p. ej., 001)
  • NNNNNNN: Número secuencial (p. ej., 0000001)

Ejemplo: 001-001-0000123

Gestión de timbrados

Comprobación del estado del timbrado

  • Vaya a Contabilidad > Configuración > Timbrados
  • Vea la lista de todos los timbrados
  • Los indicadores de estado muestran:
  • Activo: Verde (actualmente válido y dentro del rango)
  • Caducado: Rojo (fecha de fin superada)
  • Agotado: Naranja (todos los números utilizados)

Cuando un timbrado está por caducar

El sistema le avisará cuando:

  • Se acerque la fecha de fin (umbral configurable)
  • Queden pocos números de documento (p. ej., <100 restantes)

Acción requerida:

  • Solicite un nuevo timbrado a la SET
  • Cree un nuevo registro de timbrado en el sistema
  • Actualice el diario para usar el nuevo timbrado cuando esté listo

Cambio entre timbrados

Para cambiar el timbrado en un diario:

  • Vaya a Contabilidad > Configuración > Diarios
  • Edite el diario
  • Cambie el campo Timbrado
  • Guarde
  • Los nuevos documentos usarán el nuevo timbrado

Facturas de proveedor

Para las facturas de proveedor:

  • Cree la factura como de costumbre
  • Introduzca la información del timbrado del proveedor si es necesario
  • El sistema valida el formato y la estructura

Informes y seguimiento

Informe de uso del timbrado

Supervise el uso del timbrado:

  • Vaya a Contabilidad > Informes > Informe de timbrado
  • Vea:
  • Números utilizados
  • Números restantes
  • Estado de caducidad
  • Recuento de documentos

Cierre del periodo fiscal

Al cerrar periodos fiscales:

  • Verifique que todos los timbrados del periodo sean válidos
  • Compruebe que las secuencias de números de documento estén completas
  • Genere los informes fiscales requeridos

Escenarios comunes

Escenario 1: Inicio de un nuevo establecimiento

  • Cree un nuevo timbrado con el nuevo código de establecimiento
  • Cree o actualice el diario con el nuevo establecimiento
  • Vincule el timbrado al diario
  • Comience a emitir documentos

Escenario 2: Renovación de un timbrado caducado

  • Obtenga una nueva autorización de la SET
  • Cree un nuevo registro de timbrado
  • Establezca la fecha de inicio (puede solaparse con la anterior)
  • Cambie el diario al nuevo timbrado
  • El timbrado antiguo permanece como referencia histórica

Escenario 3: Múltiples puntos de venta

  • Cree un timbrado para cada punto de venta
  • Cree un diario independiente para cada uno
  • Cada diario usa su propio timbrado
  • Los usuarios seleccionan el diario adecuado al crear documentos

Solución de problemas

Error: "Timbrado caducado"

Solución:

  • Cree un nuevo timbrado
  • Actualice la configuración del diario
  • Intente crear el documento de nuevo

Error: "Número de documento fuera de rango"

Solución:

  • Solicite a la SET un nuevo timbrado con un rango superior
  • Cree un nuevo registro de timbrado
  • Cambie el diario al nuevo timbrado

Advertencia: "Timbrado próximo a caducar"

Acción:

  • Solicite la renovación a la SET
  • Cree un nuevo timbrado en el sistema
  • Planifique la fecha de transición
  • Actualice el diario cuando esté listo

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

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.