PromoStandards Attraction

Product Data 2.0.0

Descriptions des produits, variantes, paliers de prix publics et identifiants des produits offerts.

• Adresse : ProductData/2.0.0/
• Contrat : WSDL Product Data

Inventory 2.0.0

Stocks par variante de produit, avec filtres par identifiant de variante, couleur et taille.

• Adresse : Inventory/2.0.0/
• Contrat : WSDL Inventory

Media Content 1.1.0

URL des médias produits, avec filtres par type de média, variante et classification.

• Adresse : MediaContent/1.1.0/
• Contrat : WSDL Media Content

Product Pricing and Configuration 1.0.0

Paliers de prix publics et nets standards A3 par variante, avec les devises offertes au point d'expédition. Le chemin de ce service est PPC.

• Adresse : PPC/1.0.0/
• Contrat : WSDL Pricing and Configuration

Product Data

• getProductSellable : envoyez isSellable=true pour obtenir les produits et les variantes offerts. Les filtres facultatifs sont productId, partId et lineName. Précisez localizationCountry et localizationLanguage selon le marché visé.
• getProduct : exige productId, localizationCountry et localizationLanguage. Les filtres facultatifs sont partId, colorName et ApparelSizeArray.
• getProductDateModified : exige changeTimeStamp et renvoie les identifiants des produits modifiés strictement après cette date. Utilisez un horodatage ISO 8601 avec fuseau horaire, puis récupérez les fiches à jour.
• getProductCloseOut : renvoie actuellement une liste de liquidation vide.

Inventory

• getFilterValues : exige productId et renvoie les identifiants de variantes, les tailles et les couleurs utilisables pour filtrer les stocks.
• getInventoryLevels : exige productId. Le paramètre facultatif Filter accepte partIdArray, LabelSizeArray et PartColorArray. Interprétez la disponibilité selon les règles de stock.

Media Content

• getMediaContent : exige productId et mediaType (Image, Video, Audio ou Document). Les filtres facultatifs sont partId et classType; cultureName précise le marché. Un filtre de variante sélectionne les médias de sa couleur et ceux communs au produit.
• getMediaDateModified : exige changeTimeStamp et renvoie les identifiants des produits et des variantes dont les médias ont changé strictement après cette date. Utilisez un horodatage ISO 8601 avec fuseau horaire.

Un type de média valide peut renvoyer une liste vide si aucun contenu ne correspond. Media Content 1.1.0 utilise les espaces de noms 1.0.0 de son WSDL officiel. Gardez wsVersion=1.1.0 sans modifier la version des espaces de noms.

Pricing and Configuration

• getFobPoints : envoyez productId pour obtenir l'identifiant du point d'expédition et les devises publiées pour ce produit. Réutilisez le fobId reçu dans les requêtes de prix.
• getConfigurationAndPricing : exige productId, currency, fobId, priceType, localizationCountry, localizationLanguage et configurationType. partId est facultatif. Utilisez priceType=List pour les prix publics ou priceType=Net pour les prix nets standards A3, avec configurationType=Blank.
• getAvailableLocations, getAvailableCharges et getDecorationColors : renvoient des réponses vides pour les produits valides. Les configurations et les prix de décoration ne sont pas publiés par ce service.

Trouver les identifiants des produits offerts

Adresse Product Data; SOAPAction: "getProductSellable".

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:svc="http://www.promostandards.org/WSDL/ProductDataService/2.0.0/"
  xmlns:shar="http://www.promostandards.org/WSDL/ProductDataService/2.0.0/SharedObjects/">
  <soap:Body>
    <svc:GetProductSellableRequest>
      <shar:wsVersion>2.0.0</shar:wsVersion>
      <shar:id>YOUR_ID</shar:id>
      <shar:password>YOUR_PASSWORD</shar:password>
      <shar:localizationCountry>CA</shar:localizationCountry>
      <shar:localizationLanguage>en</shar:localizationLanguage>
      <shar:isSellable>true</shar:isSellable>
    </svc:GetProductSellableRequest>
  </soap:Body>
</soap:Envelope>

Lire les stocks d'un produit

Adresse Inventory; SOAPAction: "getInventoryLevels".

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:svc="http://www.promostandards.org/WSDL/Inventory/2.0.0/"
  xmlns:shar="http://www.promostandards.org/WSDL/Inventory/2.0.0/SharedObjects/">
  <soap:Body>
    <svc:GetInventoryLevelsRequest>
      <shar:wsVersion>2.0.0</shar:wsVersion>
      <shar:id>YOUR_ID</shar:id>
      <shar:password>YOUR_PASSWORD</shar:password>
      <shar:productId>PRODUCT_ID</shar:productId>
    </svc:GetInventoryLevelsRequest>
  </soap:Body>
