11.3. Bestellung erzeugen (Transaktion: Order, Operation: CreateOrder)

11.3. Bestellung erzeugen (Transaktion: Order, Operation: CreateOrder)
Zurück	11. Beispiele	Weiter

Der Käufer erzeugt eine neue Bestellung. Hierzu werden an die URL http://b2b.beispielserver.com/ mittels der POST-Methode des HTTP-Protokolls folgende Daten vom Medientyp application/xml übertragen:

<?xml version="1.0" encoding="iso-8859-1" ?>
<CreateOrderRequest  xmlns="urn:veloconnect:order-1.0"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-1.0"
xmlns:cac=
"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-1.0"
xmlns:vct="urn:veloconnect:transaction-1.0">
  <vct:BuyersID>B127645</vct:BuyersID>
  <vct:Credential><vct:Password>secret</vct:Password></vct:Credential>
  <OrderRequestLine>
      <cac:SellersItemIdentification>
	<cac:ID>42213526300</cac:ID>
      </cac:SellersItemIdentification>
      <cbc:Quantity quantityUnitCode="EA">500</cbc:Quantity>
      <cac:BuyersItemIdentification>
	<cac:ID>7285</cac:ID>
      </cac:BuyersItemIdentification>
  </OrderRequestLine>
  <OrderRequestLine>
      <cac:SellersItemIdentification>
	<cac:ID>42038057500</cac:ID>
      </cac:SellersItemIdentification>
      <cbc:Quantity quantityUnitCode="EA">20</cbc:Quantity>
      <cac:BuyersItemIdentification>
	<cac:ID>7290</cac:ID>
      </cac:BuyersItemIdentification>
  </OrderRequestLine>
  <OrderRequestLine>
      <cac:SellersItemIdentification>
	<cac:ID>52090311600</cac:ID>
      </cac:SellersItemIdentification>
      <cbc:Quantity quantityUnitCode="MTR">100</cbc:Quantity>
      <cac:BuyersItemIdentification>
	<cac:ID>7295</cac:ID>
      </cac:BuyersItemIdentification>
  </OrderRequestLine>
</CreateOrderRequest>

Alternativ dazu könnte auch folgende URL abgerufen werden

http://b2b.beispielserver.com/?BuyersID=127654&Password=secret
&RequestName=CreateOrderRequest
&Quantity.42213526300=500&quantityUnitCode.42213526300=EA
&BuyersItemIdentification.42213526300=7285
&Quantity.42038057500=20&quantityUnitCode.42038057500=EA
&BuyersItemIdentification.42038057500=7290
&Quantity.52090311600=100&quantityUnitCode.52090311600=MTR
&BuyersItemIdentification.52090311600=7295

(Zeilenumbrüche nur zur besseren Lesbarkeit!) bzw. an die URL http://b2b.beispielserver.com/ mittels der POST-Methode des HTTP-Protokolls folgende Daten vom Medientyp application/x-www-form-urlencoded übermittelt werden:

BuyersID=127654&Password=secret&RequestName=CreateOrderRequest
&Quantity.42213526300=500&quantityUnitCode.42213526300=EA
&BuyersItemIdentification.42213526300=7285
&Quantity.42038057500=20&quantityUnitCode.42038057500=EA
&BuyersItemIdentification.42038057500=7290
&Quantity.52090311600=100&quantityUnitCode.52090311600=MTR
&BuyersItemIdentification.52090311600=7295

(Zeilenumbrüche nur zur besseren Lesbarkeit!).

Die Antwort des Servers sieht beispielsweise so aus:

<?xml version="1.0" encoding="iso-8859-1" ?>
<OrderResponse  xmlns="urn:veloconnect:order-1.0"
xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-1.0"
xmlns:cac=
"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-1.0"
xmlns:vct="urn:veloconnect:transaction-1.0">
<vct:BuyersID>B127645</vct:BuyersID>
<vct:ResponseCode>200</vct:ResponseCode>
<vct:TransactionID>order-1</vct:TransactionID>
<vct:StatusCode>2</vct:StatusCode>
<OrderResponseLine>
  <cbc:Quantity quantityUnitCode="PK">5</cbc:Quantity>
  <cac:Item>
     <cbc:Description>Speichen DD 2,0x1,8x 263 mm, silber
Race,Niro, mit Messingnippel</cbc:Description>
     <cbc:PackQuantity quantityUnitCode="EA">100</cbc:PackQuantity>
     <cac:BuyersItemIdentification>
	<cac:ID>7285</cac:ID>
     </cac:BuyersItemIdentification>
     <cac:SellersItemIdentification>
       <cac:ID>42213526300</cac:ID>
     </cac:SellersItemIdentification>
     <cac:StandardItemIdentification>
       <cac:ID identificationSchemeID="EAN/UCC-13">4032191511108</cac:ID>
     </cac:StandardItemIdentification>
     <cac:BasePrice>
        <cbc:PriceAmount amountCurrencyID="EUR">34.90</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="PK">1</cbc:BaseQuantity>
     </cac:BasePrice>
     <cac:BasePrice>
        <cbc:PriceAmount amountCurrencyID="EUR">29.50</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="PK">1</cbc:BaseQuantity>
	<cbc:MinimumQuantity quantityUnitCode="PK">5</cbc:MinimumQuantity>
     </cac:BasePrice>
     <cac:RecommendedRetailPrice>
        <cbc:PriceAmount amountCurrencyID="EUR">0.70</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="EA">1</cbc:BaseQuantity>
     </cac:RecommendedRetailPrice>
  </cac:Item>
  <cac:UnitPrice amountCurrencyID="EUR">29.50</cac:UnitPrice>
  <Availability>
      <Code>available</Code>
  </Availability>
