WSElectronicOrder Web Service

WSElectronicOrder

Click here for a complete list of operations.

ShipOrderDropShipMultipleParts

This web service method creates and places an order based on the information passed in. It returns a real-time status on the line item(s). This method is very similar to ShipOrderDropShip, however, it accepts multiple line items per order. It allows different shipping options, available through the GetShippingOptions method. All orders can be viewed through eKeystone or the GetOrderHistory web method.

Input Values:
Key (String) - Web service security key assigned by Keystone.
FullAccountNo (String) - The 5-7 character account number provided by Keystone.
OrderProcessMethod (Integer) - What to do with the order:
____ 0 - Verify Order - No parts are ordered; this assures the user that the order can be fulfilled by Keystone.
____ 1 - Complete order - All parts are ordered if zero 'X' records are returned; ORDER FAILS IF THERE IS ONE OR MORE 'X' RECORDS.
PartNumberQuantity (String) - Partnumber (the Keystone vendor line code and the Keystone part number) and quantity. The string is in the following format:
____ 'K33332206,1|G12100,1,Special Deal' - a comma seperates the part number from the quantity and Additional Part Information (OPTIONAL).
____ A pipe '|' seperates the full part number and quantity from additional part number/quantity groups.
____ A maximum of 250 partnumber/quantity groupings is allowed.
DropShipFirstName (String) 25 char - Drop ship customer’s first name.
DropShipMiddleInitial (String) 1 char - Drop ship customer’s middle initial.
DropShipLastName (String) 25 char - Drop ship customer’s last name.
DropShipAddress1 (String) 35 char - Drop ship customer’s address line 1.
DropShipAddress2 (String) 35 char - Drop ship customer’s address line 2.
DropShipCity (String) 30 char - Drop ship customer’s city.
DropShipState (String) 2 char - Drop ship customer’s state.
DropShipPostalCode (String) 12 char - Drop ship customer’s postal code.
DropShipPhone (String) 15 char - Drop ship customer’s phone - use format: XXX-XXX-XXXX
DropShipState (String) 2 char - Drop ship customer’s state.
DropShipCountry (String) 3 char - Drop ship customer’s country
DropShipEmail (String) 255 char - Drop ship customer’s email.
PONumber (String) 20 char - The PO number for this order's line items.
AdditionalInfo (String) 255 char - NOT CURRENTLY IMPLEMENTED, use PartNumberQuantity to pass additional info by part.
ServiceLevel (String) 3 char - The shipping method for this item. This can be found through the GetShippingOptions web method.
Output - A dataset with two tables, 'Status' and 'PartResults'.
The Status table contains one row. Possible outputs are: "OK", "Verified" or "Error: " + error message.
The PartResults table contains a list of the input parts, quantity, status and statusmessage.
The 'Status' column value of the PartResults table will be ' ' or 'X'. 'X' is a non orderable item; the 'StatusMessage' column will display the reason for which the order was rejected.

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /WSElectronicOrder/ElectronicOrder.asmx HTTP/1.1
Host: order.ekeystone.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://eKeystone.com/ShipOrderDropShipMultipleParts"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ShipOrderDropShipMultipleParts xmlns="http://eKeystone.com">
      <Key>string</Key>
      <FullAccountNo>string</FullAccountNo>
      <OrderProcessMethod>int</OrderProcessMethod>
      <PartNumberQuantity>string</PartNumberQuantity>
      <DropShipFirstName>string</DropShipFirstName>
      <DropShipMiddleInitial>string</DropShipMiddleInitial>
      <DropShipLastName>string</DropShipLastName>
      <DropShipCompany>string</DropShipCompany>
      <DropShipAddress1>string</DropShipAddress1>
      <DropShipAddress2>string</DropShipAddress2>
      <DropShipCity>string</DropShipCity>
      <DropShipState>string</DropShipState>
      <DropShipPostalCode>string</DropShipPostalCode>
      <DropShipPhone>string</DropShipPhone>
      <DropShipCountry>string</DropShipCountry>
      <DropShipEmail>string</DropShipEmail>
      <PONumber>string</PONumber>
      <AdditionalInfo>string</AdditionalInfo>
      <ServiceLevel>string</ServiceLevel>
    </ShipOrderDropShipMultipleParts>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ShipOrderDropShipMultiplePartsResponse xmlns="http://eKeystone.com">
      <ShipOrderDropShipMultiplePartsResult>
        <xsd:schema>schema</xsd:schema>xml</ShipOrderDropShipMultiplePartsResult>
    </ShipOrderDropShipMultiplePartsResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /WSElectronicOrder/ElectronicOrder.asmx HTTP/1.1
Host: order.ekeystone.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <ShipOrderDropShipMultipleParts xmlns="http://eKeystone.com">
      <Key>string</Key>
      <FullAccountNo>string</FullAccountNo>
      <OrderProcessMethod>int</OrderProcessMethod>
      <PartNumberQuantity>string</PartNumberQuantity>
      <DropShipFirstName>string</DropShipFirstName>
      <DropShipMiddleInitial>string</DropShipMiddleInitial>
      <DropShipLastName>string</DropShipLastName>
      <DropShipCompany>string</DropShipCompany>
      <DropShipAddress1>string</DropShipAddress1>
      <DropShipAddress2>string</DropShipAddress2>
      <DropShipCity>string</DropShipCity>
      <DropShipState>string</DropShipState>
      <DropShipPostalCode>string</DropShipPostalCode>
      <DropShipPhone>string</DropShipPhone>
      <DropShipCountry>string</DropShipCountry>
      <DropShipEmail>string</DropShipEmail>
      <PONumber>string</PONumber>
      <AdditionalInfo>string</AdditionalInfo>
      <ServiceLevel>string</ServiceLevel>
    </ShipOrderDropShipMultipleParts>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <ShipOrderDropShipMultiplePartsResponse xmlns="http://eKeystone.com">
      <ShipOrderDropShipMultiplePartsResult>
        <xsd:schema>schema</xsd:schema>xml</ShipOrderDropShipMultiplePartsResult>
    </ShipOrderDropShipMultiplePartsResponse>
  </soap12:Body>
</soap12:Envelope>