Structure du document de commande (ORDER) d’un bon de commande

Last modified: 14. mars 2022

Structure de la commande

Notre système reçoit les commandes exclusivement dans un format OpenTrans version 2.1 valide pour xsd.

Description des éléments individuels de la commande

Numéro de commande (ORDER_ID):

  • Numéro de commande unique, longueur maximale : 18 caractères.
<ORDER_INFO>
  <!-- Numéro de commande unique du client -->
  <ORDER_ID>ORDER_180801-004</ORDER_ID>

Participants (PARTIES):

  • Distributeur en tant que fournisseur avec le PartyID qui est enregistré dans votre système pour le distributeur
  • Acheteur, c’est-à-dire destinataire de la facture PARTY_ROLE->buyer avec la PartyID qui est enregistrée dans votre système comme numéro de client pour l’acheteur chez le distributeur
  • Le destinataire (delivery) peut être différent de l’acheteur, éventuellement en raison d’une livraison directe.
<!-- OBLIGATOIRE : L'adresse de livraison de la commande -->
<PARTY>
  <ns2:PARTY_ID type="supplier_specific">123456</ns2:PARTY_ID>
  <PARTY_ROLE>delivery</PARTY_ROLE>
  <ADDRESS>
    <!-- OBLIGATOIRE : Nom de l'entreprise -->
    <ns2:NAME>ITscope GmbH</ns2:NAME>
    <!-- Complément d'adresse 1 -->
    <ns2:NAME2>5e étage</ns2:NAME2>
    <!-- Complément d'adresse 2 -->
    <ns2:NAME3>à l'attention de Peter Müller</ns2:NAME3>
    <CONTACT_DETAILS>
      <ns2:CONTACT_NAME>Support</ns2:CONTACT_NAME>
      <ns2:FIRST_NAME>ITscope</ns2:FIRST_NAME>
      <ns2:PHONE type="office">+49 721/6273760</ns2:PHONE>
      <ns2:EMAILS>
        <ns2:EMAIL>support@itscope.com</ns2:EMAIL>
      </ns2:EMAILS>
    </CONTACT_DETAILS>
    <ns2:STREET>Ludwig-Erhard-Allee 20</ns2:STREET>
    <ns2:ZIP>76131</ns2:ZIP>
    <ns2:CITY>Karlsruhe</ns2:CITY>
    <ns2:COUNTRY>Deutschland</ns2:COUNTRY>
    <ns2:COUNTRY_CODED>DE</ns2:COUNTRY_CODED>
  </ADDRESS>
</PARTY>

Livraison partielle (PARTIAL_SHIPMENT_ALLOWED):

  • Définissez ce champ si la commande doit être envoyée en livraisons partielles
  • Le champ est défini comme un champ obligatoire dans OpenTrans, donc préréglé avec false.
<!-- Marquage si la livraison partielle est autorisée -->
<PARTIAL_SHIPMENT_ALLOWED>true</PARTIAL_SHIPMENT_ALLOWED>

Date de livraison (DELIVERY_DATE):

  • Cochez cette case si vous souhaitez que la commande soit envoyée avec une date de livraison fixe ou souhaitée
  • L’attribut type= »fixed » indique qu’il s’agit d’une date de livraison fixe, la valeur type= »optional » indique qu’il s’agit d’une date de livraison souhaitée.
<DELIVERY_DATE type="fixed">
  <DELIVERY_START_DATE>2021-10-22T00:00:00</DELIVERY_START_DATE>
  <DELIVERY_END_DATE>2021-10-22T00:00:00</DELIVERY_END_DATE>
</DELIVERY_DATE>

Expédition avec son propre bon de livraison (UDX.DROPSHIPMENT):

  • Ce champ doit être renseigné si l’on souhaite un envoi avec son propre bon de livraison. Ce bon de livraison peut être demandé au fournisseur concerné. Des frais peuvent être engagés. Par conséquent, il convient de coordonner au préalable avec le distributeur.
<HEADER_UDX>
  <!-- Le propre bon de livraison doit être utilisé (true) / ne doit PAS être utilisé (false) -->
  <UDX.DROPSHIPMENT>true</UDX.DROPSHIPMENT>
