2Service Services API

Authenticate

The following routes are available for this service:
POST	/dealers/authenticate	Authenticate with user name and password. Returns session token. Note: the token expires after 5 minutes of inactivity.

**Authenticate** Parameters:
Name	Parameter	Data Type	Required	Description
UserName	query	string	Yes	User name for your account.
Password	query	string	Yes	Password provided by your supplier.

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

**AuthenticateResult** Parameters:
Name	Parameter	Data Type	Required	Description
SessionToken	model	string	No	Session token to use in successive calls to the services.

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

HTTP + CSV

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

POST /dealers/authenticate HTTP/1.1 
Host: services.acct.2service.nl 
Accept: text/csv
Content-Type: text/csv
Content-Length: length

{"UserName":"String","Password":"String"}

HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

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