Gérez les listes de produits à l'aide de l'API Selling Partner

Gérez le cycle de vie de votre liste de produits à l'aide de SP-API.

Ce guide décrit le cycle de vie des offres sur Amazon et les API des partenaires de vente qui peuvent être utilisées pour les gérer.

Cycle de vie des listes de produits

Le cycle de vie de création et de gestion des offres sur Amazon implique généralement les éléments suivants :

  1. Découverte
    • Est-ce qu'Amazon propose déjà l'article que je souhaite vendre dans son catalogue ?
    • Où se situe mon article dans la hiérarchie du catalogue Amazon ?
    • Quelles sont les conditions requises pour créer des articles dans le catalogue Amazon ?
    • Suis-je éligible pour mettre en vente des articles dans le catalogue Amazon ?
  2. Création
    • Ai-je satisfait aux exigences en matière de données pour créer un nouvel élément ou mettre en vente un élément existant ?
    • Ma candidature a-t-elle été acceptée ?
  3. Entretien
    • Quel est l'état de mon annonce ? Est-il achetable ? Est-il détectable ?
    • Ai-je des problèmes liés à mon annonce ?
    • Mon offre continue-t-elle de répondre aux exigences en matière de données d'Amazon ?

API des partenaires de vente pour les listes de produits

Les API des partenaires de vente suivantes peuvent vous aider à gérer vos listes de produits :

Ces API fournissent les fonctionnalités de base suivantes pour la création et la gestion des offres :

  • Recherche de données depuis le catalogue Amazon (ASIN).
  • Recherche et consultation de la hiérarchie du catalogue Amazon (classifications, nœuds de navigation).
  • Récupération de schémas décrivant les exigences d'Amazon en matière de données par type de produit.
  • Récupération des informations relatives à l'éligibilité des offres par ASIN ou par type de produit.
  • Création, recherche, mise à jour et suppression d'offres (SKU).

En outre, ces API fournissent des notifications programmatiques qui activent des workflows pilotés par des événements pour les développeurs et les vendeurs tiers.

API Définitions de types de produit

Le API Selling Partner pour les définitions des types de produits fournit un accès programmatique aux exigences en matière d'attributs et de données pour les types de produits du catalogue Amazon. Avec cette API, vous demandez des exigences pour un type de produit sur un site de vente donné et vous recevez des réponses, y compris un schéma JSON qui décrit toutes les exigences, les attributs et la conditionnalité des exigences. Vous pouvez utiliser ce schéma JSON pour valider la charge utile que vous possédez déjà ou pour la mapper à vos ERP (Enterprise Resource Planning).

L'exemple suivant utilise le getDefinitionsProductType opération pour demander le LUGGAGE type de produit sur le marché américain en anglais américain :

GET https://sellingpartnerapi-na.amazon.com/definitions/2020-09-01/productTypes/LUGGAGE ?marketplaceIds=ATVPDKIKX0DER &locale=en_US

L'exemple suivant montre une réponse à la requête ci-dessus et fournit l'attribut ProductTypeDefinition pour l'offre LUGGAGE :

