[Somente PaaS]{class="badge informative"}

Adicionar classe de imposto, conjunto de atributos e atributos de inventário

O módulo Atributos extras de produto do Adobe Commerce estende os feeds de dados do produto. Ele inclui atributos de produto adicionais das configurações de produto do Adobe Commerce:

Uma vez instalado, o módulo funciona automaticamente. Ele captura e exporta os atributos adicionais durante a sincronização do produto. Nenhuma configuração adicional é necessária.

Principais benefícios

  • Aprimoramento automático: enriquece feeds de produtos com classe de imposto, conjunto de atributos e atributos de inventário
  • Integração perfeita: fornece contexto essencial para sistemas e serviços externos
  • Configuração zero: funciona imediatamente após a instalação
  • Atualizações em tempo real: sincroniza automaticamente com as alterações do produto

Recursos e atributos exportados

O módulo adiciona três atributos adicionais aos seus feeds de dados de produtos existentes:

  • ac_tax_class
  • ac_attribute_set
  • ac_inventory

​1. Informações da classe de imposto (ac_tax_class)

Propósito: fornece informações de classificação de imposto para cada produto

Formato dos dados: valor da cadeia de caracteres que contém o nome da classe de imposto

Exemplo de saída:

{
  "attributes": [
    {
      "code": "ac_tax_class",
      "values": ["Taxable Goods"]
    }
  ]
}

Casos de uso:

Quando você exporta dados da classe de imposto para os serviços de catálogo Commerce, esses dados ficam disponíveis para aplicativos que suportam:

  • Relatório de conformidade fiscal
  • Integração com serviços de cálculo de impostos externos
  • Categorização de produtos para sistemas de contabilidade

​2. Informações de conjunto de atributos (ac_attribute_set)

Propósito: identifica qual conjunto de atributos está atribuído a cada produto

Formato dos dados: valor da cadeia de caracteres que contém o nome do conjunto de atributos

Exemplo de saída:

{
  "attributes": [
    {
      "code": "ac_attribute_set",
      "values": [
        "Default"
      ]
    }
  ]
}

Casos de uso:

Quando você exporta dados do conjunto de atributos para os serviços de catálogo da Commerce, ele ativa recursos avançados de gerenciamento de produtos em sistemas externos. Esses recursos incluem:

  • Identificação do modelo de produto
  • Gerenciamento e organização do catálogo
  • Integração de sistema de terceiros que requer o contexto do conjunto de atributos

​3. Dados avançados de inventário (ac_inventory)

Propósito: Fornece configurações de gerenciamento de estoque para cada produto

Formato de dados: cadeia de caracteres codificada em JSON contendo configuração de inventário

Campos incluídos:

  • manageStock (booleano): se o gerenciamento de estoque está habilitado

  • cartMinQty (flutuante): quantidade mínima permitida no carrinho de compras

  • cartMaxQty (flutuante): quantidade máxima permitida no carrinho de compras

  • backorders (cadeia de caracteres): política de backorder. O valor é um dos seguintes:

    • "no": Nenhuma ordem pendente permitida
    • "allow": Permitir quantidade abaixo de 0
    • "allow_notify": Permitir quantidade abaixo de 0 e notificar o cliente
  • enableQtyIncrements (booleano): se os incrementos de quantidade estão habilitados

  • qtyIncrements (flutuante): valor de incremento de quantidade necessário

Exemplo de saída:

{
  "attributes": [
    {
      "code": "ac_inventory",
      "values": [
        "{\"manageStock\":true,\"cartMinQty\":2,\"cartMaxQty\":42,\"backorders\":\"no\",\"enableQtyIncrements\":false,\"qtyIncrements\":2}"
      ]
    }
  ]
}

Casos de uso:

Quando você exporta dados de inventário para serviços de catálogo da Commerce, ele ativa recursos avançados de gerenciamento de inventário em sistemas externos. Esses recursos incluem:

  • Integração do sistema Inventory management
  • Regras de validação do carrinho de compras
  • Otimização do processo de atendimento do pedido
  • Personalização da experiência do cliente

Aprimoramento do feed de exportação de dados

O módulo de Atributos de produto adicionais aprimora os feeds de produto existentes. Ele integra os novos dados do atributo automaticamente.

  • Feed de produtos (products): aprimorado com os três atributos adicionais

    • Adiciona os atributos ac_tax_class, ac_attribute_set e ac_inventory a cada registro de produto
    • Mantém os dados originais do produto inalterados
    • Mantém a compatibilidade com versões anteriores de consumidores de feed existentes
  • Feed de atributos de produto (productAttributes): aprimorado com metadados de atributo para os novos atributos

    • Registra automaticamente metadados para os três novos atributos no feed productAttributes
    • Fornece detalhes de configuração do atributo (tipos de dados, configurações de visibilidade e assim por diante)
    • Ajuda os sistemas externos a entender o novo esquema de atributo

Instalar a extensão

Requisitos

Etapas de instalação

Adicionar o módulo adobe-commerce/module-extra-product-attributes usando o Composer:

composer require adobe-commerce/module-extra-product-attributes

Para ver as etapas detalhadas de instalação, consulte os guias a seguir:

Sincronizar dados do produto

Após a reimplantação, a instância do Adobe Commerce exporta os dados adicionais automaticamente durante a sincronização do produto. Você também pode usar os comandos da CLI do resync para sincronizar imediatamente.

# 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

Solução de problemas

Falta atributos adicionais nos produtos:

  • Verifique se o módulo está instalado e ativado corretamente
  • Execute os comandos resync para atualizar os dados do produto
  • Verificar se os produtos têm atribuições válidas de classe de imposto e conjunto de atributos

Os dados de inventário parecem incorretos:

  • Verifique se as configurações de inventário estão definidas corretamente no Administrador
  • Verificar substituições de inventário específicas do site
  • Verifique se o módulo Inventory management está funcionando corretamente

Para obter mais detalhes, consulte o Guia do Inventory management na Documentação do Comerciante da Adobe Commerce.

Questões de desempenho:

  • Monitorar o desempenho do processo de exportação após a instalação
  • Considere o agendamento de ressincronizações durante períodos de tráfego baixo

Registro e depuração

O módulo registra erros de exportação e avisos no sistema de registro padrão do Commerce. Se você encontrar problemas durante a sincronização do produto, verifique os logs de exportação de dados.

Para obter detalhes, consulte Revisar logs e solucionar problemas.

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