Create Purchase Requisitions

Description

This API is used to create orders.

Method	URL
POST	/api/v2/bumn/order/create

Request

Type	Params	Values	Description
BODY	voucher_code	string optional	Kode voucher
BODY	shipping_address_id	string mandatory	ID dari alamat pengiriman milik Buyer
BODY	payment_method	string mandatory	Metode pembayaran yang digunakan buyer. Value tersedia saat ini: MANDIRI BNI BJB BSI BRI BTNATM BCA POS_VA_FIXED CARD QR_CODE DANA LINKAJA OVO
BODY	payment_gateway_registery	string optional	Registery Penyedia Payment Gateway
BODY	payment_gateway	string mandatory	Penyedia Payment Gateway yang digunakan. Value tersedia (saat ini): xendit mps
BODY	payment_type	string mandatory	Tipe pembayaran yang digunakan Buyer. Value tersedia: postpaid, untuk pembayaran tempo prepaid , untuk pembayaran langsung termin , untuk pembayaran termin
BODY	items	array of object mandatory	Object yang berisi data items yang dibutuhkan untuk checkout
BODY	items.seller_id	string mandatory	ID Seller yang terdaftar di PaDi
BODY	items.shipping_insurance	boolean mandatory	Status produk memiliki insuransi.
BODY	items.reference_code	string optional	Kode referensi
BODY	items.shipping_type	string optional	Tipe pengiriman. Terisi jika kurir berasal dari integrasi dengan Biteship.
BODY	items.courier_code	string mandatory	Kode kurir yang dipilih. Value tersedia: cargo next_day same_day regular self pickup
BODY	items.courier_name	string mandatory	Kurir yang dipilih.
BODY	items.courier_service_code	string mandatory	Nama layanan kurir yang dipilih.
BODY	items.courier_service_name	string mandatory	Nama layanan kurir yang dipilih.
BODY	items.project_type	string mandatory	Tipe proyek yang dipilih.Value tersedia: opex capex
BODY	items.received_at_latest	string(format YY-MM-DD) mandatory	Tanggal produk diterima paling lambat
BODY	items.products	array of object mandatory	Object yang berisi data produk yang dibutuhkan untuk checkout
BODY	items.products.id	string mandatory	Kode produk yang dibeli
BODY	items.products.quantity	string mandatory	Jumlah produk yang dibeli
BODY	items.products.notes	string optional	Catatan untuk Seller
BODY	payment_term	string optional	Jangka waktu pembayaran tempo. Value tersedia (dalam hari): 14 30 60 90 120 150 180

Response

Success

Status

Payload

200

{ "status": "success", "data": { "create-order": { "amount": 36000, "bank_account": "381659999219545", "bank_name": "BCA Virtual Account", "btp_by_buyer": false, "expired_at": "2024-11-12T03:24:57.208Z", "fee_total_monthly": 0, "grand_total": 36000, "grand_total_before_discount": 36000, "isVoucherValid": false, "items": [ { "charge_fee": 0, "courier_code": "pos", "fee_total_monthly": 0, "grand_total": 36000, "order_total": 36000, "pph15": 0, "pph21": 0, "pph22": 0, "pph22_klpd": 0, "pph22_klpd_dpp": 0, "pph22_person": 0, "pph23": 0, "pph23_as_shipping_cost": 0, "pph23_person": 0, "pph42_1": 0, "pph42_10": 0, "pph42_2": 0, "pph42_3": 0, "pph42_4": 0, "pph42_6": 0, "pph42_final": 0, "ppn": 0, "ppnBy": "Penjual", "ppn_collected_by_buyer": 0, "ppn_klpd_dpp": 0, "price_subtotal": 36000, "product_ppn": 0, "seller_id": "63d23730463c50e4426ef25c", "seller_name": "evi staging", "shipping_cost": 0, "shipping_cost_before_discount": 0, "shipping_cost_pph_klpd": 0, "shipping_cost_ppn": 0, "shipping_discount": 0, "total_pph": 0, "voucher_pph_23_shipping_cost": 0, "voucher_ppn_collected_by_buyer": 0, "voucher_shipping_cost": 0, "voucher_shipping_cost_ppn": 0, "voucher_total_product_price": 0, "voucher_total_product_price_ppn": 0 } ], "mps_invoice_id": "", "mps_payment_id": "", "payment_code": "BCA", "payment_gateway": "xendit", "payment_gateway_registery": "", "payment_method": "BCA", "payment_type": "VIRTUAL_ACCOUNT", "pph15": 0, "pph21": 0, "pph22": 0, "pph22_person": 0, "pph23": 0, "pph23_as_shipping_cost": 0, "pph23_person": 0, "pph42_1": 0, "pph42_10": 0, "pph42_2": 0, "pph42_3": 0, "pph42_4": 0, "pph42_6": 0, "pph42_final": 0, "ppn": 0, "ppn_collected_by_buyer": 0, "price_subtotal": 36000, "price_subtotal_before_discount": 36000, "product_ppn": 0, "purchase_request_number": "PR-2024-11-12-318337171", "seller_payment_fee": 0, "seller_payment_fee_fixed": 0, "seller_payment_fee_percentage": 0, "seller_trx_fee": 0, "shipping_cost": 0, "shipping_cost_before_discount": 0, "shipping_cost_ppn": 0, "shipping_discount": 0, "totalTrxFee": 0, "total_pph": 0, "transaction_id": "20241112318337171", "trxFee": 4000, "trxFeePph23": 80, "trxFeePpn": 0, "trxPromo": 0, "trxPromoType": "", "url": "", "voucherCode": "", "voucherDetail": null, "voucher_pph_23_shipping_cost": 0, "voucher_ppn_collected_by_buyer": 0, "voucher_shipping_cost": 0, "voucher_shipping_cost_ppn": 0, "voucher_total_product_price": 0, "voucher_total_product_price_ppn": 0, "xendit_pm_id": "pm-c6a95014-eb39-477c-8265-0235eaa13df0" } }, "message": "ok" }

