BeaconX e-Invoice API
  1. B2C Receipt
BeaconX e-Invoice API
  • BeaconX e-Invoice API Documentation
  • API Endpoints
    • B2B e-Invoicing
      • Create Document(s)
      • Cancel Document
      • Void Document
      • Unvoid Document
      • Create Invoice from Receipt
      • Check Status
      • Embed QR Code
      • Invoice Reversal
      • Update Reference Number
    • B2C Receipt
      • Retrieve Receipt
        GET
      • Search Receipts
        GET
      • Create a Receipt
        POST
      • Update existing Receipt
        PUT
      • Void a Receipt
        GET
      • Void Multiple Receipts
        POST
      • UnVoid a Receipt
        GET
      • Send a Receipt (Email / WhatsApp)
        POST
      • Download Receipts Report
        GET
      • Create Multiple Receipts (Bulk)
        POST
      • Receipt Reversal
        POST
      • Update Reference Number
        POST
      • Check Status
        POST
    • TaxPayer
      • Validate Tax Payer
      • Sync Tax Payer Master List
      • Identity
      • Validate SSM
      • Search TIN
    • Lists
      • Get list of all Classification Codes
  1. B2C Receipt

Update existing Receipt

PUT
/receipts/{reference_number}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Header Params

Body Params application/json

Example
{
    "reference_number": "OUTLET-POSID-1130",
    "invoice_number": "1000",
    "pos_id": "",
    "source": "",
    "issued_at": "2024-04-30",
    "outlet_code": "KL",
    "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,
    "items": [
        {
            "id": "50000",
            "classification": "",
            "unit_price": 6.9,
            "quantity": 6,
            "description": "DESCRIPTION",
            "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,
            "total_incl_tax": 35.19
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://einvoice-api.beaconx.com.my/receipts/O1-20240202-VGSP217362830' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_number": "OUTLET-POSID-1130",
    "invoice_number": "1000",
    "pos_id": "",
    "source": "",
    "issued_at": "2024-04-30",
    "outlet_code": "KL",
    "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,
    "items": [
        {
            "id": "50000",
            "classification": "",
            "unit_price": 6.9,
            "quantity": 6,
            "description": "DESCRIPTION",
            "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,
            "total_incl_tax": 35.19
        }
    ]
}'

Responses

🟠405Validation error
application/json
Body

Example
{}
🟢200OK
🟠404Record not found
Modified at 2024-07-09 02:33:33
Previous
Create a Receipt
Next
Void a Receipt
Built with