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	PartResults	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.

**PartResults** Parameters:
Name	Parameter	Data Type	Required	Description
TotalNumberOfParts	form	int	No	Total number of parts available.
HasMoreRecords	form	bool	No	Indication if there are more parts to retrieve.
Parts	form	List<PartInfoResult>	No	Part records.

**PartInfoResult** Parameters:
Name	Parameter	Data Type	Required	Description
Id	form	int	No	Unique ID for the part.
PartNumber	form	string	No	Part number.
Description	form	string	No	Description of the part.
Manufacturer	form	string	No	Part manufacturer.
CanBeOrdered	form	bool	No	Determines if the part can be ordered.
StatusText	form	string	No	Textual representation of the status of the part.
AvailableStockQuantity	form	int	No	Available stock to order.
AverageDeliveryInDays	form	int?	No	Average days needed for delivery.
UnitPrice	form	decimal?	No	Price of a single unit, excluding VAT.
EanNumber	form	string	No	EAN number.
Images	form	List<PartInfoResultImage>	No	Images
SecondaryArticleNumbers	form	List<string>	No	Secondary article numbers
ReplacementArticleNumbers	form	List<string>	No	Replacement article numbers
StockQuantities	form	List<PartStockQuantity>	No	Stock quantities

**PartInfoResultImage** Parameters:
Name	Parameter	Data Type	Required	Description
ImageNumber	form	int	No	Image number
ImageUrl	form	string	No	Image URL

**PartStockQuantity** Parameters:
Name	Parameter	Data Type	Required	Description
LocationId	form	int	No	Location ID
LocationCode	form	string	No	Location code
StockQuantity	form	int	No	Stock quantity in location

**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>