Suppliers

Attributes

Name	Type	Required	Description
idsupplier	integer	generated	Unique Picqer reference
name	string	required	Must be unique within your account
contactname	string	optional
address	string	optional
address2	string	optional
zipcode	string	optional
city	string	optional
region	string	optional	Region, state or province
country	string	optional	2-letter ISO country code
telephone	string	optional
emailaddress	string	optional	Must be a valid email address
remarks	text	optional
language	string	optional	Language of PDF documents for supplier

Get all suppliers

With this call, you get the active suppliers. Provide the inactive parameter to get the inactive suppliers.

GET https://example.picqer.com/api/v1/suppliers

HTTP/1.1 200 OK [ { "idsupplier": 9424, "name": "Grinwis Plaat Stuitjes LLP", "contactname": null, "address": "de Bruijnsteeg 1-3", "address2": null, "zipcode": "6942 WI", "city": "Heerde", "region": null, "country": "NL", "telephone": null, "emailaddress": null, "remarks": null, "language": "nl" }, { "idsupplier": 9422, "name": "Mosley", "contactname": null, "address": "Katepad 5", "address2": null, "zipcode": "2604 YX", "city": "Moerdijk", "region": null, "country": "NL", "telephone": null, "emailaddress": null, "remarks": null, "language": "nl" } ]

This endpoint uses pagination.

Get a single supplier

GET https://example.picqer.com/api/v1/suppliers/{idsupplier}

HTTP/1.1 200 OK { "idsupplier": 9422, "name": "Mosley", "contactname": null, "address": "Katepad 5", "address2": null, "zipcode": "2604 YX", "city": "Moerdijk", "region": null, "country": "NL", "telephone": null, "emailaddress": null, "remarks": null, "language": "nl" }

Create a supplier

If the supplier has been successfully created, we will respond with a 200 OK status. This differs from our other endpoints for which we use a 201 Created status for successful POST requests. However, for this endpoint we will continue to use 200 OK.

POST https://example.picqer.com/api/v1/suppliers

{ "name": "Mesley", "address": "Katepad 5", "zipcode": "2604 YX", "city": "Moerdijk", "country": "NL" }

HTTP/1.1 200 OK { "idsupplier": 9422, "name": "Mesley", "contactname": null, "address": "Katepad 5", "address2": null, "zipcode": "2604 YX", "city": "Moerdijk", "region": null, "country": "NL", "telephone": null, "emailaddress": null, "remarks": null, "language": "nl" }

Update a supplier

PUT https://example.picqer.com/api/v1/suppliers/{idsupplier}

{ "name": "Mosley", "address": "Katepad 15" }

HTTP/1.1 200 OK { "idsupplier": 9422, "name": "Mosley", "contactname": null, "address": "Katepad 15", "address2": null, "zipcode": "2604 YX", "city": "Moerdijk", "region": null, "country": "NL", "telephone": null, "emailaddress": null, "remarks": null, "language": "nl" }

Comments

Comments are supported on suppliers.