Picklist Shipments
You can create shipment requests for a picklist through the API. This will request the label at the given shipping provider, like PostNL.
Attributes
Name |
Type |
Description |
idshipment |
integer |
Unique Picqer reference |
idpicklist |
integer |
Picklist where this shipment is for |
idorder |
integer |
Order where this shipment is for |
idcompany_shippingprovider |
integer |
Shipping provider used to create this order |
labelurl |
string |
Public accessible link to PDF label |
provider |
string |
Name of the shipping provider |
providername |
string |
User-defined name for this provider |
public_providername |
string |
Name for the 'service' or provider that is known to the public |
trackingcode |
string |
Shipping provider provided reference number for this shipment |
tracktraceurl |
string |
Public accessible where the customer van follow their package |
cancelled |
boolean |
Is this shipment cancelled? Can be doen within 5 minutes after creation |
Get shipments from picklist
GET
https://example.picqer.com/api/v1/picklists/{idpicklist}/shipments
HTTP/1.1 200 OK
[
{
"idshipment": 1831213,
"idpicklist": 1896306,
"idorder": 2509975,
"idcompany_shippingprovider": 3921,
"labelurl":"https:\/\/example.com\/label.pdf",
"provider": "PostNL",
"providername": "PostNL",
"public_providername": "PostNL",
"trackingcode": "3STLOG013876977",
"tracktraceurl": "https:\/\/example.com\/tracking",
"cancelled": false,
"created": "2017-02-13 21:04:57",
"updated": "2017-02-13 21:04:57"
}
]
Get allowed shipping methods for picklist
This gives a list of shipping methods that are allowed for this picklist, including which one is the default selected method for this picklist.
GET
https://example.picqer.com/api/v1/picklists/{idpicklist}/shippingmethods
HTTP/1.1 200 OK
[
{
"idshippingprovider_profile": 1287,
"name": "PostNL - EU Pack Special",
"provider": "PostNL",
"selected": false,
"extra_fields": []
},
{
"idshippingprovider_profile": 1365,
"name": "PostNL - Nederland",
"provider": "PostNL",
"selected": true,
"extra_fields": []
}
]
Create a shipment
When you create a shipment, Picqer we send the request to the shipping provider. This is in most cases an external party. This means this request can take a long time (up to 20 seconds) and it can respond with an error from the shipping provider, like when the shipping product is not allowed in a specific country.
Ones you get a 201 Created, a shipment is successfully created. At this moment you get the body of the picklist returned. Maybe this will change in the future. For now you can do a GET request on https://example.picqer.com/api/v1/picklists/{idpicklist}/shipments to get the details of the created shipment if needed.
POST
https://example.picqer.com/api/v1/picklists/{idpicklist}/shipments
{
"idshippingprofile": 1365,
"weight": 1000
}
HTTP/1.1 201 Created
{
"idpicklist":76859,
"picklistid":"20140095",
"idcustomer":5621,
"idorder":119087,
"idwarehouse":18,
"deliveryname":"Desmonds Formal Wear",
"deliverycontact":"",
"deliveryaddress":"Emmerikseweg 57",
"deliveryaddress2":"",
"deliveryzipcode":"7077 AP",
"deliverycity":"Netterden",
"deliveryregion": null,
"deliverycountry":"NL",
"emailaddress":"YassinevanLingen@mailinator.com",
"telephone": null,
"reference": "",
"assigned_to_iduser": null,
"invoiced":false,
"status":"closed",
"totalproducts":2,
"totalpicked":0,
"snoozed_until": null,
"created":"2014-08-19 12:13:38",
"updated":"2014-08-19 12:13:38",
"products":[
{
"idproduct":147,
"idvatgroup":18,
"productcode":"502.052.16",
"name":"SUNDEROe",
"remarks":"",
"amount":1,
"amount_picked":0,
"price":69.95,
"weight":10200,
"stocklocation":"Plein C"
},
{
"idproduct":126654,
"idvatgroup":18,
"productcode":"1318512",
"name":"4GB DDR3 PC10600\/1333Mhz REG ECC MEMORY (x4)",
"remarks":null,
"amount":1,
"amount_picked":0,
"price":0,
"weight":0,
"stocklocation":null
}
]
}