The Item object
Attributes
Unique identifier for the object.
ISO 8601 timestamp of when the object was created.
ISO 8601 timestamp of when the object was last updated.
Default: false
Default: false
Default: true
Default: true
Default: false
Default: 2099-12-31
Default: Purchase
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: Item Attribute
Default: true
Default: 0
Default: false
Default: false
Default: true
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: true
Default: false
Default: false
{
"id": "item_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"item_code": "item_code_example",
"variant_of": "variant_of_example",
"item_name": "item_name_example",
"item_group": "item_group_example",
"stock_uom": "stock_uom_example",
"disabled": false,
"allow_alternative_item": false,
"is_stock_item": true,
"include_item_in_manufacturing": true,
"opening_stock": 0,
"valuation_rate": 0,
"standard_rate": 0,
"is_fixed_asset": false,
"asset_category": "asset_category_example",
"asset_naming_series": "asset_naming_series_example",
"image": "image_example",
"brand": "brand_example",
"description": "description_example",
"shelf_life_in_days": 0,
"end_of_life": "2099-12-31",
"default_material_request_type": "Purchase",
"valuation_method": "valuation_method_example",
"warranty_period": "warranty_period_example",
"weight_per_unit": 0,
"weight_uom": "weight_uom_example",
"has_batch_no": false,
"create_new_batch": false,
"batch_number_series": "batch_number_series_example",
"has_expiry_date": false,
"retain_sample": false,
"sample_quantity": 0,
"has_serial_no": false,
"serial_no_series": "serial_no_series_example",
"has_variants": false,
"variant_based_on": "Item Attribute",
"is_purchase_item": true,
"purchase_uom": "purchase_uom_example",
"min_order_qty": 0,
"safety_stock": 0,
"lead_time_days": 0,
"last_purchase_rate": 0,
"is_customer_provided_item": false,
"customer": "customer_example",
"delivered_by_supplier": false,
"country_of_origin": "country_of_origin_example",
"customs_tariff_number": "customs_tariff_number_example",
"sales_uom": "sales_uom_example",
"is_sales_item": true,
"max_discount": 0,
"enable_deferred_revenue": false,
"no_of_months": 0,
"enable_deferred_expense": false,
"no_of_months_exp": 0,
"inspection_required_before_purchase": false,
"inspection_required_before_delivery": false,
"quality_inspection_template": "quality_inspection_template_example",
"default_bom": "default_bom_example",
"is_sub_contracted_item": false,
"customer_code": "customer_code_example",
"total_projected_qty": 0,
"over_delivery_receipt_allowance": 0,
"over_billing_allowance": 0,
"auto_create_assets": false,
"default_item_manufacturer": "default_item_manufacturer_example",
"default_manufacturer_part_no": "default_manufacturer_part_no_example",
"grant_commission": true,
"is_grouped_asset": false,
"allow_negative_stock": false,
"production_capacity": 0,
"purchase_tax_withholding_category": "purchase_tax_withholding_category_example",
"sales_tax_withholding_category": "sales_tax_withholding_category_example"
} /api/stock/item/{id} Retrieve a item
Retrieves the details of an existing item. Supply the unique item ID that was returned from a previous request.
Path parameters
The identifier of the item to retrieve.
Returns
Returns the item object if a valid identifier was provided.
curl https://api.overplane.dev/api/stock/item/item_abc123 \
-H "Authorization: Bearer sk_test_..." {
"id": "item_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"item_code": "item_code_example",
"variant_of": "variant_of_example",
"item_name": "item_name_example",
"item_group": "item_group_example",
"stock_uom": "stock_uom_example",
"disabled": false,
"allow_alternative_item": false,
"is_stock_item": true,
"include_item_in_manufacturing": true,
"opening_stock": 0,
"valuation_rate": 0,
"standard_rate": 0,
"is_fixed_asset": false,
"asset_category": "asset_category_example",
"asset_naming_series": "asset_naming_series_example",
"image": "image_example",
"brand": "brand_example",
"description": "description_example",
"shelf_life_in_days": 0,
"end_of_life": "2099-12-31",
"default_material_request_type": "Purchase",
"valuation_method": "valuation_method_example",
"warranty_period": "warranty_period_example",
"weight_per_unit": 0,
"weight_uom": "weight_uom_example",
"has_batch_no": false,
"create_new_batch": false,
"batch_number_series": "batch_number_series_example",
"has_expiry_date": false,
"retain_sample": false,
"sample_quantity": 0,
"has_serial_no": false,
"serial_no_series": "serial_no_series_example",
"has_variants": false,
"variant_based_on": "Item Attribute",
"is_purchase_item": true,
"purchase_uom": "purchase_uom_example",
"min_order_qty": 0,
"safety_stock": 0,
"lead_time_days": 0,
"last_purchase_rate": 0,
"is_customer_provided_item": false,
"customer": "customer_example",
"delivered_by_supplier": false,
"country_of_origin": "country_of_origin_example",
"customs_tariff_number": "customs_tariff_number_example",
"sales_uom": "sales_uom_example",
"is_sales_item": true,
"max_discount": 0,
"enable_deferred_revenue": false,
"no_of_months": 0,
"enable_deferred_expense": false,
"no_of_months_exp": 0,
"inspection_required_before_purchase": false,
"inspection_required_before_delivery": false,
"quality_inspection_template": "quality_inspection_template_example",
"default_bom": "default_bom_example",
"is_sub_contracted_item": false,
"customer_code": "customer_code_example",
"total_projected_qty": 0,
"over_delivery_receipt_allowance": 0,
"over_billing_allowance": 0,
"auto_create_assets": false,
"default_item_manufacturer": "default_item_manufacturer_example",
"default_manufacturer_part_no": "default_manufacturer_part_no_example",
"grant_commission": true,
"is_grouped_asset": false,
"allow_negative_stock": false,
"production_capacity": 0,
"purchase_tax_withholding_category": "purchase_tax_withholding_category_example",
"sales_tax_withholding_category": "sales_tax_withholding_category_example"
} /api/stock/item List all items
Returns a list of items. The results are sorted by creation date, with the most recently created appearing first.
Query parameters
Maximum number of objects to return. Default: 20.
Number of objects to skip for pagination. Default: 0.
Returns
A paginated list of item objects.
curl https://api.overplane.dev/api/stock/item \
-H "Authorization: Bearer sk_test_..." {
"data": [
{
"id": "item_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"item_code": "item_code_example",
"variant_of": "variant_of_example",
"item_name": "item_name_example",
"item_group": "item_group_example",
"stock_uom": "stock_uom_example",
"disabled": false,
"allow_alternative_item": false,
"is_stock_item": true,
"include_item_in_manufacturing": true,
"opening_stock": 0,
"valuation_rate": 0,
"standard_rate": 0,
"is_fixed_asset": false,
"asset_category": "asset_category_example",
"asset_naming_series": "asset_naming_series_example",
"image": "image_example",
"brand": "brand_example",
"description": "description_example",
"shelf_life_in_days": 0,
"end_of_life": "2099-12-31",
"default_material_request_type": "Purchase",
"valuation_method": "valuation_method_example",
"warranty_period": "warranty_period_example",
"weight_per_unit": 0,
"weight_uom": "weight_uom_example",
"has_batch_no": false,
"create_new_batch": false,
"batch_number_series": "batch_number_series_example",
"has_expiry_date": false,
"retain_sample": false,
"sample_quantity": 0,
"has_serial_no": false,
"serial_no_series": "serial_no_series_example",
"has_variants": false,
"variant_based_on": "Item Attribute",
"is_purchase_item": true,
"purchase_uom": "purchase_uom_example",
"min_order_qty": 0,
"safety_stock": 0,
"lead_time_days": 0,
"last_purchase_rate": 0,
"is_customer_provided_item": false,
"customer": "customer_example",
"delivered_by_supplier": false,
"country_of_origin": "country_of_origin_example",
"customs_tariff_number": "customs_tariff_number_example",
"sales_uom": "sales_uom_example",
"is_sales_item": true,
"max_discount": 0,
"enable_deferred_revenue": false,
"no_of_months": 0,
"enable_deferred_expense": false,
"no_of_months_exp": 0,
"inspection_required_before_purchase": false,
"inspection_required_before_delivery": false,
"quality_inspection_template": "quality_inspection_template_example",
"default_bom": "default_bom_example",
"is_sub_contracted_item": false,
"customer_code": "customer_code_example",
"total_projected_qty": 0,
"over_delivery_receipt_allowance": 0,
"over_billing_allowance": 0,
"auto_create_assets": false,
"default_item_manufacturer": "default_item_manufacturer_example",
"default_manufacturer_part_no": "default_manufacturer_part_no_example",
"grant_commission": true,
"is_grouped_asset": false,
"allow_negative_stock": false,
"production_capacity": 0,
"purchase_tax_withholding_category": "purchase_tax_withholding_category_example",
"sales_tax_withholding_category": "sales_tax_withholding_category_example"
}
],
"has_more": false,
"total": 1
} /api/stock/item Create a item
Creates a new item object.
Body parameters
Default: false
Default: false
Default: true
Default: true
Default: false
Default: 2099-12-31
Default: Purchase
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: Item Attribute
Default: true
Default: 0
Default: false
Default: false
Default: true
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: true
Default: false
Default: false
Returns
Returns the newly created item object if the call succeeded.
curl https://api.overplane.dev/api/stock/item \
-H "Authorization: Bearer sk_test_..." \
-X POST \
-H "Content-Type: application/json" \
-d '{"item_code":"item_code_example","item_group":"item_group_example","stock_uom":"stock_uom_example"}' {
"id": "item_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"item_code": "item_code_example",
"variant_of": "variant_of_example",
"item_name": "item_name_example",
"item_group": "item_group_example",
"stock_uom": "stock_uom_example",
"disabled": false,
"allow_alternative_item": false,
"is_stock_item": true,
"include_item_in_manufacturing": true,
"opening_stock": 0,
"valuation_rate": 0,
"standard_rate": 0,
"is_fixed_asset": false,
"asset_category": "asset_category_example",
"asset_naming_series": "asset_naming_series_example",
"image": "image_example",
"brand": "brand_example",
"description": "description_example",
"shelf_life_in_days": 0,
"end_of_life": "2099-12-31",
"default_material_request_type": "Purchase",
"valuation_method": "valuation_method_example",
"warranty_period": "warranty_period_example",
"weight_per_unit": 0,
"weight_uom": "weight_uom_example",
"has_batch_no": false,
"create_new_batch": false,
"batch_number_series": "batch_number_series_example",
"has_expiry_date": false,
"retain_sample": false,
"sample_quantity": 0,
"has_serial_no": false,
"serial_no_series": "serial_no_series_example",
"has_variants": false,
"variant_based_on": "Item Attribute",
"is_purchase_item": true,
"purchase_uom": "purchase_uom_example",
"min_order_qty": 0,
"safety_stock": 0,
"lead_time_days": 0,
"last_purchase_rate": 0,
"is_customer_provided_item": false,
"customer": "customer_example",
"delivered_by_supplier": false,
"country_of_origin": "country_of_origin_example",
"customs_tariff_number": "customs_tariff_number_example",
"sales_uom": "sales_uom_example",
"is_sales_item": true,
"max_discount": 0,
"enable_deferred_revenue": false,
"no_of_months": 0,
"enable_deferred_expense": false,
"no_of_months_exp": 0,
"inspection_required_before_purchase": false,
"inspection_required_before_delivery": false,
"quality_inspection_template": "quality_inspection_template_example",
"default_bom": "default_bom_example",
"is_sub_contracted_item": false,
"customer_code": "customer_code_example",
"total_projected_qty": 0,
"over_delivery_receipt_allowance": 0,
"over_billing_allowance": 0,
"auto_create_assets": false,
"default_item_manufacturer": "default_item_manufacturer_example",
"default_manufacturer_part_no": "default_manufacturer_part_no_example",
"grant_commission": true,
"is_grouped_asset": false,
"allow_negative_stock": false,
"production_capacity": 0,
"purchase_tax_withholding_category": "purchase_tax_withholding_category_example",
"sales_tax_withholding_category": "sales_tax_withholding_category_example"
} /api/stock/item/{id} Update a item
Updates the specified item by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
Path parameters
The identifier of the item to update.
Body parameters
Default: false
Default: false
Default: true
Default: true
Default: false
Default: 2099-12-31
Default: Purchase
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: Item Attribute
Default: true
Default: 0
Default: false
Default: false
Default: true
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: true
Default: false
Default: false
Returns
Returns the updated item object.
curl https://api.overplane.dev/api/stock/item/item_abc123 \
-H "Authorization: Bearer sk_test_..." \
-X PATCH \
-H "Content-Type: application/json" \
-d '{"item_code":"item_code_example","variant_of":"variant_of_example"}' {
"id": "item_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"item_code": "item_code_example",
"variant_of": "variant_of_example",
"item_name": "item_name_example",
"item_group": "item_group_example",
"stock_uom": "stock_uom_example",
"disabled": false,
"allow_alternative_item": false,
"is_stock_item": true,
"include_item_in_manufacturing": true,
"opening_stock": 0,
"valuation_rate": 0,
"standard_rate": 0,
"is_fixed_asset": false,
"asset_category": "asset_category_example",
"asset_naming_series": "asset_naming_series_example",
"image": "image_example",
"brand": "brand_example",
"description": "description_example",
"shelf_life_in_days": 0,
"end_of_life": "2099-12-31",
"default_material_request_type": "Purchase",
"valuation_method": "valuation_method_example",
"warranty_period": "warranty_period_example",
"weight_per_unit": 0,
"weight_uom": "weight_uom_example",
"has_batch_no": false,
"create_new_batch": false,
"batch_number_series": "batch_number_series_example",
"has_expiry_date": false,
"retain_sample": false,
"sample_quantity": 0,
"has_serial_no": false,
"serial_no_series": "serial_no_series_example",
"has_variants": false,
"variant_based_on": "Item Attribute",
"is_purchase_item": true,
"purchase_uom": "purchase_uom_example",
"min_order_qty": 0,
"safety_stock": 0,
"lead_time_days": 0,
"last_purchase_rate": 0,
"is_customer_provided_item": false,
"customer": "customer_example",
"delivered_by_supplier": false,
"country_of_origin": "country_of_origin_example",
"customs_tariff_number": "customs_tariff_number_example",
"sales_uom": "sales_uom_example",
"is_sales_item": true,
"max_discount": 0,
"enable_deferred_revenue": false,
"no_of_months": 0,
"enable_deferred_expense": false,
"no_of_months_exp": 0,
"inspection_required_before_purchase": false,
"inspection_required_before_delivery": false,
"quality_inspection_template": "quality_inspection_template_example",
"default_bom": "default_bom_example",
"is_sub_contracted_item": false,
"customer_code": "customer_code_example",
"total_projected_qty": 0,
"over_delivery_receipt_allowance": 0,
"over_billing_allowance": 0,
"auto_create_assets": false,
"default_item_manufacturer": "default_item_manufacturer_example",
"default_manufacturer_part_no": "default_manufacturer_part_no_example",
"grant_commission": true,
"is_grouped_asset": false,
"allow_negative_stock": false,
"production_capacity": 0,
"purchase_tax_withholding_category": "purchase_tax_withholding_category_example",
"sales_tax_withholding_category": "sales_tax_withholding_category_example"
} /api/stock/item/{id} Delete a item
Permanently deletes a item. This cannot be undone.
Path parameters
The identifier of the item to delete.
Returns
Returns a confirmation that the item has been deleted.
curl https://api.overplane.dev/api/stock/item/item_abc123 \
-H "Authorization: Bearer sk_test_..." \
-X DELETE {
"id": "item_abc123",
"deleted": true
} Line items
Child objects that belong to this item. These are accessed via the parent's ID.
Item Barcode
Attributes
Endpoints
/api/stock/item-barcode?parent_id={id} /api/stock/item-barcode /api/stock/item-barcode/{id} /api/stock/item-barcode/{id} /api/stock/item-barcode/reorder {
"id": "item-barcode_abc123",
"idx": 1,
"item_id": "item_id_example",
"barcode": "barcode_example",
"barcode_type": "barcode_type_example",
"uom": "uom_example"
} Item Customer Detail
Attributes
Endpoints
/api/stock/item-customer-detail?parent_id={id} /api/stock/item-customer-detail /api/stock/item-customer-detail/{id} /api/stock/item-customer-detail/{id} /api/stock/item-customer-detail/reorder {
"id": "item-customer-detail_abc123",
"idx": 1,
"item_id": "item_id_example",
"customer_name": "customer_name_example",
"customer_group": "customer_group_example",
"ref_code": "ref_code_example"
} Item Reorder
Attributes
Endpoints
/api/stock/item-reorder?parent_id={id} /api/stock/item-reorder /api/stock/item-reorder/{id} /api/stock/item-reorder/{id} /api/stock/item-reorder/reorder {
"id": "item-reorder_abc123",
"idx": 1,
"item_id": "item_id_example",
"warehouse_group": "warehouse_group_example",
"warehouse": "warehouse_example",
"warehouse_reorder_level": 0,
"warehouse_reorder_qty": 0,
"material_request_type": "material_request_type_example"
} Item Supplier
Attributes
Endpoints
/api/stock/item-supplier?parent_id={id} /api/stock/item-supplier /api/stock/item-supplier/{id} /api/stock/item-supplier/{id} /api/stock/item-supplier/reorder {
"id": "item-supplier_abc123",
"idx": 1,
"item_id": "item_id_example",
"supplier": "supplier_example",
"supplier_part_no": "supplier_part_no_example"
} Item Variant Attribute
Attributes
Endpoints
/api/stock/item-variant-attribute?parent_id={id} /api/stock/item-variant-attribute /api/stock/item-variant-attribute/{id} /api/stock/item-variant-attribute/{id} /api/stock/item-variant-attribute/reorder {
"id": "item-variant-attribute_abc123",
"idx": 1,
"item_id": "item_id_example",
"variant_of": "variant_of_example",
"attribute": "attribute_example",
"attribute_value": "attribute_value_example",
"numeric_values": false,
"from_range": 0,
"increment": 0,
"to_range": 0,
"disabled": false
} UOM Conversion Detail
Attributes
Endpoints
/api/stock/u-o-m-conversion-detail?parent_id={id} /api/stock/u-o-m-conversion-detail /api/stock/u-o-m-conversion-detail/{id} /api/stock/u-o-m-conversion-detail/{id} /api/stock/u-o-m-conversion-detail/reorder {
"id": "u-o-m-conversion-detail_abc123",
"idx": 1,
"item_id": "item_id_example",
"uom": "uom_example",
"conversion_factor": 0
}