Structure du document ORDER lors d’une commande avec des preneurs de licence

Last modified: 1. juin 2022

Structure de l’ordre avec le licencié

La structure est la même que celle décrite dans l’article « Structure du document de commande (ORDER) d’un bon de commande« .

Pour la commande avec les données du preneur de licence, nous avons prévu la structure supplémentaire suivante pour OpenTrans ORDER :

Toutes les commandes avec des positions de licenciés ont un point commun : des données client sont nécessaires. Pour ce cas, on utilise des parties avec PARTY_ROLE customer.

Toutes les données client nécessaires : Le nom de l’entreprise, le nom de la personne à contacter, les adresses et l’adresse e-mail de contact sont enregistrés dans la customer party, p. ex :

<PARTY>
   <ns2:PARTY_ID type="buyer_specific">K100023</ns2:PARTY_ID>
   <PARTY_ROLE>customer</PARTY_ROLE>
   <ADDRESS>
      <ns2:NAME>Examplecompany</ns2:NAME>
      <CONTACT_DETAILS>
         <ns2:CONTACT_NAME>Doe</ns2:CONTACT_NAME>
         <ns2:FIRST_NAME>John</ns2:FIRST_NAME>
         <ns2:PHONE>030123456</ns2:PHONE>
         <ns2:EMAILS>
            <ns2:EMAIL>john.doe@examplecompany.com</ns2:EMAIL>
         </ns2:EMAILS>
      </CONTACT_DETAILS>
      <ns2:STREET>12 Main Street</ns2:STREET>
      <ns2:ZIP>9110</ns2:ZIP>
      <ns2:CITY>Anytown</ns2:CITY>
      <ns2:COUNTRY>USA</ns2:COUNTRY>
      <ns2:COUNTRY_CODED>US</ns2:COUNTRY_CODED>
      <ns2:PHONE type="office">+49 030/123456</ns2:PHONE>
      <ns2:FAX type="office">+49 030/1234567</ns2:FAX>
      <ns2:URL>www.examplecompany.com</ns2:URL>
   </ADDRESS>
</PARTY>

Il peut y avoir plusieurs customer party, car une commande peut éventuellement contenir plusieurs positions de licenciés et chaque position pour laquelle un licencié est enregistré, une référence au customer party est enregistrée.

Pour les commandes normales de matériel, une entrée CUSTOMER_ORDER_REFERENCE par position n’est pas nécessaire. Pour les positions avec preneur de licence, elle est obligatoire pour enregistrer une référence au customer party, par ex.

<ORDER_ITEM>
   …
   <CUSTOMER_ORDER_REFERENCE>
      <!--Référence à la partie du client final, pour ses coordonnées et son email -->
      <CUSTOMER_IDREF type="buyer_specific">K100023</CUSTOMER_IDREF>
   </CUSTOMER_ORDER_REFERENCE>
</ORDER_ITEM>

Commandes avec positions ESD

En plus des données du preneur de licence mentionnées ci-dessus, une position ESD doit être identifiée au sein d’une commande par un <PRODUCT_TYPE>esd</PRODUCT_TYPE>. Le ProductType peut être déterminé à l’aide du famille de produit (contractTypeId) dans les formats de données API/Export. L’e-mail ESD est lu directement depuis le Customer Party dans les Contact_Details à partir du champ XML <ns2:EMAIL>.

   
<ORDER_ITEM>
   …
       <PRODUCT_ID>
            <ns2:SUPPLIER_PID type="supplier_specific">Numéro d'article chez le fournisseur</ns2:SUPPLIER_PID>
            ...
            <ns2:PRODUCT_TYPE>esd</ns2:PRODUCT_TYPE>
       </PRODUCT_ID>
 …
</ORDER_ITEM> 

Commandes avec postes de service