</OrderResponseLine>
<OrderResponseLine>
  <cbc:Quantity quantityUnitCode="PK">2</cbc:Quantity>
  <cac:Item>
     <cbc:Description>Bremsinnenzug 1800 mm mit Quernippel</cbc:Description>
     <cbc:PackSizeNumeric>10</cbc:PackSizeNumeric>
     <cac:BuyersItemIdentification>
	<cac:ID>7290</cac:ID>
     </cac:BuyersItemIdentification>
     <cac:SellersItemIdentification>
       <cac:ID>42038057500</cac:ID>
     </cac:SellersItemIdentification>
     <cac:StandardItemIdentification>
       <cac:ID identificationSchemeID="EAN/UCC-13">4032191018164</cac:ID>
     </cac:StandardItemIdentification>
     <cac:BasePrice>
        <cbc:PriceAmount amountCurrencyID="EUR">5.5</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="PK">1</cbc:BaseQuantity>
     </cac:BasePrice>
     <cac:BasePrice>
        <cbc:PriceAmount amountCurrencyID="EUR">4.8</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="PK">1</cbc:BaseQuantity>
	<cbc:MinimumQuantity quantityUnitCode="PK">2</cbc:MinimumQuantity>
     </cac:BasePrice>
     <cac:BasePrice>
        <cbc:PriceAmount amountCurrencyID="EUR">4.5</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="PK">1</cbc:BaseQuantity>
	<cbc:MinimumQuantity quantityUnitCode="PK">5</cbc:MinimumQuantity>
     </cac:BasePrice>
     <cac:RecommendedRetailPrice>
        <cbc:PriceAmount amountCurrencyID="EUR">0.99</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="EA">1</cbc:BaseQuantity>
     </cac:RecommendedRetailPrice>
  </cac:Item>
  <cac:UnitPrice amountCurrencyID="EUR">4.80</cac:UnitPrice>
  <Availability>
      <Code>available</Code>
  </Availability>
</OrderResponseLine>
<OrderResponseLine>
  <cbc:Quantity quantityUnitCode="PK">4</cbc:Quantity>
  <cac:Item>
     <cbc:Description>Shimano Bremsaußenhülle M-System grau</cbc:Description>
     <cbc:PackQuantity quantityUnitCode="MTR">30</cbc:PackQuantity>
     <cac:BuyersItemIdentification>
	<cac:ID>7295</cac:ID>
     </cac:BuyersItemIdentification>
     <cac:SellersItemIdentification>
       <cac:ID>52090311600</cac:ID>
     </cac:SellersItemIdentification>
     <cac:StandardItemIdentification>
       <cac:ID identificationSchemeID="EAN/UCC-13">4032191282381</cac:ID>
     </cac:StandardItemIdentification>
     <cac:BasePrice>
        <cbc:PriceAmount amountCurrencyID="EUR">0.96</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="MTR">1</cbc:BaseQuantity>
     </cac:BasePrice>
     <cac:BasePrice>
        <cbc:PriceAmount amountCurrencyID="EUR">0.87</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="MTR">1</cbc:BaseQuantity>
	<cbc:MinimumQuantity quantityUnitCode="MTR">60</cbc:MinimumQuantity>
     </cac:BasePrice>
     <cac:BasePrice>
        <cbc:PriceAmount amountCurrencyID="EUR">0.79</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="MTR">1</cbc:BaseQuantity>
	<cbc:MinimumQuantity quantityUnitCode="MTR">90</cbc:MinimumQuantity>
     </cac:BasePrice>
     <cac:RecommendedRetailPrice>
        <cbc:PriceAmount amountCurrencyID="EUR">1.77</cbc:PriceAmount>
	<cbc:BaseQuantity quantityUnitCode="MTR">1</cbc:BaseQuantity>
     </cac:RecommendedRetailPrice>
  </cac:Item>
  <cac:UnitPrice amountCurrencyID="EUR">23.70</cac:UnitPrice>
  <Availability>
      <Code>partially_available</Code>
      <AvailableQuantity quantityUnitCode="PK">2</AvailableQuantity>
      <cac:ItemReplacement>
	  <cac:ID>52090311000</cac:ID>
	  <cac:ReplacementCode>recommended</cac:ReplacementCode>
	  <cbc:Description>Shimano Bremsaußenhülle M-System schwarz</cbc:Description>
      </cac:ItemReplacement>
  </Availability>
</OrderResponseLine>
</OrderResponse>

Hieran ist folgendes zu erkennen:

Die erzeugte Transaktionsinstanz hat die TransactionID order-1.
Die Transaktion befindet sich im Zustand 2, d.h. im Updatezustand.
Jeder Artikel wird in einer bestimmten Packungsgröße verkauft; die Speichen zu je 100 Stück, die Bremsinnenzüge zu je 10 Stück und die Bremsaußenhülle zu Rollen je 30 Meter.
Bei der Bremsaußenhülle wurde die Bestellmenge von 100 Meter auf 4 Rollen, d.h. 120 Meter, aufgerundet. Bei den anderen beiden Artikeln wurden die Bestellmengen ohne Änderung in die entsprechende Anzahl von Packungen umgerechnet.
Von der Bremsaußenhülle sind nur zwei Rollen lieferbar, es wird empfohlen, an Stelle der grauen die schwarze Bremsaußenhülle zu bestellen.
Die Staffelpreise und die empfohlenen Verkaufspreise beziehen sich teilweise nicht auf die Einheit, in der die Bestellmenge angegeben ist.
Das System des Verkäufers liefert die übertragenen internen Artikelnummern des Käufers zurück.

Zurück	Nach oben	Weiter
11.2. Abfrage von Artikeldetails (Operation: GetItemDetails)	Zum Anfang	11.4. Bestellung ändern (Transaktion: Order, Operation: UpdateOrder)