Différences entre API 2.1 et API 2.0

Last modified: 8. avril 2022

L’API 2.1 comporte les mêmes méthodes dans tous les domaines (produits, métadonnées, entreprises) que l’API 2.0.

Toutefois, il existe certaines différences dans les champs des formats de données ou dans le comportement de l’API elle-même.

Voici un aperçu des changements.

products/ méthode

Les formats de données « developerupdate« , « standardupdate » n’ont pas changé dans l’API 2.1. Les formats de données « developer » et « standard » ont été étendus par certains champs.

Dans la section « product » (developer, standard), les champs suivants sont nouveaux :

  • eClassV7 : eClass Version 7.0
  • customsTariffNumber : ce champ a seulement été déplacé vers un nouvel emplacement dans le document
  • UNSPSC : code de classification de l’UNSPSC
  • productName : a été renommé, il s’agissait auparavant de l’appellation « productNameWithManufacturer ». A le même contenu dans l’API 2.1 que dans l’API 2.0, mais peut être configuré via l’exportation
  • colorFamilyId : Id de la famille de couleur (couleur normalisée)
  • colorFamily : famille de couleurs (couleur normalisée), par exemple gris au lieu de gris espace ou gris souris
  • combinedLengthAndGirth : circonférence
  • netWeight : poids net
  • netDimX : mesure nette X
  • netDimY : mesure nette Y
  • netDimZ : mesure nette Z
  • valueAddedTaxGermany : taux de TVA allemand
  • energyEfficiencyClass : classe d’efficacité énergétique
  • keySellingPoints : principaux points de vente
  • packageContents : étendue de la prestation
  • productFeatures : caractéristiques du produit
  • htmlMainSpecs : caractéristiques techniques du produit sous forme abrégée, séparées par des étiquettes br
  • image1 renommée en imageHighRes1
  • contractTypeId : le famille de produit pour les produits de licence et de service
  • contractTypeName : le nom du famille de produit pour les produits de licence et de service

Les champs suivants sont nouveaux dans la section « supplierItem » (developer, standard) :

  • contractTypeId : le famille de produit pour les produits de licence, de service, de CTO et de pièces détachées
  • contractTypeName : le nom du famille de produit pour les produits de licence, de service, de CTO et de pièces détachées

Les champs suivants sont nouveaux dans la section « attribute » (standard) :

  • value : la valeur de base (voir aussi unité de base) de la propriété, pour le texte en tant qu’élément de texte, pour les nombres en tant que plus petite spécification

La section « historicalDataItem » (developer, standard) est entièrement nouvelle et contient des données historiques.

business/deals/search méthode

Les commandes (deals) peuvent également être recherchées dans l’API 2.1 à l’aide de l’ID du panier (cartId). Lors de la recherche d’un ou plusieurs identifiants de chariot, toutes les affaires contenues dans ces chariots sont chargées.

Le champ suivant a été ajouté au format de données carts dans l’API 2.1 :

  • cartId : ID du panier d’achat de l’affaire dans laquelle se trouve la commande

Les ID des paniers sont spécifiés via le paramètre Filter, par exemple :

cartId=9d40ec2e-19bb-4126-9231-43a01ce675dd

Le panier d’achat partagé a l’ID « pool ». Ainsi, par exemple, nous pouvons récupérer le panier d’achat partagé et un autre panier d’achat comme suit :

cartId=9d40ec2e-19bb-4126-9231-43a01ce675dd,pool
Was this article helpful?
Dislike 0
Views: 41