edocument_ubl

Tryton 8.0 · Referencia generada desde el código oficial

Esta página combina orientación editorial con evidencia extraída de la rama oficial indicada. Pruebe siempre el flujo con sus permisos y configuración.

Propósito

El módulo edocument_ubl incorpora o amplía funciones relacionadas con edocument ubl. Su alcance real se determina por los modelos, acciones y dependencias documentados a continuación; no debe activarse únicamente por su nombre.

Descripción oficial de la rama (idioma original)

The EDocument UBL Module adds electronic documents from UBL <https://docs.oasis-open.org/ubl/os-UBL-2.4/UBL-2.4.html>_.

El análisis encontró 7 archivos Python, 5 archivos XML, 0 vistas, 1 acciones, 0 menús y 0 informes.

Guía funcional para el usuario

A quién le sirve

Este módulo interesa a las personas responsables de los procesos relacionados con edocument ubl, a quienes configuran la compañía y a quienes revisan sus resultados. Los administradores deben participar cuando se activen dependencias, permisos o secuencias.

Qué podrá hacer

Al finalizar la configuración podrá reconocer los registros que aporta edocument_ubl, ejecutar sus acciones con el estado correcto y comprender qué información termina compartiendo con otros módulos.

Requisitos y preparación

Antes de activarlo confirme la compañía, moneda, usuarios y grupos aplicables. Instale y configure primero sus dependencias obligatorias. Si existen datos reales, ensaye la activación y actualización sobre una copia restaurada.

Active primero las dependencias, revise la configuración de la compañía y ensaye el flujo completo antes de usarlo en producción.

Dependencias obligatorias

• edocument_unece — debe estar instalado y configurado antes de probar este módulo.
• ir — debe estar instalado y configurado antes de probar este módulo.
• party — debe estar instalado y configurado antes de probar este módulo.

Integraciones opcionales

• account_cash_rounding — habilita una integración adicional; pruebe la combinación explícitamente.
• account_invoice — habilita una integración adicional; pruebe la combinación explícitamente.
• account_payment — habilita una integración adicional; pruebe la combinación explícitamente.
• bank — habilita una integración adicional; pruebe la combinación explícitamente.
• document_incoming_invoice — habilita una integración adicional; pruebe la combinación explícitamente.
• purchase — habilita una integración adicional; pruebe la combinación explícitamente.
• sale — habilita una integración adicional; pruebe la combinación explícitamente.

Configuración inicial recomendada

• Active el módulo y vuelva a iniciar la sesión para cargar menús y permisos.
• Revise las nuevas opciones de configuración de compañía y los valores por defecto.
• Asigne grupos a usuarios de prueba aplicando mínimo privilegio.
• Cree datos maestros pequeños y verificables antes de importar información masiva.
• Ejecute un caso completo desde borrador hasta su estado final y revise los registros relacionados.

Objetos y conceptos del módulo

• account.invoice: agrupa 1 modelo(s), entre ellos account.invoice.edocument.start. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
• document.incoming: agrupa 1 modelo(s), entre ellos document.incoming. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
• edocument.ubl: agrupa 1 modelo(s), entre ellos edocument.ubl.invoice. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
• party.identifier: agrupa 1 modelo(s), entre ellos party.identifier. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
• party.party: agrupa 1 modelo(s), entre ellos party.party. Estos registros forman la información que el usuario consulta o modifica durante el proceso.

Flujo de trabajo habitual

1. Seleccione la compañía y fecha correctas antes de crear el documento.
2. Complete primero los datos maestros y luego las líneas o detalles.
3. Guarde y revise el registro antes de utilizarlo desde otro proceso.
4. Revise advertencias, totales, documentos relacionados y trazabilidad.
5. Compruebe el efecto en los módulos dependientes antes de cerrar el proceso.

Acciones, estados y asistentes

• No se detectaron botones o asistentes propios; el módulo actúa mediante campos, reglas o extensiones de procesos existentes.

