Versión: Tryton 8.0 (LTS)

`web_shop_shopify`

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 web_shop_shopify incorpora o amplía funciones relacionadas con web shop shopify. 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 Web Shop Shopify Module provides a way to manage Shopify <https://www.shopify.com/>_ stores. It uploads products, variants and collections to Shopify, and downloads orders, transactions and creates fulfilments.

El análisis encontró 14 archivos Python, 22 archivos XML, 15 vistas, 6 acciones, 2 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 web shop shopify, 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 web_shop_shopify, 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_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.
product — debe estar instalado y configurado antes de probar este módulo.
product_attribute — debe estar instalado y configurado antes de probar este módulo.
sale — debe estar instalado y configurado antes de probar este módulo.
sale_amendment — debe estar instalado y configurado antes de probar este módulo.
sale_payment — debe estar instalado y configurado antes de probar este módulo.
stock — debe estar instalado y configurado antes de probar este módulo.
web_shop — debe estar instalado y configurado antes de probar este módulo.

Integraciones opcionales

carrier — habilita una integración adicional; pruebe la combinación explícitamente.
customs — habilita una integración adicional; pruebe la combinación explícitamente.
product_image — habilita una integración adicional; pruebe la combinación explícitamente.
product_image_attribute — habilita una integración adicional; pruebe la combinación explícitamente.
product_kit — habilita una integración adicional; pruebe la combinación explícitamente.
product_measurements — habilita una integración adicional; pruebe la combinación explícitamente.
sale_discount — habilita una integración adicional; pruebe la combinación explícitamente.
sale_gift_card — habilita una integración adicional; pruebe la combinación explícitamente.
sale_invoice_grouping — habilita una integración adicional; pruebe la combinación explícitamente.
sale_secondary_unit — habilita una integración adicional; pruebe la combinación explícitamente.
sale_shipment_cost — habilita una integración adicional; pruebe la combinación explícitamente.
stock_package_shipping — 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.payment: agrupa 2 modelo(s), entre ellos account.payment, account.payment.journal. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
carrier: agrupa 1 modelo(s), entre ellos carrier. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
carrier.selection: agrupa 1 modelo(s), entre ellos carrier.selection.shopify. 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.address: agrupa 1 modelo(s), entre ellos party.address. 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.
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-customs.tariff: agrupa 1 modelo(s), entre ellos product-customs.tariff.code. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
product.attribute: agrupa 2 modelo(s), entre ellos product.attribute, product.attribute.set. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
product.category: agrupa 1 modelo(s), entre ellos product.category. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
product.identifier: agrupa 1 modelo(s), entre ellos product.identifier. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
product.image: agrupa 1 modelo(s), entre ellos product.image. 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.
product.shopify_inventory_item: agrupa 1 modelo(s), entre ellos product.shopify_inventory_item. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
product.template: agrupa 1 modelo(s), entre ellos product.template. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
product.template-product: agrupa 1 modelo(s), entre ellos product.template-product.category. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
product.web_shop_url: agrupa 1 modelo(s), entre ellos product.web_shop_url. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
sale.line: agrupa 1 modelo(s), entre ellos sale.line. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
sale.sale: agrupa 1 modelo(s), entre ellos sale.sale. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
stock.move: agrupa 1 modelo(s), entre ellos stock.move. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
stock.shipment: agrupa 2 modelo(s), entre ellos stock.shipment.out, stock.shipment.shopify_identifier. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
web.shop: agrupa 3 modelo(s), entre ellos web.shop, web.shop.shopify_identifier, web.shop.shopify_payment_journal. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
web.shop-product: agrupa 1 modelo(s), entre ellos web.shop-product.attribute. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
web.shop-stock: agrupa 1 modelo(s), entre ellos web.shop-stock.location. Estos registros forman la información que el usuario consulta o modifica durante el proceso.

Flujo de trabajo habitual

Seleccione la compañía y fecha correctas antes de crear el documento.
Complete primero los datos maestros y luego las líneas o detalles.
Use los botones del formulario para cambiar de estado; guardar no equivale a validar o contabilizar.
Revise advertencias, totales, documentos relacionados y trazabilidad.
Compruebe el efecto en los módulos dependientes antes de cerrar el proceso.

Acciones, estados y asistentes

set_to_update — acción o transición que inicia set to update. 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.
packed — acción o transición que inicia packed. 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 51 clases Python y declara o extiende 29 modelos. Utiliza Boolean, Char, Dict, Function, Integer, Many2One, One2Many, Reference, Selection. 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.journal
carrier
carrier.selection.shopify
ir.cron
party.address
party.party
party.replace
product-customs.tariff.code
product.attribute
product.attribute.set
product.category
product.identifier
product.image
product.product
product.shopify_inventory_item
product.template
product.template-product.category
product.web_shop_url
sale.line
sale.sale
stock.move
stock.shipment.out
stock.shipment.shopify_identifier
web.shop
web.shop-product.attribute
web.shop-stock.location
web.shop.shopify_identifier
web.shop.shopify_payment_journal

Tipos de campos utilizados

