cURL
curl --request POST \
--url https://app.stockshift.io/api/v1/manufacturing/builds/{build}/operations/{operation}/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"lines": [
{
"item": "<string>",
"quantity": "<string>",
"unit": "<string>",
"lot": "<string>",
"serials": [
"<string>"
]
}
]
}
'import requests
url = "https://app.stockshift.io/api/v1/manufacturing/builds/{build}/operations/{operation}/send"
payload = { "lines": [
{
"item": "<string>",
"quantity": "<string>",
"unit": "<string>",
"lot": "<string>",
"serials": ["<string>"]
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.stockshift.io/api/v1/manufacturing/builds/{build}/operations/{operation}/send",
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([
'lines' => [
[
'item' => '<string>',
'quantity' => '<string>',
'unit' => '<string>',
'lot' => '<string>',
'serials' => [
'<string>'
]
]
]
]),
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://app.stockshift.io/api/v1/manufacturing/builds/{build}/operations/{operation}/send"
payload := strings.NewReader("{\n \"lines\": [\n {\n \"item\": \"<string>\",\n \"quantity\": \"<string>\",\n \"unit\": \"<string>\",\n \"lot\": \"<string>\",\n \"serials\": [\n \"<string>\"\n ]\n }\n ]\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))
}{
"data": {
"id": "<string>",
"number": "<string>",
"status": "<string>",
"item_id": "<string>",
"item_sku": "<string>",
"item_name": "<string>",
"quantity": "<string>",
"unit": "<string>",
"location_id": "<string>",
"location_code": "<string>",
"location_name": "<string>",
"due_on": "<string>",
"note": "<string>",
"revision_label": "<string>",
"parts_list_fixed": true,
"blocked": "<string>",
"lines": [
{
"position": "<string>",
"component_id": "<string>",
"component_sku": "<string>",
"component_name": "<string>",
"required": "<string>",
"unit": "<string>",
"available": "<string>",
"short": "<string>",
"explanation": "<string>",
"open_orders": [
{
"number": "<string>",
"quantity": "<string>",
"expected_on": "<string>"
}
],
"alternates": [
{
"rank": 123,
"component_id": "<string>",
"component_sku": "<string>",
"component_name": "<string>",
"quantity": "<string>",
"unit": "<string>",
"available": "<string>"
}
],
"id": "<string>",
"held": "<string>",
"issued": "<string>",
"variance": "<string>",
"variance_reason": "<string>"
}
],
"released_at": "<string>",
"cancelled_at": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"can_complete": true,
"can_issue": true,
"issues": [
{
"step": 123,
"position": "<string>",
"component_id": "<string>",
"component_sku": "<string>",
"alternate_rank": 123,
"quantity": "<string>",
"lots": [
"<string>"
],
"serials": [
"<string>"
],
"cost": "<string>",
"issued_at": "<string>"
}
],
"output": {
"status": "<string>",
"lot": "<string>",
"serials": [
"<string>"
],
"cost": "<string>",
"unit_cost": "<string>",
"issued_as_recorded": true,
"completed_at": "<string>",
"reversed_at": "<string>"
},
"currency": "<string>",
"started_at": "<string>",
"can_trace": true,
"operations": [
{
"id": "<string>",
"sequence": 123,
"name": "<string>",
"work_center_id": "<string>",
"work_center_code": "<string>",
"work_center_name": "<string>",
"instructions": "<string>",
"setup_minutes": "<string>",
"run_minutes": "<string>",
"status": "<string>",
"started_at": "<string>",
"started_by_you": true,
"good_quantity": "<string>",
"scrap_quantity": "<string>",
"scrap_reason": "<string>",
"completed_at": "<string>",
"worked_minutes": "<string>",
"can_take": "<string>",
"blocked": "<string>",
"time_records": [
{
"id": "<string>",
"worked_by": 123,
"you": true,
"work_center_code": "<string>",
"started_at": "<string>",
"ended_at": "<string>",
"minutes": "<string>",
"corrects_id": "<string>",
"created_at": "<string>"
}
],
"subcontract": {
"supplier_id": "<string>",
"supplier_name": "<string>",
"service_item_id": "<string>",
"service_sku": "<string>",
"service_name": "<string>",
"unit_price": "<string>",
"purchase_order_id": "<string>",
"purchase_order_number": "<string>",
"sent": true,
"returned": true,
"cost": "<string>",
"send_blocked": "<string>",
"order_status": "<string>",
"notice": "<string>",
"can_bring_back": true,
"can_reorder": true
},
"checks": [
"<unknown>"
]
}
],
"problems": [
{
"id": "<string>",
"operation_id": "<string>",
"operation": "<string>",
"reason": "<string>",
"note": "<string>",
"has_photo": true,
"status": "<string>",
"reported_by_you": true,
"reported_at": "<string>",
"close_note": "<string>",
"closed_at": "<string>"
}
],
"can_run_operations": true,
"can_manage": true,
"priority": "<string>",
"planned_start_on": "<string>",
"planned_finish_on": "<string>",
"late": true,
"costs": {
"estimate": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"actual": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"variance": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"final": true,
"standard_unit_cost": "<string>",
"standard_variance": "<string>"
},
"can_print_labels": true
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}Builds
Send a subcontracted operation's parts to its supplier
Moves the parts named from the build’s location to the location that
stands for the supplier, created the first time, as a transfer that
arrives at once. The operation is then with the supplier, and
receiving its purchase order finishes it and brings the parts back.
Only on a released or in-progress build, once, and, unless the
organization allows overlap, once the operations before it are
finished. Answers with the build. Needs the
manufacturing.operations.run permission, a token with
manufacturing:write and a plan with subcontracting.
POST
/
manufacturing
/
builds
/
{build}
/
operations
/
{operation}
/
send
cURL
curl --request POST \
--url https://app.stockshift.io/api/v1/manufacturing/builds/{build}/operations/{operation}/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"lines": [
{
"item": "<string>",
"quantity": "<string>",
"unit": "<string>",
"lot": "<string>",
"serials": [
"<string>"
]
}
]
}
'import requests
url = "https://app.stockshift.io/api/v1/manufacturing/builds/{build}/operations/{operation}/send"
payload = { "lines": [
{
"item": "<string>",
"quantity": "<string>",
"unit": "<string>",
"lot": "<string>",
"serials": ["<string>"]
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.stockshift.io/api/v1/manufacturing/builds/{build}/operations/{operation}/send",
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([
'lines' => [
[
'item' => '<string>',
'quantity' => '<string>',
'unit' => '<string>',
'lot' => '<string>',
'serials' => [
'<string>'
]
]
]
]),
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://app.stockshift.io/api/v1/manufacturing/builds/{build}/operations/{operation}/send"
payload := strings.NewReader("{\n \"lines\": [\n {\n \"item\": \"<string>\",\n \"quantity\": \"<string>\",\n \"unit\": \"<string>\",\n \"lot\": \"<string>\",\n \"serials\": [\n \"<string>\"\n ]\n }\n ]\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))
}{
"data": {
"id": "<string>",
"number": "<string>",
"status": "<string>",
"item_id": "<string>",
"item_sku": "<string>",
"item_name": "<string>",
"quantity": "<string>",
"unit": "<string>",
"location_id": "<string>",
"location_code": "<string>",
"location_name": "<string>",
"due_on": "<string>",
"note": "<string>",
"revision_label": "<string>",
"parts_list_fixed": true,
"blocked": "<string>",
"lines": [
{
"position": "<string>",
"component_id": "<string>",
"component_sku": "<string>",
"component_name": "<string>",
"required": "<string>",
"unit": "<string>",
"available": "<string>",
"short": "<string>",
"explanation": "<string>",
"open_orders": [
{
"number": "<string>",
"quantity": "<string>",
"expected_on": "<string>"
}
],
"alternates": [
{
"rank": 123,
"component_id": "<string>",
"component_sku": "<string>",
"component_name": "<string>",
"quantity": "<string>",
"unit": "<string>",
"available": "<string>"
}
],
"id": "<string>",
"held": "<string>",
"issued": "<string>",
"variance": "<string>",
"variance_reason": "<string>"
}
],
"released_at": "<string>",
"cancelled_at": "<string>",
"created_at": "<string>",
"updated_at": "<string>",
"can_complete": true,
"can_issue": true,
"issues": [
{
"step": 123,
"position": "<string>",
"component_id": "<string>",
"component_sku": "<string>",
"alternate_rank": 123,
"quantity": "<string>",
"lots": [
"<string>"
],
"serials": [
"<string>"
],
"cost": "<string>",
"issued_at": "<string>"
}
],
"output": {
"status": "<string>",
"lot": "<string>",
"serials": [
"<string>"
],
"cost": "<string>",
"unit_cost": "<string>",
"issued_as_recorded": true,
"completed_at": "<string>",
"reversed_at": "<string>"
},
"currency": "<string>",
"started_at": "<string>",
"can_trace": true,
"operations": [
{
"id": "<string>",
"sequence": 123,
"name": "<string>",
"work_center_id": "<string>",
"work_center_code": "<string>",
"work_center_name": "<string>",
"instructions": "<string>",
"setup_minutes": "<string>",
"run_minutes": "<string>",
"status": "<string>",
"started_at": "<string>",
"started_by_you": true,
"good_quantity": "<string>",
"scrap_quantity": "<string>",
"scrap_reason": "<string>",
"completed_at": "<string>",
"worked_minutes": "<string>",
"can_take": "<string>",
"blocked": "<string>",
"time_records": [
{
"id": "<string>",
"worked_by": 123,
"you": true,
"work_center_code": "<string>",
"started_at": "<string>",
"ended_at": "<string>",
"minutes": "<string>",
"corrects_id": "<string>",
"created_at": "<string>"
}
],
"subcontract": {
"supplier_id": "<string>",
"supplier_name": "<string>",
"service_item_id": "<string>",
"service_sku": "<string>",
"service_name": "<string>",
"unit_price": "<string>",
"purchase_order_id": "<string>",
"purchase_order_number": "<string>",
"sent": true,
"returned": true,
"cost": "<string>",
"send_blocked": "<string>",
"order_status": "<string>",
"notice": "<string>",
"can_bring_back": true,
"can_reorder": true
},
"checks": [
"<unknown>"
]
}
],
"problems": [
{
"id": "<string>",
"operation_id": "<string>",
"operation": "<string>",
"reason": "<string>",
"note": "<string>",
"has_photo": true,
"status": "<string>",
"reported_by_you": true,
"reported_at": "<string>",
"close_note": "<string>",
"closed_at": "<string>"
}
],
"can_run_operations": true,
"can_manage": true,
"priority": "<string>",
"planned_start_on": "<string>",
"planned_finish_on": "<string>",
"late": true,
"costs": {
"estimate": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"actual": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"variance": {
"parts": "<string>",
"labor": "<string>",
"overhead": "<string>",
"total": "<string>",
"subcontract": "<string>"
},
"final": true,
"standard_unit_cost": "<string>",
"standard_variance": "<string>"
},
"can_print_labels": true
}
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}{
"type": "<string>",
"title": "<string>",
"status": 123,
"code": "<string>",
"detail": "<string>",
"errors": {},
"feature": "<string>",
"reason": "<string>",
"attempts_left": 123,
"rule_ids": [
"<string>"
],
"witness": "<string>",
"blind_recount": true,
"flags": [
{
"flag": "<string>",
"facts": {},
"choices": [
"<string>"
]
}
]
}Authorizations
apiKeyoauth2
For your own scripts and server-to-server integrations. Create a key in the app under Settings > Access > API keys and copy it then, because it is shown once. Send it as Authorization: Bearer <key>. The key acts as the member who made it, in the organization it was made in. A call needs the member's permission and one of the key's scopes, such as inventory:read or sales:write. A key with * has every scope.
Body
application/json
The parts sent to a subcontracted operation's supplier: lines of an item, a positive exact decimal quantity, and its lot or serial numbers, as a transfer takes them.
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
Response
BuildResource
Show child attributes
Show child attributes
Was this page helpful?