[Solo PaaS]{class="badge informative"}
Agregar atributos de clase de impuestos, juego de atributos e inventario
El módulo Atributos de producto adicionales de Adobe Commerce amplía las fuentes de datos del producto. Incluye atributos de producto adicionales de las configuraciones de producto de Adobe Commerce:
Una vez instalado, el módulo funciona automáticamente. Registra y exporta los atributos adicionales durante la sincronización de productos. No se requiere ninguna configuración adicional.
Ventajas principales
- Mejora automática: Enriquece las fuentes de productos con la clase de impuestos, el conjunto de atributos y los atributos de inventario
- Integración perfecta: proporciona contexto esencial para los sistemas y servicios externos
- Configuración cero: funciona inmediatamente después de la instalación
- Actualizaciones en tiempo real: se sincroniza automáticamente con los cambios del producto
Funciones y atributos exportados
El módulo agrega tres atributos adicionales a las fuentes de datos de productos existentes:
ac_tax_class
ac_attribute_set
ac_inventory
1. Información de clase de impuestos (ac_tax_class
)
Propósito: Proporciona información de clasificación de impuestos para cada producto
Formato de datos: Valor de cadena que contiene el nombre de la clase de impuestos
Ejemplo de salida:
{
"attributes": [
{
"code": "ac_tax_class",
"values": ["Taxable Goods"]
}
]
}
Casos de uso:
Al exportar datos de clase de impuestos a los servicios de catálogo de Commerce, estos datos están disponibles para las aplicaciones compatibles con lo siguiente:
- Informes de cumplimiento fiscal
- Integración con servicios de cálculo de impuestos externos
- Categorización de productos para sistemas de contabilidad
2. Información del conjunto de atributos (ac_attribute_set
)
Propósito: Identifica qué conjunto de atributos está asignado a cada producto
Formato de datos: Valor de cadena que contiene el nombre del conjunto de atributos
Ejemplo de salida:
{
"attributes": [
{
"code": "ac_attribute_set",
"values": [
"Default"
]
}
]
}
Casos de uso:
Al exportar datos de conjuntos de atributos a los servicios de catálogo de Commerce, se habilitan funciones avanzadas de administración de productos en sistemas externos. Estas funciones incluyen:
- Identificación de plantilla de producto
- Gestión y organización del catálogo
- Integración de sistemas de terceros que requiere un contexto de conjunto de atributos
3. Datos de inventario avanzados (ac_inventory
)
Propósito: proporciona la configuración de administración de inventario para cada producto
Formato de datos: cadena con codificación JSON que contiene la configuración del inventario
Campos incluidos:
-
manageStock
(booleano): Si la administración de existencias está habilitada -
cartMinQty
(flotante): Cantidad mínima permitida en el carro de compras -
cartMaxQty
(flotante): Cantidad máxima permitida en el carro de compras -
backorders
(cadena): directiva de pedidos pendientes. El valor es uno de los siguientes:"no"
: no se permiten pedidos pendientes"allow"
: permitir cantidad inferior a 0"allow_notify"
: permitir cantidad inferior a 0 y notificar al cliente
-
enableQtyIncrements
(booleano): Si los incrementos de cantidad están habilitados -
qtyIncrements
(flotante): valor de incremento de cantidad requerido
Ejemplo de salida:
{
"attributes": [
{
"code": "ac_inventory",
"values": [
"{\"manageStock\":true,\"cartMinQty\":2,\"cartMaxQty\":42,\"backorders\":\"no\",\"enableQtyIncrements\":false,\"qtyIncrements\":2}"
]
}
]
}
Casos de uso:
Al exportar datos de inventario a los servicios de catálogo de Commerce, se habilitan funciones avanzadas de administración de inventario en sistemas externos. Estas funciones incluyen:
- Integración del sistema de Inventory management
- Reglas de validación del carro de compras
- Optimización del proceso de realización de pedidos
- Personalización de la experiencia del cliente
Mejora de la fuente de exportación de datos
El módulo Atributos de producto adicionales mejora las fuentes de productos existentes. Integra los nuevos datos de atributos automáticamente.
-
Fuente de productos (
products
): mejorada con los tres atributos adicionales- Agrega los atributos
ac_tax_class
,ac_attribute_set
yac_inventory
a cada registro de producto - Mantiene los datos del producto original sin cambios
- Mantiene la compatibilidad con versiones anteriores de los consumidores de fuentes de datos existentes
- Agrega los atributos
-
Fuente de atributos del producto (
productAttributes
): mejorado con metadatos de atributos para los nuevos atributos- Registra automáticamente los metadatos de los tres atributos nuevos en la fuente
productAttributes
- Proporciona detalles de configuración de atributos (tipos de datos, configuración de visibilidad, etc.)
- Ayuda a los sistemas externos a comprender el nuevo esquema de atributos
- Registra automáticamente los metadatos de los tres atributos nuevos en la fuente
Instalación de la extensión
Requisitos
-
PHP 8.1, 8.2, 8.3 u 8.4
-
Adobe Commerce 2.4.4+
-
Extensión de exportación de datos de Adobe Commerce, versión 103.4.11 o posterior
-
Acceso a repo.magento.com
Para generar claves y obtener los derechos necesarios, consulta Obtener tus claves de autenticación. Para instalaciones en la nube, consulte la Guía de Commerce en infraestructura en la nube.
-
Acceso a la línea de comandos del servidor de aplicaciones de Adobe Commerce.
Pasos de instalación
Agregar el módulo adobe-commerce/module-extra-product-attributes
mediante Composer:
composer require adobe-commerce/module-extra-product-attributes
Para ver los pasos detallados de la instalación, consulte las siguientes guías:
Sincronización de datos de producto
Después de la reimplementación, la instancia de Adobe Commerce exporta los datos adicionales automáticamente durante la sincronización de productos. También puede utilizar los comandos CLI resync
para sincronizar inmediatamente.
# Resync the products feed (includes the new attributes)
bin/magento saas:resync --feed=products
# Resync the product attributes feed (includes new attribute metadata)
bin/magento saas:resync --feed=productAttributes
Resolución de problemas
A productos les faltan atributos adicionales:
- Compruebe que el módulo está correctamente instalado y habilitado
- Ejecute los comandos de resincronización para actualizar los datos del producto
- Comprobar que los productos tengan asignaciones válidas de clases de impuestos y juegos de atributos
Los datos de inventario parecen incorrectos:
- Compruebe que la configuración del inventario sea correcta en el Administrador
- Comprobar invalidaciones de inventario específicas del sitio web
- Compruebe que el módulo de Inventory management funciona correctamente
Para obtener más información, consulte la Guía de Inventory management en la Documentación de Adobe Commerce Merchant.
Problemas de rendimiento:
- Monitorización del rendimiento del proceso de exportación después de la instalación
- Considere la posibilidad de programar resincronizaciones durante períodos de poco tráfico
Registro y depuración
Los registros del módulo exportan errores y advertencias al sistema de registro estándar de Commerce. Si tiene problemas durante la sincronización de productos, compruebe los registros de exportación de datos.
Para obtener más información, vea Revisar registros y solucionar problemas.