View Source

The client requests details concerning the item with order number 42213526300 in one of the 3 following ways:

Invocation of the following URL (HTTP GET):

https://b2b.beispielserver.com/?BuyersID=B127645&Password=secret&RequestName=GetItemDetailsRequest&SellersItemIdentification=42213526300

2. Via HTTP POST to the address https://b2b.beispielserver.com/ with header

Content-Type: application/x-www-form-urlencoded

and body

BuyersID=B127645&Password=secret&RequestName=GetItemDetailsRequest&SellersItemIdentification=42213526300

3. Via HTTP POST to address https://b2b.beispielserver.com/ with header

Content-Type: application/xml

and body

<?xml version="1.0" encoding="UTF-8"?>
<GetItemDetailsRequest xmlns="urn:veloconnect:order-1.1" xmlns:vct="urn:veloconnect:transaction-1.0" xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-1.0">
  <vct:BuyersID/>
  <vct:Credential><vct:Password>secret</vct:Password></vct:Credential>
  <cac:SellersItemIdentification>
    <cac:ID>42213526300</cac:ID>
  </cac:SellersItemIdentification>
</GetItemDetailsRequest>

or, as an equivalent, with the following body:

<?xml version="1.0" encoding="UTF-8"?>
<ns:GetItemDetailsRequest xmlns:ns="urn:veloconnect:order-1.1" xmlns:xyz="urn:veloconnect:transaction-1.0" xmlns:ns3="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-1.0">
  <xyz:BuyersID/>
  <xyz:Credential><xyz:Password>secret</xyz:Password></xyz:Credential>
  <ns3:SellersItemIdentification>
    <ns3:ID>42213526300</ns3:ID>
  </ns3:SellersItemIdentification>
</ns:GetItemDetailsRequest>

The response to each of these requests can appear as follows, for example:

<?xml version="1.0" encoding="utf-8" ?>
<GetItemDetailsResponse 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>
  <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: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>
  <Availability>
    <Code>available</Code>
  </Availability>
</GetItemDetailsResponse>

The response contains information such as the following:

The item has EAN code 4032191511108.
The article in sold in packages of 100 units each.
A package costs 34,50 Euro if less than 5 packages are procured, and 29,50 Euro if more than 5 are procured.
The recommended sales price is 0.70 Euro per unit.

If the item is unknown, the response is as follows:

<?xml version="1.0" encoding="utf-8"?>
<GetItemDetailsResponse 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>
  <ItemUnknown>
    <cac:SellersItemIdentification>
      <cac:ID>42213526300</cac:ID>
    </cac:SellersItemIdentification>
  </ItemUnknown>  
</GetItemDetailsResponse>

If the item is no longer in the assortment, but a replacement item can be recommended, the response is as follows:

<?xml version="1.0" encoding="utf-8"?>
<GetItemDetailsResponse 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>
  <ItemUnknown>
    <cac:SellersItemIdentification>
      <cac:ID>42213526300</cac:ID>
    </cac:SellersItemIdentification>
  </ItemUnknown>  
</GetItemDetailsResponse>