WSElectronicOrder


Click here for a complete list of operations.

ShipOrderDropShip

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. This method is very similar to ShipOrder, however, it breaks up the "ship to" fields into separate parameters. 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.
FullPartNo (String) - The full part number includes the Keystone vendor line code and the Keystone part number.
Quantity (String) - The quantity of the part to be ordered.
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 line item.
AdditionalInfo (String) 255 char - Information pertaining to this item that the user would like to include.
ServiceLevel (String) 3 char - The shipping method for this item. This can be found through the GetShippingOptions web method.
Output - A single string return value: an "OK" confirmation, or error message

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/ShipOrderDropShip"

<?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>
    <ShipOrderDropShip xmlns="http://eKeystone.com">
      <Key>string</Key>
      <FullAccountNo>string</FullAccountNo>
      <FullPartNo>string</FullPartNo>
      <Quant>string</Quant>
      <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>
    </ShipOrderDropShip>
  </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>
    <ShipOrderDropShipResponse xmlns="http://eKeystone.com">
      <ShipOrderDropShipResult>string</ShipOrderDropShipResult>
    </ShipOrderDropShipResponse>
  </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>
    <ShipOrderDropShip xmlns="http://eKeystone.com">
      <Key>string</Key>
      <FullAccountNo>string</FullAccountNo>
      <FullPartNo>string</FullPartNo>
      <Quant>string</Quant>
      <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>
    </ShipOrderDropShip>
  </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>
    <ShipOrderDropShipResponse xmlns="http://eKeystone.com">
      <ShipOrderDropShipResult>string</ShipOrderDropShipResult>
    </ShipOrderDropShipResponse>
  </soap12:Body>
</soap12:Envelope>