[Solo PaaS]{class="badge informative"}
Aggiungere classe fiscale, serie di attributi e attributi di inventario
Il modulo Adobe Commerce Extra Product Attributes estende i feed di dati di prodotto. Include attributi di prodotto aggiuntivi dalle configurazioni di prodotto Adobe Commerce:
Una volta installato, il modulo funziona automaticamente. Acquisisce ed esporta gli attributi aggiuntivi durante la sincronizzazione del prodotto. Non è richiesta alcuna configurazione aggiuntiva.
Vantaggi chiave
- Miglioramento automatico: arricchisce i feed di prodotto con attributi di classe fiscale, set di attributi e inventario
- Integrazione perfetta: fornisce il contesto essenziale per i sistemi e i servizi esterni
- Nessuna configurazione: funziona immediatamente dopo l'installazione
- Aggiornamenti in tempo reale: sincronizzazione automatica con le modifiche apportate al prodotto
Funzioni e attributi esportati
Il modulo aggiunge tre attributi aggiuntivi ai feed di dati di prodotto esistenti:
ac_tax_class
ac_attribute_set
ac_inventory
1. Informazioni sulla classe fiscale (ac_tax_class
)
Scopo: fornisce informazioni sulla classificazione fiscale per ciascun prodotto
Formato dati: valore stringa contenente il nome della classe fiscale
Output di esempio:
{
"attributes": [
{
"code": "ac_tax_class",
"values": ["Taxable Goods"]
}
]
}
Casi d'uso:
Quando si esportano dati di classi di imposta in Commerce Catalog Services, tali dati diventano disponibili per le applicazioni che supportano:
- Report di conformità fiscale
- Integrazione con i servizi di calcolo delle imposte esterni
- Categorizzazione dei prodotti per i sistemi contabili
2. Informazioni sul set di attributi (ac_attribute_set
)
Scopo: identifica il set di attributi assegnato a ciascun prodotto
Formato dati: valore stringa contenente il nome del set di attributi
Output di esempio:
{
"attributes": [
{
"code": "ac_attribute_set",
"values": [
"Default"
]
}
]
}
Casi d'uso:
Quando si esportano i dati del set di attributi in Commerce Catalog Services, vengono attivate funzioni avanzate di gestione dei prodotti in sistemi esterni. Queste caratteristiche includono:
- Identificazione del modello di prodotto
- Gestione e organizzazione del catalogo
- Integrazione di sistemi di terze parti che richiede il contesto del set di attributi
3. Dati inventario avanzati (ac_inventory
)
Scopo: fornisce le impostazioni di gestione dell'inventario per ciascun prodotto
Formato dati: stringa con codifica JSON contenente la configurazione dell'inventario
Campi inclusi:
-
manageStock
(booleano): se la gestione azionaria è abilitata -
cartMinQty
(virgola mobile): quantità minima consentita nel carrello -
cartMaxQty
(virgola mobile): quantità massima consentita nel carrello -
backorders
(stringa): criterio ordine arretrato. Il valore è uno dei seguenti:"no"
: nessun ordine inevaso consentito"allow"
: quantità consentita inferiore a 0"allow_notify"
: consenti quantità inferiore a 0 e notifica al cliente
-
enableQtyIncrements
(booleano): se gli incrementi di quantità sono abilitati -
qtyIncrements
(virgola mobile): valore di incremento quantità richiesto
Output di esempio:
{
"attributes": [
{
"code": "ac_inventory",
"values": [
"{\"manageStock\":true,\"cartMinQty\":2,\"cartMaxQty\":42,\"backorders\":\"no\",\"enableQtyIncrements\":false,\"qtyIncrements\":2}"
]
}
]
}
Casi d'uso:
Quando si esportano dati di inventario in Commerce Catalog Services, vengono attivate funzioni avanzate di gestione dell'inventario in sistemi esterni. Queste caratteristiche includono:
- Integrazione dei sistemi Inventory management
- Regole di convalida del carrello
- Ottimizzazione del processo di evasione degli ordini
- Personalizzazione della customer experience
Miglioramento del feed di esportazione dei dati
Il modulo Attributi prodotto aggiuntivi migliora i feed di prodotto esistenti. Integra automaticamente i nuovi dati attributo.
-
Feed prodotti (
products
): migliorato con i tre attributi aggiuntivi- Aggiunge gli attributi
ac_tax_class
,ac_attribute_set
eac_inventory
a ciascun record di prodotto - Mantiene invariati i dati di prodotto originali
- Mantiene la compatibilità con le versioni precedenti dei consumatori di feed esistenti
- Aggiunge gli attributi
-
Feed attributi prodotto (
productAttributes
): migliorato con i metadati degli attributi per i nuovi attributi- Registra automaticamente i metadati per i tre nuovi attributi nel feed
productAttributes
- Fornisce i dettagli di configurazione degli attributi (tipi di dati, impostazioni di visibilità e così via)
- Aiuta i sistemi esterni a comprendere il nuovo schema di attributi
- Registra automaticamente i metadati per i tre nuovi attributi nel feed
Installare l’estensione
Requisiti
-
PHP 8.1, 8.2, 8.3 o 8.4
-
Adobe Commerce 2.4.4+
-
Estensione Adobe Commerce Data Export, versione 103.4.11 o successiva
-
Accedi a repo.magento.com
Per generare le chiavi e ottenere i diritti necessari, vedere Ottenere le chiavi di autenticazione. Per le installazioni cloud, consulta la Guida di Commerce sull'infrastruttura cloud.
-
Accedere alla riga di comando del server applicazioni Adobe Commerce.
Passaggi per l’installazione
Aggiungi il modulo adobe-commerce/module-extra-product-attributes
tramite Compositore:
composer require adobe-commerce/module-extra-product-attributes
Per i passaggi dettagliati dell’installazione, consulta le seguenti guide:
Sincronizzare i dati del prodotto
Dopo la ridistribuzione, l’istanza di Adobe Commerce esporta automaticamente i dati aggiuntivi durante la sincronizzazione del prodotto. È inoltre possibile utilizzare i comandi CLI resync
per eseguire immediatamente la sincronizzazione.
# 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
Risoluzione dei problemi
Attributi aggiuntivi mancanti per i prodotti:
- Verificare che il modulo sia installato e attivato correttamente
- Esegui i comandi di risincronizzazione per aggiornare i dati del prodotto
- Verifica che i prodotti abbiano assegnazioni valide per la classe fiscale e la serie di attributi
I dati di inventario non sono corretti:
- Verificare che le impostazioni di inventario siano configurate correttamente in Amministrazione
- Verifica sostituzioni inventario specifiche per il sito Web
- Verifica che il modulo Inventory management funzioni correttamente
Per ulteriori dettagli, consulta la Guida di Inventory management nella documentazione di Adobe Commerce Merchant.
Problemi relativi alle prestazioni:
- Monitorare le prestazioni del processo di esportazione dopo l'installazione
- Valuta la pianificazione delle risincronizzazioni durante i periodi a traffico ridotto
Registrazione e debug
Il modulo registra gli errori e gli avvisi di esportazione nel sistema di registrazione standard di Commerce. Se riscontri problemi durante la sincronizzazione del prodotto, controlla i registri di esportazione dei dati.
Per ulteriori dettagli, vedere Esaminare i registri e risolvere i problemi.