Getting Product Incoming Stock Data

$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://easycms.fi/public_api/get_products_incoming_stock",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => http_build_query([
    'username' => 'USERNAME', 
    'password' => 'PASSWORD', 
    'account' => 'ACCOUNT_ID',
    'pid' => 12345,
    'location_id' => 1,  // optional
    'shelf_id' => 5      // optional, requires location_id
  ]),
  CURLOPT_HTTPHEADER => array("Authorization1: TOKEN"),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;

import requests
url = "https://easycms.fi/public_api/get_products_incoming_stock"
headers = {"Authorization1": "TOKEN"}
payload = {
    'username': 'USERNAME', 
    'password': 'PASSWORD', 
    'account': 'ACCOUNT_ID',
    'pid': 12345,
    'location_id': 1,  # optional
    'shelf_id': 5      # optional, requires location_id
}
response = requests.post(url, headers=headers, data=payload)
print(response.text)

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://easycms.fi/public_api/get_products_incoming_stock"))
    .headers("Authorization1", "TOKEN")
    .POST(HttpRequest.BodyPublishers.ofString(
        "username=USERNAME&password=PASSWORD&account=ACCOUNT_ID&pid=12345&location_id=1&shelf_id=5"))
    .build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

const https = require('https');
const data = new URLSearchParams({ 
  username: 'USERNAME', 
  password: 'PASSWORD', 
  account: 'ACCOUNT_ID',
  pid: 12345,
  location_id: 1,  // optional
  shelf_id: 5      // optional
}).toString();
const options = {
  hostname: 'easycms.fi',
  path: '/public_api/get_products_incoming_stock',
  method: 'POST',
  headers: {
    'Authorization1': 'TOKEN',
    'Content-Type': 'application/x-www-form-urlencoded',
    'Content-Length': data.length
  }
};
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(data);
req.end();

import React, { useEffect, useState } from 'react';
function App() {
  const [incomingData, setIncomingData] = useState('');
  useEffect(() => {
    const fetchData = async () => {
      try {
        const response = await fetch('https://easycms.fi/public_api/get_products_incoming_stock', {
          method: 'POST',
          headers: {'Authorization1': 'TOKEN', 'Content-Type': 'application/x-www-form-urlencoded'},
          body: new URLSearchParams({
            username: 'USERNAME', 
            password: 'PASSWORD', 
            account: 'ACCOUNT_ID',
            pid: 12345
          }).toString()
        });
        const data = await response.text();
        setIncomingData(data);
      } catch (error) {
        console.error(error);
      }
    };
    fetchData();
  }, []);
  return (
{incomingData}
);
}
export default App;

import okhttp3.OkHttpClient
import okhttp3.FormBody
import okhttp3.Request

fun main() {
    val client = OkHttpClient()

    val formBody = FormBody.Builder()
        .add("username", "USERNAME")
        .add("password", "PASSWORD")
        .add("account", "ACCOUNT_ID")
        .add("pid", "12345")
        .add("location_id", "1")  // optional
        .add("shelf_id", "5")     // optional
        .build()

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

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

using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
    static async Task Main()
    {
        var token = "TOKEN";
        var content = new FormUrlEncodedContent(new[]
        {
            new KeyValuePair("username", "USERNAME"),
            new KeyValuePair("password", "PASSWORD"),
            new KeyValuePair("account", "ACCOUNT_ID"),
            new KeyValuePair("pid", "12345"),
            new KeyValuePair("location_id", "1"),  // optional
            new KeyValuePair("shelf_id", "5")      // optional
        });
        using (var httpClient = new HttpClient())
        {
            httpClient.DefaultRequestHeaders.Add("Authorization1", token);
            var response = await httpClient.PostAsync("https://easycms.fi/public_api/get_products_incoming_stock", content);
            if (response.IsSuccessStatusCode)
            {
                var responseData = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseData);
            }
            else
            {
                Console.WriteLine($"Error: {response.StatusCode}");
            }
        }
    }
}

- `stock`: The upcoming stock quantity expected to arrive.
- `location_id`: The unique identifier for the location/warehouse where stock will arrive.
- `location_name`: The name of the location/warehouse.
- `shelf_id`: The unique identifier for the shelf within the location.
- `shelf_name`: The name of the shelf.
- `coming_to_stock_date`: The expected date when the stock will arrive (YYYY-MM-DD format, null if not set).
- `best_before_date`: The best before date for the upcoming stock (YYYY-MM-DD format, null if not set).
- `reason`: Stock reason code indicating why this stock is coming:
  - `1` = Purchase (import from supplier)
  - `2` = Refund (return from customer)
  - `3` = Movement (transfer in)
  - `4` = Sale correction
- `price`: The sell price for the upcoming stock.
- `price_buy`: The buy price for the upcoming stock (null if not set).
- `supplier_id`: The supplier ID associated with this upcoming stock.
- `purchase_id`: The linked purchase order ID (0 if not linked to a purchase order).
- `datenew`: The date when this upcoming stock record was created (YYYY-MM-DD HH:MM:SS format).

These key-value pairs provide information about pending stock arrivals and can be used for inventory planning and forecasting in your application.
    

{
  "INFO": {
    "start": 0,
    "limit": 50,
    "count": 2,
    "total_count": 2,
    "WHERE": "pid = 12345"
  },
  "OUTPUT": [
    {
      "stock": 100.0,
      "location_id": 1,
      "location_name": "Main Warehouse",
      "shelf_id": 5,
      "shelf_name": "Shelf A1",
      "coming_to_stock_date": "2026-08-15",
      "best_before_date": "2027-08-15",
      "reason": 1,
      "price": 10.5,
      "price_buy": 6.0,
      "supplier_id": 3,
      "purchase_id": 456,
      "datenew": "2026-03-27 10:00:00"
    },
    {
      "stock": 50.0,
      "location_id": 2,
      "location_name": "Secondary Warehouse",
      "shelf_id": 3,
      "shelf_name": "Shelf B2",
      "coming_to_stock_date": "2026-09-01",
      "best_before_date": null,
      "reason": 3,
      "price": 10.5,
      "price_buy": null,
      "supplier_id": 1,
      "purchase_id": 0,
      "datenew": "2026-03-25 14:30:00"
    }
  ]
}