</soap:Envelope>

Lire les images d'un produit

Adresse Media Content; SOAPAction: "getMediaContent".

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:svc="http://www.promostandards.org/WSDL/MediaService/1.0.0/"
  xmlns:shar="http://www.promostandards.org/WSDL/MediaService/1.0.0/SharedObjects/">
  <soap:Body>
    <svc:GetMediaContentRequest>
      <shar:wsVersion>1.1.0</shar:wsVersion>
      <shar:id>YOUR_ID</shar:id>
      <shar:password>YOUR_PASSWORD</shar:password>
      <shar:cultureName>en-CA</shar:cultureName>
      <shar:mediaType>Image</shar:mediaType>
      <shar:productId>PRODUCT_ID</shar:productId>
    </svc:GetMediaContentRequest>
  </soap:Body>
</soap:Envelope>

Lire les paliers de prix publics

Adresse PPC; SOAPAction: "getConfigurationAndPricing". Remplacez FOB_ID par l'identifiant reçu de getFobPoints et choisissez une devise que cette opération indique pour le produit. L'exemple demande les prix publics; utilisez priceType=Net pour obtenir les prix nets standards A3 lorsqu'ils sont publiés pour ce produit et cette devise.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:svc="http://www.promostandards.org/WSDL/PricingAndConfiguration/1.0.0/"
  xmlns:shar="http://www.promostandards.org/WSDL/PricingAndConfiguration/1.0.0/SharedObjects/">
  <soap:Body>
    <svc:GetConfigurationAndPricingRequest>
      <shar:wsVersion>1.0.0</shar:wsVersion>
      <shar:id>YOUR_ID</shar:id>
      <shar:password>YOUR_PASSWORD</shar:password>
      <shar:productId>PRODUCT_ID</shar:productId>
      <shar:currency>CAD</shar:currency>
      <shar:fobId>FOB_ID</shar:fobId>
      <shar:priceType>List</shar:priceType>
      <shar:localizationCountry>CA</shar:localizationCountry>
      <shar:localizationLanguage>en</shar:localizationLanguage>
      <shar:configurationType>Blank</shar:configurationType>
    </svc:GetConfigurationAndPricingRequest>
  </soap:Body>
</soap:Envelope>

Langues et marchés

Product Data et PPC acceptent localizationLanguage=en avec localizationCountry=CA ou US. Les données produits en français ne sont pas disponibles dans PromoStandards actuellement. Product Data renvoie le catalogue publié pour le pays choisi.

Pour Media Content, utilisez cultureName=en-CA ou en-US. Sans ce paramètre, le service utilise l'anglais américain. Le français n'est pas pris en charge. Inventory n'accepte pas de paramètre de langue ou de pays.

Prix

Product Data publie les grilles de prix publics MSRP. Dans PPC, priceType=List renvoie les prix publics et priceType=Net renvoie la grille nette standard A3 lorsqu'elle est disponible pour le produit et la devise. Si la grille nette est absente, le service signale que le type de prix demandé n'est pas disponible.

Les identifiants PromoStandards ne sélectionnent pas le palier de votre compte. La grille A3 est commune aux intégrations; elle ne représente pas les prix nets personnalisés de votre compte. priceType=Customer n'est pas pris en charge. PPC accepte uniquement la configuration Blank; Decorated n'est pas pris en charge.

Les lettres de rabais accompagnent uniquement les prix List. Les prix Net sont déjà des montants nets et ne comportent pas de lettre de rabais.

Demandez CAD ou USD seulement si le produit possède une grille publiée dans cette devise. getFobPoints indique les devises disponibles; localizationCountry ne convertit pas les prix et ne crée pas de grille manquante. Utilisez les paliers et les prix par taille renvoyés par le service, et respectez les dates d'expiration publiées.

Stocks et produits sans quantité en stock

Pour les produits Ethica à blocs de couleurs faits sur commande et les produits hyper custom Jameo, Inventory renvoie manufacturedItem=true et buyToOrder=true, sans quantityAvailable. Product Data indique isOnDemand=true pour chaque variante.

Une quantité absente ne signifie ni un stock nul ni une promesse chiffrée de stock illimité. Conservez ces indicateurs lors de l'importation. D'autres variantes peuvent aussi omettre quantityAvailable lorsqu'aucune quantité n'est disponible; ne remplacez pas cette absence par zéro. Inventory ne publie pas replenishmentLeadTime actuellement.