Saltar al contenido principal
Versión: Tryton 8.0 (LTS)

sale_subscription

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 sale_subscription incorpora o amplía funciones relacionadas con sale subscription. 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 sale subscription module defines subscription, services and recurrence rule models.

El análisis encontró 11 archivos Python, 27 archivos XML, 20 vistas, 28 acciones, 7 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 sale subscription, 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 sale_subscription, 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​

  • account — debe estar instalado y configurado antes de probar este módulo.
  • account_invoice — debe estar instalado y configurado antes de probar este módulo.
  • company — debe estar instalado y configurado antes de probar este módulo.
  • currency — debe estar instalado y configurado antes de probar este módulo.
  • ir — debe estar instalado y configurado antes de probar este módulo.
  • product — debe estar instalado y configurado antes de probar este módulo.
  • res — debe estar instalado y configurado antes de probar este módulo.
  • sale — debe estar instalado y configurado antes de probar este módulo.

Integraciones opcionales​

  • —

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.line. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • ir.cron: agrupa 1 modelo(s), entre ellos ir.cron. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • party.erase: agrupa 1 modelo(s), entre ellos party.erase. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • party.replace: agrupa 1 modelo(s), entre ellos party.replace. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • product.product: agrupa 1 modelo(s), entre ellos product.product. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • sale.configuration: agrupa 2 modelo(s), entre ellos sale.configuration, sale.configuration.sequence. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • sale.subscription: agrupa 12 modelo(s), entre ellos sale.subscription, sale.subscription.create_invoice, sale.subscription.create_invoice.start, sale.subscription.line, sale.subscription.line.consumption. 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. Use los botones del formulario para cambiar de estado; guardar no equivale a validar o contabilizar.
  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​

  • cancel — acción o transición que inicia cancel. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
  • draft — acción o transición que inicia draft. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
  • quote — acción o transición que inicia quote. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
  • run — acción o transición que inicia run. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
  • cancelled — acción o transición que inicia cancelled. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
  • closed — acción o transición que inicia closed. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
  • quotation — acción o transición que inicia quotation. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
  • running — acción o transición que inicia running. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
  • sale.subscription.line.consumption.create — asistente que reúne datos y ejecuta sale › subscription › line › consumption › create. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
  • sale.subscription.line.consumption.create.start — asistente que reúne datos y ejecuta sale › subscription › line › consumption › create › start. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
  • sale.subscription.recurrence.rule.set.test — asistente que reúne datos y ejecuta sale › subscription › recurrence › rule › set › test. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.

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 23 clases Python y declara o extiende 19 modelos. Utiliza Boolean, Char, Date, Float, Function, Integer, Many2One, MultiValue, One2Many, Selection, Text, TimeDelta. 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.line
  • ir.cron
  • party.erase
  • party.replace
  • product.product
  • sale.configuration
  • sale.configuration.sequence
  • sale.subscription
  • sale.subscription.create_invoice
  • sale.subscription.create_invoice.start
  • sale.subscription.line
  • sale.subscription.line.consumption
  • sale.subscription.line.consumption.create
  • sale.subscription.line.consumption.create.start
  • sale.subscription.recurrence.rule
  • sale.subscription.recurrence.rule.set
  • sale.subscription.recurrence.rule.set.test
  • sale.subscription.recurrence.rule.set.test.result
  • sale.subscription.service

Tipos de campos utilizados​

  • Boolean
  • Char
  • Date
  • Float
  • Function
  • Integer
  • Many2One
  • MultiValue
  • One2Many
  • Selection
  • Text
  • TimeDelta

Clases y métodos públicos detectados​

Clases: Configuration, ConfigurationSequence, CreateLineConsumption, CreateLineConsumptionStart, CreateSubscriptionInvoice, CreateSubscriptionInvoiceStart, Cron, Erase, InvalidRecurrence, InvoiceError, InvoiceLine, Line, LineConsumption, Product, RecurrenceRule, RecurrenceRuleSet, RecurrenceRuleValidationError, Replace, Service, Subscription, TestRecurrenceRuleSet, TestRecurrenceRuleSetView, TestRecurrenceRuleSetViewResult

Métodos: cancel(), chat_language(), check_by(), check_erase_company(), check_modification(), close(), compute_next_consumption_date(), compute_next_invoice_date(), copy(), default_company(), default_currency(), default_date(), default_exclusive(), default_interval(), default_quantity(), default_rules(), default_start_date(), default_state(), default_subscription_sequence(), default_test(), do_create_(), domain_next_consumption_date_delayed(), draft(), fields_to_replace(), generate_consumption(), generate_invoice(), get_consumption(), get_invoice_lines(), get_next_consumption_date_delayed(), get_rec_name(), get_subscription_states(), multivalue_model(), on_change_invoice_party(), on_change_party(), on_change_service(), on_change_subscription(), on_change_with_company(), on_change_with_currency(), on_change_with_result(), on_change_with_service_unit_category(), on_change_with_subscription_end_date(), on_change_with_subscription_start_date(), on_change_with_subscription_state(), on_change_with_summary(), on_change_with_unit(), order_number(), origin_name(), pre_validate(), process(), quote(), rrule(), rruleset(), run(), search_rec_name(), set_number(), transition_create_(), validate_consumption_recurrence(), validate_fields(), validate_invoice_recurrence(), view_attributes()

Mapa del código​

Se detectaron 11 archivos Python, 27 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
  • configuration.py
  • configuration.xml
  • doc/conf.py
  • exceptions.py
  • invoice.py
  • ir.py
  • message.xml
  • party.py
  • party.xml
  • product.py
  • product.xml
  • recurrence.py
  • recurrence.xml
  • service.py
  • service.xml
  • subscription.py
  • subscription.xml
  • view/configuration_form.xml
  • view/create_invoice_start_form.xml
  • view/line_consumption_create_start_form.xml
  • view/party_form.xml
  • view/product_form.xml
  • view/recurrence_rule_form.xml
  • view/recurrence_rule_list.xml
  • view/recurrence_rule_set_form.xml
  • view/recurrence_rule_set_list.xml
  • view/recurrence_rule_set_test_form.xml
  • view/recurrence_rule_set_test_result_list.xml
  • view/service_form.xml
  • view/service_list.xml
  • view/subscription_form.xml
  • view/subscription_line_consumption_form.xml
  • view/subscription_line_consumption_list.xml
  • view/subscription_line_form.xml
  • view/subscription_line_list.xml
  • view/subscription_line_list_sequence.xml
  • view/subscription_list.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: Sale Subscription Module · Subscription · Service · Recurrence Rule

    • doc/index.rst: The sale subscription module defines subscription, services and recurrence rule models.

Ver código fuente