Controles antes de producción

• Defina quién crea, revisa, confirma, cancela y consulta.
• Pruebe períodos cerrados, usuarios sin permisos y datos incompletos.
• Verifique numeración, moneda, redondeo y zona horaria cuando correspondan.
• Documente cómo corregir un error sin editar directamente la base de datos.
• Incluya sus tablas y archivos en el procedimiento de copia y restauración.

Diagnóstico y resolución de problemas

• Si no aparece el menú, compruebe activación, actualización de la lista de módulos, grupos y nueva sesión.
• Si un campo no acepta un valor, revise su dominio, compañía, estado y dependencias configuradas.
• Si un botón está oculto o deshabilitado, revise permisos y transición válida; no modifique el estado con SQL.
• Si los resultados no coinciden, reproduzca un caso mínimo y compare registros relacionados antes y después.
• Conserve el traceback completo, versión, módulos activos y datos mínimos para diagnosticar un error.

Guía para desarrolladores

Arquitectura y puntos de extensión

El paquete contiene 9 clases Python y declara o extiende 5 modelos. Utiliza los campos heredados de sus dependencias. Los desarrolladores deben localizar primero si una clase crea un modelo nuevo o usa PoolMeta para extender uno existente, conservar las llamadas a super() y no duplicar reglas disponibles en las dependencias.

Modelos registrados o extendidos

• account.invoice.edocument.start
• document.incoming
• edocument.ubl.invoice
• party.identifier
• party.party

Tipos de campos utilizados

• —

Clases y métodos públicos detectados

Clases: Identifier, Incoming, Invoice, InvoiceEdocumentStart, InvoiceError, Invoice_Bank, Invoice_Payment, Invoice_Purchase, Party

Métodos: accounting_customer_address(), accounting_customer_party(), accounting_customer_tax_identifier(), accounting_supplier_address(), accounting_supplier_party(), accounting_supplier_tax_identifier(), additional_documents(), allowance_charge(), allowance_charge_code(), allowed_additional_documents(), eas(), eas_code(), filename(), get_templates(), identifier_eas(), identifier_iso6523(), iso_6523(), lines(), parse(), parser(), prepaid_amount(), render(), sale_number(), sale_reference(), taxes(), type_code(), vatin(), visit_NameConstant()

Mapa del código

Se detectaron 7 archivos Python, 5 XML y 0 archivos explícitos de acceso. Los XML conectan modelos con vistas, menús, acciones e informes; los CSV de acceso establecen permisos iniciales.

• __init__.py
• account.py
• account.xml
• doc/conf.py
• document.py
• edocument.py
• exceptions.py
• message.xml
• party.py
• template/2/CreditNote.xml
• template/2/Invoice.xml
• template/2/base.xml

Plan de pruebas

• Activación en una base vacía y actualización desde la revisión anterior.
• Creación, modificación, copia y eliminación según estado y permisos.
• Cada botón, transición y asistente con casos válidos e inválidos.
• Reglas multicompañía, traducciones, zonas horarias y monedas aplicables.
• Instalación conjunta con dependencias obligatorias e integraciones opcionales.
• Copia y restauración de registros, adjuntos e informes producidos.

Compatibilidad y actualización

Mantenga servidor y módulos en la serie 8.0. Antes de actualizar compare tryton.cfg, migraciones de __register__, cambios de estados, XML IDs y permisos. Una compilación exitosa no reemplaza una migración ensayada ni la conciliación funcional de datos.

Evidencia documental oficial

Temas encontrados: Design · UBL Invoice · EDocument UBL Module

• • doc/design.rst: The EDocument UBL Module introduces the following concepts:
• • doc/index.rst: The EDocument UBL Module adds electronic documents from UBL <https://docs.oasis-open.org/ubl/os-UBL-2.4/UBL-2.4.html>_.

Ver código fuente