Insert Stock
This guideline explains how to use the BCF API to insert or update stock levels for a specific customer and location. Important: When using this endpoint, the submitted payload must contain the complete stock for the dealer at the specified location. If you are using it for testing the endpoint set the isTest property to true.
Any previous stock data for this dealer and location will be fully replaced by the new submission. Ensure your payload includes all items currently in stock to avoid unintended data loss. The API endpoint allows you to submit a JSON payload containing stock items and their quantities, which will be processed and stored in the system.
Request
Replace {API_KEY} with your valid API key the same applies for CustomerNumber and location.
{
"CustomerNumber": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"isTest": true,
"location": "x",
"stock": [
{
"item": "SBIKADRID277",
"qty": 1
},
{
"item": "SBIFRSRID127",
"qty": 1
},
{
"item": "CONFIG029912",
"qty": 1
}
]
}
Response
On success, the API will return a 201 created status with a confirmation message or updated stock details.
On failure, it will return an appropriate error code (e.g., 400 Bad Request for invalid data, 401 Unauthorized for invalid API key).
{
"id": 10,
"customer": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"location": "1",
"stock": [
{
"qty": 1,
"item": "SBIKADRID277"
},
{
"qty": 1,
"item": "SBIFRSRID127"
},
{
"qty": 1,
"item": "CONFIG029912"
}
],
"lastmodified": "2025-11-05T14:46:07.088Z",
"geo": "xxxxx00020E61000002927DA5548D91240BBExxxxxxDA24940",
"istest": true
}
Customer number
This customer number is a pseudonymous identifier that can be obtained from our company.