account_payment_braintree

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 account_payment_braintree incorpora o amplía funciones relacionadas con account payment braintree. 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 Account Payment Braintree Module allows receiving payments using Braintree. It uses the Drop-in UI in a checkout form to handle the payment method nonce_ for card and other supported payment methods.

El análisis encontró 8 archivos Python, 14 archivos XML, 11 vistas, 19 acciones, 3 menús y 1 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 account payment braintree, 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 account_payment_braintree, ejecutar sus acciones con el estado correcto, producir sus informes 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_payment — 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.
• party — 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.payment: agrupa 10 modelo(s), entre ellos account.payment, account.payment.braintree.account, account.payment.braintree.checkout, account.payment.braintree.customer, account.payment.braintree.customer.identical. 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.party: agrupa 2 modelo(s), entre ellos party.party, party.party.reception_direct_debit. 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.

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. Genere el informe y compare su contenido con el registro antes de entregarlo.

Acciones, estados y asistentes

• approve — acción o transición que inicia approve. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• braintree_checkout — acción o transición que inicia braintree checkout. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• braintree_do_pull — acción o transición que inicia braintree do pull. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• braintree_do_settle_payment — acción o transición que inicia braintree do settle payment. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• braintree_update — acción o transición que inicia braintree update. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• delete_payment_method — acción o transición que inicia delete payment method. 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.
• new_identifier — acción o transición que inicia new identifier. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• submit — acción o transición que inicia submit. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• approved — acción o transición que inicia approved. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• failed — acción o transición que inicia failed. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• processing — acción o transición que inicia processing. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• submitted — acción o transición que inicia submitted. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• succeeded — acción o transición que inicia succeeded. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.
• account.payment.braintree.customer.payment_method.delete — asistente que reúne datos y ejecuta account › payment › braintree › customer › payment method › delete. 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 17 clases Python y declara o extiende 14 modelos. Utiliza Boolean, Char, Function, Many2Many, Many2One, One2Many, Selection, Text. 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.payment
• account.payment.braintree.account
• account.payment.braintree.checkout
• account.payment.braintree.customer
• account.payment.braintree.customer.identical
• account.payment.braintree.customer.payment_method.delete
• account.payment.braintree.customer.payment_method.delete.ask
• account.payment.braintree.refund
• account.payment.group
• account.payment.journal
• ir.cron
• party.party
• party.party.reception_direct_debit
• party.replace

Tipos de campos utilizados

• Boolean
• Char
• Function
• Many2Many
• Many2One
• One2Many
• Selection
• Text

Clases y métodos públicos detectados

Clases: BraintreeAccountWarning, BraintreeCustomerMethodMixin, CheckoutMixin, Cron, Party, PartyReceptionDirectDebit, Payment, PaymentBraintreeAccount, PaymentBraintreeCheckoutPage, PaymentBraintreeCustomer, PaymentBraintreeCustomerIdentical, PaymentBraintreeCustomerPaymentMethodDelete, PaymentBraintreeCustomerPaymentMethodDeleteAsk, PaymentBraintreeRefund, PaymentGroup, PaymentJournal, Replace

Métodos: approve(), braintree_checkout(), braintree_checkout_url(), braintree_create(), braintree_delete(), braintree_do_pull(), braintree_do_settle_payment(), braintree_pull(), braintree_refund(), braintree_set_nonce(), braintree_settle_payment_(), braintree_transact(), braintree_update(), check_braintree_journal(), check_modification(), configuration(), copy(), default_ask(), default_braintree_payment_settled(), default_braintree_settle_payment(), default_environment(), default_sandbox_settle_transaction(), default_state(), delete(), delete_payment_method(), delete_payment_method_(), draft(), fail(), fields_to_replace(), find(), gateway(), get_braintree_customer_method(), get_braintree_customer_methods(), get_braintree_settlement_needed(), get_payment_methods(), get_rec_name(), new_identifier(), on_change_braintree_customer_method_selection(), on_change_party(), on_change_with_braintree_account(), on_change_with_company(), on_change_with_currency(), on_change_with_webhook_endpoint(), on_write(), payment_methods(), process(), process_braintree(), set_braintree_customer_method(), submit(), succeed(), table_query(), transition_delete_(), validate_fields(), view_attributes(), webhook(), webhook_dispute(), webhook_transaction()

Mapa del código

Se detectaron 8 archivos Python, 14 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
• common.py
• doc/conf.py
• exceptions.py
• ir.py
• message.xml
• party.py
• party.xml
• routes.py
• view/account_form.xml
• view/account_list.xml
• view/customer_form.xml
• view/customer_list.xml
• view/customer_payment_method_delete_ask_form.xml
• view/party_reception_direct_debit_form.xml
• view/payment_form.xml
• view/payment_journal_form.xml
• view/payment_list.xml
• view/refund_form.xml
• view/refund_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: Configuration · payment_methods_cache · Design · Payment · Braintree Payment Refund · Payment Journal · Braintree Account · Braintree Customer · Braintree Checkout · Account Payment Braintree Module · API Reference · Braintree Webhook · Setup · Configure Braintree credentials

• • doc/configuration.rst: The Account Payment Braintree Module uses values from settings in the [account_payment_braintree] section of the
• • doc/design.rst: The Account Payment Braintree Module introduces and extends the following concepts:
• • doc/index.rst: The Account Payment Braintree Module allows receiving payments using Braintree. It uses the Drop-in UI in a checkout form to handle the payment method nonce_ for card and other supported payment methods.
• • doc/reference.rst: The Account Payment Braintree Module defines a route to checkout a Payment <model-account.payment> or a Braintree Customer <model-account.payment.braintree.customer>:
• • doc/setup.rst: First you must register with Braintree <https://www.braintreegateway.com/login>_ and get the API credentials <https://developer.paypal.com/braintree/articles/control-panel/important-gateway-credentials>_.

Ver código fuente