Merchanter API - Depots
Authentication
At the time of writing this document, the Merchanter API service uses basic authentication. This allows the clients to authenticate themselves by providing a username and password in the Authorization HTTP header.
Operations
Content Types
GET operations can send data in either XML (the default) or JSON format. If JSON is required, the request must be sent with an Accept HTTP header and the value “application/json”.
POST/PUT operations can receive data in either XML (the default) or JSON format. If JSON is required, the request must be sent with a Content-Type HTTP header and the value “application/json”.
Endpoints
The URL of every endpoint always starts with a base url:-
{Merchanter application url}/rest/api.merch/v1
Only the relative URL is shown for each endpoint.
Depots
· GEToperations
o /Depots – Retrieveinformation relating to depots under the current user account’s ledger
§ Parameters
· Querytype
o Where – a filterexpression string with ANDed filters. Available filters are
§ IsEcommerceDepot – is this anecommerce depot? true/false
E.g. Where=IsEcommerceDepot==true
§ Response schema & body (JSON)
Attribute Name |
Data Type |
Max Length |
Notes |
Response Body (JSON) |
Name |
String |
100 |
Full name of the depot |
[ { "Name": "", "Code": "", "EmailAddress": "", "DefaultAddress": { "AddressLine1": "", "AddressLine2": "", "City": "", "PostalCode": "", "PhoneNumber": "", "Country": { "Country_ISO3166_1": { "CountryCode_2": "" } } }, "IsEcommerceDepot": false, "changedDate": "1900-01-01T00:00:00.000Z" } ] |
Code |
String |
2 |
Depot code |
|
EmailAddress |
String |
100 |
|
|
IsEcommerceDepot |
Boolean |
|
Ecommerce depot? |
|
changedDate |
Datetime |
|
Date & time of last update |
|
DefaultAddress |
|
|
|
|
- AddressLine1 |
String |
30 |
|
|
- AddressLine2 |
String |
30 |
|
|
- City |
String |
30 |
|
|
- PostalCode |
String |
10 |
|
|
- PhoneNumber |
String |
30 |
|
|
- Country |
|
|
|
|
- - Country_ISO3166_1 |
|
|
|
|
- - - CountryCode_2 |
String |
2 |
ISO 3166-1 country code |