Create a Receipt

POST

/receipts

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Example

{
    "reference_number": "OUTLET-POSID-1131",
    "invoice_number": "OUTLET-POSID-1131",
    "type": "01",
    "original_einvoice_ref_number": "",
    "pos_id": "",
    "source": "",
    "issued_at": "2024-10-16",
    "outlet_code": "SMG",
    "status": "valid",
    "quantity": 0,
    "subtotal": 117.3,
    "discount_rate": 0,
    "discount_amount": 14.49,
    "service_fee_rate": 0,
    "service_fee_amount": 0,
    "total_excl_tax": 0,
    "sales_tax_amount": 0,
    "service_tax_amount": 0,
    "gst_amount": 0,
    "ttx_amount": 0,
    "hvgt_amount": 0,
    "lvst_amount": 0,
    "total_tax_amount": 0,
    "total_incl_tax": 102.81,
    "rounding": -0.01,
    "currency_code": "MYR",
    "currency_rate": 1,
    "total_payable_amount": 102.80,
    "suppliers_bank_account_number": "",
    "payment_method": "",
    "payment_terms": "",
    "prepayment_amount": "",
    "prepayment_datetime": "",
    "prepayment_reference_number": "",
    "footer_notes": "",
    "items": [
        {
            "id": "50000",
            "code": "SKU001",
            "classification": "",
            "unit_price": 6.9,
            "quantity": 6,
            "description": "MATEMATIK - S - MMP",
            "long_description": "",
            "measurement": "",
            "subtotal": 41.4,
            "discount_rate": 0,
            "discount_amount": 6.21,
            "total_excl_tax": 0,
            "service_fee_rate": 0,
            "service_fee_amount": 0,
            "sales_tax_rate": 0,
            "sales_tax_amount": 0,
            "service_tax_rate": 0,
            "service_tax_amount": 0,
            "gst_rate": 0,
            "gst_amount": 0,
            "ttx_rate": 0,
            "ttx_amount": 0,
            "hvgt_rate": 0,
            "hvgt_amount": 0,
            "lvst_rate": 0,
            "lvst_amount": 0,
            "tax_exempt_amount": 0,
            "total_incl_tax": 35.19
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://einvoice-api.beaconx.com.my/receipts' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_number": "OUTLET-POSID-1131",
    "invoice_number": "OUTLET-POSID-1131",
    "type": "01",
    "original_einvoice_ref_number": "",
    "pos_id": "",
    "source": "",
    "issued_at": "2024-10-16",
    "outlet_code": "SMG",
    "status": "valid",
    "quantity": 0,
    "subtotal": 117.3,
    "discount_rate": 0,
    "discount_amount": 14.49,
    "service_fee_rate": 0,
    "service_fee_amount": 0,
    "total_excl_tax": 0,
    "sales_tax_amount": 0,
    "service_tax_amount": 0,
    "gst_amount": 0,
    "ttx_amount": 0,
    "hvgt_amount": 0,
    "lvst_amount": 0,
    "total_tax_amount": 0,
    "total_incl_tax": 102.81,
    "rounding": -0.01,
    "currency_code": "MYR",
    "currency_rate": 1,
    "total_payable_amount": 102.80,
    "suppliers_bank_account_number": "",
    "payment_method": "",
    "payment_terms": "",
    "prepayment_amount": "",
    "prepayment_datetime": "",
    "prepayment_reference_number": "",
    "footer_notes": "",
    "items": [
        {
            "id": "50000",
            "code": "SKU001",
            "classification": "",
            "unit_price": 6.9,
            "quantity": 6,
            "description": "MATEMATIK - S - MMP",
            "long_description": "",
            "measurement": "",
            "subtotal": 41.4,
            "discount_rate": 0,
            "discount_amount": 6.21,
            "total_excl_tax": 0,
            "service_fee_rate": 0,
            "service_fee_amount": 0,
            "sales_tax_rate": 0,
            "sales_tax_amount": 0,
            "service_tax_rate": 0,
            "service_tax_amount": 0,
            "gst_rate": 0,
            "gst_amount": 0,
            "ttx_rate": 0,
            "ttx_amount": 0,
            "hvgt_rate": 0,
            "hvgt_amount": 0,
            "lvst_rate": 0,
            "lvst_amount": 0,
            "tax_exempt_amount": 0,
            "total_incl_tax": 35.19
        }
    ]
}'

Responses

🟢200OK

application/json

Body

Example

{
    "status": "OK",
    "message": "",
    "data": {
        "success": [
            {
                "invoice_number": "RCPT005",
                "reference_number": "RCPT005",
                "outlet_code": "001",
                "source": "",
                "pos_id": "P0302",
                "issued_at": "2024-04-30",
                "status": "valid",
                "quantity": 0,
                "subtotal": 117.3,
                "discount_rate": 0,
                "discount_amount": 14.49,
                "total_excl_tax": 0,
                "sales_tax_amount": 0,
                "service_tax_amount": 0,
                "gst_amount": 0,
                "ttx_amount": 0,
                "hvgt_amount": 0,
                "lvst_amount": 0,
                "total_incl_tax": 102.81,
                "total_tax_amount": 0,
                "rounding": 0,
                "total_payable_amount": 102.81,
                "currency_code": "MYR",
                "currency_rate": 1,
                "items": [
                    {
                        "id": "50000",
                        "classification": "",
                        "unit_price": 6.9,
                        "quantity": 6,
                        "description": "MATEMATIK - S - MMP 新北市22069板桥区三民路二段",
                        "long_description": "",
                        "measurement": "",
                        "subtotal": 41.4,
                        "discount_rate": 0,
                        "discount_amount": 6.21,
                        "total_excl_tax": 0,
                        "sales_tax_rate": 0,
                        "sales_tax_amount": 0,
                        "service_tax_rate": 0,
                        "service_tax_amount": 0,
                        "gst_rate": 0,
                        "gst_amount": 0,
                        "ttx_rate": 0,
                        "ttx_amount": 0,
                        "hvgt_rate": 0,
                        "hvgt_amount": 0,
                        "lvst_rate": 0,
                        "lvst_amount": 0,
                        "total_incl_tax": 35.19
                    }
                ],
                "service_fee_rate": 0,
                "service_fee_amount": 0,
                "sst_rate": 0,
                "sst_amount": 0,
                "buyer": {
                    "membership_id": "",
                    "name": "",
                    "tin": "",
                    "id_number": "",
                    "sst_number": "",
                    "email": "",
                    "address": "",
                    "contact": ""
                },
                "id": "9d5235b0-3195-454e-a05e-fa61b8fab680",
                "url": "https://iserve.beaconx.com.my/beacon/001/9d5235b0-3195-454e-a05e-fa61b8fab680",
                "document": []
            }
        ],
        "failed": []
    }
}

🟢200Rejected Error

🟠429Rate Limit Error

🔴500Server Error

Modified at 2025-09-10 06:43:16

Search Receipts

Update existing Receipt