Goods Receipt Line Item¶
Get A Resource By ID¶
HTTP Request
GET /api/v1/goods-receipt-line-item/{id}
📋 Description: Returns the single resource with the given ID.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Resource ID |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "source": {},
8 "errorMessage": "string",
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {
15 "id": 0,
16 "displayId": "string",
17 "quantity": 0,
18 "invoicedQuantity": 0,
19 "description": "string",
20 "expenseCategory": {
21 "id": 0,
22 "displayId": "string",
23 "status": "CREATED",
24 "name": "string",
25 "expenseCategoryType": "PAYMENT"
26 },
27 "goodsReceiptId": 0,
28 "goodsReceiptDisplayId": "string",
29 "goodsReceiptState": "INV_DRAFT",
30 "purchaseOrderLineItemId": 0,
31 "invoiceLineItemLinks": [
32 {
33 "id": 0,
34 "fromId": 0,
35 "toId": 0,
36 "linkedQuantity": 0
37 }
38 ],
39 "availableQuantity": 0,
40 "allowsSystemGenerateNewId": true,
41 "numberRangeIdentifierValue": "string",
42 "numberRangeIdentifierType": {
43 "name": "string"
44 },
45 "numberRangeType": {
46 "name": "string"
47 }
48 }
49}
Update A Resource¶
HTTP Request
PUT /api/v1/goods-receipt-line-item/{id}
📋 Description: Fully replaces the resource with the given ID. All fields in the request body are applied.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Resource ID |
body |
body |
true |
Request body containing the updated details of the goods receipt line item, including quantity, item description, and associated metadata for inventory management. |
Body Parameters
1{
2 "id": 0,
3 "displayId": "string",
4 "quantity": 0,
5 "invoicedQuantity": 0,
6 "description": "string",
7 "expenseCategory": {
8 "id": 0,
9 "displayId": "string",
10 "status": "CREATED",
11 "name": "string",
12 "expenseCategoryType": "PAYMENT"
13 },
14 "goodsReceiptId": 0,
15 "goodsReceiptDisplayId": "string",
16 "goodsReceiptState": "INV_DRAFT",
17 "purchaseOrderLineItemId": 0,
18 "invoiceLineItemLinks": [
19 {
20 "id": 0,
21 "fromId": 0,
22 "toId": 0,
23 "linkedQuantity": 0
24 }
25 ],
26 "allowsSystemGenerateNewId": true,
27 "numberRangeIdentifierValue": "string",
28 "numberRangeIdentifierType": {
29 "name": "string"
30 },
31 "numberRangeType": {
32 "name": "string"
33 }
34}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "source": {},
8 "errorMessage": "string",
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {
15 "id": 0,
16 "displayId": "string",
17 "quantity": 0,
18 "invoicedQuantity": 0,
19 "description": "string",
20 "expenseCategory": {
21 "id": 0,
22 "displayId": "string",
23 "status": "CREATED",
24 "name": "string",
25 "expenseCategoryType": "PAYMENT"
26 },
27 "goodsReceiptId": 0,
28 "goodsReceiptDisplayId": "string",
29 "goodsReceiptState": "INV_DRAFT",
30 "purchaseOrderLineItemId": 0,
31 "invoiceLineItemLinks": [
32 {
33 "id": 0,
34 "fromId": 0,
35 "toId": 0,
36 "linkedQuantity": 0
37 }
38 ],
39 "availableQuantity": 0,
40 "allowsSystemGenerateNewId": true,
41 "numberRangeIdentifierValue": "string",
42 "numberRangeIdentifierType": {
43 "name": "string"
44 },
45 "numberRangeType": {
46 "name": "string"
47 }
48 }
49}
Delete A Single Resource¶
HTTP Request
DELETE /api/v1/goods-receipt-line-item/{id}
📋 Description: Permanently deletes the resource with the given ID.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "source": {},
8 "errorMessage": "string",
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {}
15}
Partially Update A Resource (Json Patch)¶
HTTP Request
PATCH /api/v1/goods-receipt-line-item/{id}
📋 Description: Applies a JSON Patch (RFC 6902) document to the resource with the given ID. Only the fields specified in the patch are modified; all other fields remain unchanged.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
body |
body |
true |
Request body containing updated details for the specified goods receipt line item, including quantity, status, and any relevant adjustments. |
Body Parameters
1{}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "source": {},
8 "errorMessage": "string",
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {
15 "id": 0,
16 "displayId": "string",
17 "quantity": 0,
18 "invoicedQuantity": 0,
19 "description": "string",
20 "expenseCategory": {
21 "id": 0,
22 "displayId": "string",
23 "status": "CREATED",
24 "name": "string",
25 "expenseCategoryType": "PAYMENT"
26 },
27 "goodsReceiptId": 0,
28 "goodsReceiptDisplayId": "string",
29 "goodsReceiptState": "INV_DRAFT",
30 "purchaseOrderLineItemId": 0,
31 "invoiceLineItemLinks": [
32 {
33 "id": 0,
34 "fromId": 0,
35 "toId": 0,
36 "linkedQuantity": 0
37 }
38 ],
39 "availableQuantity": 0,
40 "allowsSystemGenerateNewId": true,
41 "numberRangeIdentifierValue": "string",
42 "numberRangeIdentifierType": {
43 "name": "string"
44 },
45 "numberRangeType": {
46 "name": "string"
47 }
48 }
49}
Bulk Create-Or-Update Resources¶
HTTP Request
PUT /api/v1/goods-receipt-line-item/createOrUpdate/bulk
📋 Description: Creates or updates multiple resources in a single request. Partial success: each item is processed independently. Items that pass validation are persisted; failed items are recorded in the response
errorslist. The response body always contains the successfully processed items alongside any per-item errors.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a collection of goods receipt line items for bulk creation or update, including relevant details such as item identifiers, quantities, and associated metadata. |
Body Parameters
1[
2 {
3 "id": 0,
4 "displayId": "string",
5 "quantity": 0,
6 "invoicedQuantity": 0,
7 "description": "string",
8 "expenseCategory": {
9 "id": 0,
10 "displayId": "string",
11 "status": "CREATED",
12 "name": "string",
13 "expenseCategoryType": "PAYMENT"
14 },
15 "goodsReceiptId": 0,
16 "goodsReceiptDisplayId": "string",
17 "goodsReceiptState": "INV_DRAFT",
18 "purchaseOrderLineItemId": 0,
19 "invoiceLineItemLinks": [
20 {
21 "id": 0,
22 "fromId": 0,
23 "toId": 0,
24 "linkedQuantity": 0
25 }
26 ],
27 "allowsSystemGenerateNewId": true,
28 "numberRangeIdentifierValue": "string",
29 "numberRangeIdentifierType": {
30 "name": "string"
31 },
32 "numberRangeType": {
33 "name": "string"
34 }
35 }
36]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "source": {},
8 "errorMessage": "string",
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": [
15 {
16 "id": 0,
17 "displayId": "string",
18 "quantity": 0,
19 "invoicedQuantity": 0,
20 "description": "string",
21 "expenseCategory": {
22 "id": 0,
23 "displayId": "string",
24 "status": "CREATED",
25 "name": "string",
26 "expenseCategoryType": "PAYMENT"
27 },
28 "goodsReceiptId": 0,
29 "goodsReceiptDisplayId": "string",
30 "goodsReceiptState": "INV_DRAFT",
31 "purchaseOrderLineItemId": 0,
32 "invoiceLineItemLinks": [
33 {
34 "id": 0,
35 "fromId": 0,
36 "toId": 0,
37 "linkedQuantity": 0
38 }
39 ],
40 "availableQuantity": 0,
41 "allowsSystemGenerateNewId": true,
42 "numberRangeIdentifierValue": "string",
43 "numberRangeIdentifierType": {
44 "name": "string"
45 },
46 "numberRangeType": {
47 "name": "string"
48 }
49 }
50 ]
51}
Create Or Update A Resource¶
HTTP Request
PUT /api/v1/goods-receipt-line-item/createOrUpdate
📋 Description: Creates the resource if no matching record exists, or fully updates it if one is found. Idempotent: safe to call multiple times with the same payload.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the details of the goods receipt line item, including item specifications, quantities, and associated metadata for creation or updating purposes. |
Body Parameters
1{
2 "id": 0,
3 "displayId": "string",
4 "quantity": 0,
5 "invoicedQuantity": 0,
6 "description": "string",
7 "expenseCategory": {
8 "id": 0,
9 "displayId": "string",
10 "status": "CREATED",
11 "name": "string",
12 "expenseCategoryType": "PAYMENT"
13 },
14 "goodsReceiptId": 0,
15 "goodsReceiptDisplayId": "string",
16 "goodsReceiptState": "INV_DRAFT",
17 "purchaseOrderLineItemId": 0,
18 "invoiceLineItemLinks": [
19 {
20 "id": 0,
21 "fromId": 0,
22 "toId": 0,
23 "linkedQuantity": 0
24 }
25 ],
26 "allowsSystemGenerateNewId": true,
27 "numberRangeIdentifierValue": "string",
28 "numberRangeIdentifierType": {
29 "name": "string"
30 },
31 "numberRangeType": {
32 "name": "string"
33 }
34}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "source": {},
8 "errorMessage": "string",
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {
15 "id": 0,
16 "displayId": "string",
17 "quantity": 0,
18 "invoicedQuantity": 0,
19 "description": "string",
20 "expenseCategory": {
21 "id": 0,
22 "displayId": "string",
23 "status": "CREATED",
24 "name": "string",
25 "expenseCategoryType": "PAYMENT"
26 },
27 "goodsReceiptId": 0,
28 "goodsReceiptDisplayId": "string",
29 "goodsReceiptState": "INV_DRAFT",
30 "purchaseOrderLineItemId": 0,
31 "invoiceLineItemLinks": [
32 {
33 "id": 0,
34 "fromId": 0,
35 "toId": 0,
36 "linkedQuantity": 0
37 }
38 ],
39 "availableQuantity": 0,
40 "allowsSystemGenerateNewId": true,
41 "numberRangeIdentifierValue": "string",
42 "numberRangeIdentifierType": {
43 "name": "string"
44 },
45 "numberRangeType": {
46 "name": "string"
47 }
48 }
49}
Bulk-Update Resources¶
HTTP Request
PUT /api/v1/goods-receipt-line-item/bulk
📋 Description: Updates multiple resources in a single request. Partial success: each item is processed independently. Items that pass validation are updated; failed items are recorded in the response
errorslist. The response body always contains the successfully updated items alongside any per-item errors.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a collection of goods receipt line items for bulk processing, including relevant details such as item identifiers, quantities, and associated metadata. |
Body Parameters
1[
2 {
3 "id": 0,
4 "displayId": "string",
5 "quantity": 0,
6 "invoicedQuantity": 0,
7 "description": "string",
8 "expenseCategory": {
9 "id": 0,
10 "displayId": "string",
11 "status": "CREATED",
12 "name": "string",
13 "expenseCategoryType": "PAYMENT"
14 },
15 "goodsReceiptId": 0,
16 "goodsReceiptDisplayId": "string",
17 "goodsReceiptState": "INV_DRAFT",
18 "purchaseOrderLineItemId": 0,
19 "invoiceLineItemLinks": [
20 {
21 "id": 0,
22 "fromId": 0,
23 "toId": 0,
24 "linkedQuantity": 0
25 }
26 ],
27 "allowsSystemGenerateNewId": true,
28 "numberRangeIdentifierValue": "string",
29 "numberRangeIdentifierType": {
30 "name": "string"
31 },
32 "numberRangeType": {
33 "name": "string"
34 }
35 }
36]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "source": {},
8 "errorMessage": "string",
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": [
15 {
16 "id": 0,
17 "displayId": "string",
18 "quantity": 0,
19 "invoicedQuantity": 0,
20 "description": "string",
21 "expenseCategory": {
22 "id": 0,
23 "displayId": "string",
24 "status": "CREATED",
25 "name": "string",
26 "expenseCategoryType": "PAYMENT"
27 },
28 "goodsReceiptId": 0,
29 "goodsReceiptDisplayId": "string",
30 "goodsReceiptState": "INV_DRAFT",
31 "purchaseOrderLineItemId": 0,
32 "invoiceLineItemLinks": [
33 {
34 "id": 0,
35 "fromId": 0,
36 "toId": 0,
37 "linkedQuantity": 0
38 }
39 ],
40 "availableQuantity": 0,
41 "allowsSystemGenerateNewId": true,
42 "numberRangeIdentifierValue": "string",
43 "numberRangeIdentifierType": {
44 "name": "string"
45 },
46 "numberRangeType": {
47 "name": "string"
48 }
49 }
50 ]
51}
Bulk-Create Resources¶
HTTP Request
POST /api/v1/goods-receipt-line-item/bulk
📋 Description: Creates multiple resources in a single request. Partial success: each item is processed independently. Items that pass validation are persisted; failed items are recorded in the response
errorslist. The response body always contains the successfully created items alongside any per-item errors.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a collection of goods receipt line item details, including quantities, item identifiers, and associated metadata for bulk processing. |
Body Parameters
1[
2 {
3 "id": 0,
4 "displayId": "string",
5 "quantity": 0,
6 "invoicedQuantity": 0,
7 "description": "string",
8 "expenseCategory": {
9 "id": 0,
10 "displayId": "string",
11 "status": "CREATED",
12 "name": "string",
13 "expenseCategoryType": "PAYMENT"
14 },
15 "goodsReceiptId": 0,
16 "goodsReceiptDisplayId": "string",
17 "goodsReceiptState": "INV_DRAFT",
18 "purchaseOrderLineItemId": 0,
19 "invoiceLineItemLinks": [
20 {
21 "id": 0,
22 "fromId": 0,
23 "toId": 0,
24 "linkedQuantity": 0
25 }
26 ],
27 "allowsSystemGenerateNewId": true,
28 "numberRangeIdentifierValue": "string",
29 "numberRangeIdentifierType": {
30 "name": "string"
31 },
32 "numberRangeType": {
33 "name": "string"
34 }
35 }
36]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "source": {},
8 "errorMessage": "string",
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": [
15 {
16 "id": 0,
17 "displayId": "string",
18 "quantity": 0,
19 "invoicedQuantity": 0,
20 "description": "string",
21 "expenseCategory": {
22 "id": 0,
23 "displayId": "string",
24 "status": "CREATED",
25 "name": "string",
26 "expenseCategoryType": "PAYMENT"
27 },
28 "goodsReceiptId": 0,
29 "goodsReceiptDisplayId": "string",
30 "goodsReceiptState": "INV_DRAFT",
31 "purchaseOrderLineItemId": 0,
32 "invoiceLineItemLinks": [
33 {
34 "id": 0,
35 "fromId": 0,
36 "toId": 0,
37 "linkedQuantity": 0
38 }
39 ],
40 "availableQuantity": 0,
41 "allowsSystemGenerateNewId": true,
42 "numberRangeIdentifierValue": "string",
43 "numberRangeIdentifierType": {
44 "name": "string"
45 },
46 "numberRangeType": {
47 "name": "string"
48 }
49 }
50 ]
51}
Bulk-Delete Resources¶
HTTP Request
DELETE /api/v1/goods-receipt-line-item/bulk
📋 Description: Deletes multiple resources by ID in a single request. Partial success: each deletion is attempted independently. If one or more deletions fail (e.g. due to state constraints), the successfully deleted items are NOT rolled back. A
ValidationExceptioncontaining per-item errors is thrown after all items have been attempted, so the caller must inspect the error list to determine which IDs were not deleted.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing an array of identifiers for the goods receipt line items to be deleted in bulk. |
Body Parameters
1[
2 0
3]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "source": {},
8 "errorMessage": "string",
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {}
15}
Unlink Goods Receipt Line Items From Purchase Order Line Items¶
HTTP Request
POST /api/v1/goods-receipt-line-item/unlink-goods-receipt-to-purchase-order-line-items
📋 Description: Removes the association between the specified goods receipt line items and their purchase order line items. The operation is all-or-nothing: the entire batch is validated upfront and rolled back if any item fails.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the identifiers for the goods receipt and associated purchase order line items to facilitate the unlinking process. |
Body Parameters
1[
2 {
3 "purchaseOrderLineItemId": 0,
4 "goodsReceiptLineItemId": 0
5 }
6]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
|
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1[
2 {
3 "id": 0,
4 "displayId": "string",
5 "quantity": 0,
6 "invoicedQuantity": 0,
7 "description": "string",
8 "expenseCategory": {
9 "id": 0,
10 "displayId": "string",
11 "status": "CREATED",
12 "name": "string",
13 "expenseCategoryType": "PAYMENT"
14 },
15 "goodsReceiptId": 0,
16 "goodsReceiptDisplayId": "string",
17 "goodsReceiptState": "INV_DRAFT",
18 "purchaseOrderLineItemId": 0,
19 "invoiceLineItemLinks": [
20 {
21 "id": 0,
22 "fromId": 0,
23 "toId": 0,
24 "linkedQuantity": 0
25 }
26 ],
27 "availableQuantity": 0,
28 "allowsSystemGenerateNewId": true,
29 "numberRangeIdentifierValue": "string",
30 "numberRangeIdentifierType": {
31 "name": "string"
32 },
33 "numberRangeType": {
34 "name": "string"
35 }
36 }
37]
Response Schema
Status Code 200
Name |
Type |
Required |
Restrictions |
Description |
|---|---|---|---|---|
anonymous |
false |
none |
[Data transfer object representing a line item within a goods receipt, detailing the specific items received, their quantities, and associated metadata to facilitate inventory management and financial reconciliation.] |
|
» id |
integer(int64) |
false |
none |
Unique identifier for the resource |
» displayId |
string |
false |
none |
Unique identifier for the display |
» quantity |
integer(int64) |
false |
none |
Quantity value |
» invoicedQuantity |
integer(int64) |
false |
none |
Quantity of invoiced quantity |
» description |
string |
false |
none |
Description of the resource |
» expenseCategory |
false |
none |
Data transfer object representing a simplified categorization of expenses, enabling efficient tracking and reporting of financial allocations within the organization. |
|
»» id |
integer(int64) |
false |
none |
Unique identifier for the resource |
»» displayId |
string |
false |
none |
Unique identifier for the display |
»» status |
string |
false |
none |
Status of the resource |
»» name |
string |
false |
none |
Name of the resource |
»» expenseCategoryType |
string |
false |
none |
Type of the expense category |
» goodsReceiptId |
integer(int64) |
true |
none |
Unique identifier for the goods receipt |
» goodsReceiptDisplayId |
string |
false |
none |
Unique identifier for the goods receipt display |
» goodsReceiptState |
string |
false |
none |
Indicates the current status of the goods receipt, reflecting its processing stage within the supply chain management system. |
» purchaseOrderLineItemId |
integer(int64) |
false |
none |
Unique identifier for the purchase order line item |
» invoiceLineItemLinks |
false |
none |
Array of links to associated invoice line items, facilitating the tracking and management of goods receipt transactions. |
|
»» id |
integer(int64) |
false |
none |
Unique identifier for the resource |
»» fromId |
integer(int64) |
false |
none |
Unique identifier for the from |
»» toId |
integer(int64) |
false |
none |
Unique identifier for the to |
»» linkedQuantity |
integer(int64) |
false |
none |
Quantity of linked quantity |
» availableQuantity |
integer(int64) |
false |
read-only |
Quantity of available quantity |
» allowsSystemGenerateNewId |
boolean |
false |
none |
Unique identifier for the allows system generate new |
» numberRangeIdentifierValue |
string |
false |
none |
Represents a unique identifier for the range of numbers associated with a specific goods receipt line item, facilitating accurate tracking and management of inventory. |
» numberRangeIdentifierType |
false |
none |
Data transfer object representing a numerical range identifier used for categorizing and validating data entries within business processes, ensuring consistency and accuracy in data management. |
|
»» name |
string |
false |
none |
Name of the resource |
» numberRangeType |
false |
none |
Data structure representing a numerical range, utilized for defining limits or thresholds within business processes, ensuring precise data validation and operational efficiency. |
|
»» name |
string |
true |
none |
Name of the resource |
Enumerated Values
Attribute |
Value |
|---|---|
expenseCategoryType |
CASH_INCENTIVE, CASUALTY, EXPECTED_GRV, INCENTIVE, NON_LEASE, PAYMENT, PURCHASE_OPTION, TERMINATION_OPTION |
goodsReceiptState |
GOODS_RECEIPT_DRAFT, GOODS_RECEIPT_MATCHED, GOODS_RECEIPT_RECEIVED, GOODS_RECEIPT_REJECTED, INVOICE_PAYMENT_DRAFT, INVOICE_PAYMENT_JOURNALS_GENERATING, INVOICE_PAYMENT_POSTED, INVOICE_PAYMENT_POSTING, INVOICE_PAYMENT_REVIEW, INV_APPROVED, INV_DRAFT, INV_GENERATING_JOURNALS, INV_PAID, INV_POSTED, INV_POSTING, INV_REJECTED, INV_REVIEW, INV_WAITING_FOR_APPROVAL, PURCHASE_ORDER_APPROVED, PURCHASE_ORDER_DRAFT, PURCHASE_ORDER_REJECTED, PURCHASE_ORDER_WAITING_FOR_APPROVAL, PURCHASE_REQUISITION_APPROVED, PURCHASE_REQUISITION_DRAFT, PURCHASE_REQUISITION_REJECTED, PURCHASE_REQUISITION_WAITING_FOR_APPROVAL, VENDOR_REQUEST_APPROVED, VENDOR_REQUEST_DRAFT, VENDOR_REQUEST_PENDING_APPROVAL, VENDOR_REQUEST_REJECTED, WORKSPACE_CLOSED, WORKSPACE_JOURNALS_GENERATING, WORKSPACE_OPEN, WORKSPACE_POSTING, WORKSPACE_REVIEW |
status |
ACTIVE, CREATED, DECOMMISSIONED, DISABLED |
Search Resources¶
HTTP Request
POST /api/v1/goods-receipt-line-item/search
📋 Description: Returns a paginated list of resources matching the given filter criteria. Pass null or an empty body to return all accessible records.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
page |
query |
integer |
false |
Zero-based page index (0..N) |
size |
query |
integer |
false |
The size of the page to be returned |
sort |
query |
array[string] |
false |
Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported. |
body |
body |
false |
Request body containing search criteria and filters for retrieving specific goods receipt line items relevant to inventory management. |
Default Values¶
Parameter |
Default |
Type |
|---|---|---|
page |
|
query |
size |
|
query |
sort |
|
query |
Parameter Constraints¶
Parameter |
Constraints |
|---|---|
page |
Min: 0 |
size |
Min: 1 |
Body Parameters
1{
2 "idIn": [
3 0
4 ],
5 "idEqual": 0,
6 "idLike": "string",
7 "createdAtGreaterThanOrEqual": "2019-08-24T14:15:22Z",
8 "createdAtLessThanOrEqual": "2019-08-24T14:15:22Z",
9 "createdByLike": "string",
10 "createdByEqual": "string",
11 "modifiedAtGreaterThanOrEqual": "2019-08-24T14:15:22Z",
12 "modifiedAtLessThanOrEqual": "2019-08-24T14:15:22Z",
13 "modifiedByLike": "string",
14 "modifiedByEqual": "string",
15 "displayIdIn": [
16 "string"
17 ],
18 "displayIdLike": "string",
19 "quantityEqual": 0,
20 "invoicedQuantityEqual": 0,
21 "descriptionLike": "string",
22 "expenseCategoryIdEqual": 0,
23 "expenseCategoryDisplayIdLike": "string",
24 "goodsReceiptIdIn": [
25 0
26 ],
27 "goodsReceiptIdEqual": 0,
28 "goodsReceiptDisplayIdIn": [
29 "string"
30 ],
31 "goodsReceiptDisplayIdEqual": "string",
32 "goodsReceiptStateIn": [
33 "INV_DRAFT"
34 ],
35 "goodsReceiptStateEqual": "INV_DRAFT",
36 "purchaseOrderLineItemIdIn": [
37 0
38 ],
39 "purchaseOrderLineItemIdEqual": 0
40}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "totalPages": 0,
3 "totalElements": 0,
4 "pageable": {
5 "pageNumber": 0,
6 "unpaged": true,
7 "paged": true,
8 "pageSize": 0,
9 "offset": 0,
10 "sort": {
11 "unsorted": true,
12 "sorted": true,
13 "empty": true
14 }
15 },
16 "numberOfElements": 0,
17 "size": 0,
18 "content": [
19 {
20 "id": 0,
21 "displayId": "string",
22 "quantity": 0,
23 "invoicedQuantity": 0,
24 "description": "string",
25 "expenseCategory": {
26 "id": 0,
27 "displayId": "string",
28 "status": "CREATED",
29 "name": "string",
30 "expenseCategoryType": "PAYMENT"
31 },
32 "goodsReceiptId": 0,
33 "goodsReceiptDisplayId": "string",
34 "goodsReceiptState": "INV_DRAFT",
35 "purchaseOrderLineItemId": 0,
36 "invoiceLineItemLinks": [
37 {
38 "id": 0,
39 "fromId": 0,
40 "toId": 0,
41 "linkedQuantity": 0
42 }
43 ],
44 "availableQuantity": 0,
45 "allowsSystemGenerateNewId": true,
46 "numberRangeIdentifierValue": "string",
47 "numberRangeIdentifierType": {
48 "name": "string"
49 },
50 "numberRangeType": {
51 "name": "string"
52 }
53 }
54 ],
55 "number": 0,
56 "sort": {
57 "unsorted": true,
58 "sorted": true,
59 "empty": true
60 },
61 "first": true,
62 "last": true,
63 "empty": true
64}
Record Goods Receipt Line Items From Purchase Order Line Items¶
HTTP Request
POST /api/v1/goods-receipt-line-item/record-goods-receipt-from-purchase-order-line-items
📋 Description: Creates new goods receipt line items pre-populated from the specified purchase order line items. Each DTO specifies the goods receipt, PO line item, and received quantity. The operation is all-or-nothing: the entire batch is validated upfront and rolled back if any item fails.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the details of goods receipt line items, including associated purchase order line item identifiers and quantities, necessary for accurate inventory and financial reconciliation. |
Body Parameters
1[
2 {
3 "purchaseOrderLineItemId": 0,
4 "goodsReceiptId": 0,
5 "quantity": 0
6 }
7]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
|
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1[
2 {
3 "id": 0,
4 "displayId": "string",
5 "quantity": 0,
6 "invoicedQuantity": 0,
7 "description": "string",
8 "expenseCategory": {
9 "id": 0,
10 "displayId": "string",
11 "status": "CREATED",
12 "name": "string",
13 "expenseCategoryType": "PAYMENT"
14 },
15 "goodsReceiptId": 0,
16 "goodsReceiptDisplayId": "string",
17 "goodsReceiptState": "INV_DRAFT",
18 "purchaseOrderLineItemId": 0,
19 "invoiceLineItemLinks": [
20 {
21 "id": 0,
22 "fromId": 0,
23 "toId": 0,
24 "linkedQuantity": 0
25 }
26 ],
27 "availableQuantity": 0,
28 "allowsSystemGenerateNewId": true,
29 "numberRangeIdentifierValue": "string",
30 "numberRangeIdentifierType": {
31 "name": "string"
32 },
33 "numberRangeType": {
34 "name": "string"
35 }
36 }
37]
Response Schema
Status Code 200
Name |
Type |
Required |
Restrictions |
Description |
|---|---|---|---|---|
anonymous |
false |
none |
[Data transfer object representing a line item within a goods receipt, detailing the specific items received, their quantities, and associated metadata to facilitate inventory management and financial reconciliation.] |
|
» id |
integer(int64) |
false |
none |
Unique identifier for the resource |
» displayId |
string |
false |
none |
Unique identifier for the display |
» quantity |
integer(int64) |
false |
none |
Quantity value |
» invoicedQuantity |
integer(int64) |
false |
none |
Quantity of invoiced quantity |
» description |
string |
false |
none |
Description of the resource |
» expenseCategory |
false |
none |
Data transfer object representing a simplified categorization of expenses, enabling efficient tracking and reporting of financial allocations within the organization. |
|
»» id |
integer(int64) |
false |
none |
Unique identifier for the resource |
»» displayId |
string |
false |
none |
Unique identifier for the display |
»» status |
string |
false |
none |
Status of the resource |
»» name |
string |
false |
none |
Name of the resource |
»» expenseCategoryType |
string |
false |
none |
Type of the expense category |
» goodsReceiptId |
integer(int64) |
true |
none |
Unique identifier for the goods receipt |
» goodsReceiptDisplayId |
string |
false |
none |
Unique identifier for the goods receipt display |
» goodsReceiptState |
string |
false |
none |
Indicates the current status of the goods receipt, reflecting its processing stage within the supply chain management system. |
» purchaseOrderLineItemId |
integer(int64) |
false |
none |
Unique identifier for the purchase order line item |
» invoiceLineItemLinks |
false |
none |
Array of links to associated invoice line items, facilitating the tracking and management of goods receipt transactions. |
|
»» id |
integer(int64) |
false |
none |
Unique identifier for the resource |
»» fromId |
integer(int64) |
false |
none |
Unique identifier for the from |
»» toId |
integer(int64) |
false |
none |
Unique identifier for the to |
»» linkedQuantity |
integer(int64) |
false |
none |
Quantity of linked quantity |
» availableQuantity |
integer(int64) |
false |
read-only |
Quantity of available quantity |
» allowsSystemGenerateNewId |
boolean |
false |
none |
Unique identifier for the allows system generate new |
» numberRangeIdentifierValue |
string |
false |
none |
Represents a unique identifier for the range of numbers associated with a specific goods receipt line item, facilitating accurate tracking and management of inventory. |
» numberRangeIdentifierType |
false |
none |
Data transfer object representing a numerical range identifier used for categorizing and validating data entries within business processes, ensuring consistency and accuracy in data management. |
|
»» name |
string |
false |
none |
Name of the resource |
» numberRangeType |
false |
none |
Data structure representing a numerical range, utilized for defining limits or thresholds within business processes, ensuring precise data validation and operational efficiency. |
|
»» name |
string |
true |
none |
Name of the resource |
Enumerated Values
Attribute |
Value |
|---|---|
expenseCategoryType |
CASH_INCENTIVE, CASUALTY, EXPECTED_GRV, INCENTIVE, NON_LEASE, PAYMENT, PURCHASE_OPTION, TERMINATION_OPTION |
goodsReceiptState |
GOODS_RECEIPT_DRAFT, GOODS_RECEIPT_MATCHED, GOODS_RECEIPT_RECEIVED, GOODS_RECEIPT_REJECTED, INVOICE_PAYMENT_DRAFT, INVOICE_PAYMENT_JOURNALS_GENERATING, INVOICE_PAYMENT_POSTED, INVOICE_PAYMENT_POSTING, INVOICE_PAYMENT_REVIEW, INV_APPROVED, INV_DRAFT, INV_GENERATING_JOURNALS, INV_PAID, INV_POSTED, INV_POSTING, INV_REJECTED, INV_REVIEW, INV_WAITING_FOR_APPROVAL, PURCHASE_ORDER_APPROVED, PURCHASE_ORDER_DRAFT, PURCHASE_ORDER_REJECTED, PURCHASE_ORDER_WAITING_FOR_APPROVAL, PURCHASE_REQUISITION_APPROVED, PURCHASE_REQUISITION_DRAFT, PURCHASE_REQUISITION_REJECTED, PURCHASE_REQUISITION_WAITING_FOR_APPROVAL, VENDOR_REQUEST_APPROVED, VENDOR_REQUEST_DRAFT, VENDOR_REQUEST_PENDING_APPROVAL, VENDOR_REQUEST_REJECTED, WORKSPACE_CLOSED, WORKSPACE_JOURNALS_GENERATING, WORKSPACE_OPEN, WORKSPACE_POSTING, WORKSPACE_REVIEW |
status |
ACTIVE, CREATED, DECOMMISSIONED, DISABLED |
Link Goods Receipt Line Items To Purchase Order Line Items¶
HTTP Request
POST /api/v1/goods-receipt-line-item/link-goods-receipt-to-purchase-order-line-items
📋 Description: Associates existing goods receipt line items with purchase order line items. The operation is all-or-nothing: the entire batch is validated upfront and rolled back if any item fails.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the details necessary to link goods receipt line items to their corresponding purchase order line items, ensuring accurate inventory and financial tracking. |
Body Parameters
1[
2 {
3 "purchaseOrderLineItemId": 0,
4 "goodsReceiptLineItemId": 0
5 }
6]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
|
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1[
2 {
3 "id": 0,
4 "displayId": "string",
5 "quantity": 0,
6 "invoicedQuantity": 0,
7 "description": "string",
8 "expenseCategory": {
9 "id": 0,
10 "displayId": "string",
11 "status": "CREATED",
12 "name": "string",
13 "expenseCategoryType": "PAYMENT"
14 },
15 "goodsReceiptId": 0,
16 "goodsReceiptDisplayId": "string",
17 "goodsReceiptState": "INV_DRAFT",
18 "purchaseOrderLineItemId": 0,
19 "invoiceLineItemLinks": [
20 {
21 "id": 0,
22 "fromId": 0,
23 "toId": 0,
24 "linkedQuantity": 0
25 }
26 ],
27 "availableQuantity": 0,
28 "allowsSystemGenerateNewId": true,
29 "numberRangeIdentifierValue": "string",
30 "numberRangeIdentifierType": {
31 "name": "string"
32 },
33 "numberRangeType": {
34 "name": "string"
35 }
36 }
37]
Response Schema
Status Code 200
Name |
Type |
Required |
Restrictions |
Description |
|---|---|---|---|---|
anonymous |
false |
none |
[Data transfer object representing a line item within a goods receipt, detailing the specific items received, their quantities, and associated metadata to facilitate inventory management and financial reconciliation.] |
|
» id |
integer(int64) |
false |
none |
Unique identifier for the resource |
» displayId |
string |
false |
none |
Unique identifier for the display |
» quantity |
integer(int64) |
false |
none |
Quantity value |
» invoicedQuantity |
integer(int64) |
false |
none |
Quantity of invoiced quantity |
» description |
string |
false |
none |
Description of the resource |
» expenseCategory |
false |
none |
Data transfer object representing a simplified categorization of expenses, enabling efficient tracking and reporting of financial allocations within the organization. |
|
»» id |
integer(int64) |
false |
none |
Unique identifier for the resource |
»» displayId |
string |
false |
none |
Unique identifier for the display |
»» status |
string |
false |
none |
Status of the resource |
»» name |
string |
false |
none |
Name of the resource |
»» expenseCategoryType |
string |
false |
none |
Type of the expense category |
» goodsReceiptId |
integer(int64) |
true |
none |
Unique identifier for the goods receipt |
» goodsReceiptDisplayId |
string |
false |
none |
Unique identifier for the goods receipt display |
» goodsReceiptState |
string |
false |
none |
Indicates the current status of the goods receipt, reflecting its processing stage within the supply chain management system. |
» purchaseOrderLineItemId |
integer(int64) |
false |
none |
Unique identifier for the purchase order line item |
» invoiceLineItemLinks |
false |
none |
Array of links to associated invoice line items, facilitating the tracking and management of goods receipt transactions. |
|
»» id |
integer(int64) |
false |
none |
Unique identifier for the resource |
»» fromId |
integer(int64) |
false |
none |
Unique identifier for the from |
»» toId |
integer(int64) |
false |
none |
Unique identifier for the to |
»» linkedQuantity |
integer(int64) |
false |
none |
Quantity of linked quantity |
» availableQuantity |
integer(int64) |
false |
read-only |
Quantity of available quantity |
» allowsSystemGenerateNewId |
boolean |
false |
none |
Unique identifier for the allows system generate new |
» numberRangeIdentifierValue |
string |
false |
none |
Represents a unique identifier for the range of numbers associated with a specific goods receipt line item, facilitating accurate tracking and management of inventory. |
» numberRangeIdentifierType |
false |
none |
Data transfer object representing a numerical range identifier used for categorizing and validating data entries within business processes, ensuring consistency and accuracy in data management. |
|
»» name |
string |
false |
none |
Name of the resource |
» numberRangeType |
false |
none |
Data structure representing a numerical range, utilized for defining limits or thresholds within business processes, ensuring precise data validation and operational efficiency. |
|
»» name |
string |
true |
none |
Name of the resource |
Enumerated Values
Attribute |
Value |
|---|---|
expenseCategoryType |
CASH_INCENTIVE, CASUALTY, EXPECTED_GRV, INCENTIVE, NON_LEASE, PAYMENT, PURCHASE_OPTION, TERMINATION_OPTION |
goodsReceiptState |
GOODS_RECEIPT_DRAFT, GOODS_RECEIPT_MATCHED, GOODS_RECEIPT_RECEIVED, GOODS_RECEIPT_REJECTED, INVOICE_PAYMENT_DRAFT, INVOICE_PAYMENT_JOURNALS_GENERATING, INVOICE_PAYMENT_POSTED, INVOICE_PAYMENT_POSTING, INVOICE_PAYMENT_REVIEW, INV_APPROVED, INV_DRAFT, INV_GENERATING_JOURNALS, INV_PAID, INV_POSTED, INV_POSTING, INV_REJECTED, INV_REVIEW, INV_WAITING_FOR_APPROVAL, PURCHASE_ORDER_APPROVED, PURCHASE_ORDER_DRAFT, PURCHASE_ORDER_REJECTED, PURCHASE_ORDER_WAITING_FOR_APPROVAL, PURCHASE_REQUISITION_APPROVED, PURCHASE_REQUISITION_DRAFT, PURCHASE_REQUISITION_REJECTED, PURCHASE_REQUISITION_WAITING_FOR_APPROVAL, VENDOR_REQUEST_APPROVED, VENDOR_REQUEST_DRAFT, VENDOR_REQUEST_PENDING_APPROVAL, VENDOR_REQUEST_REJECTED, WORKSPACE_CLOSED, WORKSPACE_JOURNALS_GENERATING, WORKSPACE_OPEN, WORKSPACE_POSTING, WORKSPACE_REVIEW |
status |
ACTIVE, CREATED, DECOMMISSIONED, DISABLED |
Advanced Goods Receipt Line Item Search¶
HTTP Request
POST /api/v1/goods-receipt-line-item/advanced-search
📋 Description: Full-text / multi-field search with faceting. Applies company-access and vendor-access filtering.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
page |
query |
integer |
false |
Zero-based page index (0..N) |
size |
query |
integer |
false |
The size of the page to be returned |
sort |
query |
array[string] |
false |
Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported. |
body |
body |
true |
Request body containing the criteria for advanced searching of goods receipt line items, including filters such as item details, quantities, and associated metadata. |
Default Values¶
Parameter |
Default |
Type |
|---|---|---|
page |
|
query |
size |
|
query |
sort |
|
query |
Parameter Constraints¶
Parameter |
Constraints |
|---|---|
page |
Min: 0 |
size |
Min: 1 |
Body Parameters
1{
2 "facets": [
3 "ID"
4 ],
5 "facetSelections": {
6 "property1": [
7 "string"
8 ],
9 "property2": [
10 "string"
11 ]
12 },
13 "aggregations": {
14 "property1": {
15 "type": "TERMS",
16 "field": "ID",
17 "size": 0,
18 "missing": "string"
19 },
20 "property2": {
21 "type": "TERMS",
22 "field": "ID",
23 "size": 0,
24 "missing": "string"
25 }
26 },
27 "filter": {
28 "operator": "AND",
29 "children": [
30 {}
31 ],
32 "field": "ID",
33 "comparison": "EQUAL",
34 "value": "string",
35 "values": [
36 "string"
37 ],
38 "from": "string",
39 "to": "string"
40 }
41}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "results": [
3 {
4 "id": 0,
5 "displayId": "string",
6 "quantity": 0,
7 "invoicedQuantity": 0,
8 "description": "string",
9 "expenseCategory": {
10 "id": 0,
11 "displayId": "string",
12 "status": "CREATED",
13 "name": "string",
14 "expenseCategoryType": "PAYMENT"
15 },
16 "goodsReceiptId": 0,
17 "goodsReceiptDisplayId": "string",
18 "goodsReceiptState": "INV_DRAFT",
19 "purchaseOrderLineItemId": 0,
20 "invoiceLineItemLinks": [
21 {
22 "id": 0,
23 "fromId": 0,
24 "toId": 0,
25 "linkedQuantity": 0
26 }
27 ],
28 "availableQuantity": 0,
29 "allowsSystemGenerateNewId": true,
30 "numberRangeIdentifierValue": "string",
31 "numberRangeIdentifierType": {
32 "name": "string"
33 },
34 "numberRangeType": {
35 "name": "string"
36 }
37 }
38 ],
39 "facets": {
40 "property1": {},
41 "property2": {}
42 },
43 "aggregations": {
44 "property1": {},
45 "property2": {}
46 },
47 "pagination": {
48 "number": 0,
49 "size": 0,
50 "totalElements": 0,
51 "totalPages": 0,
52 "first": true,
53 "last": true,
54 "empty": true,
55 "numberOfElements": 0
56 }
57}
List All Resources¶
HTTP Request
GET /api/v1/goods-receipt-line-item
📋 Description: Returns a paginated list of all accessible resources ordered by ID. Prefer POST /search for filtered queries.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
pageable |
query |
true |
Indicates whether the results of the goods receipt line items should be returned in a paginated format, facilitating efficient data retrieval and management. |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "totalPages": 0,
3 "totalElements": 0,
4 "pageable": {
5 "pageNumber": 0,
6 "unpaged": true,
7 "paged": true,
8 "pageSize": 0,
9 "offset": 0,
10 "sort": {
11 "unsorted": true,
12 "sorted": true,
13 "empty": true
14 }
15 },
16 "numberOfElements": 0,
17 "size": 0,
18 "content": [
19 {
20 "id": 0,
21 "displayId": "string",
22 "quantity": 0,
23 "invoicedQuantity": 0,
24 "description": "string",
25 "expenseCategory": {
26 "id": 0,
27 "displayId": "string",
28 "status": "CREATED",
29 "name": "string",
30 "expenseCategoryType": "PAYMENT"
31 },
32 "goodsReceiptId": 0,
33 "goodsReceiptDisplayId": "string",
34 "goodsReceiptState": "INV_DRAFT",
35 "purchaseOrderLineItemId": 0,
36 "invoiceLineItemLinks": [
37 {
38 "id": 0,
39 "fromId": 0,
40 "toId": 0,
41 "linkedQuantity": 0
42 }
43 ],
44 "availableQuantity": 0,
45 "allowsSystemGenerateNewId": true,
46 "numberRangeIdentifierValue": "string",
47 "numberRangeIdentifierType": {
48 "name": "string"
49 },
50 "numberRangeType": {
51 "name": "string"
52 }
53 }
54 ],
55 "number": 0,
56 "sort": {
57 "unsorted": true,
58 "sorted": true,
59 "empty": true
60 },
61 "first": true,
62 "last": true,
63 "empty": true
64}
Create A Resource¶
HTTP Request
POST /api/v1/goods-receipt-line-item
📋 Description: Creates a single resource. Returns the created resource with its generated ID.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the details of the goods receipt line item, including item specifications, quantities, and associated metadata for inventory management. |
Body Parameters
1{
2 "id": 0,
3 "displayId": "string",
4 "quantity": 0,
5 "invoicedQuantity": 0,
6 "description": "string",
7 "expenseCategory": {
8 "id": 0,
9 "displayId": "string",
10 "status": "CREATED",
11 "name": "string",
12 "expenseCategoryType": "PAYMENT"
13 },
14 "goodsReceiptId": 0,
15 "goodsReceiptDisplayId": "string",
16 "goodsReceiptState": "INV_DRAFT",
17 "purchaseOrderLineItemId": 0,
18 "invoiceLineItemLinks": [
19 {
20 "id": 0,
21 "fromId": 0,
22 "toId": 0,
23 "linkedQuantity": 0
24 }
25 ],
26 "allowsSystemGenerateNewId": true,
27 "numberRangeIdentifierValue": "string",
28 "numberRangeIdentifierType": {
29 "name": "string"
30 },
31 "numberRangeType": {
32 "name": "string"
33 }
34}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
||
409 |
Payment amount exceeds remaining invoice balance |
||
502 |
Downstream service call failed |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "source": {},
8 "errorMessage": "string",
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {
15 "id": 0,
16 "displayId": "string",
17 "quantity": 0,
18 "invoicedQuantity": 0,
19 "description": "string",
20 "expenseCategory": {
21 "id": 0,
22 "displayId": "string",
23 "status": "CREATED",
24 "name": "string",
25 "expenseCategoryType": "PAYMENT"
26 },
27 "goodsReceiptId": 0,
28 "goodsReceiptDisplayId": "string",
29 "goodsReceiptState": "INV_DRAFT",
30 "purchaseOrderLineItemId": 0,
31 "invoiceLineItemLinks": [
32 {
33 "id": 0,
34 "fromId": 0,
35 "toId": 0,
36 "linkedQuantity": 0
37 }
38 ],
39 "availableQuantity": 0,
40 "allowsSystemGenerateNewId": true,
41 "numberRangeIdentifierValue": "string",
42 "numberRangeIdentifierType": {
43 "name": "string"
44 },
45 "numberRangeType": {
46 "name": "string"
47 }
48 }
49}