Create Purchase Invoice
- Purchase Invoice created successful, it will auto generate A/R Invoice.
- Request Instruction
HTTPS Method POST URL http://subdomain.supersuite.my/api/purchase-invoice/create Content Type application/json Response Type JSON Parameter Description token : string, is required.
branch_ref_id : string, is required.
doc_no : string.
number_format_ref_id : string, is required.
creditor_account_number : string, is required.
date : date, is required. (Format : Y-m-d)
name : string, is required.
address_1 : string.
address_2 : string.
address_3 : string.
address_4 : string.
credit_term_id : int, is required.
agent_ref_id : string.
creditor_debtor_branch_id : int.
shipping_info : string.
shipping_method_ref_id : string.
supplier_do_no: string.
supplier_invoice_no: string.
allow_to_transfer : char, is required.
inclusive : char (3), is required.
currency_id : int, is required.
remark : text.
items : [
{
item_code : string.
chart_account_number : string, is required.
description : string, is required.
description_2 : string.
department_id : int.
project_id : int.
qty : int, is required.
unit_price : decimal, is required.
discount : decimal.
cn_amount: decimal.
tax_code_ref_id : string.
sales_tax_exemption_no : string.
type : string, is required.,
discount_type : char (1).
discount_percentage : decimal.
discount_amount : decimal.
discount_parent_account_number : string.
package_item ; json_encode.
}
]
Request Headers {
"Content-Type":"application/json"
}
Request Body {
"token" : "B7ABD5DEEC6588997DE41B0FE0665",
"branch_ref_id" : "BB31CD0066F81E3C27674B1BB8BC7F",
"doc_no" : "I-00001",
"number_format_ref_id" : "NN31CD0066F81E3C27674B1BB8BC7F",
"creditor_account_number" : "300-F001",
"date" : "2020-01-14",
"name" : "Alex Lim",
"address_1" : "Bayan Lepas Industrial Park,",
"address_2" : "Penang, Malaysia",
"address_3" : "",
"address_4" : "",
"credit_term_id" : "1",
"agent_ref_id" : "AA31CD0066F81E3C27674B1BB8BC7F",
"creditor_debtor_branch_id" : "",
"shipping_info" : "",
"shipping_method_ref_id" : "",
"supplier_do_no" : "",
"supplier_invoice_no" : "",
"allow_to_transfer" : "Y",
"inclusive" : "off",
"currency_id" : "105",
"remark" : "",
"items" : [
{
"item_code" : "B0001",
"chart_account_number" : "500-0000",
"description" : "Stock 1",
"description_2" : "",
"department_id" : "",
"project_id" : "",
"qty" : "10",
"unit_price" : "10.00",
"discount" : "20.00",
"cn_amount" : "0.00",
"tax_code_ref_id" : "TTC1CD0066F81E3C27674B1BB8BC7F",
"sales_tax_exemption_no" : "",
"type" : "Product",
"discount_type" : "",
"discount_percentage" : "",
"discount_amount" : "",
"discount_parent_account_number" : "",
"package_item" : ""
}
]
}
- Response JSON Format
Successful Example {
"purchase_invoice_doc_no" : "I-00001",
"invoice_doc_no" : "I-00001",
"purchase_invoice_ref_id" :"SSC1CD0066F81E3C27674B1BB8BC7F",
}
Fail Example {
"purchase_invoice_doc_no" : false,
"error" : "Token invalid. / Document save fail."
}
- Remark Property
Doc No If doc no is empty, it will auto generate by system.
Allow To Transfer Only Accept : Y, N
Y= Yes,
N = No
Inclusive Only Accept : on, off Type Only Accept : Product, Discount Discount Type * Only type is D (Discount) need to fill in value.
Only Accept : P, V
P = Percentage,
V = Value
Discount Percentage * Only discount type is P (Percentage) need to fill in value.
Discount Amount * Total discount amount giving for this item.
Discount Parent Account Number * This discount parent account number is record this discount from which parent item / product item.
Package Item When Item is Package Item, you need to fill it and the data format is json encode.
The package item is important, do not allow you to edit the data. It will affect you entry calculation. If you edited it, it will follow you edit to saving. if the system could not catch the special key, you document amount will be calculate wrongly.
You can take the data from below link:
https://knowledge.supersuite.my/books/api/page/package-item-data-option
- Bold word is Important message.