Les produits de services comprennent par exemple les eCare Packs, le support, les échanges et les services tels que : HP eCare Pack, Fujitsu Support Services, Garantie, Maintenance, Lenovo Carepacks. En plus des données du licencié mentionnées ci-dessus, une position de service dans une commande doit être identifiée par un <PRODUCT_TYPE>service</PRODUCT_TYPE>. Le ProductType peut être déterminé à l’aide de la famille de produits (contractTypeId) dans les formats de données API/export. L’e-mail du client du destinataire du service est directement extrait du Customer Party dans les Contact_Details à partir du champ XML <ns2:EMAIL>. En outre, l’adresse complète du client et les contacts du client sont également transmis aux fournisseurs à partir du Customer Party. En cas de besoin, le fournisseur peut alors transmettre toutes les données nécessaires au fabricant de services concerné.

   
<ORDER_ITEM>
   …
       <PRODUCT_ID>
            <ns2:SUPPLIER_PID type="supplier_specific">Numéro d'article chez le fournisseur</ns2:SUPPLIER_PID>
            ...
            <ns2:PRODUCT_TYPE>service</ns2:PRODUCT_TYPE>
       </PRODUCT_ID>
 …
</ORDER_ITEM> 

Commandes de services et de licences avec paramètres contractuels

Pour certains produits de service et de licence, des paramètres supplémentaires peuvent être indiqués lors de la commande, en fonction du distributeur. Ces informations aident le distributeur à traiter la commande plus rapidement et sans demande supplémentaire. Une liste des distributeurs et des familles de produits pour lesquels c’est le cas se trouve sur cette page d’aide.

Les paramètres nécessaires sont indiqués dans l’exportation de produits (standard et developer) au niveau de la source d’approvisionnement (<supplierItem> et <contractParameters>) et ne sont valables que pour le distributeur indiqué :

<product>
    ...
    <supplierItems>
      ...
      <supplierItem>
        ...
        <contractParameters>
          <contractParameter>
            <displayName>Date d'achat du matériel (format YYYY-MM-DD, exemple 2022-04-06)</displayName>
            <orderParameterName>purchaseDate</orderParameterName>
            <mandatory>true</mandatory>
            <example>2022-04-06</example>
          </contractParameter>
          <contractParameter>
            <displayName>Numéro de série du matériel. Si commandé avec le matériel, indiquer "same"</displayName>
            <orderParameterName>serial</orderParameterName>
            <mandatory>true</mandatory>
          </contractParameter>
        </contractParameters>
        <projects/>
      </supplierItem>
    </supplierItems>
  </product>

Ces paramètres peuvent être indiqués dans la commande OpenTrans pour la position dans le champ <CONTRACT_INFORMATION> sous <PARAMETERS> avec la valeur correspondante.

   
<ORDER_ITEM>
   …
         <CONTRACT_INFORMATION>
            <PARAMETERS>
               <PARAMETER type="purchaseDate">2022-04-12</PARAMETER>
               <PARAMETER type="serial">same</PARAMETER>
            </PARAMETERS>
         </CONTRACT_INFORMATION>
 …
</ORDER_ITEM> 

Télécharger des exemples

Ordres ESD

Les fichiers sont accompagnés de commentaires HTML afin de mieux comprendre la structure d’un ORDER. Ce fichier sert également de fichier de référence pour l’envoi test d’une commande ESD via la méthode business/deals/send de l’API ITscope au Partner Test DistributorId 10000735.

Example_ESD_ORDER_Testdistributor_Bestellung_1Party_ESD_only.xml

  • Une position ESD est commandée (ItemId 1) pour le client K100023. Les données du preneur de licence pour le fabricant peuvent être lues à partir de la customer party correspondante dans le LINE_ITEM correspondant, tout comme l’email ESD nécessaire à partir des données de contact du preneur de licence dans le champ <ns2:Email>.

 Example_ESD_ORDER_Testdistributor_Bestellung_1Party_ESD_and_Hardware.xml

  • Deux positions sont commandées,
  • une position (ItemId2) est une position ESD pour le client K100023. Les données du preneur de licence pour le fabricant peuvent être lues à partir de la customer Party correspondante dans le LINE_ITEM correspondant, tout comme l’email Esd nécessaire à partir des données de contact du preneur de licence dans le champ <ns2:Email>
  • une position (ItemId1) est une position de matériel qui, dans ce cas, est livrée par son propre bon de livraison (UDX.DROPSHIPMENT = true) au delivery party. Dans cette position, il n’y a pas d’entrée <PRODUCT_TYPE> ni de référence à un customer party.

Commandes de services et de licences avec paramètres contractuels

Example_Service_ORDER_Testdistributor_Bestellung.xml

Il s’agit d’une commande avec un poste de service dont les paramètres contractuels sont déjà remplis.

Was this article helpful?
Dislike 0
Views: 40