2Service Services API

PostNewOrder

The following routes are available for this service:
POST	/dealers/order	Places a new order with the specified items.

**PostNewOrder** Parameters:
Name	Parameter	Data Type	Required	Description
Items	body	NewOrderItemList	Yes	Items to order.
UseDropshipment	body	bool?	No	Dropshipment indication.
DeliveryAddress	body	NewOrderAddress	No	Delivery address.

**AuthenticatedRequest** Parameters:
Name	Parameter	Data Type	Required	Description
SessionToken	query	string	Yes	Session token received from successful authentication.

**NewOrderItem** Parameters:
Name	Parameter	Data Type	Required	Description
PartId	body	int	Yes	Unique ID for the part.
Quantity	body	int	Yes	Quantity to order.
Reference	body	string	No	Custom reference.

**NewOrderAddress** Parameters:
Name	Parameter	Data Type	Required	Description
CompanyName	body	string	No	Company name.
FirstName	body	string	No	First name.
LastName	body	string	No	Last name.
StreetName	body	string	Yes	Street name.
HouseNumber	body	string	Yes	House number.
HouseNumberAddition	body	string	No	House number addition.
PostalCode	body	string	Yes	Postal code.
City	body	string	Yes	City.
CountryCode	body	string	Yes	Country code.
TelephoneNumber	body	string	No	Telephone number.

**OperationResult<T>** Parameters:
Name	Parameter	Data Type	Required	Description
Result	model	T	No	Result value

**OperationResult** Parameters:
Name	Parameter	Data Type	Required	Description
IsSuccessful	model	bool	No	Specifies if the operation was successful.
ErrorMessage	model	string	No	States error message in case of unsuccessful operation.

**NewOrderResult** Parameters:
Name	Parameter	Data Type	Required	Description
OrderNumber	model	string	No	Number for the order that has been placed.

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /dealers/order HTTP/1.1 
Host: services.acct.2service.nl 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<PostNewOrder xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/_2Service.Webservices.ServiceModel.Dealers">
  <SessionToken>String</SessionToken>
  <DeliveryAddress>
    <City>String</City>
    <CompanyName>String</CompanyName>
    <CountryCode>String</CountryCode>
    <FirstName>String</FirstName>
    <HouseNumber>String</HouseNumber>
    <HouseNumberAddition>String</HouseNumberAddition>
    <LastName>String</LastName>
    <PostalCode>String</PostalCode>
    <StreetName>String</StreetName>
    <TelephoneNumber>String</TelephoneNumber>
  </DeliveryAddress>
  <Items>
    <NewOrderItem>
      <PartId>0</PartId>
      <Quantity>0</Quantity>
      <Reference>String</Reference>
    </NewOrderItem>
  </Items>
  <UseDropshipment>false</UseDropshipment>
</PostNewOrder>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<NewOrderResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/_2Service.Webservices.ServiceModel.Dealers">
  <ErrorMessage xmlns="http://schemas.datacontract.org/2004/07/_2Service.Webservices.ServiceModel">String</ErrorMessage>
  <IsSuccessful xmlns="http://schemas.datacontract.org/2004/07/_2Service.Webservices.ServiceModel">false</IsSuccessful>
  <Result xmlns:d2p1="http://schemas.datacontract.org/2004/07/_2Service.Webservices.ServiceModel.Dealers" xmlns="http://schemas.datacontract.org/2004/07/_2Service.Webservices.ServiceModel">
    <d2p1:OrderNumber>String</d2p1:OrderNumber>
  </Result>
</NewOrderResponse>