Setting Product Stock Data

$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://easycms.fi/public_api/set_products_stock",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode([
    'username' => 'USERNAME', 
    'password' => 'PASSWORD', 
    'account' => 'ACCOUNT_ID',
    'pid' => 12345,
    'location_id' => 1,
    'shelf_id' => 5,
    'stock' => 100,           // positive for addition
    'reason' => 1,            // IN_PURCHASE
    'best_before_date' => '2025-12-31',
    'price_buy' => 15.50,
    'supplier_id' => 10,
    'reference' => 'PO-2024-001'
  ]),
  CURLOPT_HTTPHEADER => array(
    "Authorization1: TOKEN",
    "Content-Type: application/json"
  ),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;

import requests
import json

url = "https://easycms.fi/public_api/set_products_stock"
headers = {
    "Authorization1": "TOKEN",
    "Content-Type": "application/json"
}
payload = {
    'username': 'USERNAME', 
    'password': 'PASSWORD', 
    'account': 'ACCOUNT_ID',
    'pid': 12345,
    'location_id': 1,
    'shelf_id': 5,
    'stock': 100,           # positive for addition
    'reason': 1,            # IN_PURCHASE
    'best_before_date': '2025-12-31',
    'price_buy': 15.50,
    'supplier_id': 10,
    'reference': 'PO-2024-001'
}
response = requests.post(url, headers=headers, data=json.dumps(payload))
print(response.text)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
String jsonPayload = """
    {
        "username": "USERNAME",
        "password": "PASSWORD",
        "account": "ACCOUNT_ID",
        "pid": 12345,
        "location_id": 1,
        "shelf_id": 5,
        "stock": 100,
        "reason": 1,
        "best_before_date": "2025-12-31",
        "price_buy": 15.50,
        "supplier_id": 10,
        "reference": "PO-2024-001"
    }
    """;
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://easycms.fi/public_api/set_products_stock"))
    .headers("Authorization1", "TOKEN", "Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(jsonPayload))
    .build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

const https = require('https');

const payload = JSON.stringify({
  username: 'USERNAME', 
  password: 'PASSWORD', 
  account: 'ACCOUNT_ID',
  pid: 12345,
  location_id: 1,
  shelf_id: 5,
  stock: 100,
  reason: 1,
  best_before_date: '2025-12-31',
  price_buy: 15.50,
  supplier_id: 10,
  reference: 'PO-2024-001'
});

const options = {
  hostname: 'easycms.fi',
  path: '/public_api/set_products_stock',
  method: 'POST',
  headers: {
    'Authorization1': 'TOKEN',
    'Content-Type': 'application/json',
    'Content-Length': Buffer.byteLength(payload)
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(data); });
});
req.on('error', (e) => { console.error(e); });
req.write(payload);
req.end();

import okhttp3.OkHttpClient
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.Request
import okhttp3.RequestBody.Companion.toRequestBody

fun main() {
    val client = OkHttpClient()

    val jsonPayload = """
        {
            "username": "USERNAME",
            "password": "PASSWORD",
            "account": "ACCOUNT_ID",
            "pid": 12345,
            "location_id": 1,
            "shelf_id": 5,
            "stock": 100,
            "reason": 1,
            "best_before_date": "2025-12-31",
            "price_buy": 15.50,
            "supplier_id": 10,
            "reference": "PO-2024-001"
        }
    """.trimIndent()

    val requestBody = jsonPayload.toRequestBody("application/json".toMediaType())

    val request = Request.Builder()
        .url("https://easycms.fi/public_api/set_products_stock")
        .post(requestBody)
        .addHeader("Authorization1", "TOKEN")
        .build()

    client.newCall(request).execute().use { response ->
        if (!response.isSuccessful) throw IOException("Unexpected code $response")
        println(response.body?.string())
    }
}

- `status`: The operation status ("success" or "error")
- `message`: Human-readable message describing the result
- `data`: Object containing the operation details:
  - `pid`: The product ID that was updated
  - `location_id`: The location ID
  - `shelf_id`: The shelf ID
  - `previous_stock`: The stock quantity before this update
  - `stock_change`: The amount that was added (positive) or deducted (negative)
  - `new_stock`: The current stock quantity after this update
  - `reason`: The numeric reason code used
  - `reason_text`: The human-readable reason text
  - `stockdiary_id`: The UUID of the created stockdiary entry
  - `best_before_date`: The best before date (if provided)
    

When creating a new stock entry (no previous stock existed):

{
  "status": "success",
  "message": "Stock entry created successfully",
  "data": {
    "pid": 12345,
    "location_id": 2,
    "shelf_id": 3,
    "previous_stock": 0,
    "stock_change": 100.0,
    "new_stock": 100.0,
    "reason": 1,
    "reason_text": "IN_PURCHASE",
    "stockdiary_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "best_before_date": "2025-12-31",
    "is_new_entry": true
  }
}