[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 y ac_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
  • 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

Instalación de la extensión

Requisitos

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.

recommendation-more-help
84c95778-e795-4ef1-8b7e-54d73e45e22d