2Service Services API

<back to all web services

PostNewOrder

The following routes are available for this service:
POST/dealers/orderPlaces a new order with the specified items.
PostNewOrder Parameters:
NameParameterData TypeRequiredDescription
ItemsbodyNewOrderItemListYesItems to order.
UseDropshipmentbodybool?NoDropshipment indication.
DeliveryAddressbodyNewOrderAddressNoDelivery address.
AuthenticatedRequest Parameters:
NameParameterData TypeRequiredDescription
SessionTokenquerystringYesSession token received from successful authentication.
NewOrderItem Parameters:
NameParameterData TypeRequiredDescription
PartIdbodyintYesUnique ID for the part.
QuantitybodyintYesQuantity to order.
ReferencebodystringNoCustom reference.
NewOrderAddress Parameters:
NameParameterData TypeRequiredDescription
CompanyNamebodystringNoCompany name.
FirstNamebodystringNoFirst name.
LastNamebodystringNoLast name.
StreetNamebodystringYesStreet name.
HouseNumberbodystringYesHouse number.
HouseNumberAdditionbodystringNoHouse number addition.
PostalCodebodystringYesPostal code.
CitybodystringYesCity.
CountryCodebodystringYesCountry code.
TelephoneNumberbodystringNoTelephone number.
OperationResult<T> Parameters:
NameParameterData TypeRequiredDescription
ResultmodelTNoResult value
OperationResult Parameters:
NameParameterData TypeRequiredDescription
IsSuccessfulmodelboolNoSpecifies if the operation was successful.
ErrorMessagemodelstringNoStates error message in case of unsuccessful operation.
NewOrderResult Parameters:
NameParameterData TypeRequiredDescription
OrderNumbermodelstringNoNumber for the order that has been placed.

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

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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/json
Content-Type: application/json
Content-Length: length

{"Items":[{"PartId":0,"Quantity":0,"Reference":"String"}],"UseDropshipment":false,"DeliveryAddress":{"CompanyName":"String","FirstName":"String","LastName":"String","StreetName":"String","HouseNumber":"String","HouseNumberAddition":"String","PostalCode":"String","City":"String","CountryCode":"String","TelephoneNumber":"String"},"SessionToken":"String"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"Result":{"OrderNumber":"String"},"IsSuccessful":false,"ErrorMessage":"String"}