iVendNextDevelopers Request a sandbox

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

s41_regulated_register

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

All record types · What you can use

This record type in the kit