Boolean
Char
Dict
Function
Integer
Many2One
One2Many
Reference
Selection

Clases y métodos públicos detectados

Clases: Address, Attribute, AttributeSet, Carrier, Category, Cron, GraphQLException, IdentifierMixin, IdentifiersMixin, IdentifiersUpdateMixin, Image, Image_Attribute, Line, Line_Discount, Line_Kit, Line_SaleSecondaryUnit, Line_ShipmentCost, Move, Move_Kit, Party, Payment, PaymentJournal, Product, ProductIdentifier, ProductURL, Product_GiftCard, Product_Image, Product_SaleSecondaryUnit, Product_TariffCode, Replace, Sale, Sale_ShipmentCost, SelectionShopify, ShipmentOut, ShipmentOut_PackageShipping, ShipmentShopifyIdentifier, Shop, ShopShopifyIdentifier, ShopShopifyPaymentJournal, Shop_Attribute, Shop_Image, Shop_Warehouse, ShopifyCredentialWarning, ShopifyError, ShopifyInventoryItem, ShopifyInventoryItem_Customs, Template, TemplateCategory, Template_GiftCard, Template_Image, Template_SaleSecondaryUnit

Métodos: amount_to_pay(), check_modification(), check_shopify_handle(), copy(), create_invoice(), draft(), fields_to_replace(), get_address_from_shopify(), get_from_shopify(), get_from_shopify_refund(), get_from_shopify_shipping(), get_payment_journal(), get_product(), get_records(), get_sale(), get_shopify(), get_shopify_identifier(), get_shopify_identifier_to_update(), get_shopify_inventory_context(), get_shopify_locations(), get_shopify_metafields(), get_shopify_refund(), get_shopify_refund_line_items(), get_shopify_sku(), get_shopify_uom(), get_shopify_url(), get_shopify_values(), get_tax_amount(), get_url(), get_web_status_url(), get_web_url(), getter(), invoice_grouping_method(), is_managing_gift_card(), is_shopify_to_update(), managed_metafields(), match(), on_change_with_shopify_url(), on_change_with_shopify_webhook_endpoint_order(), on_change_with_warehouse(), on_modification(), on_write(), pack(), process(), process_shopify(), search_shopify_identifier(), search_shopify_sku(), set_shipment_cost(), set_shopify_identifier(), set_shopify_to_update(), set_to_update(), shopify_attributes(), shopify_fetch_order(), shopify_fields(), shopify_images(), shopify_match(), shopify_name(), shopify_price(), shopify_quantity(), shopify_request(), shopify_resource(), shopify_shop(), shopify_shop_locales(), shopify_uom_factor(), shopify_uom_rate(), shopify_update_inventory(), shopify_update_order(), shopify_update_product(), shopify_update_sale(), shopify_values(), table_query(), to_sync(), update_sales(), validate_fields(), view_attributes()

Mapa del código

Se detectaron 14 archivos Python, 22 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
carrier.py
carrier.xml
common.py
doc/conf.py
exceptions.py
graphql.py
ir.py
ir.xml
message.xml
party.py
party.xml
product.py
product.xml
routes.py
sale.py
stock.py
stock.xml
view/carrier_form.xml
view/carrier_selection_shopify_form.xml
view/carrier_selection_shopify_list.xml
view/party_form.xml
view/product_attribute_set_form.xml
view/product_template_form.xml
view/shop_form.xml
view/shop_shopify_identifier_form.xml
view/shop_shopify_identifier_list.xml
view/shop_shopify_payment_journal_form.xml
view/shop_shopify_payment_journal_list.xml
view/shop_stock_location_form.xml
view/shop_stock_location_list.xml
view/stock_shipment_shopify_identifier_form.xml
view/stock_shipment_shopify_identifier_list.xml
web.py
web.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 · locations_cache · Design · Shopify Identifier · Shopify Payment Journal · Shopify Shipment Identifier · Shopify Inventory Item · Carrier · Web Shop Shopify Module · Usage · Configure Shopify Web Shop · Setup Shopify Variants · Admin Links · Setup Gift Cards

- doc/configuration.rst: The Web Shop Shopify Module uses values from settings in the [web_shop_shopify] section of the trytond:topics-configuration.
- doc/design.rst: The Web Shop Shopify Module introduces some new concepts.
- doc/index.rst: The Web Shop Shopify Module provides a way to manage Shopify <https://www.shopify.com/>_ stores. It uploads products, variants and collections to Shopify, and downloads orders, transactions and creates fulfilments.
- doc/usage.rst: First you must create a new custom app <https://help.shopify.com/en/manual/apps/app-types>_ for your Shopify store with, as a minimum, the Admin API access scopes:

Ver código fuente

Propósito​

Descripción oficial de la rama (idioma original)​

Guía funcional para el usuario

A quién le sirve​

Qué podrá hacer​

Requisitos y preparación​

Dependencias obligatorias​

Integraciones opcionales​

Configuración inicial recomendada​

Objetos y conceptos del módulo​

Flujo de trabajo habitual​

Acciones, estados y asistentes​

Controles antes de producción​

Diagnóstico y resolución de problemas​