Params	Description
status	Data Type: STRING Status of the request delivered to server. Available value: * "success" * "error"
data	Data Type: OBJECT Data transmitted by response.
data.create-order	Data Type: OBJECT Contains purchase request creation data
data.create-order.amount	Data Type: INTEGER Final amount to be paid
data.create-order.bank_account	Data Type: String Number of the bank account Buyer used
data.create-order.bank_name	Data Type: String Name of bank
data.create-order.btp_by_buyer	Data Type: BOOLEAN Status of availability from seller transaction fee (Biaya Transaksi Penjual (BTP)). Available value: * "true" * "false"
data.create-order.expired_at	Data Type: String Payment expiration date, if any
data.create-order.fee_total_monthly	Data Type: Integer Bill payment and shipping cost data
data.create-order.grand_total	Data Type: Integer Total amount of purchase including tax
data.create-order.grand_total_before_discount	Data Type: Integer Total amount of purchase including tax before discount
data.create-order.isVoucherValid	Data Type: Boolean Status of voucher used. Available value: * "true" * "false"
data.create-order.items	Data Type: ARRAY OF OBJECT
data.create-order.items.charge_fee	Data Type: Array of Object Data on products purchased based on only one Seller
data.create-order.items.courier_code	Data Type: String Code of courier. Currently Available Value: * "pos" * "jne" * "jnt" * "sicepat" * "anteraja" * "idexpress" * "sap" * "self" * "pickup"
data.create-order.items.fee_total_monthly	Data Type: Integer Bill payment and shipping cost data
data.create-order.items.grand_total	Data Type: Integer Total amount of purchase including tax
data.create-order.items.order_total	Data Type: Integer Order total of the product
data.create-order.items.pph15	Data Type: Integer Amount of income tax PPh 15 for service purchase (at 1,2%)
data.create-order.items.pph21	Data Type: Integer Amount of income tax PPh 21 for service purchase (at 5%-35%)
data.create-order.items.pph22	Data Type: Integer Amount of income tax PPh 22 for product purchase (at 1.5%)
data.create-order.items.pph22_klpd	Data Type: Integer Amount of income tax PPh 22 for Buyer of Kementerian, Lembaga dan Pemerintah Daerah (KLPD)
data.create-order.items.pph22_klpd_dpp	Data Type: Integer Amount of income tax PPh 22 for Buyer of Kementerian, Lembaga dan Pemerintah Daerah (KLPD) with Dasar Pengenaan Pajak / Total Tagihan Sebelum Pajak (DPP)
data.create-order.items.pph22_person	Data Type: Integer Amount of income tax PPh 22 person for product purchase (at 3%)
data.create-order.items.pph23	Data Type: Integer Amount of income tax PPh 23 person for service purchase (at 4%)
data.create-order.items.pph23_as_shipping_cost	Data Type: Integer Amount of income tax PPh 23 person for as shipping cost
data.create-order.items.pph23_person	Data Type: Integer Amount of income tax PPh 23 person for service purchase (at 4%)
data.create-order.items.pph42_1	Data Type: Integer Amount of income tax PPh 22 for service purchase (at 1.75%)
data.create-order.items.pph42_10	Data Type: Integer Total amount of tax Pajak Penghasilan (PPh4(2) (at 10%)
data.create-order.items.pph42_2	Data Type: Integer Total amount of tax Pajak Penghasilan (PPh4(2) (at 2.65%)
data.create-order.items.pph42_3	Data Type: Integer Total amount of tax Pajak Penghasilan (PPh4(2) (at 3.5%)
data.create-order.items.pph42_4	Data Type: Integer Total amount of tax Pajak Penghasilan (PPh4(2) (at 4%)
data.create-order.items.pph42_6	Data Type: Integer Total amount of tax Pajak Penghasilan (PPh4(2) (at 6%)
data.create-order.items.pph42_final	Data Type: Integer Final amount of tax Pajak Penghasilan (PPh4(2) (at 0.5%)
data.create-order.items.ppn	Data Type: Integer Amount of tax Pajak Pertambahan Nilai (PPN)
data.create-order.items.ppnBy	Data Type: String Parties/person who are required to pay tax Pajak Pertambahan Nilai (PPN)
data.create-order.items.ppn_collected_by_buyer	Data Type: Integer Amount of collected tax Pajak Pertambahan Nilai (PPN)
data.create-order.items.ppn_klpd_dpp	Data Type: Integer Amount of tax Pajak Pertambahan Nilai (PPN) for Buyer of Kementerian, Lembaga dan Pemerintah Daerah (KLPD) with Dasar Pengenaan Pajak / Total Tagihan Sebelum Pajak (DPP)
data.create-order.items.price_subtotal	Data Type: Integer Total price of the product
data.create-order.items.product_ppn	Data Type: Integer Amount of tax (PPN) imposed on the product
data.create-order.items.seller_id	Data Type: String ID of the Seller
data.create-order.items.seller_name	Data Type: String Name of the Seller
data.create-order.items.shipping_cost	Data Type: Integer Amount of shipping cost
data.create-order.items.shipping_cost_before_discount	Data Type: Integer Shipping cost before discount
data.create-order.items.shipping_cost_pph_klpd	Data Type: Integer Amount of shipping cost for income tax for Buyer of Kementerian, Lembaga dan Pemerintah Daerah (KLPD)
data.create-order.items.shipping_cost_ppn	Data Type: Integer Amount of tax (PPN) imposed on the shipping
data.create-order.items.shipping_discount	Data Type: Integer Amount of discount given
data.create-order.items.total_pph	Data Type: Integer Total amount of income tax PPh to pay
data.create-order.items.voucher_pph_23_shipping_cost	Data Type: Integer Cost of income tax (Pph23) from voucher shipping
data.create-order.items.voucher_ppn_collected_by_buyer	Data Type: Integer Amount of tax from collected voucher by Buyer
data.create-order.items.voucher_shipping_cost	Data Type: Integer Amount cost of voucher shipping
data.create-order.items.voucher_shipping_cost_ppn	Data Type: Integer Amount cost of voucher shipping
data.create-order.items.voucher_total_product_price	Data Type: Integer Price of voucher total product
data.create-order.items.voucher_total_product_price_ppn	Data Type: Integer Price of tax from voucher total product
data.create-order.mps_invoice_id	Data Type: String Generate ID of invoice by payment gateway vendor MPS. Only appears if payment uses payment_gateway with value "mps".
data.create-order.mps_payment_id	Data Type: String Generate ID of payment by payment gateway vendor MPS. Only appears if payment uses payment_gateway with value "mps".
data.create-order.payment_code	Data Type: String Code of payment method used. Currently Available Value: * "MANDIRI" * "BNI" * "BRI" * "BJB" * "BSI" * "BTNATM" * "BCA" * "POS_VA_FIXED" * "CARD" * "QR_CODE" * "DANA" * "LINKAJA" * "OVO"
data.create-order.payment_gateway	Data Type: String Payment gateway used. Currently Available Value: * "xendit" * "mps"
data.create-order.payment_gateway_registery	Data Type: String ID of the payment gateway registery. Only appears if payment uses payment_gateway with value "mps".
data.create-order.payment_method	Data Type: String Payment method used. Currently Available Value: * "MANDIRI" * "BNI" * "BRI" * "BJB" * "BSI" * "BTNATM" * "BCA" * "POS_VA_FIXED" * "CARD" * "QR_CODE" * "DANA" * "LINKAJA" * "OVO"
data.create-order.payment_type	Data Type: String Payment type used. Currently Available Value: * "VIRTUAL_ACCOUNT" * "CARD" * "QR_CODE" * "EWALLET"
data.create-order.pph15	Data Type: Integer Amount of income tax PPh 15 for service purchase (at 1,2%)
data.create-order.pph21	Data Type: Integer Amount of income tax PPh 21 for service purchase (at 5%-35%)
data.create-order.pph22	Data Type: Integer Amount of income tax PPh 22 for product purchase (at 1.5%)
data.create-order.pph22_person	Data Type: Integer Amount of income tax PPh 22 person for product purchase (at 3%)
data.create-order.pph23	Data Type: Integer Amount of income tax PPh 23 person for service purchase (at 4%)
data.create-order.pph23_as_shipping_cost	Data Type: Integer Amount of income tax PPh 23 person for as shipping cost
data.create-order.pph23_person	Data Type: Integer Amount of income tax PPh 23 person for service purchase (at 4%)
data.create-order.pph42_1	Data Type: Integer Amount of income tax PPh 22 for service purchase (at 1.75%)
data.create-order.pph42_10	Data Type: Integer Total amount of tax Pajak Penghasilan (PPh4(2) (at 10%)
data.create-order.pph42_2	Data Type: Integer Total amount of tax Pajak Penghasilan (PPh4(2) (at 2.65%)
data.create-order.pph42_3	Data Type: Integer Total amount of tax Pajak Penghasilan (PPh4(2) (at 3.5%)
data.create-order.pph42_4	Data Type: Integer Total amount of tax Pajak Penghasilan (PPh4(2) (at 4%)
data.create-order.pph42_6	Data Type: Integer Total amount of tax Pajak Penghasilan (PPh4(2) (at 6%)
data.create-order.pph42_final	Data Type: Integer Final amount of tax Pajak Penghasilan (PPh4(2) (at 0.5%)
data.create-order.ppn	Data Type: Integer Amount of tax Pajak Pertambahan Nilai (PPN)
data.create-order.ppn_collected_by_buyer	Data Type: Integer Amount of collected tax Pajak Pertambahan Nilai (PPN)
data.create-order.price_subtotal	Data Type: Integer Total price of the product
data.create-order.price_subtotal_before_discount	Data Type: Integer Total price of the product before discount
data.create-order.product_ppn	Data Type: Integer Amount of tax (PPN) imposed on the product
data.create-order.purchase_request_number	Data Type: String ID of the purchase request
data.create-order.seller_payment_fee	Data Type: Integer Payment fee for Seller
data.create-order.seller_payment_fee_fixed	Data Type: INTEGER Fixed payment fee for Seller
data.create-order.seller_payment_fee_percentage	Data Type: Integer Seller payment fee percentage
data.create-order.seller_trx_fee	Data Type: Integer Seller transaction fee
data.create-order.totalTrxFee	Data Type: Integer Total amount of from Transaction fee
data.create-order.transaction_id	Data Type: String ID of the transaction
data.create-order.trxFee	Data Type: Integer Transaction fee
data.create-order.trxFeePph23	Data Type: Integer Amount of income tax from Transaction fee
data.create-order.trxFeePpn	Data Type: Integer Amount of tax from Transaction fee
data.create-order.trxPromo	Data Type: Integer Total amount of from Transaction fee
data.create-order.trxPromoType	Data Type: String Transaction promo type. Available value: * "subtotal" * "shipment"
data.create-order.url	Data Type: String Redirect link to ewallet
data.create-order.voucherCode	Data Type: String Code of the voucher
data.create-order.voucherDetail	Data Type: Object Detail of the voucher
data.create-order.voucher_pph_23_shipping_cost	Data Type: Integer Cost of income tax (Pph23) from voucher shipping
data.create-order.voucher_ppn_collected_by_buyer	Data Type: Integer Amount of tax from collected voucher by Buyer
data.create-order.voucher_shipping_cost	Data Type: Integer Amount cost of voucher shipping
data.create-order.voucher_shipping_cost_ppn	Data Type: Integer Amount cost of tax from voucher shipping
data.create-order.voucher_total_product_price	Data Type: Integer Price of voucher total product
data.create-order.voucher_total_product_price_ppn	Data Type: Integer Price of tax from voucher total product
data.create-order.xendit_pm_id	Data Type: String Generate ID of the payment from gateway vendor Xendit payment.
message	Data Type: STRING Description and/or details message of the status. Available Value: "ok" or some error message by trapped condition

Error

Case	Status Code	Message
Failed to get response because bad internet	400	Bad Request
Failed to set shipping cost	400	Failed to set shipping cost
Failed to get data from collect bill	400	Failed to collect bill
Failed to get data from calculate bill	400	Failed to calculate bill
Failed to hit create order	400	Failed to create orders
ERP user does not match the token obtained from the API Login	400	Invalid User ERP
payment_type is not available	400	Payment type is not available
payment_term is not available	400	Payment terms is not available
payment_method is not available	400	Payment method is not available
Invalid shipping_address_id	404	Address Not Found
Transaction not found	404	Transaction Not Found
Invalid product_id	404	Product Not Found
Invalid courier_code	404	Courrier Not Found
Courier not found	404	Product Detail Not Found
Internal Server Error	500	Internal Server Error