Correct a completed assembly order's quantities
curl --request POST \
--url https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reason": "Counted 24 gaskets used, not 2",
"produced_quantity": 12,
"lines": [
{
"order_line_id": 88,
"quantity": 24
}
],
"balancing_entry": {
"date": "2026-10-19"
},
"allow_shelf_change": false
}
'import requests
url = "https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction"
payload = {
"reason": "Counted 24 gaskets used, not 2",
"produced_quantity": 12,
"lines": [
{
"order_line_id": 88,
"quantity": 24
}
],
"balancing_entry": { "date": "2026-10-19" },
"allow_shelf_change": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
reason: 'Counted 24 gaskets used, not 2',
produced_quantity: 12,
lines: [{order_line_id: 88, quantity: 24}],
balancing_entry: {date: '2026-10-19'},
allow_shelf_change: false
})
};
fetch('https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'reason' => 'Counted 24 gaskets used, not 2',
'produced_quantity' => 12,
'lines' => [
[
'order_line_id' => 88,
'quantity' => 24
]
],
'balancing_entry' => [
'date' => '2026-10-19'
],
'allow_shelf_change' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction"
payload := strings.NewReader("{\n \"reason\": \"Counted 24 gaskets used, not 2\",\n \"produced_quantity\": 12,\n \"lines\": [\n {\n \"order_line_id\": 88,\n \"quantity\": 24\n }\n ],\n \"balancing_entry\": {\n \"date\": \"2026-10-19\"\n },\n \"allow_shelf_change\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"reason\": \"Counted 24 gaskets used, not 2\",\n \"produced_quantity\": 12,\n \"lines\": [\n {\n \"order_line_id\": 88,\n \"quantity\": 24\n }\n ],\n \"balancing_entry\": {\n \"date\": \"2026-10-19\"\n },\n \"allow_shelf_change\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"reason\": \"Counted 24 gaskets used, not 2\",\n \"produced_quantity\": 12,\n \"lines\": [\n {\n \"order_line_id\": 88,\n \"quantity\": 24\n }\n ],\n \"balancing_entry\": {\n \"date\": \"2026-10-19\"\n },\n \"allow_shelf_change\": false\n}"
response = http.request(request)
puts response.read_body{
"message": "Order quantities corrected. Rewritten quantity logs were rematerialized into Core where Core tables exist.",
"data": {
"order_id": 500,
"type": "assembly",
"rows": [
{
"order_line_id": 88,
"sku": "GASKET-02",
"role": "produced",
"old_quantity": 2,
"new_quantity": 24,
"onhand_delta": -22,
"onhand_after": 78,
"later_count_warning": true,
"later_count_transaction": "CYCLE COUNT",
"later_count_date": "2026-10-02"
}
],
"balancing_entry": {
"date": "2026-10-19",
"lines": [
{
"sku": "GASKET-02",
"quantity": 22,
"onhand_after": 100
}
]
},
"requires_full_core_rebuild": false,
"message": "Rewritten quantity logs were rematerialized into Core where Core tables exist.",
"correction_ids": [
41
],
"rematerialized_log_ids": [
7781
],
"adjustment_id": 9001,
"balance_warnings": [
{}
]
}
}{
"error": "<string>"
}{
"message": "<string>"
}{
"message": "Assembly order not found."
}{
"message": "<string>"
}Work Order Materials & Orders
Correct a completed assembly order's quantities
Corrects a completed assembly or disassembly order. You can set the produced quantity and each component line’s actual quantity independently. The original quantity logs are rewritten in place, later running balances on each stock shift by the on-hand change, and the stock total and bin always move by the same delta. By default a balancing adjustment then posts the opposite deltas so today’s on-hand does not change (a historical fix). Planned quantities are never changed. After apply, the rewritten quantity logs are rematerialized into Core inventory immediately; no full Core rebuild is needed.
To rescale the finished good together with its planned quantity, use
POST /posted-quantity-corrections instead (same balancing defaults). This
endpoint never changes planned quantity.
Send only the legs you want to change. A leg whose quantity equals the posted one is ignored; at least one leg must change. Each value is in the leg’s order unit of measure, and the base quantity scales by the same ratio.
Balancing entry
- Default (no
balancing_entry.date,allow_shelf_changenot true): a balancing adjustment is posted today with the opposite of each stock’s net change, so today’s on-hand does not move. - With
balancing_entry.date: the balancing adjustment is posted on that date instead (not in the future; a back-dated entry is dated at the start of that day). allow_shelf_change: true: no balancing adjustment is posted and today’s on-hand moves by each change. Use this only when the shelf really holds the corrected amount. Rejected (422) when a later shipment, location transfer, transfer order, fulfillment order, stock pull, cycle count, adjustment or recount already exists on an affected stock.
The adjustment’s remarks reference the order and the reason; running balances for those stocks are recomputed in date order from the earlier of the order’s log and the adjustment.
Rejected (422) when the order is not completed or not an
assembly/disassembly order, a line id is not on this order, nothing changes,
a changed leg does not have exactly one posted on-hand log, the balancing
date is in the future, allow_shelf_change is true but later movements exist
on an affected stock, or the order’s completion date or the balancing date is
in a closed period.
POST
/
assembly-orders
/
{assemblyOrderId}
/
ledger-correction
Correct a completed assembly order's quantities
curl --request POST \
--url https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"reason": "Counted 24 gaskets used, not 2",
"produced_quantity": 12,
"lines": [
{
"order_line_id": 88,
"quantity": 24
}
],
"balancing_entry": {
"date": "2026-10-19"
},
"allow_shelf_change": false
}
'import requests
url = "https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction"
payload = {
"reason": "Counted 24 gaskets used, not 2",
"produced_quantity": 12,
"lines": [
{
"order_line_id": 88,
"quantity": 24
}
],
"balancing_entry": { "date": "2026-10-19" },
"allow_shelf_change": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
reason: 'Counted 24 gaskets used, not 2',
produced_quantity: 12,
lines: [{order_line_id: 88, quantity: 24}],
balancing_entry: {date: '2026-10-19'},
allow_shelf_change: false
})
};
fetch('https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'reason' => 'Counted 24 gaskets used, not 2',
'produced_quantity' => 12,
'lines' => [
[
'order_line_id' => 88,
'quantity' => 24
]
],
'balancing_entry' => [
'date' => '2026-10-19'
],
'allow_shelf_change' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction"
payload := strings.NewReader("{\n \"reason\": \"Counted 24 gaskets used, not 2\",\n \"produced_quantity\": 12,\n \"lines\": [\n {\n \"order_line_id\": 88,\n \"quantity\": 24\n }\n ],\n \"balancing_entry\": {\n \"date\": \"2026-10-19\"\n },\n \"allow_shelf_change\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"reason\": \"Counted 24 gaskets used, not 2\",\n \"produced_quantity\": 12,\n \"lines\": [\n {\n \"order_line_id\": 88,\n \"quantity\": 24\n }\n ],\n \"balancing_entry\": {\n \"date\": \"2026-10-19\"\n },\n \"allow_shelf_change\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{companyName}.api.joinluminous.com/external/api/v1/assembly-orders/{assemblyOrderId}/ledger-correction")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"reason\": \"Counted 24 gaskets used, not 2\",\n \"produced_quantity\": 12,\n \"lines\": [\n {\n \"order_line_id\": 88,\n \"quantity\": 24\n }\n ],\n \"balancing_entry\": {\n \"date\": \"2026-10-19\"\n },\n \"allow_shelf_change\": false\n}"
response = http.request(request)
puts response.read_body{
"message": "Order quantities corrected. Rewritten quantity logs were rematerialized into Core where Core tables exist.",
"data": {
"order_id": 500,
"type": "assembly",
"rows": [
{
"order_line_id": 88,
"sku": "GASKET-02",
"role": "produced",
"old_quantity": 2,
"new_quantity": 24,
"onhand_delta": -22,
"onhand_after": 78,
"later_count_warning": true,
"later_count_transaction": "CYCLE COUNT",
"later_count_date": "2026-10-02"
}
],
"balancing_entry": {
"date": "2026-10-19",
"lines": [
{
"sku": "GASKET-02",
"quantity": 22,
"onhand_after": 100
}
]
},
"requires_full_core_rebuild": false,
"message": "Rewritten quantity logs were rematerialized into Core where Core tables exist.",
"correction_ids": [
41
],
"rematerialized_log_ids": [
7781
],
"adjustment_id": 9001,
"balance_warnings": [
{}
]
}
}{
"error": "<string>"
}{
"message": "<string>"
}{
"message": "Assembly order not found."
}{
"message": "<string>"
}Authorizations
Authenticate using a bearer token. To create a token, navigate to /settings/api-tokens and click Create API Token.
Path Parameters
ID of a completed assembly or disassembly order.
Body
application/json
Maximum string length:
500Example:
"Counted 24 gaskets used, not 2"
New actual quantity of the order's own SKU (the finished good on an assembly, the parent on a disassembly). Greater than zero.
Required range:
x > 0Example:
12
Show child attributes
Show child attributes
Show child attributes
Show child attributes
true skips the balancing adjustment so today's on-hand moves by
each change. Rejected (422) when later inventory movements exist
on an affected stock.
Response
Correction applied
Example:
"Order quantities corrected. Rewritten quantity logs were rematerialized into Core where Core tables exist."
Result of a ledger correction on a completed assembly or disassembly order.
The preview omits correction_ids, adjustment_id, rematerialized_log_ids
and balance_warnings.
Show child attributes
Show child attributes