The Sales Invoice 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: draft
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: 0
Default: false
Default: Grand Total
Default: false
Default: false
Default: false
Default: false
Default: No
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: true
Default: false
Default: true
Default: false
Default: false
Default: false
Default: false
Default: false
{
"id": "sales-invoice_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"status": "draft",
"customer": "customer_example",
"customer_name": "customer_name_example",
"tax_id": "tax_id_example",
"project": "project_example",
"is_pos": false,
"pos_profile": "pos_profile_example",
"is_return": false,
"company": "Example Corp",
"cost_center": "cost_center_example",
"posting_date": "2024-01-15",
"posting_time": "posting_time_example",
"set_posting_time": false,
"due_date": "2024-01-15",
"return_against": "return_against_example",
"update_billed_amount_in_sales_order": false,
"po_no": "po_no_example",
"po_date": "2024-01-15",
"customer_address": "customer_address_example",
"address_display": "address_display_example",
"contact_person": "contact_person_example",
"contact_display": "contact_display_example",
"contact_mobile": "contact_mobile_example",
"contact_email": "[email protected]",
"territory": "territory_example",
"shipping_address_name": "shipping_address_name_example",
"shipping_address": "shipping_address_example",
"company_address": "Example Corp",
"company_address_display": "Example Corp",
"currency": "USD",
"conversion_rate": 0,
"selling_price_list": "selling_price_list_example",
"price_list_currency": "USD",
"plc_conversion_rate": 0,
"ignore_pricing_rule": false,
"set_warehouse": "set_warehouse_example",
"update_stock": false,
"scan_barcode": "scan_barcode_example",
"total_billing_amount": 0,
"total_qty": 0,
"base_total": 0,
"base_net_total": 0,
"total": 0,
"net_total": 0,
"total_net_weight": 0,
"taxes_and_charges": "taxes_and_charges_example",
"shipping_rule": "shipping_rule_example",
"tax_category": "tax_category_example",
"other_charges_calculation": "other_charges_calculation_example",
"base_total_taxes_and_charges": 0,
"total_taxes_and_charges": 0,
"loyalty_points": 0,
"loyalty_amount": 0,
"redeem_loyalty_points": false,
"loyalty_program": "loyalty_program_example",
"loyalty_redemption_account": "loyalty_redemption_account_example",
"loyalty_redemption_cost_center": "loyalty_redemption_cost_center_example",
"apply_discount_on": "Grand Total",
"base_discount_amount": 0,
"additional_discount_percentage": 0,
"discount_amount": 0,
"base_grand_total": 0,
"base_rounding_adjustment": 0,
"base_rounded_total": 0,
"base_in_words": "base_in_words_example",
"grand_total": 0,
"rounding_adjustment": 0,
"rounded_total": 0,
"in_words": "in_words_example",
"total_advance": 0,
"outstanding_amount": 0,
"allocate_advances_automatically": false,
"payment_terms_template": "payment_terms_template_example",
"cash_bank_account": "cash_bank_account_example",
"base_paid_amount": 0,
"paid_amount": 0,
"base_change_amount": 0,
"change_amount": 0,
"account_for_change_amount": "account_for_change_amount_example",
"write_off_amount": 0,
"base_write_off_amount": 0,
"write_off_outstanding_amount_automatically": false,
"write_off_account": "write_off_account_example",
"write_off_cost_center": "write_off_cost_center_example",
"tc_name": "tc_name_example",
"terms": "terms_example",
"letter_head": "letter_head_example",
"group_same_items": false,
"language": "language_example",
"select_print_heading": "select_print_heading_example",
"inter_company_invoice_reference": "Example Corp",
"customer_group": "customer_group_example",
"is_discounted": false,
"debit_to": "debit_to_example",
"party_account_currency": "USD",
"is_opening": "No",
"remarks": "remarks_example",
"sales_partner": "sales_partner_example",
"commission_rate": 0,
"total_commission": 0,
"from_date": "2024-01-15",
"to_date": "2024-01-15",
"auto_repeat": "auto_repeat_example",
"against_income_account": "against_income_account_example",
"is_consolidated": false,
"is_internal_customer": false,
"company_tax_id": "Example Corp",
"unrealized_profit_loss_account": "unrealized_profit_loss_account_example",
"represents_company": "Example Corp",
"set_target_warehouse": "set_target_warehouse_example",
"is_debit_note": false,
"disable_rounded_total": false,
"additional_discount_account": "additional_discount_account_example",
"dispatch_address_name": "dispatch_address_name_example",
"dispatch_address": "dispatch_address_example",
"ignore_default_payment_terms_template": false,
"total_billing_hours": 0,
"amount_eligible_for_commission": 0,
"subscription": "subscription_example",
"is_cash_or_non_trade_discount": false,
"incoterm": "incoterm_example",
"named_place": "named_place_example",
"only_include_allocated_payments": false,
"use_company_roundoff_cost_center": false,
"update_billed_amount_in_delivery_note": true,
"dont_create_loyalty_points": false,
"coupon_code": "coupon_code_example",
"update_outstanding_for_self": true,
"utm_medium": "utm_medium_example",
"utm_content": "utm_content_example",
"utm_campaign": "utm_campaign_example",
"utm_source": "utm_source_example",
"company_contact_person": "Example Corp",
"is_created_using_pos": false,
"pos_closing_entry": "pos_closing_entry_example",
"has_subcontracted": false,
"apply_tds": false,
"tax_withholding_group": "tax_withholding_group_example",
"ignore_tax_withholding_threshold": false,
"override_tax_withholding_entries": false,
"title": "title_example",
"signing_document_id": "signing_document_id_example"
} /api/accounts/sales-invoice/{id} Retrieve a sales invoice
Retrieves the details of an existing sales invoice. Supply the unique sales invoice ID that was returned from a previous request.
Path parameters
The identifier of the sales invoice to retrieve.
Returns
Returns the sales invoice object if a valid identifier was provided.
curl https://api.overplane.dev/api/accounts/sales-invoice/sales-invoice_abc123 \
-H "Authorization: Bearer sk_test_..." {
"id": "sales-invoice_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"status": "draft",
"customer": "customer_example",
"customer_name": "customer_name_example",
"tax_id": "tax_id_example",
"project": "project_example",
"is_pos": false,
"pos_profile": "pos_profile_example",
"is_return": false,
"company": "Example Corp",
"cost_center": "cost_center_example",
"posting_date": "2024-01-15",
"posting_time": "posting_time_example",
"set_posting_time": false,
"due_date": "2024-01-15",
"return_against": "return_against_example",
"update_billed_amount_in_sales_order": false,
"po_no": "po_no_example",
"po_date": "2024-01-15",
"customer_address": "customer_address_example",
"address_display": "address_display_example",
"contact_person": "contact_person_example",
"contact_display": "contact_display_example",
"contact_mobile": "contact_mobile_example",
"contact_email": "[email protected]",
"territory": "territory_example",
"shipping_address_name": "shipping_address_name_example",
"shipping_address": "shipping_address_example",
"company_address": "Example Corp",
"company_address_display": "Example Corp",
"currency": "USD",
"conversion_rate": 0,
"selling_price_list": "selling_price_list_example",
"price_list_currency": "USD",
"plc_conversion_rate": 0,
"ignore_pricing_rule": false,
"set_warehouse": "set_warehouse_example",
"update_stock": false,
"scan_barcode": "scan_barcode_example",
"total_billing_amount": 0,
"total_qty": 0,
"base_total": 0,
"base_net_total": 0,
"total": 0,
"net_total": 0,
"total_net_weight": 0,
"taxes_and_charges": "taxes_and_charges_example",
"shipping_rule": "shipping_rule_example",
"tax_category": "tax_category_example",
"other_charges_calculation": "other_charges_calculation_example",
"base_total_taxes_and_charges": 0,
"total_taxes_and_charges": 0,
"loyalty_points": 0,
"loyalty_amount": 0,
"redeem_loyalty_points": false,
"loyalty_program": "loyalty_program_example",
"loyalty_redemption_account": "loyalty_redemption_account_example",
"loyalty_redemption_cost_center": "loyalty_redemption_cost_center_example",
"apply_discount_on": "Grand Total",
"base_discount_amount": 0,
"additional_discount_percentage": 0,
"discount_amount": 0,
"base_grand_total": 0,
"base_rounding_adjustment": 0,
"base_rounded_total": 0,
"base_in_words": "base_in_words_example",
"grand_total": 0,
"rounding_adjustment": 0,
"rounded_total": 0,
"in_words": "in_words_example",
"total_advance": 0,
"outstanding_amount": 0,
"allocate_advances_automatically": false,
"payment_terms_template": "payment_terms_template_example",
"cash_bank_account": "cash_bank_account_example",
"base_paid_amount": 0,
"paid_amount": 0,
"base_change_amount": 0,
"change_amount": 0,
"account_for_change_amount": "account_for_change_amount_example",
"write_off_amount": 0,
"base_write_off_amount": 0,
"write_off_outstanding_amount_automatically": false,
"write_off_account": "write_off_account_example",
"write_off_cost_center": "write_off_cost_center_example",
"tc_name": "tc_name_example",
"terms": "terms_example",
"letter_head": "letter_head_example",
"group_same_items": false,
"language": "language_example",
"select_print_heading": "select_print_heading_example",
"inter_company_invoice_reference": "Example Corp",
"customer_group": "customer_group_example",
"is_discounted": false,
"debit_to": "debit_to_example",
"party_account_currency": "USD",
"is_opening": "No",
"remarks": "remarks_example",
"sales_partner": "sales_partner_example",
"commission_rate": 0,
"total_commission": 0,
"from_date": "2024-01-15",
"to_date": "2024-01-15",
"auto_repeat": "auto_repeat_example",
"against_income_account": "against_income_account_example",
"is_consolidated": false,
"is_internal_customer": false,
"company_tax_id": "Example Corp",
"unrealized_profit_loss_account": "unrealized_profit_loss_account_example",
"represents_company": "Example Corp",
"set_target_warehouse": "set_target_warehouse_example",
"is_debit_note": false,
"disable_rounded_total": false,
"additional_discount_account": "additional_discount_account_example",
"dispatch_address_name": "dispatch_address_name_example",
"dispatch_address": "dispatch_address_example",
"ignore_default_payment_terms_template": false,
"total_billing_hours": 0,
"amount_eligible_for_commission": 0,
"subscription": "subscription_example",
"is_cash_or_non_trade_discount": false,
"incoterm": "incoterm_example",
"named_place": "named_place_example",
"only_include_allocated_payments": false,
"use_company_roundoff_cost_center": false,
"update_billed_amount_in_delivery_note": true,
"dont_create_loyalty_points": false,
"coupon_code": "coupon_code_example",
"update_outstanding_for_self": true,
"utm_medium": "utm_medium_example",
"utm_content": "utm_content_example",
"utm_campaign": "utm_campaign_example",
"utm_source": "utm_source_example",
"company_contact_person": "Example Corp",
"is_created_using_pos": false,
"pos_closing_entry": "pos_closing_entry_example",
"has_subcontracted": false,
"apply_tds": false,
"tax_withholding_group": "tax_withholding_group_example",
"ignore_tax_withholding_threshold": false,
"override_tax_withholding_entries": false,
"title": "title_example",
"signing_document_id": "signing_document_id_example"
} /api/accounts/sales-invoice List all sales invoices
Returns a list of sales invoices. 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 sales invoice objects.
curl https://api.overplane.dev/api/accounts/sales-invoice \
-H "Authorization: Bearer sk_test_..." {
"data": [
{
"id": "sales-invoice_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"status": "draft",
"customer": "customer_example",
"customer_name": "customer_name_example",
"tax_id": "tax_id_example",
"project": "project_example",
"is_pos": false,
"pos_profile": "pos_profile_example",
"is_return": false,
"company": "Example Corp",
"cost_center": "cost_center_example",
"posting_date": "2024-01-15",
"posting_time": "posting_time_example",
"set_posting_time": false,
"due_date": "2024-01-15",
"return_against": "return_against_example",
"update_billed_amount_in_sales_order": false,
"po_no": "po_no_example",
"po_date": "2024-01-15",
"customer_address": "customer_address_example",
"address_display": "address_display_example",
"contact_person": "contact_person_example",
"contact_display": "contact_display_example",
"contact_mobile": "contact_mobile_example",
"contact_email": "[email protected]",
"territory": "territory_example",
"shipping_address_name": "shipping_address_name_example",
"shipping_address": "shipping_address_example",
"company_address": "Example Corp",
"company_address_display": "Example Corp",
"currency": "USD",
"conversion_rate": 0,
"selling_price_list": "selling_price_list_example",
"price_list_currency": "USD",
"plc_conversion_rate": 0,
"ignore_pricing_rule": false,
"set_warehouse": "set_warehouse_example",
"update_stock": false,
"scan_barcode": "scan_barcode_example",
"total_billing_amount": 0,
"total_qty": 0,
"base_total": 0,
"base_net_total": 0,
"total": 0,
"net_total": 0,
"total_net_weight": 0,
"taxes_and_charges": "taxes_and_charges_example",
"shipping_rule": "shipping_rule_example",
"tax_category": "tax_category_example",
"other_charges_calculation": "other_charges_calculation_example",
"base_total_taxes_and_charges": 0,
"total_taxes_and_charges": 0,
"loyalty_points": 0,
"loyalty_amount": 0,
"redeem_loyalty_points": false,
"loyalty_program": "loyalty_program_example",
"loyalty_redemption_account": "loyalty_redemption_account_example",
"loyalty_redemption_cost_center": "loyalty_redemption_cost_center_example",
"apply_discount_on": "Grand Total",
"base_discount_amount": 0,
"additional_discount_percentage": 0,
"discount_amount": 0,
"base_grand_total": 0,
"base_rounding_adjustment": 0,
"base_rounded_total": 0,
"base_in_words": "base_in_words_example",
"grand_total": 0,
"rounding_adjustment": 0,
"rounded_total": 0,
"in_words": "in_words_example",
"total_advance": 0,
"outstanding_amount": 0,
"allocate_advances_automatically": false,
"payment_terms_template": "payment_terms_template_example",
"cash_bank_account": "cash_bank_account_example",
"base_paid_amount": 0,
"paid_amount": 0,
"base_change_amount": 0,
"change_amount": 0,
"account_for_change_amount": "account_for_change_amount_example",
"write_off_amount": 0,
"base_write_off_amount": 0,
"write_off_outstanding_amount_automatically": false,
"write_off_account": "write_off_account_example",
"write_off_cost_center": "write_off_cost_center_example",
"tc_name": "tc_name_example",
"terms": "terms_example",
"letter_head": "letter_head_example",
"group_same_items": false,
"language": "language_example",
"select_print_heading": "select_print_heading_example",
"inter_company_invoice_reference": "Example Corp",
"customer_group": "customer_group_example",
"is_discounted": false,
"debit_to": "debit_to_example",
"party_account_currency": "USD",
"is_opening": "No",
"remarks": "remarks_example",
"sales_partner": "sales_partner_example",
"commission_rate": 0,
"total_commission": 0,
"from_date": "2024-01-15",
"to_date": "2024-01-15",
"auto_repeat": "auto_repeat_example",
"against_income_account": "against_income_account_example",
"is_consolidated": false,
"is_internal_customer": false,
"company_tax_id": "Example Corp",
"unrealized_profit_loss_account": "unrealized_profit_loss_account_example",
"represents_company": "Example Corp",
"set_target_warehouse": "set_target_warehouse_example",
"is_debit_note": false,
"disable_rounded_total": false,
"additional_discount_account": "additional_discount_account_example",
"dispatch_address_name": "dispatch_address_name_example",
"dispatch_address": "dispatch_address_example",
"ignore_default_payment_terms_template": false,
"total_billing_hours": 0,
"amount_eligible_for_commission": 0,
"subscription": "subscription_example",
"is_cash_or_non_trade_discount": false,
"incoterm": "incoterm_example",
"named_place": "named_place_example",
"only_include_allocated_payments": false,
"use_company_roundoff_cost_center": false,
"update_billed_amount_in_delivery_note": true,
"dont_create_loyalty_points": false,
"coupon_code": "coupon_code_example",
"update_outstanding_for_self": true,
"utm_medium": "utm_medium_example",
"utm_content": "utm_content_example",
"utm_campaign": "utm_campaign_example",
"utm_source": "utm_source_example",
"company_contact_person": "Example Corp",
"is_created_using_pos": false,
"pos_closing_entry": "pos_closing_entry_example",
"has_subcontracted": false,
"apply_tds": false,
"tax_withholding_group": "tax_withholding_group_example",
"ignore_tax_withholding_threshold": false,
"override_tax_withholding_entries": false,
"title": "title_example",
"signing_document_id": "signing_document_id_example"
}
],
"has_more": false,
"total": 1
} /api/accounts/sales-invoice Create a sales invoice
Creates a new sales invoice object.
Body parameters
Default: draft
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: 0
Default: false
Default: Grand Total
Default: false
Default: false
Default: false
Default: false
Default: No
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: true
Default: false
Default: true
Default: false
Default: false
Default: false
Default: false
Default: false
Returns
Returns the newly created sales invoice object if the call succeeded.
curl https://api.overplane.dev/api/accounts/sales-invoice \
-H "Authorization: Bearer sk_test_..." \
-X POST \
-H "Content-Type: application/json" \
-d '{"customer":"customer_example","company":"Example Corp","posting_date":"2024-01-15","currency":"USD","conversion_rate":0,"selling_price_list":"selling_price_list_example","price_list_currency":"USD","plc_conversion_rate":0,"base_net_total":0,"base_grand_total":0,"grand_total":0,"debit_to":"debit_to_example"}' {
"id": "sales-invoice_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"status": "draft",
"customer": "customer_example",
"customer_name": "customer_name_example",
"tax_id": "tax_id_example",
"project": "project_example",
"is_pos": false,
"pos_profile": "pos_profile_example",
"is_return": false,
"company": "Example Corp",
"cost_center": "cost_center_example",
"posting_date": "2024-01-15",
"posting_time": "posting_time_example",
"set_posting_time": false,
"due_date": "2024-01-15",
"return_against": "return_against_example",
"update_billed_amount_in_sales_order": false,
"po_no": "po_no_example",
"po_date": "2024-01-15",
"customer_address": "customer_address_example",
"address_display": "address_display_example",
"contact_person": "contact_person_example",
"contact_display": "contact_display_example",
"contact_mobile": "contact_mobile_example",
"contact_email": "[email protected]",
"territory": "territory_example",
"shipping_address_name": "shipping_address_name_example",
"shipping_address": "shipping_address_example",
"company_address": "Example Corp",
"company_address_display": "Example Corp",
"currency": "USD",
"conversion_rate": 0,
"selling_price_list": "selling_price_list_example",
"price_list_currency": "USD",
"plc_conversion_rate": 0,
"ignore_pricing_rule": false,
"set_warehouse": "set_warehouse_example",
"update_stock": false,
"scan_barcode": "scan_barcode_example",
"total_billing_amount": 0,
"total_qty": 0,
"base_total": 0,
"base_net_total": 0,
"total": 0,
"net_total": 0,
"total_net_weight": 0,
"taxes_and_charges": "taxes_and_charges_example",
"shipping_rule": "shipping_rule_example",
"tax_category": "tax_category_example",
"other_charges_calculation": "other_charges_calculation_example",
"base_total_taxes_and_charges": 0,
"total_taxes_and_charges": 0,
"loyalty_points": 0,
"loyalty_amount": 0,
"redeem_loyalty_points": false,
"loyalty_program": "loyalty_program_example",
"loyalty_redemption_account": "loyalty_redemption_account_example",
"loyalty_redemption_cost_center": "loyalty_redemption_cost_center_example",
"apply_discount_on": "Grand Total",
"base_discount_amount": 0,
"additional_discount_percentage": 0,
"discount_amount": 0,
"base_grand_total": 0,
"base_rounding_adjustment": 0,
"base_rounded_total": 0,
"base_in_words": "base_in_words_example",
"grand_total": 0,
"rounding_adjustment": 0,
"rounded_total": 0,
"in_words": "in_words_example",
"total_advance": 0,
"outstanding_amount": 0,
"allocate_advances_automatically": false,
"payment_terms_template": "payment_terms_template_example",
"cash_bank_account": "cash_bank_account_example",
"base_paid_amount": 0,
"paid_amount": 0,
"base_change_amount": 0,
"change_amount": 0,
"account_for_change_amount": "account_for_change_amount_example",
"write_off_amount": 0,
"base_write_off_amount": 0,
"write_off_outstanding_amount_automatically": false,
"write_off_account": "write_off_account_example",
"write_off_cost_center": "write_off_cost_center_example",
"tc_name": "tc_name_example",
"terms": "terms_example",
"letter_head": "letter_head_example",
"group_same_items": false,
"language": "language_example",
"select_print_heading": "select_print_heading_example",
"inter_company_invoice_reference": "Example Corp",
"customer_group": "customer_group_example",
"is_discounted": false,
"debit_to": "debit_to_example",
"party_account_currency": "USD",
"is_opening": "No",
"remarks": "remarks_example",
"sales_partner": "sales_partner_example",
"commission_rate": 0,
"total_commission": 0,
"from_date": "2024-01-15",
"to_date": "2024-01-15",
"auto_repeat": "auto_repeat_example",
"against_income_account": "against_income_account_example",
"is_consolidated": false,
"is_internal_customer": false,
"company_tax_id": "Example Corp",
"unrealized_profit_loss_account": "unrealized_profit_loss_account_example",
"represents_company": "Example Corp",
"set_target_warehouse": "set_target_warehouse_example",
"is_debit_note": false,
"disable_rounded_total": false,
"additional_discount_account": "additional_discount_account_example",
"dispatch_address_name": "dispatch_address_name_example",
"dispatch_address": "dispatch_address_example",
"ignore_default_payment_terms_template": false,
"total_billing_hours": 0,
"amount_eligible_for_commission": 0,
"subscription": "subscription_example",
"is_cash_or_non_trade_discount": false,
"incoterm": "incoterm_example",
"named_place": "named_place_example",
"only_include_allocated_payments": false,
"use_company_roundoff_cost_center": false,
"update_billed_amount_in_delivery_note": true,
"dont_create_loyalty_points": false,
"coupon_code": "coupon_code_example",
"update_outstanding_for_self": true,
"utm_medium": "utm_medium_example",
"utm_content": "utm_content_example",
"utm_campaign": "utm_campaign_example",
"utm_source": "utm_source_example",
"company_contact_person": "Example Corp",
"is_created_using_pos": false,
"pos_closing_entry": "pos_closing_entry_example",
"has_subcontracted": false,
"apply_tds": false,
"tax_withholding_group": "tax_withholding_group_example",
"ignore_tax_withholding_threshold": false,
"override_tax_withholding_entries": false,
"title": "title_example",
"signing_document_id": "signing_document_id_example"
} /api/accounts/sales-invoice/{id} Update a sales invoice
Updates the specified sales invoice by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
Path parameters
The identifier of the sales invoice to update.
Body parameters
Default: draft
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: 0
Default: false
Default: Grand Total
Default: false
Default: false
Default: false
Default: false
Default: No
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: false
Default: true
Default: false
Default: true
Default: false
Default: false
Default: false
Default: false
Default: false
Returns
Returns the updated sales invoice object.
curl https://api.overplane.dev/api/accounts/sales-invoice/sales-invoice_abc123 \
-H "Authorization: Bearer sk_test_..." \
-X PATCH \
-H "Content-Type: application/json" \
-d '{"status":"draft","customer":"customer_example"}' {
"id": "sales-invoice_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"status": "draft",
"customer": "customer_example",
"customer_name": "customer_name_example",
"tax_id": "tax_id_example",
"project": "project_example",
"is_pos": false,
"pos_profile": "pos_profile_example",
"is_return": false,
"company": "Example Corp",
"cost_center": "cost_center_example",
"posting_date": "2024-01-15",
"posting_time": "posting_time_example",
"set_posting_time": false,
"due_date": "2024-01-15",
"return_against": "return_against_example",
"update_billed_amount_in_sales_order": false,
"po_no": "po_no_example",
"po_date": "2024-01-15",
"customer_address": "customer_address_example",
"address_display": "address_display_example",
"contact_person": "contact_person_example",
"contact_display": "contact_display_example",
"contact_mobile": "contact_mobile_example",
"contact_email": "[email protected]",
"territory": "territory_example",
"shipping_address_name": "shipping_address_name_example",
"shipping_address": "shipping_address_example",
"company_address": "Example Corp",
"company_address_display": "Example Corp",
"currency": "USD",
"conversion_rate": 0,
"selling_price_list": "selling_price_list_example",
"price_list_currency": "USD",
"plc_conversion_rate": 0,
"ignore_pricing_rule": false,
"set_warehouse": "set_warehouse_example",
"update_stock": false,
"scan_barcode": "scan_barcode_example",
"total_billing_amount": 0,
"total_qty": 0,
"base_total": 0,
"base_net_total": 0,
"total": 0,
"net_total": 0,
"total_net_weight": 0,
"taxes_and_charges": "taxes_and_charges_example",
"shipping_rule": "shipping_rule_example",
"tax_category": "tax_category_example",
"other_charges_calculation": "other_charges_calculation_example",
"base_total_taxes_and_charges": 0,
"total_taxes_and_charges": 0,
"loyalty_points": 0,
"loyalty_amount": 0,
"redeem_loyalty_points": false,
"loyalty_program": "loyalty_program_example",
"loyalty_redemption_account": "loyalty_redemption_account_example",
"loyalty_redemption_cost_center": "loyalty_redemption_cost_center_example",
"apply_discount_on": "Grand Total",
"base_discount_amount": 0,
"additional_discount_percentage": 0,
"discount_amount": 0,
"base_grand_total": 0,
"base_rounding_adjustment": 0,
"base_rounded_total": 0,
"base_in_words": "base_in_words_example",
"grand_total": 0,
"rounding_adjustment": 0,
"rounded_total": 0,
"in_words": "in_words_example",
"total_advance": 0,
"outstanding_amount": 0,
"allocate_advances_automatically": false,
"payment_terms_template": "payment_terms_template_example",
"cash_bank_account": "cash_bank_account_example",
"base_paid_amount": 0,
"paid_amount": 0,
"base_change_amount": 0,
"change_amount": 0,
"account_for_change_amount": "account_for_change_amount_example",
"write_off_amount": 0,
"base_write_off_amount": 0,
"write_off_outstanding_amount_automatically": false,
"write_off_account": "write_off_account_example",
"write_off_cost_center": "write_off_cost_center_example",
"tc_name": "tc_name_example",
"terms": "terms_example",
"letter_head": "letter_head_example",
"group_same_items": false,
"language": "language_example",
"select_print_heading": "select_print_heading_example",
"inter_company_invoice_reference": "Example Corp",
"customer_group": "customer_group_example",
"is_discounted": false,
"debit_to": "debit_to_example",
"party_account_currency": "USD",
"is_opening": "No",
"remarks": "remarks_example",
"sales_partner": "sales_partner_example",
"commission_rate": 0,
"total_commission": 0,
"from_date": "2024-01-15",
"to_date": "2024-01-15",
"auto_repeat": "auto_repeat_example",
"against_income_account": "against_income_account_example",
"is_consolidated": false,
"is_internal_customer": false,
"company_tax_id": "Example Corp",
"unrealized_profit_loss_account": "unrealized_profit_loss_account_example",
"represents_company": "Example Corp",
"set_target_warehouse": "set_target_warehouse_example",
"is_debit_note": false,
"disable_rounded_total": false,
"additional_discount_account": "additional_discount_account_example",
"dispatch_address_name": "dispatch_address_name_example",
"dispatch_address": "dispatch_address_example",
"ignore_default_payment_terms_template": false,
"total_billing_hours": 0,
"amount_eligible_for_commission": 0,
"subscription": "subscription_example",
"is_cash_or_non_trade_discount": false,
"incoterm": "incoterm_example",
"named_place": "named_place_example",
"only_include_allocated_payments": false,
"use_company_roundoff_cost_center": false,
"update_billed_amount_in_delivery_note": true,
"dont_create_loyalty_points": false,
"coupon_code": "coupon_code_example",
"update_outstanding_for_self": true,
"utm_medium": "utm_medium_example",
"utm_content": "utm_content_example",
"utm_campaign": "utm_campaign_example",
"utm_source": "utm_source_example",
"company_contact_person": "Example Corp",
"is_created_using_pos": false,
"pos_closing_entry": "pos_closing_entry_example",
"has_subcontracted": false,
"apply_tds": false,
"tax_withholding_group": "tax_withholding_group_example",
"ignore_tax_withholding_threshold": false,
"override_tax_withholding_entries": false,
"title": "title_example",
"signing_document_id": "signing_document_id_example"
} /api/accounts/sales-invoice/{id} Delete a sales invoice
Permanently deletes a sales invoice. This cannot be undone.
Path parameters
The identifier of the sales invoice to delete.
Returns
Returns a confirmation that the sales invoice has been deleted.
curl https://api.overplane.dev/api/accounts/sales-invoice/sales-invoice_abc123 \
-H "Authorization: Bearer sk_test_..." \
-X DELETE {
"id": "sales-invoice_abc123",
"deleted": true
} /api/accounts/sales-invoice/{id}/submit Submit a sales invoice
Submits a draft sales invoice, transitioning its status from draft to submitted.
Path parameters
The identifier of the sales invoice to act on.
Returns
Returns the sales invoice object with updated status.
curl https://api.overplane.dev/api/accounts/sales-invoice/sales-invoice_abc123/submit \
-H "Authorization: Bearer sk_test_..." \
-X POST {
"id": "sales-invoice_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"status": "draft",
"customer": "customer_example",
"customer_name": "customer_name_example",
"tax_id": "tax_id_example",
"project": "project_example",
"is_pos": false,
"pos_profile": "pos_profile_example",
"is_return": false,
"company": "Example Corp",
"cost_center": "cost_center_example",
"posting_date": "2024-01-15",
"posting_time": "posting_time_example",
"set_posting_time": false,
"due_date": "2024-01-15",
"return_against": "return_against_example",
"update_billed_amount_in_sales_order": false,
"po_no": "po_no_example",
"po_date": "2024-01-15",
"customer_address": "customer_address_example",
"address_display": "address_display_example",
"contact_person": "contact_person_example",
"contact_display": "contact_display_example",
"contact_mobile": "contact_mobile_example",
"contact_email": "[email protected]",
"territory": "territory_example",
"shipping_address_name": "shipping_address_name_example",
"shipping_address": "shipping_address_example",
"company_address": "Example Corp",
"company_address_display": "Example Corp",
"currency": "USD",
"conversion_rate": 0,
"selling_price_list": "selling_price_list_example",
"price_list_currency": "USD",
"plc_conversion_rate": 0,
"ignore_pricing_rule": false,
"set_warehouse": "set_warehouse_example",
"update_stock": false,
"scan_barcode": "scan_barcode_example",
"total_billing_amount": 0,
"total_qty": 0,
"base_total": 0,
"base_net_total": 0,
"total": 0,
"net_total": 0,
"total_net_weight": 0,
"taxes_and_charges": "taxes_and_charges_example",
"shipping_rule": "shipping_rule_example",
"tax_category": "tax_category_example",
"other_charges_calculation": "other_charges_calculation_example",
"base_total_taxes_and_charges": 0,
"total_taxes_and_charges": 0,
"loyalty_points": 0,
"loyalty_amount": 0,
"redeem_loyalty_points": false,
"loyalty_program": "loyalty_program_example",
"loyalty_redemption_account": "loyalty_redemption_account_example",
"loyalty_redemption_cost_center": "loyalty_redemption_cost_center_example",
"apply_discount_on": "Grand Total",
"base_discount_amount": 0,
"additional_discount_percentage": 0,
"discount_amount": 0,
"base_grand_total": 0,
"base_rounding_adjustment": 0,
"base_rounded_total": 0,
"base_in_words": "base_in_words_example",
"grand_total": 0,
"rounding_adjustment": 0,
"rounded_total": 0,
"in_words": "in_words_example",
"total_advance": 0,
"outstanding_amount": 0,
"allocate_advances_automatically": false,
"payment_terms_template": "payment_terms_template_example",
"cash_bank_account": "cash_bank_account_example",
"base_paid_amount": 0,
"paid_amount": 0,
"base_change_amount": 0,
"change_amount": 0,
"account_for_change_amount": "account_for_change_amount_example",
"write_off_amount": 0,
"base_write_off_amount": 0,
"write_off_outstanding_amount_automatically": false,
"write_off_account": "write_off_account_example",
"write_off_cost_center": "write_off_cost_center_example",
"tc_name": "tc_name_example",
"terms": "terms_example",
"letter_head": "letter_head_example",
"group_same_items": false,
"language": "language_example",
"select_print_heading": "select_print_heading_example",
"inter_company_invoice_reference": "Example Corp",
"customer_group": "customer_group_example",
"is_discounted": false,
"debit_to": "debit_to_example",
"party_account_currency": "USD",
"is_opening": "No",
"remarks": "remarks_example",
"sales_partner": "sales_partner_example",
"commission_rate": 0,
"total_commission": 0,
"from_date": "2024-01-15",
"to_date": "2024-01-15",
"auto_repeat": "auto_repeat_example",
"against_income_account": "against_income_account_example",
"is_consolidated": false,
"is_internal_customer": false,
"company_tax_id": "Example Corp",
"unrealized_profit_loss_account": "unrealized_profit_loss_account_example",
"represents_company": "Example Corp",
"set_target_warehouse": "set_target_warehouse_example",
"is_debit_note": false,
"disable_rounded_total": false,
"additional_discount_account": "additional_discount_account_example",
"dispatch_address_name": "dispatch_address_name_example",
"dispatch_address": "dispatch_address_example",
"ignore_default_payment_terms_template": false,
"total_billing_hours": 0,
"amount_eligible_for_commission": 0,
"subscription": "subscription_example",
"is_cash_or_non_trade_discount": false,
"incoterm": "incoterm_example",
"named_place": "named_place_example",
"only_include_allocated_payments": false,
"use_company_roundoff_cost_center": false,
"update_billed_amount_in_delivery_note": true,
"dont_create_loyalty_points": false,
"coupon_code": "coupon_code_example",
"update_outstanding_for_self": true,
"utm_medium": "utm_medium_example",
"utm_content": "utm_content_example",
"utm_campaign": "utm_campaign_example",
"utm_source": "utm_source_example",
"company_contact_person": "Example Corp",
"is_created_using_pos": false,
"pos_closing_entry": "pos_closing_entry_example",
"has_subcontracted": false,
"apply_tds": false,
"tax_withholding_group": "tax_withholding_group_example",
"ignore_tax_withholding_threshold": false,
"override_tax_withholding_entries": false,
"title": "title_example",
"signing_document_id": "signing_document_id_example"
} /api/accounts/sales-invoice/{id}/cancel Cancel a sales invoice
Cancels a submitted sales invoice, transitioning its status to cancelled.
Path parameters
The identifier of the sales invoice to act on.
Returns
Returns the sales invoice object with updated status.
curl https://api.overplane.dev/api/accounts/sales-invoice/sales-invoice_abc123/cancel \
-H "Authorization: Bearer sk_test_..." \
-X POST {
"id": "sales-invoice_abc123",
"created_at": "2024-01-15T09: 30: 00Z",
"updated_at": "2024-01-15T09: 30: 00Z",
"status": "draft",
"customer": "customer_example",
"customer_name": "customer_name_example",
"tax_id": "tax_id_example",
"project": "project_example",
"is_pos": false,
"pos_profile": "pos_profile_example",
"is_return": false,
"company": "Example Corp",
"cost_center": "cost_center_example",
"posting_date": "2024-01-15",
"posting_time": "posting_time_example",
"set_posting_time": false,
"due_date": "2024-01-15",
"return_against": "return_against_example",
"update_billed_amount_in_sales_order": false,
"po_no": "po_no_example",
"po_date": "2024-01-15",
"customer_address": "customer_address_example",
"address_display": "address_display_example",
"contact_person": "contact_person_example",
"contact_display": "contact_display_example",
"contact_mobile": "contact_mobile_example",
"contact_email": "[email protected]",
"territory": "territory_example",
"shipping_address_name": "shipping_address_name_example",
"shipping_address": "shipping_address_example",
"company_address": "Example Corp",
"company_address_display": "Example Corp",
"currency": "USD",
"conversion_rate": 0,
"selling_price_list": "selling_price_list_example",
"price_list_currency": "USD",
"plc_conversion_rate": 0,
"ignore_pricing_rule": false,
"set_warehouse": "set_warehouse_example",
"update_stock": false,
"scan_barcode": "scan_barcode_example",
"total_billing_amount": 0,
"total_qty": 0,
"base_total": 0,
"base_net_total": 0,
"total": 0,
"net_total": 0,
"total_net_weight": 0,
"taxes_and_charges": "taxes_and_charges_example",
"shipping_rule": "shipping_rule_example",
"tax_category": "tax_category_example",
"other_charges_calculation": "other_charges_calculation_example",
"base_total_taxes_and_charges": 0,
"total_taxes_and_charges": 0,
"loyalty_points": 0,
"loyalty_amount": 0,
"redeem_loyalty_points": false,
"loyalty_program": "loyalty_program_example",
"loyalty_redemption_account": "loyalty_redemption_account_example",
"loyalty_redemption_cost_center": "loyalty_redemption_cost_center_example",
"apply_discount_on": "Grand Total",
"base_discount_amount": 0,
"additional_discount_percentage": 0,
"discount_amount": 0,
"base_grand_total": 0,
"base_rounding_adjustment": 0,
"base_rounded_total": 0,
"base_in_words": "base_in_words_example",
"grand_total": 0,
"rounding_adjustment": 0,
"rounded_total": 0,
"in_words": "in_words_example",
"total_advance": 0,
"outstanding_amount": 0,
"allocate_advances_automatically": false,
"payment_terms_template": "payment_terms_template_example",
"cash_bank_account": "cash_bank_account_example",
"base_paid_amount": 0,
"paid_amount": 0,
"base_change_amount": 0,
"change_amount": 0,
"account_for_change_amount": "account_for_change_amount_example",
"write_off_amount": 0,
"base_write_off_amount": 0,
"write_off_outstanding_amount_automatically": false,
"write_off_account": "write_off_account_example",
"write_off_cost_center": "write_off_cost_center_example",
"tc_name": "tc_name_example",
"terms": "terms_example",
"letter_head": "letter_head_example",
"group_same_items": false,
"language": "language_example",
"select_print_heading": "select_print_heading_example",
"inter_company_invoice_reference": "Example Corp",
"customer_group": "customer_group_example",
"is_discounted": false,
"debit_to": "debit_to_example",
"party_account_currency": "USD",
"is_opening": "No",
"remarks": "remarks_example",
"sales_partner": "sales_partner_example",
"commission_rate": 0,
"total_commission": 0,
"from_date": "2024-01-15",
"to_date": "2024-01-15",
"auto_repeat": "auto_repeat_example",
"against_income_account": "against_income_account_example",
"is_consolidated": false,
"is_internal_customer": false,
"company_tax_id": "Example Corp",
"unrealized_profit_loss_account": "unrealized_profit_loss_account_example",
"represents_company": "Example Corp",
"set_target_warehouse": "set_target_warehouse_example",
"is_debit_note": false,
"disable_rounded_total": false,
"additional_discount_account": "additional_discount_account_example",
"dispatch_address_name": "dispatch_address_name_example",
"dispatch_address": "dispatch_address_example",
"ignore_default_payment_terms_template": false,
"total_billing_hours": 0,
"amount_eligible_for_commission": 0,
"subscription": "subscription_example",
"is_cash_or_non_trade_discount": false,
"incoterm": "incoterm_example",
"named_place": "named_place_example",
"only_include_allocated_payments": false,
"use_company_roundoff_cost_center": false,
"update_billed_amount_in_delivery_note": true,
"dont_create_loyalty_points": false,
"coupon_code": "coupon_code_example",
"update_outstanding_for_self": true,
"utm_medium": "utm_medium_example",
"utm_content": "utm_content_example",
"utm_campaign": "utm_campaign_example",
"utm_source": "utm_source_example",
"company_contact_person": "Example Corp",
"is_created_using_pos": false,
"pos_closing_entry": "pos_closing_entry_example",
"has_subcontracted": false,
"apply_tds": false,
"tax_withholding_group": "tax_withholding_group_example",
"ignore_tax_withholding_threshold": false,
"override_tax_withholding_entries": false,
"title": "title_example",
"signing_document_id": "signing_document_id_example"
} Line items
Child objects that belong to this sales invoice. These are accessed via the parent's ID.
Sales Invoice Item
Attributes
Endpoints
/api/accounts/sales-invoice-item?parent_id={id} /api/accounts/sales-invoice-item /api/accounts/sales-invoice-item/{id} /api/accounts/sales-invoice-item/{id} /api/accounts/sales-invoice-item/reorder {
"id": "sales-invoice-item_abc123",
"idx": 1,
"sales_invoice_id": "sales_invoice_id_example",
"barcode": "barcode_example",
"item_code": "item_code_example",
"item_name": "item_name_example",
"customer_item_code": "customer_item_code_example",
"description": "description_example",
"image_view": "image_view_example",
"image": "image_example",
"qty": 0,
"stock_uom": "stock_uom_example",
"uom": "uom_example",
"conversion_factor": 0,
"stock_qty": 0,
"price_list_rate": 0,
"base_price_list_rate": 0,
"margin_type": "margin_type_example",
"margin_rate_or_amount": 0,
"rate_with_margin": 0,
"discount_percentage": 0,
"discount_amount": 0,
"base_rate_with_margin": 0,
"rate": 0,
"amount": 0,
"base_rate": 0,
"base_amount": 0,
"pricing_rules": "pricing_rules_example",
"is_free_item": false,
"net_rate": 0,
"net_amount": 0,
"base_net_rate": 0,
"base_net_amount": 0,
"delivered_by_supplier": false,
"income_account": "income_account_example",
"expense_account": "expense_account_example",
"item_tax_template": "item_tax_template_example",
"cost_center": "cost_center_example",
"deferred_revenue_account": "deferred_revenue_account_example",
"service_stop_date": "2024-01-15",
"enable_deferred_revenue": false,
"service_start_date": "2024-01-15",
"service_end_date": "2024-01-15",
"weight_per_unit": 0,
"total_weight": 0,
"weight_uom": "weight_uom_example",
"warehouse": "warehouse_example",
"target_warehouse": "target_warehouse_example",
"quality_inspection": "quality_inspection_example",
"batch_no": "batch_no_example",
"allow_zero_valuation_rate": false,
"serial_no": "serial_no_example",
"item_group": "item_group_example",
"brand": "brand_example",
"item_tax_rate": "item_tax_rate_example",
"actual_batch_qty": 0,
"actual_qty": 0,
"sales_order": "sales_order_example",
"so_detail": "so_detail_example",
"delivery_note": "delivery_note_example",
"dn_detail": "dn_detail_example",
"delivered_qty": 0,
"is_fixed_asset": false,
"asset": "asset_example",
"page_break": false,
"finance_book": "finance_book_example",
"project": "project_example",
"sales_invoice_item": "sales_invoice_item_example",
"incoming_rate": 0,
"stock_uom_rate": 0,
"discount_account": "discount_account_example",
"grant_commission": false,
"purchase_order": "purchase_order_example",
"purchase_order_item": "purchase_order_item_example",
"has_item_scanned": false,
"serial_and_batch_bundle": "serial_and_batch_bundle_example",
"use_serial_batch_fields": false,
"distributed_discount_amount": 0,
"company_total_stock": 0,
"pos_invoice_item": "pos_invoice_item_example",
"pos_invoice": "pos_invoice_example",
"scio_detail": "scio_detail_example",
"tax_withholding_category": "tax_withholding_category_example",
"apply_tds": true
}