DokumentationHandelData Export-guide för SaaS-tjänster

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

Lägg till momsklass, attributuppsättning och lagerattribut

Last update: Thu Sep 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Administratör
  • Utvecklare

Modulen Extra produktattribut i Adobe Commerce utökar produktdatautflöden. Den innehåller ytterligare produktattribut från Adobe Commerce produktkonfigurationer:

När modulen har installerats fungerar den automatiskt. Det hämtar och exporterar ytterligare attribut under produktsynkroniseringen. Ingen ytterligare konfiguration krävs.

Viktiga fördelar

  • Automatisk förbättring: Förbättrar produktflöden med attribut för momsklass, attributuppsättning och lager
  • Smidig integrering: Tillhandahåller viktig kontext för externa system och tjänster
  • Nollkonfiguration: Fungerar omedelbart efter installation
  • Realtidsuppdateringar: Synkroniserar automatiskt med produktändringar

Funktioner och exporterade attribut

Modulen lägger till ytterligare tre attribut till dina befintliga produktdataflöden:

  • ac_tax_class
  • ac_attribute_set
  • ac_inventory

​1. Information om momsklass (ac_tax_class)

Syfte: Tillhandahåller information om skatteklassificering för varje produkt

Dataformat: Strängvärde som innehåller momsklassnamnet

Exempelutdata:

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

Användningsexempel:

När du exporterar momsklassdata till Commerce katalogtjänster blir dessa data tillgängliga för program som stöder:

  • Rapportering om skatteefterlevnad
  • Integrering med externa momsberäkningstjänster
  • Produktkategorisering för redovisningssystem

​2. Information om attributuppsättning (ac_attribute_set)

Syfte: Identifierar vilken attributuppsättning som tilldelas varje produkt

Dataformat: Strängvärde som innehåller attributuppsättningsnamnet

Exempelutdata:

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

Användningsexempel:

När du exporterar attributuppsättningsdata till Commerce katalogtjänster aktiveras avancerade funktioner för produkthantering i externa system. Bland dessa funktioner finns:

  • Identifiering av produktmall
  • Kataloghantering och katalogorganisation
  • Systemintegrering från tredje part som kräver kontext för attributuppsättning

​3. Avancerade lagerdata (ac_inventory)

Syfte: Tillhandahåller lagerhanteringsinställningar för varje produkt

Dataformat: JSON-kodad sträng som innehåller lagerkonfiguration

Inkluderade fält:

  • manageStock (boolesk): Anger om arkivhantering är aktiverat

  • cartMinQty (flyttal): Minsta tillåtna kvantitet i kundvagn

  • cartMaxQty (flyttal): Högsta tillåtna kvantitet i kundvagnen

  • backorders (sträng): Bakgrundsprincip. Värdet är något av följande:

    • "no": Inga backorder tillåts
    • "allow": Tillåt kvantitet under 0
    • "allow_notify": Tillåt kvantitet under 0 och meddela kunden

  • enableQtyIncrements (booleskt): Anger om kvantitetsökningar är aktiverade

  • qtyIncrements (flytande): Ökningsvärde för obligatorisk kvantitet

Exempelutdata:

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

Användningsexempel:

När du exporterar lagerdata till Commerce katalogtjänster aktiveras avancerade funktioner för lagerhantering i externa system. Bland dessa funktioner finns:

  • Integrering med Inventory management
  • Valideringsregler för kundvagn
  • Optimering av orderprocess
  • Anpassning av kundupplevelser

Förbättrad dataexport

Modulen Extra produktattribut förbättrar befintliga produktflöden. Den integrerar de nya attributdata automatiskt.

  • Produktfeed (products): Förbättrat med tre ytterligare attribut

    • Lägger till attributen ac_tax_class, ac_attribute_set och ac_inventory i varje produktpost
    • Behåller ursprungliga produktdata oförändrade
    • Bevarar bakåtkompatibilitet med befintliga foderkonsumenter

  • Produktattributfeed (productAttributes): Förbättrat med attributmetadata för de nya attributen

    • Registrerar automatiskt metadata för de tre nya attributen i feeden productAttributes
    • Tillhandahåller information om attributkonfiguration (datatyper, synlighetsinställningar och så vidare)
    • Hjälper externa system att förstå det nya attributschemat

Installera tillägget

Krav

Installationssteg

Lägg till modulen adobe-commerce/module-extra-product-attributes med Composer:

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

Detaljerade installationssteg finns i följande handböcker:

Synkronisera produktdata

Efter omdistributionen exporterar Adobe Commerce-instansen automatiskt ytterligare data under produktsynkroniseringen. Du kan också använda CLI-kommandona resync för att synkronisera omedelbart.

# 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

Felsökning

Produkter saknar ytterligare attribut:

  • Kontrollera att modulen är korrekt installerad och aktiverad
  • Kör omsynkroniseringskommandona för att uppdatera produktdata
  • Kontrollera att produkter har giltiga tilldelningar för momsklass och attributuppsättning

Lagerdata verkar vara felaktiga:

  • Kontrollera att lagerinställningarna är korrekt konfigurerade i administratören
  • Kontrollera om det finns webbplatsspecifika lageråsidosättningar
  • Kontrollera att modulen Inventory management fungerar som den ska

Mer information finns i Inventory management Guide i Adobe Commerce Merchant Documentation.

Prestandaproblem:

  • Övervaka prestanda för exportprocess efter installation
  • Överväg att schemalägga omsynkronisering under lågtrafikperioder

Loggning och felsökning

Modulen loggar exportfel och varningar till Commerce standardloggningssystem. Om du råkar ut för problem under produktsynkroniseringen kontrollerar du dataexportloggarna.

Mer information finns i Granska loggar och felsöka.

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