</HEADER_UDX>

Référence de la commande du client final (CUSTOMER_ORDER_REFERENCE -> ORDER_ID):

  • Ce champ est le numéro que le client final reçoit comme numéro de commande
  • Ce champ est facultatif.
<CUSTOMER_ORDER_REFERENCE>
<!-- Référence de commande du client final (le numéro que le client final reçoit comme numéro de commande) -->
  <ORDER_ID>BESTELLUNG_019203</ORDER_ID>
</CUSTOMER_ORDER_REFERENCE>

Numéro de produit du distributeur (SUPPLIER_PID type= »supplier_specific »):

  • Ce numéro est le numéro d’article unique du distributeur. Nous utilisons ce numéro pour rechercher l’article à commander.
<!-- Numéro d'article du fournisseur - champ obligatoire -->
<ns2:SUPPLIER_PID type="supplier_specific">123002</ns2:SUPPLIER_PID>

ITscope PUID (INTERNATIONAL_PID type= »itscope »):

  • Ce numéro est l’identifiant du produit ITscope. Ce numéro est une référence unique au produit ITscope.
<!-- ID produit ITscope - champ non obligatoire -->
<ns2:INTERNATIONAL_PID type="itscope">6676919000</ns2:INTERNATIONAL_PID>

Numéro d’offre en cas de commande faisant référence à un devis (QUOTATION_ID) :

  • Il s’agit du numéro d’offre unique pour un devis particulier du fournisseur. Il est indiqué au niveau du poste.
<!-- Référence de devis fournisseur -->
<SOURCING_INFO>
<!-- Numéro de devis du distributeur - obligatoire -->
  <QUOTATION_ID>1040104240</QUOTATION_ID>
</SOURCING_INFO>

Numéro de projet pour la commande de projet (AGREEMENT_ID):

  • Ce numéro est le numéro de projet du fabricant pour une commande de projet. Sur la base de ce nombre, la distribution peut réserver les articles corrects pour le projet auprès du fabricant.
<!-- Conditions pour le prix du projet -->
<SOURCING_INFO>
<!-- Numéro de projet/de devis du distributeur - champ non obligatoire -->
  <QUOTATION_ID>1040104240</QUOTATION_ID>
  <AGREEMENT>
    <!-- Numéro de projet du fabricant - champ obligatoire pour que le fournisseur puisse attribuer le prix du projet -->
    <ns2:AGREEMENT_ID>HPPSK1234500</ns2:AGREEMENT_ID>
    <!-- Période pendant laquelle les conditions du projet sont valables -->
    <ns2:AGREEMENT_START_DATE>2018-09-05T00:00:00</ns2:AGREEMENT_START_DATE>
    <ns2:AGREEMENT_END_DATE>2019-12-31T00:00:00</ns2:AGREEMENT_END_DATE>
    <!-- Client final de l'article de projet -->
    <AGREEMENT_DESCR>Ville de Karlsruhe</AGREEMENT_DESCR>
  </AGREEMENT>
</SOURCING_INFO>

Télécharger des exemples de fichiers de commande

Les exemples de fichiers sont fournis avec des commentaires XML afin de mieux comprendre la structure d’une commande (ORDER). Ces fichiers peuvent également être utilisés comme fichier de référence pour tester l’envoi d’une commande via la méthode ITscope API business/deals/send au « Partner Test » DistributorId 10000735.

Le fichier Example_ORDER_Testdistributor_Bestellung.xml est un commande d’achat normal.

Le fichier Example_ORDER_Testdistributor_Bestellung_Eigener_Lieferschein.xml est un bon de commande de livraison directe avec son propre bon de livraison.

Le fichier Example_ORDER_Testdistributor_Bestellung_Projekt.xml est un bon de commande avec un prix de projet. La troisième position contient les conditions du projet à titre d’exemple. L’exemple montre également que les prix « normaux » et les prix des projets ou même des projets différents peuvent être mélangés dans une même commande, puisque le projet est spécifié article par article.

Was this article helpful?
Dislike 0
Views: 206