{ "metaSchema": { "link": { "resource": "https://...", "verb": "GET" }, "checksum": "QFQDmPwMARO7vwMEyLhOtw==" }, "schema": { "link": { "resource": "https://...", "verb": "GET" }, "checksum": "TBr8ubaxXrUyay9hmxUXUw==" }, "requirements": "LISTING", "requirementsEnforced": "ENFORCED", "propertyGroups": { "offer": { "title": "Offer", "description": "Product Offer", "propertyNames": [ "fulfillment_channel_availability", "purchasable_offer", "condition_type", "condition_note", "list_price", "product_tax_code", "merchant_release_date", "merchant_shipping_group", "max_order_quantity", "gift_options", "main_offer_image_locator", "other_offer_image_locator_1", "other_offer_image_locator_2", "other_offer_image_locator_3", "other_offer_image_locator_4", "other_offer_image_locator_5" ] }, "images": { "title": "Images", "description": "Physical imagess or URL's", "propertyNames": [ "main_product_image_locator", "other_product_image_locator_1", "other_product_image_locator_2", "other_product_image_locator_3", "other_product_image_locator_4", "other_product_image_locator_5", "other_product_image_locator_6", "other_product_image_locator_7", "other_product_image_locator_8", "swatch_product_image_locator" ] }, "shipping": { "title": "Shipping", "description": "Information to determine shipping and storage of your product (e.g., package dimensions, weight, volume)", "propertyNames": [ "item_dimensions", "item_package_dimensions", "item_package_weight" ] }, "variations": { "title": "Variations", "description": "Variations that product uses", "propertyNames": [ "parentage_level", "child_parent_sku_relationship", "variation_theme" ] }, "safety_and_compliance": { "title": "Safety & Compliance", "description": "Information to indicate product compliance, hazardous materials, and legal and safety warnings (e.g., lithium batteries, choking hazards, Consumer Product Safety Information Act (CPSIA))", "propertyNames": [ "country_of_origin", "warranty_description", "batteries_required", "batteries_included", "battery", "num_batteries", "number_of_lithium_metal_cells", "number_of_lithium_ion_cells", "lithium_battery", "supplier_declared_dg_hz_regulation", "hazmat", "safety_data_sheet_url", "item_weight", "ghs", "supplier_declared_material_regulation", "california_proposition_65", "pesticide_marking" ] }, "product_identity": { "title": "Product Identity", "description": "Information to uniquely identify your product (e.g., UPC, EAN, GTIN, Product Type, Brand)", "propertyNames": [ "item_name", "brand", "supplier_declared_has_product_identifier_exemption", "externally_assigned_product_identifier", "merchant_suggested_asin", "item_type_keyword", "item_type_name", "model_number", "manufacturer" ] }, "product_details": { "title": "Product Details", "description": "Information and characteristics to describe the product to support search, browse and detail page content (e.g., bullets, product features, model, style name)", "propertyNames": [ "product_description", "bullet_point", "special_feature", "style", "department", "target_gender", "age_range_description", "material", "outer", "fabric_type", "lining_description", "number_of_items", "number_of_wheels", "wheel", "model_name", "color", "size", "size_map", "part_number", "compliance_media" ] } }, "locale": "en_US", "marketplaceIds": [ "ATVPDKIKX0DER" ], "productType": "LUGGAGE", "productTypeVersion": { "version": "U8L4z4Ud95N16tZlR7rsmbQ==", "latest": true, "releaseCandidate": false } }

Schémas JSON Flux

En utilisant Alimente les schémas JSON vous pouvez mettre à jour des annonces individuelles en masse. Ces schémas fonctionnent avec API de définitions de types de produits et autorisez les intégrateurs à créer, modifier et supprimer des offres Amazon (SKU) avec le même format de données que celui utilisé par l'API Listings Items. Les données des listes sont interopérables entre l'API Listings Items et le JSON_LISTINGS_FEED type de flux, permettant aux partenaires commerciaux d'utiliser le mécanisme ou la combinaison qui convient le mieux à leurs flux de vente d'annonces.

API Articles d'offre

Le API du partenaire de vente pour les articles mis en vente fournit un accès programmatique aux offres des partenaires de vente sur Amazon. Grâce à cette API, vous pouvez créer et modifier vos annonces sur une base individuelle. Il comporte quatre opérations :

  • putListingsItem vous permet de créer un SKU donné et de mettre à jour des attributs tels que le prix, le stock ou les deux.

  • patchListingsItem vous permet de mettre à jour les attributs d'un SKU donné.

  • deleteListingsItem vous permet de supprimer un SKU donné.

  • getListingsItem renvoie des informations relatives à un SKU donné.

Le flux de listes JSON est un nouveau type de flux. Le flux de listes JSON est similaire à l'API Listings en ce sens qu'il vous permet de mettre à jour en masse, d'utiliser l'API Product Type Definitions pour obtenir le schéma et de constituer une charge utile. Cette charge utile peut être soumise à l'API Listing Items ou en masse au flux d'annonces JSON.

L'exemple suivant utilise le getListingsItem opération pour demander un Item auprès d'un vendeur disposant d'un sellerId de AXXXXXXXXXXXX sur le marché américain en anglais américain. Il demande summaries, attributes, issues, offers, et fulfillmentAvailability pour être dans Item dans la réponse :

GET https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXX/example-sku ?marketplaceIds=ATVPDKIKX0DER &issueLocale=en_US &includedData=summaries,attributes,issues,offers,fulfillmentAvailability

The following example shows a response to this request is an Item with summaries, attributes, issues, offers, and fulfillmentAvailability:

