Subcontracting Receipt
Goods received back from a subcontractor, one of the stock documents a register book can take.
Area: Purchase and transfer documents · Why it is here: · Fields: 50 · Submitted (booked) records: send docstatus: 1 to book it as you create it, or submit a draft with submit.
Read and write it
Every call runs as your app's own user, with its key in one header, at the retailer's own address. The user reads and writes only what its role allows: your app's user, and the rights the retailer gives it.
Read a list (only name unless you ask for fields):
curl -s "https://⟨site⟩/api/resource/Subcontracting%20Receipt?fields=%5B%22*%22%5D&limit_page_length=20" \
-H "Authorization: token ⟨api key⟩:⟨api secret⟩"
Read one, with its tables:
curl -s "https://⟨site⟩/api/resource/Subcontracting%20Receipt/⟨name⟩" -H "Authorization: token ⟨api key⟩:⟨api secret⟩"
Create one (the required fields first), if your app's role may:
curl -s -X POST "https://⟨site⟩/api/resource/Subcontracting%20Receipt" -H "Authorization: token ⟨api key⟩:⟨api secret⟩" \
-H "Content-Type: application/json" -d '{"naming_series": …, "supplier": …, "company": …, "posting_date": …, "posting_time": …, "items": …}'
Change one with PUT /api/resource/Subcontracting%20Receipt/⟨name⟩ and the fields you change; a table sent there replaces its rows, so send its existing rows too. All the record calls and their answers: the API reference.
Samples that use it
Fields
Read from the product at POS 2.1.0.667 (till app 60147699c): its own fields, the fields iVendNext adds to it, and iVendNext's changes to any of them. Read-only fields are set by iVendNext; a hidden one is not on the form but can be read. Every record also has name (its id, in the address), owner, creation, modified, modified_by and docstatus (0 a draft, 1 submitted, 2 cancelled), all read-only.
| Field | Field name | Type | Required | Read-only | Hidden | Links to |
|---|---|---|---|---|---|---|
| Title | title |
Data | yes | |||
| Series | naming_series |
Select | yes | one of: MAT-SCR-.YYYY.-, MAT-SCR-RET-.YYYY.- | ||
| Job Worker | supplier |
Link | yes | Supplier | ||
| Job Worker Name | supplier_name |
Data | yes | |||
| Job Worker Delivery Note | supplier_delivery_note |
Data | ||||
| Company | company |
Link | yes | Company | ||
| Date | posting_date |
Date | yes | |||
| Posting Time | posting_time |
Time | yes | |||
| Edit Posting Date and Time | set_posting_time |
Check | ||||
| Is Return | is_return |
Check | yes | |||
| Return Against Subcontracting Receipt | return_against |
Link | yes | Subcontracting Receipt | ||
| Cost Center | cost_center |
Link | Cost Center | |||
| Project | project |
Link | Project | |||
| Accepted Warehouse | set_warehouse |
Link | Warehouse | |||
| Rejected Warehouse | rejected_warehouse |
Link | Warehouse | |||
| Job Worker Warehouse | supplier_warehouse |
Link | Warehouse | |||
| Items | items |
Table | yes | Subcontracting Receipt Item | ||
| Total Quantity | total_qty |
Float | yes | |||
| Total | total |
Currency | yes | |||
| Consumed Items | supplied_items |
Table | Subcontracting Receipt Supplied Item | |||
| In Words | in_words |
Data | yes | |||
| Bill No | bill_no |
Data | yes | |||
| Bill Date | bill_date |
Date | yes | |||
| Select Job Worker Address | supplier_address |
Link | Address | |||
| Contact Person | contact_person |
Link | Contact | |||
| Address | address_display |
Small Text | yes | |||
| Contact | contact_display |
Small Text | yes | |||
| Mobile No | contact_mobile |
Small Text | yes | |||
| Contact Email | contact_email |
Small Text | yes | |||
| Select Shipping Address | shipping_address |
Link | Address | |||
| Shipping Address | shipping_address_display |
Small Text | yes | |||
| Select Billing Address | billing_address |
Link | Address | |||
| Billing Address | billing_address_display |
Small Text | yes | |||
| Distribute Additional Costs Based On | distribute_additional_costs_based_on |
Select | one of: Qty, Amount | |||
| Additional Costs | additional_costs |
Table | Landed Cost Taxes and Charges | |||
| Total Additional Costs | total_additional_costs |
Currency | yes | |||
| Amended From | amended_from |
Link | yes | yes | Subcontracting Receipt | |
| Range | range |
Data | yes | |||
| Represents Company | represents_company |
Link | yes | Company | ||
| Status | status |
Select | yes | yes | one of: Draft, Completed, Return, Return Issued, Cancelled, Closed | |
| % Returned | per_returned |
Percent | yes | |||
| Auto Repeat | auto_repeat |
Link | yes | Auto Repeat | ||
| Letter Head | letter_head |
Link | Letter Head | |||
| Print Language | language |
Data | yes | |||
| Instructions | instructions |
Small Text | ||||
| Print Heading | select_print_heading |
Link | Print Heading | |||
| Remarks | remarks |
Small Text | ||||
| Transporter Name | transporter_name |
Data | ||||
| Vehicle Number | lr_no |
Data | ||||
| Vehicle Date | lr_date |
Date |
Table: Landed Cost Taxes and Charges
The rows of additional_costs. Each row also has idx (its place), parent, parentfield and parenttype.
| Field | Field name | Type | Required | Read-only | Hidden | Links to |
|---|---|---|---|---|---|---|
| Expense Account | expense_account |
Link | Account | |||
| Account Currency | account_currency |
Link | yes | Currency | ||
| Exchange Rate | exchange_rate |
Float | ||||
| Description | description |
Small Text | yes | |||
| Amount | amount |
Currency | yes | |||
| Amount (Company Currency) | base_amount |
Currency | yes | |||
| Has Corrective Cost | has_corrective_cost |
Check | yes |
Table: Subcontracting Receipt Item
The rows of items. Each row also has idx (its place), parent, parentfield and parenttype.
| Field | Field name | Type | Required | Read-only | Hidden | Links to |
|---|---|---|---|---|---|---|
| Item Code | item_code |
Link | yes | Item | ||
| Item Name | item_name |
Data | ||||
| Is Scrap Item | is_scrap_item |
Check | ||||
| Description | description |
Text Editor | ||||
| Brand | brand |
Link | yes | yes | Brand | |
| Image | image |
Attach | yes | |||
| Received Quantity | received_qty |
Float | yes | yes | ||
| Accepted Quantity | qty |
Float | ||||
| Rejected Quantity | rejected_qty |
Float | ||||
| Returned Qty | returned_qty |
Float | yes | |||
| Stock UOM | stock_uom |
Link | yes | yes | UOM | |
| Conversion Factor | conversion_factor |
Float | yes | yes | ||
| Rate | rate |
Currency | yes | |||
| Amount | amount |
Currency | yes | |||
| Raw Material Cost Per Qty | rm_cost_per_qty |
Currency | yes | |||
| Service Cost Per Qty | service_cost_per_qty |
Currency | yes | yes | ||
| Additional Cost Per Qty | additional_cost_per_qty |
Currency | yes | |||
| Scrap Cost Per Qty | scrap_cost_per_qty |
Float | yes | |||
| Raw Materials Supplied Cost | rm_supp_cost |
Currency | yes | yes | ||
| Accepted Warehouse | warehouse |
Link | Warehouse | |||
| Subcontracting Order | subcontracting_order |
Link | yes | Subcontracting Order | ||
| Subcontracting Order Item | subcontracting_order_item |
Data | yes | yes | ||
| Subcontracting Receipt Item | subcontracting_receipt_item |
Data | yes | yes | ||
| Rejected Warehouse | rejected_warehouse |
Link | Warehouse | |||
| BOM | bom |
Link | BOM | |||
| Include Exploded Items | include_exploded_items |
Check | ||||
| Quality Inspection | quality_inspection |
Link | Quality Inspection | |||
| Required By | schedule_date |
Date | yes | |||
| Reference Name | reference_name |
Data | yes | yes | ||
| Serial and Batch Bundle | serial_and_batch_bundle |
Link | Serial and Batch Bundle | |||
| Use Serial No / Batch Fields | use_serial_batch_fields |
Check | ||||
| Rejected Serial and Batch Bundle | rejected_serial_and_batch_bundle |
Link | Serial and Batch Bundle | |||
| Serial No | serial_no |
Small Text | ||||
| Rejected Serial No | rejected_serial_no |
Small Text | ||||
| Batch No | batch_no |
Link | Batch | |||
| Manufacturer | manufacturer |
Link | Manufacturer | |||
| Manufacturer Part Number | manufacturer_part_no |
Data | ||||
| Expense Account | expense_account |
Link | Account | |||
| Cost Center | cost_center |
Link | Cost Center | |||
| Project | project |
Link | Project | |||
| Page Break | page_break |
Check | ||||
| Purchase Order | purchase_order |
Link | yes | yes | Purchase Order | |
| Purchase Order Item | purchase_order_item |
Data | yes | yes |
Table: Subcontracting Receipt Supplied Item
The rows of supplied_items. Each row also has idx (its place), parent, parentfield and parenttype.
| Field | Field name | Type | Required | Read-only | Hidden | Links to |
|---|---|---|---|---|---|---|
| Item Code | main_item_code |
Link | yes | Item | ||
| Raw Material Item Code | rm_item_code |
Link | yes | Item | ||
| Item Name | item_name |
Data | yes | |||
| BOM Detail No | bom_detail_no |
Data | yes | yes | ||
| Description | description |
Text Editor | yes | |||
| Stock Uom | stock_uom |
Link | yes | UOM | ||
| Conversion Factor | conversion_factor |
Float | yes | yes | ||
| Reference Name | reference_name |
Data | yes | yes | ||
| Rate | rate |
Currency | yes | |||
| Amount | amount |
Currency | yes | |||
| Available Qty For Consumption | available_qty_for_consumption |
Float | yes | |||
| Required Qty | required_qty |
Float | yes | |||
| Consumed Qty | consumed_qty |
Float | yes | yes | ||
| Current Stock | current_stock |
Float | yes | |||
| Serial / Batch Bundle | serial_and_batch_bundle |
Link | Serial and Batch Bundle | |||
| Use Serial No / Batch Fields | use_serial_batch_fields |
Check | ||||
| Subcontracting Order | subcontracting_order |
Link | yes | yes | Subcontracting Order | |
| Serial No | serial_no |
Text | ||||
| Batch No | batch_no |
Link | Batch |