The External Order Management section of the InvenTree API schema is documented below.
InvenTree API 435¶
API for InvenTree - the intuitive open source inventory management system
Servers¶
| Description | URL |
|---|---|
| http://localhost:8000 | http://localhost:8000 |
order¶
GET /api/order/po-extra-line/¶
Description
Override the GET method to determine export options.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
limit |
query | integer | No | Number of results to return per page. | |
offset |
query | integer | No | The initial index from which to return the results. | |
order |
query | integer | No | ||
order_detail |
query | boolean | False | No | Include detailed information about the sales order in the response |
ordering |
query | string | No | Which field to use when ordering the results. | |
search |
query | string | No | A search term. Searched fields: description, notes, quantity, reference. |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/PurchaseOrderExtraLine"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
POST /api/order/po-extra-line/¶
Description
API endpoint for accessing a list of PurchaseOrderExtraLine objects.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
Response 201 Created
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
DELETE /api/order/po-extra-line/{id}/¶
Description
API endpoint for detail view of a PurchaseOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/po-extra-line/{id}/¶
Description
API endpoint for detail view of a PurchaseOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
PATCH /api/order/po-extra-line/{id}/¶
Description
API endpoint for detail view of a PurchaseOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
Response 200 OK
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
PUT /api/order/po-extra-line/{id}/¶
Description
API endpoint for detail view of a PurchaseOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
Response 200 OK
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a PurchaseOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
GET /api/order/po-extra-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PATCH /api/order/po-extra-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PUT /api/order/po-extra-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
DELETE /api/order/po-line/¶
Description
Perform a DELETE operation against this list endpoint.
Note that the typical DRF list endpoint does not support DELETE, so this method is provided as a custom implementation.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"filters": {},
"items": [
0
]
}
Schema of the request body
{
"description": "Parameters for selecting items for bulk operations.",
"properties": {
"filters": {
"additionalProperties": {},
"title": "A dictionary of filter values",
"type": "object"
},
"items": {
"items": {
"type": "integer"
},
"title": "A list of primary key values",
"type": "array"
}
},
"type": "object"
}
{
"filters": {},
"items": [
0
]
}
Schema of the request body
{
"description": "Parameters for selecting items for bulk operations.",
"properties": {
"filters": {
"additionalProperties": {},
"title": "A dictionary of filter values",
"type": "object"
},
"items": {
"items": {
"type": "integer"
},
"title": "A list of primary key values",
"type": "array"
}
},
"type": "object"
}
{
"filters": {},
"items": [
0
]
}
Schema of the request body
{
"description": "Parameters for selecting items for bulk operations.",
"properties": {
"filters": {
"additionalProperties": {},
"title": "A dictionary of filter values",
"type": "object"
},
"items": {
"items": {
"type": "integer"
},
"title": "A list of primary key values",
"type": "array"
}
},
"type": "object"
}
Response 204 No Content
GET /api/order/po-line/¶
Description
Override the GET method to determine export options.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
base_part |
query | integer | No | Internal Part | |
has_pricing |
query | boolean | No | Has Pricing | |
include_variants |
query | boolean | No | Include Variants | |
limit |
query | integer | No | Number of results to return per page. | |
offset |
query | integer | No | The initial index from which to return the results. | |
order |
query | integer | No | Order | |
order_complete |
query | boolean | No | Order Complete | |
order_detail |
query | boolean | False | No | Include detailed information about the sales order in the response |
order_status |
query | integer | No | Order Status | |
ordering |
query | string | No | Which field to use when ordering the results. | |
part |
query | integer | No | Supplier Part | |
part_detail |
query | boolean | False | No | Include detailed information about the related part in the response |
pending |
query | boolean | No | Order Pending | |
received |
query | boolean | No | Items Received | |
search |
query | string | No | A search term. Searched fields: part__SKU, part__manufacturer_part__MPN, part__part__description, part__part__name, reference. |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/PurchaseOrderLineItem"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
POST /api/order/po-line/¶
Description
API endpoint for accessing a list of PurchaseOrderLineItem objects.
- GET: Return a list of PurchaseOrder Line Item objects
- POST: Create a new PurchaseOrderLineItem object
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the request body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"required": [
"internal_part",
"internal_part_name",
"order",
"part",
"pk",
"quantity",
"received",
"total_price"
],
"type": "object"
}
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the request body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"required": [
"internal_part",
"internal_part_name",
"order",
"part",
"pk",
"quantity",
"received",
"total_price"
],
"type": "object"
}
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the request body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"required": [
"internal_part",
"internal_part_name",
"order",
"part",
"pk",
"quantity",
"received",
"total_price"
],
"type": "object"
}
Response 201 Created
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the response body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"required": [
"internal_part",
"internal_part_name",
"order",
"part",
"pk",
"quantity",
"received",
"total_price"
],
"type": "object"
}
DELETE /api/order/po-line/{id}/¶
Description
Detail API endpoint for PurchaseOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/po-line/{id}/¶
Description
Detail API endpoint for PurchaseOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No | ||
order_detail |
query | boolean | False | No | Include detailed information about the sales order in the response |
part_detail |
query | boolean | False | No | Include detailed information about the related part in the response |
Response 200 OK
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the response body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"required": [
"internal_part",
"internal_part_name",
"order",
"part",
"pk",
"quantity",
"received",
"total_price"
],
"type": "object"
}
PATCH /api/order/po-line/{id}/¶
Description
Detail API endpoint for PurchaseOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the request body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"type": "object"
}
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the request body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"type": "object"
}
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the request body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"type": "object"
}
Response 200 OK
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the response body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"required": [
"internal_part",
"internal_part_name",
"order",
"part",
"pk",
"quantity",
"received",
"total_price"
],
"type": "object"
}
PUT /api/order/po-line/{id}/¶
Description
Detail API endpoint for PurchaseOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the request body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"required": [
"internal_part",
"internal_part_name",
"order",
"part",
"pk",
"quantity",
"received",
"total_price"
],
"type": "object"
}
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the request body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"required": [
"internal_part",
"internal_part_name",
"order",
"part",
"pk",
"quantity",
"received",
"total_price"
],
"type": "object"
}
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the request body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"required": [
"internal_part",
"internal_part_name",
"order",
"part",
"pk",
"quantity",
"received",
"total_price"
],
"type": "object"
}
Response 200 OK
{
"auto_pricing": true,
"build_order": 0,
"build_order_detail": null,
"destination": 0,
"destination_detail": null,
"internal_part": 0,
"internal_part_name": "string",
"ipn": "string",
"link": "string",
"merge_items": true,
"mpn": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"received": 10.12,
"reference": "string",
"sku": "string",
"supplier_part_detail": null,
"target_date": "2022-04-13",
"total_price": 10.12
}
Schema of the response body
{
"description": "Serializer class for the PurchaseOrderLineItem model.",
"properties": {
"auto_pricing": {
"default": true,
"description": "Automatically calculate purchase price based on supplier part data",
"type": "boolean"
},
"build_order": {
"description": "External Build Order to be fulfilled by this line item",
"nullable": true,
"type": "integer"
},
"build_order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Build"
}
],
"nullable": true,
"readOnly": true
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"destination_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"internal_part": {
"readOnly": true,
"type": "integer"
},
"internal_part_name": {
"readOnly": true,
"type": "string"
},
"ipn": {
"nullable": true,
"readOnly": true,
"title": "Internal Part Number",
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"merge_items": {
"default": true,
"description": "Merge items with the same part, destination and target date into one line item",
"type": "boolean",
"writeOnly": true
},
"mpn": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Purchase Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PurchaseOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"nullable": true,
"title": "Supplier Part",
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"purchase_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"purchase_price_currency": {
"description": "Purchase price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"quantity": {
"format": "double",
"minimum": 0,
"type": "number"
},
"received": {
"default": 0.0,
"format": "double",
"readOnly": true,
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sku": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"supplier_part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SupplierPart"
}
],
"nullable": true,
"readOnly": true
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "double",
"readOnly": true,
"type": "number"
}
},
"required": [
"internal_part",
"internal_part_name",
"order",
"part",
"pk",
"quantity",
"received",
"total_price"
],
"type": "object"
}
GET /api/order/po-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PATCH /api/order/po-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PUT /api/order/po-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
GET /api/order/po/¶
Description
Override the GET method to determine export options.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
assigned_to |
query | integer | No | Responsible | |
assigned_to_me |
query | boolean | No | Assigned to me | |
completed_after |
query | string | No | Completed After | |
completed_before |
query | string | No | Completed Before | |
created_after |
query | string | No | Created After | |
created_before |
query | string | No | Created Before | |
created_by |
query | integer | No | Created By | |
external_build |
query | integer | No | External Build Order | |
has_project_code |
query | boolean | No | Has Project Code | |
has_start_date |
query | boolean | No | Has Start Date | |
has_target_date |
query | boolean | No | Has Target Date | |
limit |
query | integer | No | Number of results to return per page. | |
max_date |
query | string | No | Max Date | |
min_date |
query | string | No | Min Date | |
offset |
query | integer | No | The initial index from which to return the results. | |
ordering |
query | string | No | Which field to use when ordering the results. | |
outstanding |
query | boolean | No | Outstanding | |
overdue |
query | boolean | No | overdue | |
part |
query | integer | No | Part | |
project_code |
query | integer | No | Project Code | |
reference |
query | string | No | Order Reference | |
search |
query | string | No | A search term. Searched fields: description, project_code__code, reference, supplier__name, supplier_reference. | |
start_date_after |
query | string | No | Start Date After | |
start_date_before |
query | string | No | Start Date Before | |
status |
query | integer | No | Order Status | |
supplier |
query | integer | No | ||
supplier_detail |
query | boolean | False | No | Include detailed information about the supplier in the response |
supplier_part |
query | integer | No | Supplier Part | |
target_date_after |
query | string | No | Target Date After | |
target_date_before |
query | string | No | Target Date Before |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 128,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/PurchaseOrder"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
POST /api/order/po/¶
Description
API endpoint for accessing a list of PurchaseOrder objects.
- GET: Return list of PurchaseOrder objects (with filters)
- POST: Create a new PurchaseOrder object
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 4,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text",
"supplier",
"supplier_name"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 102,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text",
"supplier",
"supplier_name"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 87,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text",
"supplier",
"supplier_name"
],
"type": "object"
}
Response 201 Created
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 124,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text",
"supplier",
"supplier_name"
],
"type": "object"
}
GET /api/order/po/status/¶
Description
Retrieve information about a specific status code
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Response 200 OK
{
"status_class": "string",
"values": {}
}
Schema of the response body
{
"description": "API serializer for generic state class information.",
"properties": {
"status_class": {
"readOnly": true,
"title": "Class",
"type": "string"
},
"values": {
"additionalProperties": {
"$ref": "#/components/schemas/GenericStateValue"
},
"type": "object"
}
},
"required": [
"status_class",
"values"
],
"type": "object"
}
Response 400 Bad Request
DELETE /api/order/po/{id}/¶
Description
API endpoint for detail view of a PurchaseOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/po/{id}/¶
Description
API endpoint for detail view of a PurchaseOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No | ||
supplier_detail |
query | boolean | False | No | Include detailed information about the supplier in the response |
Response 200 OK
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 249,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text",
"supplier",
"supplier_name"
],
"type": "object"
}
PATCH /api/order/po/{id}/¶
Description
API endpoint for detail view of a PurchaseOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 86,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 165,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 299,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
Response 200 OK
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 119,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text",
"supplier",
"supplier_name"
],
"type": "object"
}
PUT /api/order/po/{id}/¶
Description
API endpoint for detail view of a PurchaseOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 92,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text",
"supplier",
"supplier_name"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 156,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text",
"supplier",
"supplier_name"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 279,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text",
"supplier",
"supplier_name"
],
"type": "object"
}
Response 200 OK
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"description": "string",
"destination": 0,
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 137,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"supplier": 0,
"supplier_detail": null,
"supplier_name": "string",
"supplier_reference": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for a PurchaseOrder object.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"readOnly": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"destination": {
"description": "Destination for received items",
"nullable": true,
"type": "integer"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - Placed\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"supplier": {
"description": "Company from which the items are being ordered",
"nullable": true,
"type": "integer"
},
"supplier_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"supplier_name": {
"readOnly": true,
"type": "string"
},
"supplier_reference": {
"description": "Supplier order reference code",
"maxLength": 64,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text",
"supplier",
"supplier_name"
],
"type": "object"
}
POST /api/order/po/{id}/cancel/¶
Description
API endpoint to 'cancel' a purchase order.
The purchase order must be in a state which can be cancelled
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 201 Created
POST /api/order/po/{id}/complete/¶
Description
API endpoint to 'complete' a purchase order.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"accept_incomplete": true
}
Schema of the request body
{
"description": "Serializer for completing a purchase order.",
"properties": {
"accept_incomplete": {
"default": false,
"description": "Allow order to be closed with incomplete line items",
"type": "boolean"
}
},
"type": "object"
}
{
"accept_incomplete": true
}
Schema of the request body
{
"description": "Serializer for completing a purchase order.",
"properties": {
"accept_incomplete": {
"default": false,
"description": "Allow order to be closed with incomplete line items",
"type": "boolean"
}
},
"type": "object"
}
{
"accept_incomplete": true
}
Schema of the request body
{
"description": "Serializer for completing a purchase order.",
"properties": {
"accept_incomplete": {
"default": false,
"description": "Allow order to be closed with incomplete line items",
"type": "boolean"
}
},
"type": "object"
}
Response 201 Created
{
"accept_incomplete": true
}
Schema of the response body
{
"description": "Serializer for completing a purchase order.",
"properties": {
"accept_incomplete": {
"default": false,
"description": "Allow order to be closed with incomplete line items",
"type": "boolean"
}
},
"type": "object"
}
POST /api/order/po/{id}/hold/¶
Description
API endpoint to place a PurchaseOrder on hold.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 201 Created
POST /api/order/po/{id}/issue/¶
Description
API endpoint to 'issue' (place) a PurchaseOrder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 201 Created
GET /api/order/po/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PATCH /api/order/po/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PUT /api/order/po/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
POST /api/order/po/{id}/receive/¶
Description
API endpoint to receive stock items against a PurchaseOrder.
- The purchase order is specified in the URL.
- Items to receive are specified as a list called "items" with the following
options:
- line_item: pk of the PO Line item
- supplier_part: pk value of the supplier part
- quantity: quantity to receive
- status: stock item status
- expiry_date: stock item expiry date (optional)
- location: destination for stock item (optional)
- batch_code: the batch code for this stock item
- serial_numbers: serial numbers for this stock item
- A global location must also be specified. This is used when no locations are specified for items, and no location is given in the PO line item
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"items": [
{
"barcode": "string",
"batch_code": "string",
"expiry_date": "2022-04-13",
"line_item": 0,
"location": 0,
"note": "string",
"packaging": "string",
"quantity": "string",
"serial_numbers": "string",
"status": 0
}
],
"location": 0
}
Schema of the request body
{
"description": "Serializer for receiving items against a PurchaseOrder.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/PurchaseOrderLineItemReceive"
},
"type": "array"
},
"location": {
"description": "Select destination location for received items",
"nullable": true,
"type": "integer"
}
},
"required": [
"items"
],
"type": "object"
}
{
"items": [
{
"barcode": "string",
"batch_code": "string",
"expiry_date": "2022-04-13",
"line_item": 0,
"location": 0,
"note": "string",
"packaging": "string",
"quantity": "string",
"serial_numbers": "string",
"status": 0
}
],
"location": 0
}
Schema of the request body
{
"description": "Serializer for receiving items against a PurchaseOrder.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/PurchaseOrderLineItemReceive"
},
"type": "array"
},
"location": {
"description": "Select destination location for received items",
"nullable": true,
"type": "integer"
}
},
"required": [
"items"
],
"type": "object"
}
{
"items": [
{
"barcode": "string",
"batch_code": "string",
"expiry_date": "2022-04-13",
"line_item": 0,
"location": 0,
"note": "string",
"packaging": "string",
"quantity": "string",
"serial_numbers": "string",
"status": 0
}
],
"location": 0
}
Schema of the request body
{
"description": "Serializer for receiving items against a PurchaseOrder.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/PurchaseOrderLineItemReceive"
},
"type": "array"
},
"location": {
"description": "Select destination location for received items",
"nullable": true,
"type": "integer"
}
},
"required": [
"items"
],
"type": "object"
}
Response 201 Created
[
{
"MPN": "string",
"SKU": "string",
"allocated": 10.12,
"barcode_hash": "string",
"batch": "string",
"belongs_to": 0,
"build": 0,
"child_items": 0,
"consumed_by": 0,
"customer": 0,
"delete_on_deplete": true,
"expired": true,
"expiry_date": "2022-04-13",
"in_stock": true,
"installed_items": 0,
"is_building": true,
"link": "string",
"location": 0,
"location_detail": null,
"location_path": [
{}
],
"notes": "string",
"owner": 0,
"packaging": "string",
"parent": 0,
"part": 0,
"part_detail": null,
"pk": 0,
"purchase_order": 0,
"purchase_order_reference": "string",
"purchase_price": "string",
"purchase_price_currency": "string",
"quantity": 10.12,
"sales_order": 0,
"sales_order_reference": "string",
"serial": "string",
"serial_numbers": "string",
"stale": true,
"status": null,
"status_custom_key": 0,
"status_text": "string",
"stocktake_date": "2022-04-13",
"supplier_part": 0,
"supplier_part_detail": null,
"tags": [
"string"
],
"tests": [
{
"attachment": "string",
"date": "2022-04-13T15:42:05.901Z",
"finished_datetime": "2022-04-13T15:42:05.901Z",
"notes": "string",
"pk": 0,
"result": true,
"started_datetime": "2022-04-13T15:42:05.901Z",
"stock_item": 0,
"template": 0,
"template_detail": null,
"test_station": "string",
"user": 0,
"user_detail": null,
"value": "string"
}
],
"tracking_items": 0,
"updated": "2022-04-13T15:42:05.901Z",
"use_pack_size": true
}
]
Schema of the response body
{
"items": {
"$ref": "#/components/schemas/StockItem"
},
"type": "array"
}
GET /api/order/ro-extra-line/¶
Description
Override the GET method to determine export options.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
limit |
query | integer | No | Number of results to return per page. | |
offset |
query | integer | No | The initial index from which to return the results. | |
order |
query | integer | No | ||
order_detail |
query | boolean | False | No | Include detailed information about the sales order in the response |
ordering |
query | string | No | Which field to use when ordering the results. | |
search |
query | string | No | A search term. Searched fields: description, notes, quantity, reference. |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/ReturnOrderExtraLine"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
POST /api/order/ro-extra-line/¶
Description
API endpoint for accessing a list of ReturnOrderExtraLine objects.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
Response 201 Created
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
DELETE /api/order/ro-extra-line/{id}/¶
Description
API endpoint for detail view of a ReturnOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/ro-extra-line/{id}/¶
Description
API endpoint for detail view of a ReturnOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
PATCH /api/order/ro-extra-line/{id}/¶
Description
API endpoint for detail view of a ReturnOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
Response 200 OK
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
PUT /api/order/ro-extra-line/{id}/¶
Description
API endpoint for detail view of a ReturnOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
Response 200 OK
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a ReturnOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
GET /api/order/ro-extra-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PATCH /api/order/ro-extra-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PUT /api/order/ro-extra-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
GET /api/order/ro-line/¶
Description
Override the GET method to determine export options.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
has_pricing |
query | boolean | No | Has Pricing | |
item |
query | integer | No | ||
item_detail |
query | boolean | True | No | Include detailed information about the item in the response |
limit |
query | integer | No | Number of results to return per page. | |
offset |
query | integer | No | The initial index from which to return the results. | |
order |
query | integer | No | ||
order_detail |
query | boolean | False | No | Include detailed information about the sales order in the response |
order_status |
query | integer | No | Order Status | |
ordering |
query | string | No | Which field to use when ordering the results. | |
outcome |
query | integer | No | outcome | |
part_detail |
query | boolean | False | No | Include detailed information about the related part in the response |
received |
query | boolean | No | received | |
search |
query | string | No | A search term. Searched fields: item__part__description, item__part__name, item__serial, reference. |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/ReturnOrderLineItem"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
POST /api/order/ro-line/¶
Description
API endpoint for accessing a list of ReturnOrderLineItemList objects.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"item",
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"item",
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"item",
"order",
"pk",
"quantity"
],
"type": "object"
}
Response 201 Created
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"item",
"order",
"pk",
"quantity"
],
"type": "object"
}
GET /api/order/ro-line/status/¶
Description
Retrieve information about a specific status code
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Response 200 OK
{
"status_class": "string",
"values": {}
}
Schema of the response body
{
"description": "API serializer for generic state class information.",
"properties": {
"status_class": {
"readOnly": true,
"title": "Class",
"type": "string"
},
"values": {
"additionalProperties": {
"$ref": "#/components/schemas/GenericStateValue"
},
"type": "object"
}
},
"required": [
"status_class",
"values"
],
"type": "object"
}
Response 400 Bad Request
DELETE /api/order/ro-line/{id}/¶
Description
API endpoint for detail view of a ReturnOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/ro-line/{id}/¶
Description
API endpoint for detail view of a ReturnOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No | ||
item_detail |
query | boolean | True | No | Include detailed information about the item in the response |
order_detail |
query | boolean | False | No | Include detailed information about the sales order in the response |
part_detail |
query | boolean | False | No | Include detailed information about the related part in the response |
Response 200 OK
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"item",
"order",
"pk",
"quantity"
],
"type": "object"
}
PATCH /api/order/ro-line/{id}/¶
Description
API endpoint for detail view of a ReturnOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
Response 200 OK
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"item",
"order",
"pk",
"quantity"
],
"type": "object"
}
PUT /api/order/ro-line/{id}/¶
Description
API endpoint for detail view of a ReturnOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"item",
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"item",
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"item",
"order",
"pk",
"quantity"
],
"type": "object"
}
Response 200 OK
{
"item": 0,
"item_detail": null,
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"outcome": null,
"part_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"received_date": "2022-04-13",
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a ReturnOrderLineItem object.",
"properties": {
"item": {
"description": "Select item to return from customer",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Return Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ReturnOrder"
}
],
"nullable": true,
"readOnly": true
},
"outcome": {
"allOf": [
{
"$ref": "#/components/schemas/OutcomeEnum"
}
],
"description": "Outcome for this line item\n\n* `10` - Pending\n* `20` - Return\n* `30` - Repair\n* `40` - Replace\n* `50` - Refund\n* `60` - Reject",
"maximum": 9223372036854775807,
"minimum": 0
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Line price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"description": "Quantity to return",
"format": "double",
"type": "number"
},
"received_date": {
"description": "The date this this return item was received",
"format": "date",
"nullable": true,
"type": "string"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"item",
"order",
"pk",
"quantity"
],
"type": "object"
}
GET /api/order/ro-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PATCH /api/order/ro-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PUT /api/order/ro-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
GET /api/order/ro/¶
Description
Override the GET method to determine export options.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
assigned_to |
query | integer | No | Responsible | |
assigned_to_me |
query | boolean | No | Assigned to me | |
completed_after |
query | string | No | Completed After | |
completed_before |
query | string | No | Completed Before | |
created_after |
query | string | No | Created After | |
created_before |
query | string | No | Created Before | |
created_by |
query | integer | No | Created By | |
customer |
query | integer | No | ||
customer_detail |
query | boolean | False | No | Include detailed information about the customer in the response |
has_project_code |
query | boolean | No | Has Project Code | |
has_start_date |
query | boolean | No | Has Start Date | |
has_target_date |
query | boolean | No | Has Target Date | |
include_variants |
query | boolean | No | Include Variants | |
limit |
query | integer | No | Number of results to return per page. | |
max_date |
query | string | No | Max Date | |
min_date |
query | string | No | Min Date | |
offset |
query | integer | No | The initial index from which to return the results. | |
ordering |
query | string | No | Which field to use when ordering the results. | |
outstanding |
query | boolean | No | Outstanding | |
overdue |
query | boolean | No | overdue | |
part |
query | integer | No | ||
project_code |
query | integer | No | Project Code | |
reference |
query | string | No | Order Reference | |
search |
query | string | No | A search term. Searched fields: customer__name, customer_reference, description, project_code__code, reference. | |
start_date_after |
query | string | No | Start Date After | |
start_date_before |
query | string | No | Start Date Before | |
status |
query | integer | No | Order Status | |
target_date_after |
query | string | No | Target Date After | |
target_date_before |
query | string | No | Target Date Before |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 275,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/ReturnOrder"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
POST /api/order/ro/¶
Description
API endpoint for accessing a list of ReturnOrder objects.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 93,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 68,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 207,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
Response 201 Created
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 175,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
GET /api/order/ro/status/¶
Description
Retrieve information about a specific status code
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Response 200 OK
{
"status_class": "string",
"values": {}
}
Schema of the response body
{
"description": "API serializer for generic state class information.",
"properties": {
"status_class": {
"readOnly": true,
"title": "Class",
"type": "string"
},
"values": {
"additionalProperties": {
"$ref": "#/components/schemas/GenericStateValue"
},
"type": "object"
}
},
"required": [
"status_class",
"values"
],
"type": "object"
}
Response 400 Bad Request
DELETE /api/order/ro/{id}/¶
Description
API endpoint for detail view of a single ReturnOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/ro/{id}/¶
Description
API endpoint for detail view of a single ReturnOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
customer_detail |
query | boolean | False | No | Include detailed information about the customer in the response |
id |
path | integer | No |
Response 200 OK
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 44,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
PATCH /api/order/ro/{id}/¶
Description
API endpoint for detail view of a single ReturnOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 299,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 279,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 181,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
Response 200 OK
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 258,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
PUT /api/order/ro/{id}/¶
Description
API endpoint for detail view of a single ReturnOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 183,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 37,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 119,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
Response 200 OK
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"complete_date": "2022-04-13",
"completed_lines": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 33,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for the ReturnOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"complete_date": {
"description": "Date order was completed",
"format": "date",
"nullable": true,
"title": "Completion Date",
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company from which items are being returned",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `20` - In Progress\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
POST /api/order/ro/{id}/cancel/¶
Description
API endpoint to cancel a ReturnOrder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 201 Created
POST /api/order/ro/{id}/complete/¶
Description
API endpoint to complete a ReturnOrder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 201 Created
POST /api/order/ro/{id}/hold/¶
Description
API endpoint to hold a ReturnOrder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 201 Created
POST /api/order/ro/{id}/issue/¶
Description
API endpoint to issue (place) a ReturnOrder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 201 Created
GET /api/order/ro/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PATCH /api/order/ro/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PUT /api/order/ro/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
POST /api/order/ro/{id}/receive/¶
Description
API endpoint to receive items against a ReturnOrder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"items": [
{
"item": 0,
"status": 0
}
],
"location": 0,
"note": "string"
}
Schema of the request body
{
"description": "Serializer for receiving items against a ReturnOrder.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/ReturnOrderLineItemReceive"
},
"type": "array"
},
"location": {
"description": "Select destination location for received items",
"type": "integer"
},
"note": {
"default": "",
"description": "Additional note for incoming stock items",
"type": "string"
}
},
"required": [
"items",
"location"
],
"type": "object"
}
{
"items": [
{
"item": 0,
"status": 0
}
],
"location": 0,
"note": "string"
}
Schema of the request body
{
"description": "Serializer for receiving items against a ReturnOrder.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/ReturnOrderLineItemReceive"
},
"type": "array"
},
"location": {
"description": "Select destination location for received items",
"type": "integer"
},
"note": {
"default": "",
"description": "Additional note for incoming stock items",
"type": "string"
}
},
"required": [
"items",
"location"
],
"type": "object"
}
{
"items": [
{
"item": 0,
"status": 0
}
],
"location": 0,
"note": "string"
}
Schema of the request body
{
"description": "Serializer for receiving items against a ReturnOrder.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/ReturnOrderLineItemReceive"
},
"type": "array"
},
"location": {
"description": "Select destination location for received items",
"type": "integer"
},
"note": {
"default": "",
"description": "Additional note for incoming stock items",
"type": "string"
}
},
"required": [
"items",
"location"
],
"type": "object"
}
Response 201 Created
{
"items": [
{
"item": 0,
"status": 0
}
],
"location": 0,
"note": "string"
}
Schema of the response body
{
"description": "Serializer for receiving items against a ReturnOrder.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/ReturnOrderLineItemReceive"
},
"type": "array"
},
"location": {
"description": "Select destination location for received items",
"type": "integer"
},
"note": {
"default": "",
"description": "Additional note for incoming stock items",
"type": "string"
}
},
"required": [
"items",
"location"
],
"type": "object"
}
GET /api/order/so-allocation/¶
Description
API endpoint for listing SalesOrderAllocation objects.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
assigned_to_shipment |
query | boolean | No | Has Shipment | |
customer_detail |
query | boolean | False | No | Include detailed information about the customer in the response |
include_variants |
query | boolean | No | Include Variants | |
item |
query | integer | No | ||
item_detail |
query | boolean | False | No | Include detailed information about the item in the response |
limit |
query | integer | No | Number of results to return per page. | |
line |
query | integer | No | ||
location |
query | integer | No | Location | |
location_detail |
query | boolean | False | No | Include detailed information about the stock location in the response |
offset |
query | integer | No | The initial index from which to return the results. | |
order |
query | integer | No | Order | |
order_detail |
query | boolean | False | No | Include detailed information about the sales order in the response |
ordering |
query | string | No | Which field to use when ordering the results. | |
outstanding |
query | boolean | No | Outstanding | |
part |
query | integer | No | Part | |
part_detail |
query | boolean | False | No | Include detailed information about the related part in the response |
search |
query | string | No | A search term. Searched fields: item__batch, item__part__IPN, item__part__name, item__serial. | |
shipment |
query | integer | No |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/SalesOrderAllocation"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
PATCH /api/order/so-allocation/¶
Description
Perform a PATCH operation against this list endpoint.
Note that the typical DRF list endpoint does not support PATCH, so this method is provided as a custom implementation.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"type": "object"
}
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"type": "object"
}
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"type": "object"
}
Response 200 OK
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the response body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
PUT /api/order/so-allocation/¶
Description
Perform a PUT operation against this list endpoint.
Simply redirects to the PATCH method.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
Response 200 OK
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the response body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
DELETE /api/order/so-allocation/{id}/¶
Description
API endpoint for detail view of a SalesOrderAllocation object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/so-allocation/{id}/¶
Description
API endpoint for detail view of a SalesOrderAllocation object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the response body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
PATCH /api/order/so-allocation/{id}/¶
Description
API endpoint for detail view of a SalesOrderAllocation object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"type": "object"
}
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"type": "object"
}
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"type": "object"
}
Response 200 OK
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the response body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
PUT /api/order/so-allocation/{id}/¶
Description
API endpoint for detail view of a SalesOrderAllocation object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the request body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
Response 200 OK
{
"customer_detail": null,
"item": 0,
"item_detail": null,
"line": 0,
"location": 0,
"location_detail": null,
"order": 0,
"order_detail": null,
"part": 0,
"part_detail": null,
"pk": 0,
"quantity": 10.12,
"serial": "string",
"shipment": 0,
"shipment_detail": null
}
Schema of the response body
{
"description": "Serializer for the SalesOrderAllocation model.\n\nThis includes some fields from the related model objects.",
"properties": {
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"item": {
"description": "Select stock item to allocate",
"type": "integer"
},
"item_detail": {
"allOf": [
{
"$ref": "#/components/schemas/StockItem"
}
],
"nullable": true,
"readOnly": true
},
"line": {
"readOnly": true,
"type": "integer"
},
"location": {
"readOnly": true,
"type": "integer"
},
"location_detail": {
"allOf": [
{
"$ref": "#/components/schemas/LocationBrief"
}
],
"nullable": true,
"readOnly": true
},
"order": {
"readOnly": true,
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"part": {
"readOnly": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"quantity": {
"format": "double",
"type": "number"
},
"serial": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipment": {
"description": "Sales order shipment reference",
"nullable": true,
"type": "integer"
},
"shipment_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrderShipment"
}
],
"nullable": true,
"readOnly": true
}
},
"required": [
"item",
"line",
"location",
"order",
"part",
"pk",
"quantity"
],
"type": "object"
}
GET /api/order/so-extra-line/¶
Description
Override the GET method to determine export options.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
limit |
query | integer | No | Number of results to return per page. | |
offset |
query | integer | No | The initial index from which to return the results. | |
order |
query | integer | No | ||
order_detail |
query | boolean | False | No | Include detailed information about the sales order in the response |
ordering |
query | string | No | Which field to use when ordering the results. | |
search |
query | string | No | A search term. Searched fields: description, notes, quantity, reference. |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/SalesOrderExtraLine"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
POST /api/order/so-extra-line/¶
Description
API endpoint for accessing a list of SalesOrderExtraLine objects.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
Response 201 Created
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
DELETE /api/order/so-extra-line/{id}/¶
Description
API endpoint for detail view of a SalesOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/so-extra-line/{id}/¶
Description
API endpoint for detail view of a SalesOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
PATCH /api/order/so-extra-line/{id}/¶
Description
API endpoint for detail view of a SalesOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
Response 200 OK
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
PUT /api/order/so-extra-line/{id}/¶
Description
API endpoint for detail view of a SalesOrderExtraLine object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
Response 200 OK
{
"description": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"price": "string",
"price_currency": "string",
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a SalesOrderExtraLine object.",
"properties": {
"description": {
"description": "Line item description (optional)",
"maxLength": 250,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"price_currency": {
"description": "Select currency from available options\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"target_date": {
"description": "Target date for this line item (leave blank to use the target date from the order)",
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"order",
"pk",
"quantity"
],
"type": "object"
}
GET /api/order/so-extra-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PATCH /api/order/so-extra-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PUT /api/order/so-extra-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
GET /api/order/so-line/¶
Description
Override the GET method to determine export options.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
allocated |
query | boolean | No | Allocated | |
completed |
query | boolean | No | Completed | |
customer_detail |
query | boolean | False | No | Include detailed information about the customer in the response |
has_pricing |
query | boolean | No | Has Pricing | |
limit |
query | integer | No | Number of results to return per page. | |
offset |
query | integer | No | The initial index from which to return the results. | |
order |
query | integer | No | Order | |
order_complete |
query | boolean | No | Order Complete | |
order_detail |
query | boolean | False | No | Include detailed information about the sales order in the response |
order_outstanding |
query | boolean | No | Order Outstanding | |
order_status |
query | integer | No | Order Status | |
ordering |
query | string | No | Which field to use when ordering the results. | |
part |
query | integer | No | ||
part_detail |
query | boolean | False | No | Include detailed information about the related part in the response |
search |
query | string | No | A search term. Searched fields: part__name, quantity, reference. |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/SalesOrderLineItem"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
POST /api/order/so-line/¶
Description
API endpoint for accessing a list of SalesOrderLineItem objects.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"allocated",
"available_stock",
"available_variant_stock",
"building",
"on_order",
"order",
"pk",
"quantity",
"shipped"
],
"type": "object"
}
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"allocated",
"available_stock",
"available_variant_stock",
"building",
"on_order",
"order",
"pk",
"quantity",
"shipped"
],
"type": "object"
}
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"allocated",
"available_stock",
"available_variant_stock",
"building",
"on_order",
"order",
"pk",
"quantity",
"shipped"
],
"type": "object"
}
Response 201 Created
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"allocated",
"available_stock",
"available_variant_stock",
"building",
"on_order",
"order",
"pk",
"quantity",
"shipped"
],
"type": "object"
}
DELETE /api/order/so-line/{id}/¶
Description
API endpoint for detail view of a SalesOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/so-line/{id}/¶
Description
API endpoint for detail view of a SalesOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
customer_detail |
query | boolean | False | No | Include detailed information about the customer in the response |
id |
path | integer | No | ||
order_detail |
query | boolean | False | No | Include detailed information about the sales order in the response |
part_detail |
query | boolean | False | No | Include detailed information about the related part in the response |
Response 200 OK
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"allocated",
"available_stock",
"available_variant_stock",
"building",
"on_order",
"order",
"pk",
"quantity",
"shipped"
],
"type": "object"
}
PATCH /api/order/so-line/{id}/¶
Description
API endpoint for detail view of a SalesOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"type": "object"
}
Response 200 OK
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"allocated",
"available_stock",
"available_variant_stock",
"building",
"on_order",
"order",
"pk",
"quantity",
"shipped"
],
"type": "object"
}
PUT /api/order/so-line/{id}/¶
Description
API endpoint for detail view of a SalesOrderLineItem object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"allocated",
"available_stock",
"available_variant_stock",
"building",
"on_order",
"order",
"pk",
"quantity",
"shipped"
],
"type": "object"
}
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"allocated",
"available_stock",
"available_variant_stock",
"building",
"on_order",
"order",
"pk",
"quantity",
"shipped"
],
"type": "object"
}
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the request body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"allocated",
"available_stock",
"available_variant_stock",
"building",
"on_order",
"order",
"pk",
"quantity",
"shipped"
],
"type": "object"
}
Response 200 OK
{
"allocated": 10.12,
"available_stock": 10.12,
"available_variant_stock": 10.12,
"building": 10.12,
"customer_detail": null,
"link": "string",
"notes": "string",
"on_order": 10.12,
"order": 0,
"order_detail": null,
"overdue": true,
"part": 0,
"part_detail": null,
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"quantity": 10.12,
"reference": "string",
"sale_price": "string",
"sale_price_currency": "string",
"shipped": 10.12,
"target_date": "2022-04-13"
}
Schema of the response body
{
"description": "Serializer for a SalesOrderLineItem object.",
"properties": {
"allocated": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"available_variant_stock": {
"format": "double",
"readOnly": true,
"type": "number"
},
"building": {
"format": "double",
"readOnly": true,
"title": "In Production",
"type": "number"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Line item notes",
"maxLength": 500,
"type": "string"
},
"on_order": {
"format": "double",
"readOnly": true,
"type": "number"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"part": {
"description": "Part",
"nullable": true,
"type": "integer"
},
"part_detail": {
"allOf": [
{
"$ref": "#/components/schemas/PartBrief"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"quantity": {
"format": "double",
"type": "number"
},
"reference": {
"description": "Line item reference",
"maxLength": 100,
"type": "string"
},
"sale_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"type": "string"
},
"sale_price_currency": {
"description": "Sale price currency\n\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"title": "Currency",
"type": "string"
},
"shipped": {
"format": "double",
"readOnly": true,
"type": "number"
},
"target_date": {
"format": "date",
"nullable": true,
"type": "string"
}
},
"required": [
"allocated",
"available_stock",
"available_variant_stock",
"building",
"on_order",
"order",
"pk",
"quantity",
"shipped"
],
"type": "object"
}
GET /api/order/so-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PATCH /api/order/so-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PUT /api/order/so-line/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
GET /api/order/so/¶
Description
Override the GET method to determine export options.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
assigned_to |
query | integer | No | Responsible | |
assigned_to_me |
query | boolean | No | Assigned to me | |
completed_after |
query | string | No | Completed After | |
completed_before |
query | string | No | Completed Before | |
created_after |
query | string | No | Created After | |
created_before |
query | string | No | Created Before | |
created_by |
query | integer | No | Created By | |
customer |
query | integer | No | ||
customer_detail |
query | boolean | False | No | Include detailed information about the customer in the response |
has_project_code |
query | boolean | No | Has Project Code | |
has_start_date |
query | boolean | No | Has Start Date | |
has_target_date |
query | boolean | No | Has Target Date | |
include_variants |
query | boolean | No | Include Variants | |
limit |
query | integer | No | Number of results to return per page. | |
max_date |
query | string | No | Max Date | |
min_date |
query | string | No | Min Date | |
offset |
query | integer | No | The initial index from which to return the results. | |
ordering |
query | string | No | Which field to use when ordering the results. | |
outstanding |
query | boolean | No | Outstanding | |
overdue |
query | boolean | No | overdue | |
part |
query | integer | No | ||
project_code |
query | integer | No | Project Code | |
reference |
query | string | No | Order Reference | |
search |
query | string | No | A search term. Searched fields: customer__name, customer_reference, description, project_code__code, reference. | |
start_date_after |
query | string | No | Start Date After | |
start_date_before |
query | string | No | Start Date Before | |
status |
query | integer | No | Order Status | |
target_date_after |
query | string | No | Target Date After | |
target_date_before |
query | string | No | Target Date Before |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 50,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/SalesOrder"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
POST /api/order/so/¶
Description
API endpoint for accessing a list of SalesOrder objects.
- GET: Return list of SalesOrder objects (with filters)
- POST: Create a new SalesOrder
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 198,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 208,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 71,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
Response 201 Created
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 43,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
GET /api/order/so/shipment/¶
Description
API list endpoint for SalesOrderShipment model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
checked |
query | boolean | No | checked | |
delivered |
query | boolean | No | delivered | |
limit |
query | integer | No | Number of results to return per page. | |
offset |
query | integer | No | The initial index from which to return the results. | |
order |
query | integer | No | ||
order_outstanding |
query | boolean | No | Order Outstanding | |
order_status |
query | number | No | Order Status | |
ordering |
query | string | No | Which field to use when ordering the results. | |
search |
query | string | No | A search term. Searched fields: invoice_number, order__reference, reference, tracking_number. | |
shipped |
query | boolean | No | shipped |
Response 200 OK
{
"count": 123,
"next": "http://api.example.org/accounts/?offset=400&limit=100",
"previous": "http://api.example.org/accounts/?offset=200&limit=100",
"results": [
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
]
}
Schema of the response body
{
"properties": {
"count": {
"example": 123,
"type": "integer"
},
"next": {
"example": "http://api.example.org/accounts/?offset=400&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"previous": {
"example": "http://api.example.org/accounts/?offset=200&limit=100",
"format": "uri",
"nullable": true,
"type": "string"
},
"results": {
"items": {
"$ref": "#/components/schemas/SalesOrderShipment"
},
"type": "array"
}
},
"required": [
"count",
"results"
],
"type": "object"
}
POST /api/order/so/shipment/¶
Description
API list endpoint for SalesOrderShipment model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Request body
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"required": [
"order",
"pk"
],
"type": "object"
}
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"required": [
"order",
"pk"
],
"type": "object"
}
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"required": [
"order",
"pk"
],
"type": "object"
}
Response 201 Created
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the response body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"required": [
"order",
"pk"
],
"type": "object"
}
DELETE /api/order/so/shipment/{id}/¶
Description
API detail endpoint for SalesOrderShipment model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/so/shipment/{id}/¶
Description
API detail endpoint for SalesOrderShipment model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the response body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"required": [
"order",
"pk"
],
"type": "object"
}
PATCH /api/order/so/shipment/{id}/¶
Description
API detail endpoint for SalesOrderShipment model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"type": "object"
}
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"type": "object"
}
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"type": "object"
}
Response 200 OK
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the response body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"required": [
"order",
"pk"
],
"type": "object"
}
PUT /api/order/so/shipment/{id}/¶
Description
API detail endpoint for SalesOrderShipment model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"required": [
"order",
"pk"
],
"type": "object"
}
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"required": [
"order",
"pk"
],
"type": "object"
}
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"required": [
"order",
"pk"
],
"type": "object"
}
Response 200 OK
{
"allocated_items": 0,
"barcode_hash": "string",
"checked_by": 0,
"checked_by_detail": null,
"customer_detail": null,
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"notes": "string",
"order": 0,
"order_detail": null,
"pk": 0,
"reference": "string",
"shipment_address": 0,
"shipment_address_detail": null,
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the response body
{
"description": "Serializer for the SalesOrderShipment class.",
"properties": {
"allocated_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"barcode_hash": {
"description": "Unique hash of barcode data",
"maxLength": 128,
"type": "string"
},
"checked_by": {
"description": "User who checked this shipment",
"nullable": true,
"type": "integer"
},
"checked_by_detail": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"nullable": true,
"readOnly": true
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order": {
"description": "Sales Order",
"type": "integer"
},
"order_detail": {
"allOf": [
{
"$ref": "#/components/schemas/SalesOrder"
}
],
"nullable": true,
"readOnly": true
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"reference": {
"default": "1",
"description": "Shipment number",
"maxLength": 100,
"title": "Shipment",
"type": "string"
},
"shipment_address": {
"description": "Shipping address for this shipment",
"nullable": true,
"title": "Address",
"type": "integer"
},
"shipment_address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"required": [
"order",
"pk"
],
"type": "object"
}
GET /api/order/so/shipment/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PATCH /api/order/so/shipment/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PUT /api/order/so/shipment/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
POST /api/order/so/shipment/{id}/ship/¶
Description
API endpoint for completing (shipping) a SalesOrderShipment.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for completing (shipping) a SalesOrderShipment.",
"properties": {
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"type": "object"
}
{
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for completing (shipping) a SalesOrderShipment.",
"properties": {
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"type": "object"
}
{
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the request body
{
"description": "Serializer for completing (shipping) a SalesOrderShipment.",
"properties": {
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"type": "object"
}
Response 201 Created
{
"delivery_date": "2022-04-13",
"invoice_number": "string",
"link": "string",
"shipment_date": "2022-04-13",
"tracking_number": "string"
}
Schema of the response body
{
"description": "Serializer for completing (shipping) a SalesOrderShipment.",
"properties": {
"delivery_date": {
"description": "Date of delivery of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"invoice_number": {
"description": "Reference number for associated invoice",
"maxLength": 100,
"type": "string"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"shipment_date": {
"description": "Date of shipment",
"format": "date",
"nullable": true,
"type": "string"
},
"tracking_number": {
"description": "Shipment tracking information",
"maxLength": 100,
"type": "string"
}
},
"type": "object"
}
GET /api/order/so/status/¶
Description
Retrieve information about a specific status code
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
Response 200 OK
{
"status_class": "string",
"values": {}
}
Schema of the response body
{
"description": "API serializer for generic state class information.",
"properties": {
"status_class": {
"readOnly": true,
"title": "Class",
"type": "string"
},
"values": {
"additionalProperties": {
"$ref": "#/components/schemas/GenericStateValue"
},
"type": "object"
}
},
"required": [
"status_class",
"values"
],
"type": "object"
}
Response 400 Bad Request
DELETE /api/order/so/{id}/¶
Description
API endpoint for detail view of a SalesOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 204 No Content
GET /api/order/so/{id}/¶
Description
API endpoint for detail view of a SalesOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
customer_detail |
query | boolean | False | No | Include detailed information about the customer in the response |
id |
path | integer | No |
Response 200 OK
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 195,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
PATCH /api/order/so/{id}/¶
Description
API endpoint for detail view of a SalesOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 70,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 232,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 139,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
Response 200 OK
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 15,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
PUT /api/order/so/{id}/¶
Description
API endpoint for detail view of a SalesOrder object.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 168,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 210,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 184,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the request body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
Response 200 OK
{
"address": 0,
"address_detail": null,
"barcode_hash": "string",
"completed_lines": 0,
"completed_shipments_count": 0,
"contact": 0,
"contact_detail": null,
"created_by": null,
"creation_date": "2022-04-13",
"customer": 0,
"customer_detail": null,
"customer_reference": "string",
"description": "string",
"duplicate": null,
"issue_date": "2022-04-13",
"line_items": 0,
"link": "string",
"notes": "string",
"order_currency": "string",
"overdue": true,
"parameters": [
{
"data": "string",
"data_numeric": 10.12,
"model_id": 259,
"model_type": null,
"note": "string",
"pk": 0,
"template": 0,
"template_detail": null,
"updated": "2022-04-13T15:42:05.901Z",
"updated_by": 0,
"updated_by_detail": null
}
],
"pk": 0,
"project_code": 0,
"project_code_detail": null,
"project_code_label": "string",
"reference": "string",
"responsible": 0,
"responsible_detail": null,
"shipment_date": "2022-04-13",
"shipments_count": 0,
"start_date": "2022-04-13",
"status": 0,
"status_custom_key": 0,
"status_text": "string",
"target_date": "2022-04-13",
"total_price": "string"
}
Schema of the response body
{
"description": "Serializer for the SalesOrder model class.",
"properties": {
"address": {
"description": "Company address for this order",
"nullable": true,
"type": "integer"
},
"address_detail": {
"allOf": [
{
"$ref": "#/components/schemas/AddressBrief"
}
],
"nullable": true,
"readOnly": true
},
"barcode_hash": {
"readOnly": true,
"type": "string"
},
"completed_lines": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"completed_shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Completed Shipments",
"type": "integer"
},
"contact": {
"description": "Point of contact for this order",
"nullable": true,
"type": "integer"
},
"contact_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Contact"
}
],
"nullable": true,
"readOnly": true
},
"created_by": {
"allOf": [
{
"$ref": "#/components/schemas/User"
}
],
"readOnly": true
},
"creation_date": {
"format": "date",
"nullable": true,
"type": "string"
},
"customer": {
"description": "Company to which the items are being sold",
"nullable": true,
"type": "integer"
},
"customer_detail": {
"allOf": [
{
"$ref": "#/components/schemas/CompanyBrief"
}
],
"nullable": true,
"readOnly": true
},
"customer_reference": {
"description": "Customer order reference code",
"maxLength": 64,
"type": "string"
},
"description": {
"description": "Order description (optional)",
"maxLength": 250,
"type": "string"
},
"duplicate": {
"allOf": [
{
"$ref": "#/components/schemas/DuplicateOrder"
}
],
"description": "Specify options for duplicating this order",
"title": "Duplicate Order",
"writeOnly": true
},
"issue_date": {
"description": "Date order was issued",
"format": "date",
"nullable": true,
"type": "string"
},
"line_items": {
"nullable": true,
"readOnly": true,
"type": "integer"
},
"link": {
"description": "Link to external page",
"format": "uri",
"maxLength": 2000,
"type": "string"
},
"notes": {
"description": "Markdown notes (optional)",
"maxLength": 50000,
"nullable": true,
"type": "string"
},
"order_currency": {
"description": "Currency for this order (leave blank to use company default)\n\n* `` - ---------\n* `AUD` - AUD - Australian Dollar\n* `CAD` - CAD - Canadian Dollar\n* `CNY` - CNY - Chinese Yuan\n* `EUR` - EUR - Euro\n* `GBP` - GBP - British Pound\n* `JPY` - JPY - Japanese Yen\n* `NZD` - NZD - New Zealand Dollar\n* `USD` - USD - US Dollar\n\nOther valid currencies may be found in the 'CURRENCY_CODES' global setting.",
"nullable": true,
"type": "string"
},
"overdue": {
"nullable": true,
"readOnly": true,
"type": "boolean"
},
"parameters": {
"items": {
"$ref": "#/components/schemas/Parameter"
},
"nullable": true,
"readOnly": true,
"type": "array"
},
"pk": {
"readOnly": true,
"title": "ID",
"type": "integer"
},
"project_code": {
"description": "Select project code for this order",
"nullable": true,
"type": "integer"
},
"project_code_detail": {
"allOf": [
{
"$ref": "#/components/schemas/ProjectCode"
}
],
"nullable": true,
"readOnly": true
},
"project_code_label": {
"nullable": true,
"readOnly": true,
"type": "string"
},
"reference": {
"type": "string"
},
"responsible": {
"description": "User or group responsible for this order",
"nullable": true,
"type": "integer"
},
"responsible_detail": {
"allOf": [
{
"$ref": "#/components/schemas/Owner"
}
],
"nullable": true,
"readOnly": true
},
"shipment_date": {
"format": "date",
"nullable": true,
"readOnly": true,
"type": "string"
},
"shipments_count": {
"nullable": true,
"readOnly": true,
"title": "Shipments",
"type": "integer"
},
"start_date": {
"description": "Scheduled start date for this order",
"format": "date",
"nullable": true,
"type": "string"
},
"status": {
"readOnly": true,
"title": "Order Status",
"type": "integer"
},
"status_custom_key": {
"description": "Additional status information for this item\n\n* `10` - Pending\n* `15` - In Progress\n* `20` - Shipped\n* `25` - On Hold\n* `30` - Complete\n* `40` - Cancelled\n* `50` - Lost\n* `60` - Returned\n\nAdditional custom status keys may be retrieved from the corresponding 'status_retrieve' call.",
"nullable": true,
"readOnly": true,
"title": "Custom status key",
"type": "integer"
},
"status_text": {
"readOnly": true,
"type": "string"
},
"target_date": {
"description": "Expected date for order delivery. Order will be overdue after this date.",
"format": "date",
"nullable": true,
"type": "string"
},
"total_price": {
"format": "decimal",
"nullable": true,
"pattern": "^-?\\d{0,13}(?:\\.\\d{0,6})?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"barcode_hash",
"created_by",
"pk",
"reference",
"status",
"status_text"
],
"type": "object"
}
POST /api/order/so/{id}/allocate-serials/¶
Description
API endpoint to allocation stock items against a SalesOrder, by specifying serial numbers.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"line_item": 0,
"quantity": 0,
"serial_numbers": "string",
"shipment": 0
}
Schema of the request body
{
"description": "DRF serializer for allocation of serial numbers against a sales order / shipment.",
"properties": {
"line_item": {
"type": "integer"
},
"quantity": {
"minimum": 1,
"type": "integer"
},
"serial_numbers": {
"description": "Enter serial numbers to allocate",
"type": "string"
},
"shipment": {
"nullable": true,
"type": "integer"
}
},
"required": [
"line_item",
"quantity",
"serial_numbers"
],
"type": "object"
}
{
"line_item": 0,
"quantity": 0,
"serial_numbers": "string",
"shipment": 0
}
Schema of the request body
{
"description": "DRF serializer for allocation of serial numbers against a sales order / shipment.",
"properties": {
"line_item": {
"type": "integer"
},
"quantity": {
"minimum": 1,
"type": "integer"
},
"serial_numbers": {
"description": "Enter serial numbers to allocate",
"type": "string"
},
"shipment": {
"nullable": true,
"type": "integer"
}
},
"required": [
"line_item",
"quantity",
"serial_numbers"
],
"type": "object"
}
{
"line_item": 0,
"quantity": 0,
"serial_numbers": "string",
"shipment": 0
}
Schema of the request body
{
"description": "DRF serializer for allocation of serial numbers against a sales order / shipment.",
"properties": {
"line_item": {
"type": "integer"
},
"quantity": {
"minimum": 1,
"type": "integer"
},
"serial_numbers": {
"description": "Enter serial numbers to allocate",
"type": "string"
},
"shipment": {
"nullable": true,
"type": "integer"
}
},
"required": [
"line_item",
"quantity",
"serial_numbers"
],
"type": "object"
}
Response 201 Created
{
"line_item": 0,
"quantity": 0,
"serial_numbers": "string",
"shipment": 0
}
Schema of the response body
{
"description": "DRF serializer for allocation of serial numbers against a sales order / shipment.",
"properties": {
"line_item": {
"type": "integer"
},
"quantity": {
"minimum": 1,
"type": "integer"
},
"serial_numbers": {
"description": "Enter serial numbers to allocate",
"type": "string"
},
"shipment": {
"nullable": true,
"type": "integer"
}
},
"required": [
"line_item",
"quantity",
"serial_numbers"
],
"type": "object"
}
POST /api/order/so/{id}/allocate/¶
Description
API endpoint to allocate stock items against a SalesOrder.
- The SalesOrder is specified in the URL
- See the SalesOrderShipmentAllocationSerializer class
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"items": [
{
"line_item": 0,
"quantity": "string",
"stock_item": 0
}
],
"shipment": 0
}
Schema of the request body
{
"description": "DRF serializer for allocation of stock items against a sales order / shipment.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/SalesOrderShipmentAllocationItem"
},
"type": "array"
},
"shipment": {
"nullable": true,
"type": "integer"
}
},
"required": [
"items"
],
"type": "object"
}
{
"items": [
{
"line_item": 0,
"quantity": "string",
"stock_item": 0
}
],
"shipment": 0
}
Schema of the request body
{
"description": "DRF serializer for allocation of stock items against a sales order / shipment.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/SalesOrderShipmentAllocationItem"
},
"type": "array"
},
"shipment": {
"nullable": true,
"type": "integer"
}
},
"required": [
"items"
],
"type": "object"
}
{
"items": [
{
"line_item": 0,
"quantity": "string",
"stock_item": 0
}
],
"shipment": 0
}
Schema of the request body
{
"description": "DRF serializer for allocation of stock items against a sales order / shipment.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/SalesOrderShipmentAllocationItem"
},
"type": "array"
},
"shipment": {
"nullable": true,
"type": "integer"
}
},
"required": [
"items"
],
"type": "object"
}
Response 201 Created
{
"items": [
{
"line_item": 0,
"quantity": "string",
"stock_item": 0
}
],
"shipment": 0
}
Schema of the response body
{
"description": "DRF serializer for allocation of stock items against a sales order / shipment.",
"properties": {
"items": {
"items": {
"$ref": "#/components/schemas/SalesOrderShipmentAllocationItem"
},
"type": "array"
},
"shipment": {
"nullable": true,
"type": "integer"
}
},
"required": [
"items"
],
"type": "object"
}
POST /api/order/so/{id}/cancel/¶
Description
API endpoint to cancel a SalesOrder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 201 Created
POST /api/order/so/{id}/complete/¶
Description
API endpoint for manually marking a SalesOrder as "complete".
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"accept_incomplete": true
}
Schema of the request body
{
"description": "DRF serializer for manually marking a sales order as complete.",
"properties": {
"accept_incomplete": {
"default": false,
"description": "Allow order to be closed with incomplete line items",
"type": "boolean"
}
},
"type": "object"
}
{
"accept_incomplete": true
}
Schema of the request body
{
"description": "DRF serializer for manually marking a sales order as complete.",
"properties": {
"accept_incomplete": {
"default": false,
"description": "Allow order to be closed with incomplete line items",
"type": "boolean"
}
},
"type": "object"
}
{
"accept_incomplete": true
}
Schema of the request body
{
"description": "DRF serializer for manually marking a sales order as complete.",
"properties": {
"accept_incomplete": {
"default": false,
"description": "Allow order to be closed with incomplete line items",
"type": "boolean"
}
},
"type": "object"
}
Response 201 Created
{
"accept_incomplete": true
}
Schema of the response body
{
"description": "DRF serializer for manually marking a sales order as complete.",
"properties": {
"accept_incomplete": {
"default": false,
"description": "Allow order to be closed with incomplete line items",
"type": "boolean"
}
},
"type": "object"
}
POST /api/order/so/{id}/hold/¶
Description
API endpoint to place a SalesOrder on hold.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 201 Created
POST /api/order/so/{id}/issue/¶
Description
API endpoint to issue a SalesOrder.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 201 Created
GET /api/order/so/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PATCH /api/order/so/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
PUT /api/order/so/{id}/metadata/¶
Description
Generic API endpoint for reading and editing metadata for a model.
Input parameters
| Parameter | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
oauth2 |
header | string | N/A | No | |
cookieAuth |
cookie | string | N/A | No | API key |
basicAuth |
header | string | N/A | No | Basic authentication |
tokenAuth |
header | string | N/A | No | Token-based authentication with required prefix "Token" |
id |
path | integer | No |
Request body
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
{
"metadata": null
}
Schema of the request body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Response 200 OK
{
"metadata": null
}
Schema of the response body
{
"description": "Serializer class for model metadata API access.",
"properties": {
"metadata": {}
},
"required": [
"metadata"
],
"type": "object"
}
Schemas¶
AddressBrief¶
| Name | Type |
|---|---|
country |
string |
internal_shipping_notes |
string |
line1 |
string |
line2 |
string |
pk |
integer |
postal_city |
string |
postal_code |
string |
province |
string |
shipping_notes |
string |
BlankEnum¶
Type:
Build¶
| Name | Type |
|---|---|
barcode_hash |
string |
batch |
string| null |
completed |
integer |
completion_date |
string(date)| null |
creation_date |
string(date) |
destination |
integer| null |
external |
boolean |
issued_by |
integer| null |
issued_by_detail |
|
level |
integer |
link |
string(uri) |
notes |
string| null |
overdue |
boolean |
parameters |
Array<Parameter> |
parent |
integer| null |
part |
integer |
part_detail |
|
part_name |
string |
pk |
integer |
priority |
integer(int64) |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
reference |
string |
responsible |
integer| null |
responsible_detail |
|
sales_order |
integer| null |
start_date |
string(date)| null |
status |
|
status_custom_key |
integer| null |
status_text |
string |
take_from |
integer| null |
target_date |
string(date)| null |
title |
string |
BuildStatusEnum¶
Type: integer
BulkRequest¶
| Name | Type |
|---|---|
filters |
|
items |
Array<integer> |
CompanyBrief¶
| Name | Type |
|---|---|
active |
boolean |
currency |
string |
description |
string |
image |
string(uri) |
name |
string |
pk |
integer |
tax_id |
string |
thumbnail |
string |
Contact¶
| Name | Type |
|---|---|
company |
integer |
company_name |
string |
email |
string(email) |
name |
string |
phone |
string |
pk |
integer |
role |
string |
DuplicateOrder¶
| Name | Type |
|---|---|
copy_extra_lines |
boolean |
copy_lines |
boolean |
order_id |
integer |
GenericStateClass¶
| Name | Type |
|---|---|
status_class |
string |
values |
GenericStateValue¶
| Name | Type |
|---|---|
color |
string |
custom |
boolean |
key |
integer |
label |
string |
logical_key |
string |
name |
string |
LocationBrief¶
| Name | Type |
|---|---|
name |
string |
pathstring |
string |
pk |
integer |
ManufacturerPart¶
| Name | Type |
|---|---|
barcode_hash |
string |
description |
string| null |
link |
string(uri)| null |
manufacturer |
integer |
manufacturer_detail |
|
MPN |
string| null |
notes |
string| null |
parameters |
Array<Parameter> |
part |
integer |
part_detail |
|
pk |
integer |
pretty_name |
string| null |
tags |
Array<string> |
Metadata¶
| Name | Type |
|---|---|
metadata |
ModelType98eEnum¶
Type: string
NullEnum¶
Type:
OutcomeEnum¶
Type: integer
Owner¶
| Name | Type |
|---|---|
label |
string |
name |
string |
owner_id |
integer(int64)| null |
owner_model |
string |
pk |
integer |
PaginatedPurchaseOrderExtraLineList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<PurchaseOrderExtraLine> |
PaginatedPurchaseOrderLineItemList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<PurchaseOrderLineItem> |
PaginatedPurchaseOrderList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<PurchaseOrder> |
PaginatedReturnOrderExtraLineList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<ReturnOrderExtraLine> |
PaginatedReturnOrderLineItemList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<ReturnOrderLineItem> |
PaginatedReturnOrderList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<ReturnOrder> |
PaginatedSalesOrderAllocationList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<SalesOrderAllocation> |
PaginatedSalesOrderExtraLineList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<SalesOrderExtraLine> |
PaginatedSalesOrderLineItemList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<SalesOrderLineItem> |
PaginatedSalesOrderList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<SalesOrder> |
PaginatedSalesOrderShipmentList¶
| Name | Type |
|---|---|
count |
integer |
next |
string(uri)| null |
previous |
string(uri)| null |
results |
Array<SalesOrderShipment> |
Parameter¶
| Name | Type |
|---|---|
data |
string |
data_numeric |
number(double)| null |
model_id |
integer(int64) |
model_type |
|
note |
string |
pk |
integer |
template |
integer |
template_detail |
|
updated |
string(date-time)| null |
updated_by |
integer| null |
updated_by_detail |
ParameterTemplate¶
| Name | Type |
|---|---|
checkbox |
boolean |
choices |
string |
description |
string |
enabled |
boolean |
model_type |
|
name |
string |
pk |
integer |
selectionlist |
integer| null |
units |
string |
PartBrief¶
| Name | Type |
|---|---|
active |
boolean |
assembly |
boolean |
barcode_hash |
string |
category_default_location |
integer| null |
component |
boolean |
default_expiry |
integer(int64) |
default_location |
integer| null |
description |
string |
full_name |
string |
image |
string(uri)| null |
IPN |
string| null |
is_template |
boolean |
locked |
boolean |
minimum_stock |
string(decimal) |
name |
string |
pk |
integer |
pricing_max |
string(decimal)| null |
pricing_min |
string(decimal)| null |
purchaseable |
boolean |
revision |
string| null |
salable |
boolean |
testable |
boolean |
thumbnail |
string |
trackable |
boolean |
units |
string| null |
virtual |
boolean |
PartTestTemplate¶
| Name | Type |
|---|---|
choices |
string |
description |
string| null |
enabled |
boolean |
key |
string |
part |
integer |
pk |
integer |
required |
boolean |
requires_attachment |
boolean |
requires_value |
boolean |
results |
integer |
test_name |
string |
PatchedMetadata¶
| Name | Type |
|---|---|
metadata |
PatchedPurchaseOrder¶
| Name | Type |
|---|---|
address |
integer| null |
address_detail |
|
barcode_hash |
string |
complete_date |
string(date)| null |
completed_lines |
integer| null |
contact |
integer| null |
contact_detail |
|
created_by |
|
creation_date |
string(date)| null |
description |
string |
destination |
integer| null |
duplicate |
|
issue_date |
string(date)| null |
line_items |
integer| null |
link |
string(uri) |
notes |
string| null |
order_currency |
string| null |
overdue |
boolean| null |
parameters |
Array<Parameter> |
pk |
integer |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
reference |
string |
responsible |
integer| null |
responsible_detail |
|
start_date |
string(date)| null |
status |
integer |
status_custom_key |
integer| null |
status_text |
string |
supplier |
integer| null |
supplier_detail |
|
supplier_name |
string |
supplier_reference |
string |
target_date |
string(date)| null |
total_price |
string(decimal)| null |
PatchedPurchaseOrderExtraLine¶
| Name | Type |
|---|---|
description |
string |
link |
string(uri) |
notes |
string |
order |
integer |
order_detail |
|
pk |
integer |
price |
string(decimal)| null |
price_currency |
string |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
reference |
string |
target_date |
string(date)| null |
PatchedPurchaseOrderLineItem¶
| Name | Type |
|---|---|
auto_pricing |
boolean |
build_order |
integer| null |
build_order_detail |
|
destination |
integer| null |
destination_detail |
|
internal_part |
integer |
internal_part_name |
string |
ipn |
string| null |
link |
string(uri) |
merge_items |
boolean |
mpn |
string| null |
notes |
string |
order |
integer |
order_detail |
|
overdue |
boolean| null |
part |
integer| null |
part_detail |
|
pk |
integer |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
purchase_price |
string(decimal)| null |
purchase_price_currency |
string |
quantity |
number(double) |
received |
number(double) |
reference |
string |
sku |
string| null |
supplier_part_detail |
|
target_date |
string(date)| null |
total_price |
number(double) |
PatchedReturnOrder¶
| Name | Type |
|---|---|
address |
integer| null |
address_detail |
|
barcode_hash |
string |
complete_date |
string(date)| null |
completed_lines |
integer| null |
contact |
integer| null |
contact_detail |
|
created_by |
|
creation_date |
string(date)| null |
customer |
integer| null |
customer_detail |
|
customer_reference |
string |
description |
string |
duplicate |
|
issue_date |
string(date)| null |
line_items |
integer| null |
link |
string(uri) |
notes |
string| null |
order_currency |
string| null |
overdue |
boolean| null |
parameters |
Array<Parameter> |
pk |
integer |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
reference |
string |
responsible |
integer| null |
responsible_detail |
|
start_date |
string(date)| null |
status |
integer |
status_custom_key |
integer| null |
status_text |
string |
target_date |
string(date)| null |
total_price |
string(decimal)| null |
PatchedReturnOrderExtraLine¶
| Name | Type |
|---|---|
description |
string |
link |
string(uri) |
notes |
string |
order |
integer |
order_detail |
|
pk |
integer |
price |
string(decimal)| null |
price_currency |
string |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
reference |
string |
target_date |
string(date)| null |
PatchedReturnOrderLineItem¶
| Name | Type |
|---|---|
item |
integer |
item_detail |
|
link |
string(uri) |
notes |
string |
order |
integer |
order_detail |
|
outcome |
|
part_detail |
|
pk |
integer |
price |
string(decimal)| null |
price_currency |
string |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
received_date |
string(date)| null |
reference |
string |
target_date |
string(date)| null |
PatchedSalesOrder¶
| Name | Type |
|---|---|
address |
integer| null |
address_detail |
|
barcode_hash |
string |
completed_lines |
integer| null |
completed_shipments_count |
integer| null |
contact |
integer| null |
contact_detail |
|
created_by |
|
creation_date |
string(date)| null |
customer |
integer| null |
customer_detail |
|
customer_reference |
string |
description |
string |
duplicate |
|
issue_date |
string(date)| null |
line_items |
integer| null |
link |
string(uri) |
notes |
string| null |
order_currency |
string| null |
overdue |
boolean| null |
parameters |
Array<Parameter> |
pk |
integer |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
reference |
string |
responsible |
integer| null |
responsible_detail |
|
shipment_date |
string(date)| null |
shipments_count |
integer| null |
start_date |
string(date)| null |
status |
integer |
status_custom_key |
integer| null |
status_text |
string |
target_date |
string(date)| null |
total_price |
string(decimal)| null |
PatchedSalesOrderAllocation¶
| Name | Type |
|---|---|
customer_detail |
|
item |
integer |
item_detail |
|
line |
integer |
location |
integer |
location_detail |
|
order |
integer |
order_detail |
|
part |
integer |
part_detail |
|
pk |
integer |
quantity |
number(double) |
serial |
string| null |
shipment |
integer| null |
shipment_detail |
PatchedSalesOrderExtraLine¶
| Name | Type |
|---|---|
description |
string |
link |
string(uri) |
notes |
string |
order |
integer |
order_detail |
|
pk |
integer |
price |
string(decimal)| null |
price_currency |
string |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
reference |
string |
target_date |
string(date)| null |
PatchedSalesOrderLineItem¶
| Name | Type |
|---|---|
allocated |
number(double) |
available_stock |
number(double) |
available_variant_stock |
number(double) |
building |
number(double) |
customer_detail |
|
link |
string(uri) |
notes |
string |
on_order |
number(double) |
order |
integer |
order_detail |
|
overdue |
boolean| null |
part |
integer| null |
part_detail |
|
pk |
integer |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
reference |
string |
sale_price |
string(decimal)| null |
sale_price_currency |
string |
shipped |
number(double) |
target_date |
string(date)| null |
PatchedSalesOrderShipment¶
| Name | Type |
|---|---|
allocated_items |
integer| null |
barcode_hash |
string |
checked_by |
integer| null |
checked_by_detail |
|
customer_detail |
|
delivery_date |
string(date)| null |
invoice_number |
string |
link |
string(uri) |
notes |
string| null |
order |
integer |
order_detail |
|
pk |
integer |
reference |
string |
shipment_address |
integer| null |
shipment_address_detail |
|
shipment_date |
string(date)| null |
tracking_number |
string |
ProjectCode¶
| Name | Type |
|---|---|
code |
string |
description |
string |
pk |
integer |
responsible |
integer| null |
responsible_detail |
PurchaseOrder¶
| Name | Type |
|---|---|
address |
integer| null |
address_detail |
|
barcode_hash |
string |
complete_date |
string(date)| null |
completed_lines |
integer| null |
contact |
integer| null |
contact_detail |
|
created_by |
|
creation_date |
string(date)| null |
description |
string |
destination |
integer| null |
duplicate |
|
issue_date |
string(date)| null |
line_items |
integer| null |
link |
string(uri) |
notes |
string| null |
order_currency |
string| null |
overdue |
boolean| null |
parameters |
Array<Parameter> |
pk |
integer |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
reference |
string |
responsible |
integer| null |
responsible_detail |
|
start_date |
string(date)| null |
status |
integer |
status_custom_key |
integer| null |
status_text |
string |
supplier |
integer| null |
supplier_detail |
|
supplier_name |
string |
supplier_reference |
string |
target_date |
string(date)| null |
total_price |
string(decimal)| null |
PurchaseOrderComplete¶
| Name | Type |
|---|---|
accept_incomplete |
boolean |
PurchaseOrderExtraLine¶
| Name | Type |
|---|---|
description |
string |
link |
string(uri) |
notes |
string |
order |
integer |
order_detail |
|
pk |
integer |
price |
string(decimal)| null |
price_currency |
string |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
reference |
string |
target_date |
string(date)| null |
PurchaseOrderLineItem¶
| Name | Type |
|---|---|
auto_pricing |
boolean |
build_order |
integer| null |
build_order_detail |
|
destination |
integer| null |
destination_detail |
|
internal_part |
integer |
internal_part_name |
string |
ipn |
string| null |
link |
string(uri) |
merge_items |
boolean |
mpn |
string| null |
notes |
string |
order |
integer |
order_detail |
|
overdue |
boolean| null |
part |
integer| null |
part_detail |
|
pk |
integer |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
purchase_price |
string(decimal)| null |
purchase_price_currency |
string |
quantity |
number(double) |
received |
number(double) |
reference |
string |
sku |
string| null |
supplier_part_detail |
|
target_date |
string(date)| null |
total_price |
number(double) |
PurchaseOrderLineItemReceive¶
| Name | Type |
|---|---|
barcode |
string| null |
batch_code |
string |
expiry_date |
string(date)| null |
line_item |
integer |
location |
integer| null |
note |
string |
packaging |
string |
quantity |
string(decimal) |
serial_numbers |
string |
status |
integer |
PurchaseOrderReceive¶
| Name | Type |
|---|---|
items |
Array<PurchaseOrderLineItemReceive> |
location |
integer| null |
ReturnOrder¶
| Name | Type |
|---|---|
address |
integer| null |
address_detail |
|
barcode_hash |
string |
complete_date |
string(date)| null |
completed_lines |
integer| null |
contact |
integer| null |
contact_detail |
|
created_by |
|
creation_date |
string(date)| null |
customer |
integer| null |
customer_detail |
|
customer_reference |
string |
description |
string |
duplicate |
|
issue_date |
string(date)| null |
line_items |
integer| null |
link |
string(uri) |
notes |
string| null |
order_currency |
string| null |
overdue |
boolean| null |
parameters |
Array<Parameter> |
pk |
integer |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
reference |
string |
responsible |
integer| null |
responsible_detail |
|
start_date |
string(date)| null |
status |
integer |
status_custom_key |
integer| null |
status_text |
string |
target_date |
string(date)| null |
total_price |
string(decimal)| null |
ReturnOrderExtraLine¶
| Name | Type |
|---|---|
description |
string |
link |
string(uri) |
notes |
string |
order |
integer |
order_detail |
|
pk |
integer |
price |
string(decimal)| null |
price_currency |
string |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
reference |
string |
target_date |
string(date)| null |
ReturnOrderLineItem¶
| Name | Type |
|---|---|
item |
integer |
item_detail |
|
link |
string(uri) |
notes |
string |
order |
integer |
order_detail |
|
outcome |
|
part_detail |
|
pk |
integer |
price |
string(decimal)| null |
price_currency |
string |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
received_date |
string(date)| null |
reference |
string |
target_date |
string(date)| null |
ReturnOrderLineItemReceive¶
| Name | Type |
|---|---|
item |
integer |
status |
integer |
ReturnOrderReceive¶
| Name | Type |
|---|---|
items |
Array<ReturnOrderLineItemReceive> |
location |
integer |
note |
string |
SalesOrder¶
| Name | Type |
|---|---|
address |
integer| null |
address_detail |
|
barcode_hash |
string |
completed_lines |
integer| null |
completed_shipments_count |
integer| null |
contact |
integer| null |
contact_detail |
|
created_by |
|
creation_date |
string(date)| null |
customer |
integer| null |
customer_detail |
|
customer_reference |
string |
description |
string |
duplicate |
|
issue_date |
string(date)| null |
line_items |
integer| null |
link |
string(uri) |
notes |
string| null |
order_currency |
string| null |
overdue |
boolean| null |
parameters |
Array<Parameter> |
pk |
integer |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
reference |
string |
responsible |
integer| null |
responsible_detail |
|
shipment_date |
string(date)| null |
shipments_count |
integer| null |
start_date |
string(date)| null |
status |
integer |
status_custom_key |
integer| null |
status_text |
string |
target_date |
string(date)| null |
total_price |
string(decimal)| null |
SalesOrderAllocation¶
| Name | Type |
|---|---|
customer_detail |
|
item |
integer |
item_detail |
|
line |
integer |
location |
integer |
location_detail |
|
order |
integer |
order_detail |
|
part |
integer |
part_detail |
|
pk |
integer |
quantity |
number(double) |
serial |
string| null |
shipment |
integer| null |
shipment_detail |
SalesOrderComplete¶
| Name | Type |
|---|---|
accept_incomplete |
boolean |
SalesOrderExtraLine¶
| Name | Type |
|---|---|
description |
string |
link |
string(uri) |
notes |
string |
order |
integer |
order_detail |
|
pk |
integer |
price |
string(decimal)| null |
price_currency |
string |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
reference |
string |
target_date |
string(date)| null |
SalesOrderLineItem¶
| Name | Type |
|---|---|
allocated |
number(double) |
available_stock |
number(double) |
available_variant_stock |
number(double) |
building |
number(double) |
customer_detail |
|
link |
string(uri) |
notes |
string |
on_order |
number(double) |
order |
integer |
order_detail |
|
overdue |
boolean| null |
part |
integer| null |
part_detail |
|
pk |
integer |
project_code |
integer| null |
project_code_detail |
|
project_code_label |
string| null |
quantity |
number(double) |
reference |
string |
sale_price |
string(decimal)| null |
sale_price_currency |
string |
shipped |
number(double) |
target_date |
string(date)| null |
SalesOrderSerialAllocation¶
| Name | Type |
|---|---|
line_item |
integer |
quantity |
integer |
serial_numbers |
string |
shipment |
integer| null |
SalesOrderShipment¶
| Name | Type |
|---|---|
allocated_items |
integer| null |
barcode_hash |
string |
checked_by |
integer| null |
checked_by_detail |
|
customer_detail |
|
delivery_date |
string(date)| null |
invoice_number |
string |
link |
string(uri) |
notes |
string| null |
order |
integer |
order_detail |
|
pk |
integer |
reference |
string |
shipment_address |
integer| null |
shipment_address_detail |
|
shipment_date |
string(date)| null |
tracking_number |
string |
SalesOrderShipmentAllocation¶
| Name | Type |
|---|---|
items |
Array<SalesOrderShipmentAllocationItem> |
shipment |
integer| null |
SalesOrderShipmentAllocationItem¶
| Name | Type |
|---|---|
line_item |
integer |
quantity |
string(decimal) |
stock_item |
integer |
SalesOrderShipmentComplete¶
| Name | Type |
|---|---|
delivery_date |
string(date)| null |
invoice_number |
string |
link |
string(uri) |
shipment_date |
string(date)| null |
tracking_number |
string |
StockItem¶
| Name | Type |
|---|---|
allocated |
number(double)| null |
barcode_hash |
string |
batch |
string| null |
belongs_to |
integer| null |
build |
integer| null |
child_items |
integer| null |
consumed_by |
integer| null |
customer |
integer| null |
delete_on_deplete |
boolean |
expired |
boolean| null |
expiry_date |
string(date)| null |
in_stock |
boolean |
installed_items |
integer| null |
is_building |
boolean |
link |
string(uri) |
location |
integer| null |
location_detail |
|
location_path |
Array<> |
MPN |
string| null |
notes |
string| null |
owner |
integer| null |
packaging |
string| null |
parent |
integer |
part |
integer |
part_detail |
|
pk |
integer |
purchase_order |
integer| null |
purchase_order_reference |
string| null |
purchase_price |
string(decimal)| null |
purchase_price_currency |
string |
quantity |
number(double) |
sales_order |
integer| null |
sales_order_reference |
string| null |
serial |
string| null |
serial_numbers |
string| null |
SKU |
string| null |
stale |
boolean| null |
status |
|
status_custom_key |
integer| null |
status_text |
string |
stocktake_date |
string(date)| null |
supplier_part |
integer| null |
supplier_part_detail |
|
tags |
Array<string> |
tests |
Array<StockItemTestResult> |
tracking_items |
integer| null |
updated |
string(date-time)| null |
use_pack_size |
boolean| null |
StockItemStatusEnum¶
Type: integer
StockItemTestResult¶
| Name | Type |
|---|---|
attachment |
string(uri)| null |
date |
string(date-time) |
finished_datetime |
string(date-time)| null |
notes |
string |
pk |
integer |
result |
boolean |
started_datetime |
string(date-time)| null |
stock_item |
integer |
template |
integer| null |
template_detail |
|
test_station |
string |
user |
integer| null |
user_detail |
|
value |
string |
SupplierPart¶
| Name | Type |
|---|---|
active |
boolean |
availability_updated |
string(date-time)| null |
available |
number(double) |
barcode_hash |
string |
description |
string| null |
in_stock |
number(double)| null |
link |
string(uri)| null |
manufacturer_detail |
|
manufacturer_part |
integer| null |
manufacturer_part_detail |
|
MPN |
string| null |
note |
string| null |
notes |
string| null |
on_order |
number(double)| null |
pack_quantity |
string |
pack_quantity_native |
number(double) |
packaging |
string| null |
parameters |
Array<Parameter> |
part |
integer |
part_detail |
|
pk |
integer |
pretty_name |
string| null |
price_breaks |
Array<SupplierPriceBreakBrief> |
SKU |
string |
supplier |
integer |
supplier_detail |
|
tags |
Array<string> |
updated |
string(date-time)| null |
SupplierPriceBreakBrief¶
| Name | Type |
|---|---|
part |
integer |
pk |
integer |
price |
string(decimal)| null |
price_currency |
string |
quantity |
number(double) |
supplier |
integer |
updated |
string(date-time)| null |
User¶
| Name | Type |
|---|---|
email |
string(email) |
first_name |
string |
last_name |
string |
pk |
integer |
username |
string |
Common responses¶
This section describes common responses that are reused across operations.
allauth.AddAuthenticatorConflict¶
The account prohibits adding an authenticator, e.g. because of an unverified email address.
Schema of the response body
null
allauth.AddWebAuthnAuthenticator¶
A WebAuthn authenticator.
{
"data": null,
"meta": {
"recovery_codes_generated": true
},
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"$ref": "#/components/schemas/allauth.WebAuthnAuthenticator"
},
"meta": {
"properties": {
"recovery_codes_generated": {
"description": "Whether or not recovery codes where generated automatically.\n",
"type": "boolean"
}
},
"type": "object"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data",
"meta"
],
"type": "object"
}
allauth.Authenticated¶
The user is authenticated.
Schema of the response body
null
allauth.AuthenticatedByCode¶
Authenticated by code.
{
"summary": "Authenticated by code.\n",
"value": {
"data": {
"methods": [
{
"at": 1711555057.065702,
"email": "email@domain.org",
"method": "code"
}
],
"user": {
"display": "Magic Wizard",
"email": "email@domain.org",
"has_usable_password": true,
"id": 123,
"username": "wizard"
}
},
"meta": {
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdW",
"is_authenticated": true,
"session_token": "ufwcig0zen9skyd545jc0fkq813ghar2"
},
"status": 200
}
}
Schema of the response body
null
allauth.AuthenticatedByPassword¶
Authenticated by password.
{
"summary": "Authenticated by password.\n",
"value": {
"data": {
"methods": [
{
"at": 1711555057.065702,
"email": "email@domain.org",
"method": "password"
}
],
"user": {
"display": "Magic Wizard",
"email": "email@domain.org",
"has_usable_password": true,
"id": 123,
"username": "wizard"
}
},
"meta": {
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdW",
"is_authenticated": true,
"session_token": "ufwcig0zen9skyd545jc0fkq813ghar2"
},
"status": 200
}
}
Schema of the response body
null
allauth.AuthenticatedByPasswordAnd2FA¶
Authenticated by password and 2FA.
{
"summary": "Fully authenticated using by password and 2FA.\n",
"value": {
"data": {
"methods": [
{
"at": 1711555057.065702,
"email": "email@domain.org",
"method": "password"
},
{
"at": 1711555060.9375854,
"id": 66,
"method": "mfa",
"type": "totp"
}
],
"user": {
"display": "Magic Wizard",
"email": "email@domain.org",
"has_usable_password": true,
"id": 123,
"username": "wizard"
}
},
"meta": {
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdW",
"is_authenticated": true,
"session_token": "ufwcig0zen9skyd545jc0fkq813ghar2"
},
"status": 200
}
}
Schema of the response body
null
allauth.Authentication¶
Not authenticated.
{
"summary": "Reauthentication required\n",
"value": {
"data": {
"flows": [
{
"id": "reauthenticate"
},
{
"id": "mfa_reauthenticate"
}
],
"methods": [
{
"at": 1711555057.065702,
"email": "email@domain.org",
"method": "password"
},
{
"at": 1711555060.9375854,
"id": 66,
"method": "mfa",
"type": "totp"
}
],
"user": {
"display": "Magic Wizard",
"email": "email@domain.org",
"has_usable_password": true,
"id": 123,
"username": "wizard"
}
},
"meta": {
"is_authenticated": true
},
"status": 401
}
}
{
"summary": "Unauthenticated: Initial\n",
"value": {
"data": {
"flows": [
{
"id": "login"
},
{
"id": "signup"
},
{
"id": "provider_redirect",
"providers": [
"facebook",
"google",
"telegram"
]
},
{
"id": "provider_token",
"providers": [
"google"
]
}
]
},
"meta": {
"is_authenticated": false
},
"status": 401
}
}
{
"summary": "Unauthenticated: pending 2FA\n",
"value": {
"data": {
"flows": [
{
"id": "login"
},
{
"id": "signup"
},
{
"id": "provider_redirect",
"providers": [
"facebook",
"google",
"telegram"
]
},
{
"id": "provider_token",
"providers": [
"google"
]
},
{
"id": "mfa_authenticate",
"is_pending": true
}
]
},
"meta": {
"is_authenticated": false
},
"status": 401
}
}
{
"summary": "Unauthenticated: pending email verification\n",
"value": {
"data": {
"flows": [
{
"id": "login"
},
{
"id": "signup"
},
{
"id": "provider_redirect",
"providers": [
"facebook",
"google",
"telegram"
]
},
{
"id": "provider_token",
"providers": [
"google"
]
},
{
"id": "verify_email",
"is_pending": true
}
]
},
"meta": {
"is_authenticated": false
},
"status": 401
}
}
{
"summary": "Unauthenticated: pending provider signup\n",
"value": {
"data": {
"flows": [
{
"id": "login"
},
{
"id": "signup"
},
{
"id": "provider_redirect",
"providers": [
"facebook",
"google",
"telegram"
]
},
{
"id": "provider_token",
"providers": [
"google"
]
},
{
"id": "provider_signup",
"is_pending": true,
"provider": {
"client_id": "123.apps.googleusercontent.com",
"flows": [
"provider_redirect",
"provider_token"
],
"id": "google",
"name": "Google"
}
}
]
},
"meta": {
"is_authenticated": false
},
"status": 401
}
}
Schema of the response body
null
allauth.AuthenticationOrReauthentication¶
The response indicates authentication or re-authentication is required.
Schema of the response body
{
"oneOf": [
{
"$ref": "#/components/schemas/allauth.AuthenticationResponse"
},
{
"$ref": "#/components/schemas/allauth.ReauthenticationResponse"
}
]
}
allauth.Authenticators¶
List of authenticators.
{
"data": null,
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"$ref": "#/components/schemas/allauth.AuthenticatorList"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
allauth.Configuration¶
The django-allauth configuration.
Schema of the response body
null
allauth.EmailAddresses¶
List of email addresses.
{
"data": [
null
],
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"items": {
"$ref": "#/components/schemas/allauth.EmailAddress"
},
"type": "array"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
allauth.EmailVerificationInfo¶
Email verification information.
Schema of the response body
null
allauth.Error¶
An input error occurred.
Schema of the response body
null
allauth.Forbidden¶
A forbidden response.
Schema of the response body
null
allauth.NotFound¶
Not found.
{
"status": 0
}
Schema of the response body
{
"properties": {
"status": {
"enum": [
404
],
"type": "integer"
}
},
"required": [
"status"
],
"type": "object"
}
allauth.PasswordResetInfo¶
Information about the password reset key.
{
"data": {
"user": null
},
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"properties": {
"user": {
"$ref": "#/components/schemas/allauth.User"
}
},
"type": "object"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
allauth.PhoneNumbers¶
List of phone numbers.
Schema of the response body
null
allauth.ProviderAccounts¶
List of third-party provider accounts.
{
"data": [
null
],
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"items": {
"$ref": "#/components/schemas/allauth.ProviderAccount"
},
"type": "array"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
allauth.ProviderSignup¶
Information relating to the pending provider signup.
{
"data": {
"account": null,
"email": [
null
],
"user": null
},
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"properties": {
"account": {
"$ref": "#/components/schemas/allauth.ProviderAccount"
},
"email": {
"items": {
"$ref": "#/components/schemas/allauth.EmailAddress"
},
"type": "array"
},
"user": {
"$ref": "#/components/schemas/allauth.User"
}
},
"required": [
"email",
"account",
"user"
],
"type": "object"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
allauth.ReauthenticationRequired¶
The response indicates reauthentication is required.
{
"data": {
"flows": [
{
"id": "reauthenticate"
},
{
"id": "mfa_reauthenticate"
}
],
"methods": [
{
"at": 1711555057.065702,
"email": "email@domain.org",
"method": "password"
},
{
"at": 1711555060.9375854,
"id": 66,
"method": "mfa",
"type": "totp"
}
],
"user": {
"display": "Magic Wizard",
"email": "email@domain.org",
"has_usable_password": true,
"id": 123,
"username": "wizard"
}
},
"meta": {
"is_authenticated": true
},
"status": 401
}
Schema of the response body
null
allauth.RecoveryCodes¶
Information on the recovery codes.
{
"data": null,
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"$ref": "#/components/schemas/allauth.SensitiveRecoveryCodesAuthenticator"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
allauth.RefreshToken¶
A new access token (and optionally new refresh token).
{
"data": {
"access_token": null,
"refresh_token": null
},
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"properties": {
"access_token": {
"$ref": "#/components/schemas/allauth.AccessToken"
},
"refresh_token": {
"$ref": "#/components/schemas/allauth.RefreshToken"
}
},
"required": [
"access_token"
],
"type": "object"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"data",
"status"
],
"type": "object"
}
allauth.SessionGone¶
The response indicates session is invalid or no longer exists.
{
"summary": "Unauthenticated: Initial\n",
"value": {
"data": {
"flows": [
{
"id": "login"
},
{
"id": "signup"
},
{
"id": "provider_redirect",
"providers": [
"facebook",
"google",
"telegram"
]
},
{
"id": "provider_token",
"providers": [
"google"
]
}
]
},
"meta": {
"is_authenticated": false
},
"status": 401
}
}
Schema of the response body
null
allauth.Sessions¶
List of sessions.
{
"data": [
null
],
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"items": {
"$ref": "#/components/schemas/allauth.Session"
},
"type": "array"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
allauth.StatusOK¶
A success response.
{
"status": null
}
Schema of the response body
{
"properties": {
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status"
],
"type": "object"
}
allauth.TOTPAuthenticator¶
Information on the TOTP authenticator.
{
"data": null,
"meta": {
"recovery_codes_generated": true
},
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"$ref": "#/components/schemas/allauth.TOTPAuthenticator"
},
"meta": {
"properties": {
"recovery_codes_generated": {
"description": "Whether or not recovery codes where generated automatically.",
"type": "boolean"
}
},
"type": "object"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
allauth.TOTPAuthenticatorNotFound¶
No TOTP authenticator has been set up.
{
"meta": {
"secret": "J4ZKKXTK7NOVU7EPUVY23LCDV4T2QZYM",
"totp_url": "otpauth://totp/Example:alice@fsf.org?secret=JBSWY3DPEHPK3PXP&issuer=Example"
},
"status": 0
}
Schema of the response body
{
"properties": {
"meta": {
"properties": {
"secret": {
"description": "A TOTP secret that can be used to setup a new authenticator.\n",
"example": "J4ZKKXTK7NOVU7EPUVY23LCDV4T2QZYM",
"type": "string"
},
"totp_url": {
"description": "otpauth URI from which a QR code can be generated and scanned by OTP clients.\n",
"example": "otpauth://totp/Example:alice@fsf.org?secret=JBSWY3DPEHPK3PXP&issuer=Example",
"type": "string"
}
},
"required": [
"secret",
"totp_url"
],
"type": "object"
},
"status": {
"enum": [
404
],
"type": "integer"
}
},
"required": [
"status",
"meta"
],
"type": "object"
}
allauth.TooManyRequests¶
Too many requests.
{
"status": 0
}
Schema of the response body
{
"properties": {
"status": {
"enum": [
429
],
"type": "integer"
}
},
"required": [
"status"
],
"type": "object"
}
allauth.Unauthenticated¶
There is no authenticated session.
{
"summary": "Unauthenticated: Initial\n",
"value": {
"data": {
"flows": [
{
"id": "login"
},
{
"id": "signup"
},
{
"id": "provider_redirect",
"providers": [
"facebook",
"google",
"telegram"
]
},
{
"id": "provider_token",
"providers": [
"google"
]
}
]
},
"meta": {
"is_authenticated": false
},
"status": 401
}
}
Schema of the response body
null
allauth.WebAuthnAuthenticator¶
A WebAuthn authenticator.
{
"data": null,
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"$ref": "#/components/schemas/allauth.WebAuthnAuthenticator"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
allauth.WebAuthnCreationOptionsResponse¶
WebAuthn credential creation options.
{
"data": null,
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"$ref": "#/components/schemas/allauth.WebAuthnCredentialCreationOptions"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
allauth.WebAuthnRequestOptionsResponse¶
WebAuthn credential request options.
{
"data": null,
"status": null
}
Schema of the response body
{
"properties": {
"data": {
"$ref": "#/components/schemas/allauth.WebAuthnCredentialRequestOptions"
},
"status": {
"$ref": "#/components/schemas/allauth.StatusOK"
}
},
"required": [
"status",
"data"
],
"type": "object"
}
Common parameters¶
This section describes common parameters that are reused across operations.
allauth.EmailVerificationKey¶
| Name | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
X-Email-Verification-Key |
header | string | No |
allauth.PasswordLess¶
| Name | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
passwordless |
query | boolean | No |
allauth.PasswordResetKey¶
| Name | In | Type | Default | Nullable | Description |
|---|---|---|---|---|---|
X-Password-Reset-Key |
header | string | No |
Security schemes¶
| Name | Type | Scheme | Description |
|---|---|---|---|
| basicAuth | http | basic | |
| cookieAuth | apiKey | ||
| oauth2 | oauth2 | ||
| tokenAuth | apiKey | Token-based authentication with required prefix "Token" |
More documentation¶
More information about InvenTree in the official docs