Request for item details(GetItemDetails)
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>