{ "sku": "example-aku", "summaries": [ { "marketplaceId": "ATVPDKIKX0DER", "asin": "XXXASINXXX", "productType": "DRINKING_CUP", "conditionType": "new_new", "status": [ "BUYABLE", "DISCOVERABLE" ], "itemName": "6 Pack Coffee Mug Set, Farielyn-X 16 Ounce Ceramic Coffee Cups, Black Large Coffee mugs, Restaurant Coffee Cups for Coffee, Tea, Cappuccino, Cocoa, Cereal, Matte Black Outside and Colorful Inside", "createdDate": "2021-07-14T19:57:02.327Z", "lastUpdatedDate": "2021-07-14T19:57:10.637Z", "mainImage": { "link": "https://m.media-amazon.com/images/I/41epVg7mZoS.jpg", "height": 500, "width": 500 } } ], "attributes": { "condition_type": [ { "value": "new_new", "marketplace_id": "ATVPDKIKX0DER" } ], "merchant_shipping_group": [ { "value": "legacy-template-id", "marketplace_id": "ATVPDKIKX0DER" } ], "merchant_suggested_asin": [ { "value": "XXXASINXXX", "marketplace_id": "ATVPDKIKX0DER" } ], "purchasable_offer": [ { "currency": "USD", "start_at": { "value": "2021-07-14T19:56:57.717Z" }, "our_price": [ { "schedule": [ { "value_with_tax": 30.0 } ] } ], "marketplace_id": "ATVPDKIKX0DER" } ], "fulfillment_availability": [ { "fulfillment_channel_code": "DEFAULT", "quantity": 1, "marketplace_id": "ATVPDKIKX0DER" } ], "main_product_image_locator": [ { "media_location": "https://media-origin-na-ssl.integ.amazon.com/images/I/xxxx1.jpg", "marketplace_id": "ATVPDKIKX0DER" } ], "other_product_image_locator_1": [ { "media_location": "https://media-origin-na-ssl.integ.amazon.com/images/I/xxxxx2.jpg", "marketplace_id": "ATVPDKIKX0DER" } ], "other_product_image_locator_2": [ { "media_location": "https://media-origin-na-ssl.integ.amazon.com/images/I/xxxxx3.jpg", "marketplace_id": "ATVPDKIKX0DER" } ] }, "issues": [ { "message": "Attributes tagged as relevant_attributes are incomplete. Provide values for the following attribute(s): item_weight, theme, item_dimensions, item_diameter", "severity": "WARNING", "attributeName": "item_diameter", "attributeNames": [ "item_diameter", "item_dimensions", "item_weight", "theme" ] }, { "message": "Attributes tagged as customer_returns are incomplete. Provide values for the following attribute(s): color, item_dimensions, item_weight", "severity": "WARNING", "attributeName": "color", "attributeNames": [ "color", "item_dimensions", "item_weight" ] } ], "offers": [ { "marketplaceId": "ATVPDKIKX0DER", "offerType": "B2C", "price": { "currency": "USD", "amount": "30.0" } } ], "fulfillmentAvailability": [ { "fulfillmentChannelCode": "DEFAULT", "quantity": 1 } ] }

API Articles du catalogue

The Selling Partner API for Catalog Items provides programmatic access to information about items in the Amazon catalog. In other words, you can search Amazon's catalog for products, match your products to the existing product listings on Amazon, and then make sourcing and pricing decisions for listing those products.

L'exemple suivant utilise le getCatalogItem opération pour demander un article avec un ASIN XXXXXXXXXX sur le marché de l'Amérique du Nord. Il demande une réponse avec un Item qui contient attributes, identifiers, images, productTypes, salesRanks, summaries, variations, et vendorDetails:

GET https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items/XXXXXXXXXX ?marketplaceIds=ATVPDKIKX0DER &includedData=attributes,identifiers,images,productTypes,salesRanks,summaries,variations,vendorDetails

The following example shows a response to this request that contains an Item with all the requested information:

