Order via online (Transaction: OrderInOnlineShop)

The following scenario is assumed: The buyer has already placed an item in the shopping cart at the vendor's online shop, and has created an order with additional items in their own merchandise management system. These two orders are to be synchronized and completed. For this, the client uses the OrderInOnlineShop transaction. First, they issue the following request

https://shop.beispielserver.com/vc_order.jsp?BuyersID=127654&Password=secret&RequestName=ViewOrderRequest&TransactionId=online-basket

to obtain information on the shopping cart's contents. The different URL and TransactionID have been derived from the server's Veloconnect profile.

The following response is returned:

<?xml version="1.0" encoding="iso-8859-1" ?>
<OrderResponse  xmlns="urn:veloconnect:order-1.1"
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>online-basket</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">10</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>
</OrderResponse>

By comparison with own master data or by querying the user, the client determines the internal item number and inserts the shopping cart's contents into the order. The order's line items not yet present in the shopping cart are communicated to the server by sending the following XML document to the URL https://shop.beispielserver.com/vc_order.jsp.

<?xml version="1.0" encoding="iso-8859-1" ?>
<UpdateOrderRequest  xmlns="urn:veloconnect:order-1.1"
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>
  <vct:TransactionID>online-basket</vct:TransactionID>
  <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>52090311100</cac:ID>
      </cac:SellersItemIdentification>
      <cbc:Quantity quantityUnitCode="PK">4</cbc:Quantity>
      <cac:BuyersItemIdentification>
	<cac:ID>7295</cac:ID>
      </cac:BuyersItemIdentification>
  </OrderRequestLine>
</UpdateOrderRequest>

The server responds to this as follows:

The shopping cart and order have now been matched. If the user were to retrieve the current shopping cart at the online shop, it would contain exactly the same three line items as the order in the own inventory management system. The order is then concluded with the following request

whereupon the server returns the expected, complete order.

The shopping cart at the online shop is thus empty again, and the order is marked as concluded in the buyer's merchandise management system.

Documentation [EN]

Order via online (Transaction: OrderInOnlineShop)

Related pages