Fulfilment customers
Fulfilment customers can use the API themselves, as explained in this page. But you can also manage fulfilment customers via the API, that is what this page is about.
For the monthtly report, check this page
Attributes
Name | Type | Required | Description |
---|---|---|---|
idfulfilment_customer | integer | generated | Unique Picqer reference |
name | string | required | Name of fulfilment customer |
can_login | boolean | optional | Can this fulfilment customer login to the fulfilment portal |
username | string | optional | The username to login to the fulfilment portal |
password | string | optional and write-only | The password to login to the fulfilment portal |
language | string | optional | 'nl' or 'en' for language of fulfilment portal |
idtemplate | integer | optional | Default selected template for new orders from this fulfilment customer |
last_login_at | datetime | read-only | Last time this fulfilment customer logged in to the fulfilment portal |
allowed_shipping_profiles | array | optional | List of idshippingprovider_profile's that this fulfilment customer is allowed to use. If empty, all profiles are allowed to be used |
Get fulfilment customers
GET
https://example.picqer.com/api/v1/fulfilment/customers
HTTP/1.1 200 OK
[
{
"idfulfilment_customer": 1,
"name": "FulfilmentPartij BV",
"can_login": true,
"username": "fulfilment",
"language": "nl",
"idtemplate": null,
"last_login_at": "2019-04-03 21:14:18"
},
{
"idfulfilment_customer": 3,
"name": "Fulfilling Partners",
"can_login": true,
"username": "partners",
"language": "en",
"idtemplate": null,
"last_login_at": "2019-03-13 16:24:28"
}
]
This endpoint uses pagination.
Get single fulfilment customer
GET
https://example.picqer.com/api/v1/fulfilment/customers/{id}
HTTP/1.1 200 OK
{
"idfulfilment_customer": 1,
"name": "FulfilmentPartij BV",
"can_login": true,
"username": "fulfilment",
"language": "nl",
"idtemplate": null,
"last_login_at": "2019-04-03 21:14:18",
"allowed_shipping_profiles": [22, 98]
}
Create new fulfilment customer
POST
https://example.picqer.com/api/v1/fulfilment/customers
{
"name": "Fulfilling Partners",
"can_login": true,
"username": "partners",
"password": "ue73hjdf893",
"language": "nl",
"allowed_shipping_profiles": []
}
HTTP/1.1 200 OK
{
"idfulfilment_customer": 4,
"name": "Fulfilling Partners",
"can_login": true,
"username": "partners",
"language": "nl",
"idtemplate": null,
"last_login_at": null,
"allowed_shipping_profiles": []
}
Update fulfilment customer
PUT
https://example.picqer.com/api/v1/fulfilment/customers/{id}
{
"name": "Fulfilling Partners BV"
}
HTTP/1.1 200 OK
{
"idfulfilment_customer": 4,
"name": "Fulfilling Partners BV",
"can_login": true,
"username": "partners",
"language": "nl",
"idtemplate": null,
"last_login_at": null,
"allowed_shipping_profiles": []
}