Getting Stock Transfers Data

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

import requests
url = "https://easycms.fi/public_api/get_stock_transfers"
headers = {"Authorization1": "TOKEN"}
payload = {'username': 'USERNAME', 'password': 'PASSWORD', 'account': 'ACCOUNT_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_stock_transfers"))
    .headers("Authorization1", "TOKEN")
    .POST(HttpRequest.BodyPublishers.ofString("username=USERNAME&password=PASSWORD&account=ACCOUNT_ID"))
    .build();
HttpResponse<String> 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'
}).toString();
const options = {
  hostname: 'prolasku.fi',
  path: '/public_api/get_stock_transfers',
  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 [transferData, setTransferData] = useState('');
  useEffect(() => {
    const fetchData = async () => {
      try {
        const response = await fetch('https://easycms.fi/public_api/get_stock_transfers', {
          method: 'POST',
          headers: {'Authorization1': 'TOKEN', 'Content-Type': 'application/x-www-form-urlencoded'},
          body: new URLSearchParams({username: 'USERNAME', password: 'PASSWORD', account: 'ACCOUNT_ID'}).toString()
        });
        const data = await response.text();
        setTransferData(data);
      } catch (error) {
        console.error(error);
      }
    };
    fetchData();
  }, []);
  return (<div>{transferData}</div>);
}
export default App;

// Kotlin example requires using a third-party library like OkHttp for POST requests with a body
// Kotlin Example using OkHttp for POST request
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")
        .build()

    val request = Request.Builder()
        .url("https://easycms.fi/public_api/get_stock_transfers")
        .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<string, string>("username", "USERNAME"),
            new KeyValuePair<string, string>("password", "PASSWORD"),
            new KeyValuePair<string, string>("account", "ACCOUNT_ID")
        });
        using (var httpClient = new HttpClient())
        {
            httpClient.DefaultRequestHeaders.Add("Authorization1", token);
            var response = await httpClient.PostAsync("https://easycms.fi/public_api/get_stock_transfers", content);
            if (response.IsSuccessStatusCode)
            {
                var responseData = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseData);
            }
            else
            {
                Console.WriteLine($"Error: {response.StatusCode}");
            }
        }
    }
}

- `id`: Transfer ID - This is a unique identifier for the stock transfer.
- `reference`: Transfer reference number - A reference number for the transfer.
- `from_location_id`: Source Location ID - The ID of the location where the stock is being transferred from.
- `from_location_name`: Source Location Name - The name of the source location.
- `to_location_id`: Destination Location ID - The ID of the location where the stock is being transferred to.
- `to_location_name`: Destination Location Name - The name of the destination location.
- `status`: Transfer status code - Numeric status indicator:
  - 1 = Draft
  - 100 = Sent
  - 110 = Preparing
  - 120 = Shipped
  - 200 = Received
  - -1 = Cancelled
- `status_title`: Transfer status title - Human-readable status text.
- `transfer_date`: Transfer date - The date when the transfer was created/scheduled.
- `delivery_date`: Delivery date - The expected or actual delivery date.
- `total`: Total value - The total value of items in the transfer.
- `discount`: Discount - Any discount applied to the transfer.
- `note`: Note - General notes about the transfer.
- `admin_note`: Admin note - Internal administrative notes.
- `delivery_instructions`: Delivery instructions - Special delivery instructions.
- `title`: Transfer title - A title/name for the transfer.
- `deleted`: Deletion status - 0 or 1 indicating if the transfer is deleted.
- `transfer_lines`: Array of transfer line items (when include_lines=1):
  - `transfer_line_id`: Unique identifier for the line item.
  - `pid`: Product ID - The product being transferred.
  - `product_name`: Product name - The name of the product.
  - `product_title`: Product title - Additional product title.
  - `quantity`: Quantity - The quantity being transferred.
  - `received_quantity`: Received quantity - The quantity actually received.
  - `unit_price`: Unit price - Net price per unit.
  - `unit_price_buy`: Unit buy price - Purchase price per unit.
  - `vat_percent`: VAT percentage for selling.
  - `vat_percent_buy`: VAT percentage for buying.
  - `discount`: Line discount percentage.
  - `best_before_date`: Best before date for the product.
  - `barcode`: Product barcode.
  - `line_note`: Notes specific to this line item.
  - `stock_type_id`: Stock type ID.
  - `weight`: Weight of the product.
  - `weight_type`: Weight unit (e.g., kg).
  - `received_confirmed`: Received Confirmed - `0` = pending confirmation, `1` = confirmed and stock moved. Audit trail is logged via KLogger.

These key-value pairs provide comprehensive information about stock transfers and can be used for various purposes in your application.
    

{
  "INFO": {
    "start": 0,
    "limit": 50,
    "count": 1,
    "total_count": 1,
    "WHERE": "id = 123"
  },
  "OUTPUT": [
    {
      "id": 123,
      "reference": 1001,
      "from_location_id": 1,
      "from_location_name": "Main Warehouse",
      "to_location_id": 4,
      "to_location_name": "Retail Store",
      "status": 200,
      "status_title": "transfer_received",
      "transfer_date": "2024-03-15 10:30:00",
      "delivery_date": "2024-03-16 14:00:00",
      "total": 1500.00,
      "discount": 0,
      "note": "Regular stock replenishment",
      "admin_note": "",
      "delivery_instructions": "Deliver to loading dock B",
      "title": "Weekly Stock Transfer",
      "deleted": 0,
      "transfer_lines": [
        {
          "transfer_line_id": "abc123-uuid",
          "pid": 1001,
          "product_name": "Product A",
          "product_title": "",
          "quantity": 50,
          "received_quantity": 50,
          "unit_price": 10.00,
          "unit_price_buy": 8.00,
          "vat_percent": 24.00,
          "vat_percent_buy": 24.00,
          "discount": 0,
          "best_before_date": "2025-12-31",
          "barcode": "6410123456789",
          "line_note": "",
          "stock_type_id": 1,
          "weight": 0.5,
          "weight_type": "kg"
        },
        {
          "transfer_line_id": "def456-uuid",
          "pid": 1002,
          "product_name": "Product B",
          "product_title": "",
          "quantity": 100,
          "received_quantity": 98,
          "unit_price": 5.00,
          "unit_price_buy": 4.00,
          "vat_percent": 14.00,
          "vat_percent_buy": 14.00,
          "discount": 0,
          "best_before_date": "2025-06-30",
          "barcode": "6410123456790",
          "line_note": "2 items damaged during transport",
          "stock_type_id": 1,
          "weight": 0.25,
          "weight_type": "kg"
        }
      ]
    }
  ]
}