{ "asin": "XXXXXXXXXX", "attributes": { "total_hdmi_ports": [ { "value": 4, "marketplace_id": "ATVPDKIKX0DER" } ], "resolution": [ { "language_tag": "en_US", "value": "4K", "marketplace_id": "ATVPDKIKX0DER" } ], "item_weight": [ { "unit": "pounds", "value": 107.6, "marketplace_id": "ATVPDKIKX0DER" } ], "product_subcategory": [ { "value": "50400150", "marketplace_id": "ATVPDKIKX0DER" } ], "item_dimensions": [ { "width": { "unit": "inches", "value": 72.4 }, "length": { "unit": "inches", "value": 2.4 }, "height": { "unit": "inches", "value": 41.4 }, "marketplace_id": "ATVPDKIKX0DER" } ], "brand": [ { "language_tag": "en_US", "value": "Samsung Electronics", "marketplace_id": "ATVPDKIKX0DER" } ], "control_method": [ { "value": "voice", "marketplace_id": "ATVPDKIKX0DER" } ], "item_package_dimensions": [ { "length": { "unit": "centimeters", "value": ### }, "width": { "unit": "centimeters", "value": ### }, "height": { "unit": "centimeters", "value": ### }, "marketplace_id": "ATVPDKIKX0DER" } ], "image_aspect_ratio": [ { "language_tag": "en_US", "value": "##:#", "marketplace_id": "ATVPDKIKX0DER" } ], "part_number": [ { "value": "XXX", "marketplace_id": "ATVPDKIKX0DER" } ], "includes_remote": [ { "value": true, "marketplace_id": "ATVPDKIKX0DER" } ], "item_type_name": [ { "language_tag": "en_US", "value": "TV", "marketplace_id": "ATVPDKIKX0DER" } ], "battery": [ { "cell_composition": [ { "value": "XXX" } ], "marketplace_id": "ATVPDKIKX0DER" } ], "manufacturer": [ { "language_tag": "en_US", "value": "XXX", "marketplace_id": "ATVPDKIKX0DER" } ], "number_of_boxes": [ { "value": #, "marketplace_id": "ATVPDKIKX0DER" } ], "total_usb_ports": [ { "value": #, "marketplace_id": "ATVPDKIKX0DER" } ], "model_number": [ { "value": "XXX", "marketplace_id": "ATVPDKIKX0DER" } ], "supplier_declared_dg_hz_regulation": [ { "value": "not_applicable", "marketplace_id": "ATVPDKIKX0DER" } ], "num_batteries": [ { "quantity": 2, "type": "aaa", "marketplace_id": "ATVPDKIKX0DER" } ], "california_proposition_65": [ { "compliance_type": "on_product_combined_cancer_reproductive", "marketplace_id": "ATVPDKIKX0DER" }, { "compliance_type": "chemical", "chemical_names": [ "xxx" ], "marketplace_id": "ATVPDKIKX0DER" } ], "display": [ { "resolution_maximum": [ { "unit": "pixels", "language_tag": "en_US", "value": "XX x XX" } ], "size": [ { "unit": "inches", "value":## } ], "type": [ { "language_tag": "en_US", "value": "****" } ], "marketplace_id": "ATVPDKIKX0DER" } ], "item_name": [ { "language_tag": "en_US", "value": "XXX", "marketplace_id": "ATVPDKIKX0DER" } ], "list_price": [ { "currency": "USD", "value": $$$, "marketplace_id": "ATVPDKIKX0DER" } ], "batteries_required": [ { "value": false, "marketplace_id": "ATVPDKIKX0DER" } ], "includes_rechargable_battery": [ { "value": false, "marketplace_id": "ATVPDKIKX0DER" } ], "product_site_launch_date": [ { "value": "2019-03-11T08:00:01.000Z", "marketplace_id": "ATVPDKIKX0DER" } ], "product_category": [ { "value": "50400100", "marketplace_id": "ATVPDKIKX0DER" } ], "batteries_included": [ { "value": false, "marketplace_id": "ATVPDKIKX0DER" } ], "connectivity_technology": [ { "language_tag": "en_US", "value": "Bluetooth", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "USB", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Wireless", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "HDMI", "marketplace_id": "ATVPDKIKX0DER" } ], "included_components": [ { "language_tag": "en_US", "value": "XXX", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "XXX", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "XXX", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "XXX", "marketplace_id": "ATVPDKIKX0DER" } ], "specification_met": [ { "language_tag": "en_US", "value": "", "marketplace_id": "ATVPDKIKX0DER" } ], "cpsia_cautionary_statement": [ { "value": "XXX", "marketplace_id": "ATVPDKIKX0DER" } ], "item_type_keyword": [ { "value": "XXX", "marketplace_id": "ATVPDKIKX0DER" } ], "number_of_items": [ { "value": 1, "marketplace_id": "ATVPDKIKX0DER" } ], "warranty_description": [ { "language_tag": "en_US", "value": "1 year manufacturer", "marketplace_id": "ATVPDKIKX0DER" } ], "max_resolution": [ { "unit": "pixels", "value": 8.3, "marketplace_id": "ATVPDKIKX0DER" } ], "item_package_weight": [ { "unit": "kilograms", "value": 62.142, "marketplace_id": "ATVPDKIKX0DER" } ], "supported_internet_services": [ { "language_tag": "en_US", "value": "Amazon Instant Video", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "YouTube", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Netflix", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Hulu", "marketplace_id": "ATVPDKIKX0DER" }, { "language_tag": "en_US", "value": "Browser", "marketplace_id": "ATVPDKIKX0DER" } ], "tuner_technology": [ { "language_tag": "en_US", "value": "Analog Tuner", "marketplace_id": "ATVPDKIKX0DER" } ], "wireless_communication_technology": [ { "language_tag": "en_US", "value": "Wi-Fi::Wi-Fi Direct::Bluetooth", "marketplace_id": "ATVPDKIKX0DER" } ], "model_year": [ { "value": 2019, "marketplace_id": "ATVPDKIKX0DER" } ], "power_source_type": [ { "language_tag": "en_US", "value": "Corded Electric", "marketplace_id": "ATVPDKIKX0DER" } ], "street_date": [ { "value": "2019-03-21T00:00:01Z", "marketplace_id": "ATVPDKIKX0DER" } ], "refresh_rate": [ { "unit": "hertz", "language_tag": "en_US", "value": "120", "marketplace_id": "ATVPDKIKX0DER" } ] }, "identifiers": [ { "marketplaceId": "ATVPDKIKX0DER", "identifiers": [ { "identifier": "0887276302195", "identifierType": "EAN" }, { "identifier": "00887276302195", "identifierType": "GTIN" }, { "identifier": "887276302195", "identifierType": "UPC" } ] } ], "images": [ { "marketplaceId": "ATVPDKIKX0DER", "images": [ { "variant": "MAIN", "link": "https://m.media-amazon.com/images/I/51DZzp3w3vL.jpg", "height": 333, "width": 500 } ] } ], "productTypes": [ { "marketplaceId": "ATVPDKIKX0DER", "productType": "TELEVISION" } ], "ranks": [ { "marketplaceId": "ATVPDKIKX0DER", "ranks": [ { "title": "Electronics", "link": "http://www.amazon.com/gp/bestsellers/electronics", "value": 61667 }, { "title": "QLED TVs", "link": "http://www.amazon.com/gp/bestsellers/electronics/21489946011", "value": 84 } ] } ], "summaries": [ { "marketplaceId": "ATVPDKIKX0DER", "brandName": "Samsung Electronics", "colorName": "Black", "itemName": "Samsung QN82Q60RAFXZA Flat 82-Inch QLED 4K Q60 Series (2019) Ultra HD Smart TV with HDR and Alexa Compatibility", "manufacturer": "Samsung", "modelNumber": "QN82Q60RAFXZA", "sizeName": "82-Inch", "styleName": "TV only" } ], "variations": [ { "marketplaceId": "ATVPDKIKX0DER", "asins": [ "B08J7TQ9FL" ], "variationType": "CHILD" } ], "vendorDetails": [ { "marketplaceId": "ATVPDKIKX0DER", "brandCode": "SAMF9", "categoryCode": "50400100", "manufacturerCode": "SAMF9", "manufacturerCodeParent": "SAMF9", "productGroup": "Home Entertainment", "replenishmentCategory": "OBSOLETE", "subcategoryCode": "50400150" } ] }

API Notifications

Le API des partenaires commerciaux pour les notifications vous permet de vous abonner à diverses notifications relatives à l'activité d'un partenaire commercial. Les notifications suivantes fournissent des informations utiles pour mettre en vente des objets :

  • ITEM_PRODUCT_TYPE_CHANGE: Envoyé en cas de modification du type de produit d'un article avec lequel le partenaire de vente entretient une relation de marque.
  • LISTINGS_ITEM_STATUS_CHANGE: Envoyé lorsque le statut d'une annonce change pour un partenaire de vente. Cette notification est publiée lorsqu'un article d'une annonce est créé, supprimé ou que sa capacité d'achat change.
  • LISTINGS_ITEM_ISSUES_CHANGE: Envoyé en cas de modification des problèmes liés à une annonce appartenant au partenaire vendeur. Les problèmes indiquent que l'élément de l'annonce présente des problèmes qui entraînent l'inactivation des annonces, la suppression de la recherche ou d'autres problèmes de qualité.
  • PRODUCT_TYPE_DEFINITIONS_CHANGE: Envoyé lorsqu'il existe un nouveau type de produit ou une nouvelle version de type de produit.

Pour plus d'informations sur l'abonnement aux notifications, consultez le Guide de cas d'utilisation des notifications et le createSubscription opération.


Cette page vous a-t-elle été utile ?