jualan

caution

akaun demo

id: demo@gmail.com
pwd: demo

Merekod jualan (tambah baru & edit)

Request method: POST
Endpoint: http://www.eas-pro.my/eas/api/external/transaction/create
Header:

1. partner: [dapatkan value dari admin easpro]. Nilai ini telah diganti: nilai lama ditolak, jadi dapatkan nilai baharu daripada admin EASPRO.
2. user-id: [dapatkan input dari user]

Akaun mesti diaktifkan, dan jawapan 200 bukan bukti rekod

Header partner dan user-id sahaja tidak mencukupi. Integrasi ordersini.com mesti diaktifkan untuk akaun EASPRO milik user-id itu oleh admin EASPRO (hubungi sokongan EASPRO dengan nama akaun dan projek yang digunakan). Pada masa ini pengguna tidak boleh mengaktifkannya sendiri daripada skrin tetapan. Permintaan untuk akaun yang belum diaktifkan ditolak, dengan cara yang sama seperti user-id yang tidak wujud: tiada invois atau bayaran direkodkan.

API ini berjalan secara tidak serentak. Jawapan 200 hanya bermakna permintaan diterima, bukan bahawa invois atau bayaran sudah direkodkan. Semak di EASPRO untuk memastikan rekod wujud.

billReferenceId hanya dipadankan dengan invois dalam akaun pengguna itu sendiri. Jika dua invois dalam satu akaun berkongsi billReferenceId yang sama, permintaan ditolak tanpa mengubah mana-mana invois.

Variable	Mandatory	Description	Type	Example
Value	yes	Total transaction	number	30
transactionDate	yes	Transaction date	string	"2023-05-04T09:43"
billType	yes	Value options INVOICE QUOTATION	string	"INVOICE"
billStatus	yes	Value options UNPAID PAID	string	"UNPAID"
billReferenceId	yes	unique key from partner to determine invoice (use same id for update)	string	"ORD-2023-000123"
delivery	no	delivery charge	number	5
partner	no	customer details	json object	{ "type": "CUSTOMER", "name": "Adam", "email": "adam@gmail.com", "telNo": "013484573", "address": "No 12, jalan istean, 09739, pangkor, perak" } caution type & name adalah mandatory kalau partner object diberi
products	no	product details	json array	[ { "description": "-", "discount": "20", "discountType": "flat", "invProductId": "68668492-e16b-4b5c-82e6-8e5d843ffbdc", // product id "name": "airpod", "priceSellPerUnit": "20", // price per unit "stockToCount": "10", // quantity "subTotal": 180 // sub total: "priceSellPerUnit" * "stockToCount" (- or *) discount } ] caution invProductId adalah product id dari easpro, partner perlu ambil input dari user untuk mapping setiap product discountType options flat percent

Sample body request

{
    "data": {
        "value": 25,
        "transactionDate": "2023-05-04T09:43",
        "billType": "INVOICE",
        "billStatus": "UNPAID",
        "products": [
            {
                "description": "-",
                "discount": "20",
                "discountType": "flat",
                "invFeId": "6fd515ef-4d90-49f7-a857-9241758974f0",
                "invProductId": "68668492-e16b-4b5c-82e6-8e5d843ffbdc",
                "name": "airpod",
                "priceSellPerUnit": "20",
                "stockToCount": "10",
                "subTotal": 180
            }
        ],
        "delivery": 5,
        "billReferenceId": "ORD-2023-000123",
        "partner": {
            "type": "CUSTOMER",
            "name": "Adam", 
            "email": "adam@gmail.com",
            "telNo": "013484593",
            "address": "No 21, Taman isaed, 09232, pangkor, perak"
        }
    }
}

Sample body response

info

response sentiasa HTTP:200

{
    "data": {
        "result": "Success",
        "demo": false
    },
    "response": {
        "date": "2023/05/09 19:44:10",
        "status": {
            "code": "0",
            "httpMessage": "success processed"
        }
    }
}