Create Document SAP DRC - BeaconX e-Invoice API

This endpoint allows source systems to create eInvoice from provided invoice document data.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Invoice

object

required

object

required

IssueDate

object

required

IssueTime

object

required

InvoiceTypeCode

object

required

DocumentCurrencyCode

object

required

BillingReference

object

required

AdditionalDocumentReference

object

required

AccountingSupplierParty

object

required

AccountingCustomerParty

object

required

PaymentTerms

object

required

TaxTotal

object

required

LegalMonetaryTotal

object

required

InvoiceLine

array [object {7}]

required

Example

{
  "Invoice": {
    "ID": {
      "_text": "9000000488"
    },
    "IssueDate": {
      "_text": "2025-01-20"
    },
    "IssueTime": {
      "_text": "09:40:19Z"
    },
    "InvoiceTypeCode": {
      "_listVersionID": "1.0",
      "_text": "01"
    },
    "DocumentCurrencyCode": {
      "_text": "MYR"
    },
    "BillingReference": {
      "AdditionalDocumentReference": {
        "ID": {
          "_text": "9000000488"
        }
      }
    },
    "AdditionalDocumentReference": {
      "ID": {
        "_text": "DDP"
      }
    },
    "AccountingSupplierParty": {
      "Party": {
        "IndustryClassificationCode": {
          "_name": "Keye MY10TEST2",
          "_text": "01113"
        },
        "PartyIdentification": [
          {
            "ID": {
              "_schemeID": "TIN",
              "_text": "C25323854040"
            }
          },
          {
            "ID": {
              "_schemeID": "BRN",
              "_text": "C25323854040"
            }
          },
          {
            "ID": {
              "_schemeID": "SST",
              "_text": "NA"
            }
          },
          {
            "ID": {
              "_schemeID": "TTX",
              "_text": "NA"
            }
          }
        ],
        "PostalAddress": {
          "CityName": {
            "_text": "Petaling Jaya"
          },
          "PostalZone": {
            "_text": "47800"
          },
          "CountrySubentityCode": {
            "_text": "10"
          },
          "AddressLine": {
            "Line": {
              "_text": "Jalan PJU 7/6 , Mutiara Damansara 10"
            }
          },
          "Country": {
            "IdentificationCode": {
              "_listID": "ISO3166-1",
              "_listAgencyID": "6",
              "_text": "MYS"
            }
          }
        },
        "PartyLegalEntity": {
          "RegistrationName": {
            "_text": "Kering Eyewear Malaysia Sdn Bhd"
          }
        },
        "Contact": {
          "Telephone": {
            "_text": "+60TBD"
          },
          "ElectronicMail": {
            "_text": "TBD@TBD.com"
          }
        }
      }
    },
    "AccountingCustomerParty": {
      "Party": {
        "PartyIdentification": [
          {
            "ID": {
              "_schemeID": "TIN",
              "_text": "IG56003500071"
            }
          },
          {
            "ID": {
              "_schemeID": "BRN",
              "_text": "770625-01-5324"
            }
          },
          {
            "ID": {
              "_schemeID": "SST",
              "_text": "202405123456"
            }
          }
        ],
        "PostalAddress": {
          "CityName": {
            "_text": "JALAN KUCHAI MAJU 13 KUALA LUMPUR"
          },
          "PostalZone": {
            "_text": "58200"
          },
          "CountrySubentityCode": {
            "_text": "14"
          },
          "AddressLine": {
            "Line": {
              "_text": "A-5-8, KUCHAI EXCHANGE, NO. 43,"
            }
          },
          "Country": {
            "IdentificationCode": {
              "_listID": "ISO3166-1",
              "_listAgencyID": "6",
              "_text": "MYS"
            }
          }
        },
        "PartyLegalEntity": {
          "RegistrationName": {
            "_text": "UNIQUE I SDN BHD"
          }
        },
        "Contact": {
          "Telephone": {
            "_text": "+60123456789"
          },
          "ElectronicMail": {
            "_text": "EUGENIU@gmail.com"
          }
        }
      }
    },
    "PaymentTerms": {
      "Note": {
        "_text": "Bank trans 60 days in. date EM"
      }
    },
    "TaxTotal": {
      "TaxAmount": {
        "_currencyID": "MYR",
        "_text": "0.00"
      },
      "TaxSubtotal": {
        "TaxableAmount": {
          "_currencyID": "MYR",
          "_text": "630.00"
        },
        "TaxAmount": {
          "_currencyID": "MYR",
          "_text": "0.00"
        },
        "Percent": {
          "_text": "0.00"
        },
        "TaxCategory": {
          "ID": {
            "_text": "06"
          },
          "TaxScheme": {
            "ID": {
              "_schemeID": "UN/ECE 5153",
              "_schemeAgencyID": "6",
              "_text": "OTH"
            }
          }
        }
      }
    },
    "LegalMonetaryTotal": {
      "LineExtensionAmount": {
        "_currencyID": "MYR",
        "_text": "630.00"
      },
      "TaxExclusiveAmount": {
        "_currencyID": "MYR",
        "_text": "630.00"
      },
      "TaxInclusiveAmount": {
        "_currencyID": "MYR",
        "_text": "630.00"
      },
      "PayableAmount": {
        "_currencyID": "MYR",
        "_text": "630.00"
      }
    },
    "InvoiceLine": [
      {
        "ID": {
          "_text": "1"
        },
        "InvoicedQuantity": {
          "_unitCode": "PCE",
          "_text": "0.000"
        },
        "LineExtensionAmount": {
          "_currencyID": "MYR",
          "_text": "0.00"
        },
        "TaxTotal": {
          "TaxAmount": {
            "_currencyID": "MYR",
            "_text": "0.00"
          },
          "TaxSubtotal": {
            "TaxableAmount": {
              "_currencyID": "MYR",
              "_text": "0.00"
            },
            "TaxAmount": {
              "_currencyID": "MYR",
              "_text": "0.00"
            },
            "Percent": {
              "_text": "0.00"
            },
            "TaxCategory": {
              "ID": {
                "_text": "06"
              },
              "TaxScheme": {
                "ID": {
                  "_schemeID": "UN/ECE 5153",
                  "_schemeAgencyID": "6",
                  "_text": "OTH"
                }
              }
            }
          }
        },
        "Item": {
          "Description": {
            "_text": "GG0854SK-004 56 Sunglass WOMAN INJECTION"
          },
          "CommodityClassification": {
            "ItemClassificationCode": {
              "_listID": "CLASS",
              "_text": "017"
            }
          }
        },
        "Price": {
          "PriceAmount": {
            "_currencyID": "MYR",
            "_text": "630.00"
          }
        },
        "ItemPriceExtension": {
          "Amount": {
            "_currencyID": "MYR",
            "_text": "0.00"
          }
        }
      }
    ]
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://einvoice-api.beaconx.com.my/einvoices/create/store3' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Invoice": {
        "ID": {
            "_text": "9000000488"
        },
        "IssueDate": {
            "_text": "2025-01-20"
        },
        "IssueTime": {
            "_text": "09:40:19Z"
        },
        "InvoiceTypeCode": {
            "_listVersionID": "1.0",
            "_text": "01"
        },
        "DocumentCurrencyCode": {
            "_text": "MYR"
        },
        "BillingReference": {
            "AdditionalDocumentReference": {
                "ID": {
                    "_text": "9000000488"
                }
            }
        },
        "AdditionalDocumentReference": {
            "ID": {
                "_text": "DDP"
            }
        },
        "AccountingSupplierParty": {
            "Party": {
                "IndustryClassificationCode": {
                    "_name": "Keye MY10TEST2",
                    "_text": "01113"
                },
                "PartyIdentification": [
                    {
                        "ID": {
                            "_schemeID": "TIN",
                            "_text": "C25323854040"
                        }
                    },
                    {
                        "ID": {
                            "_schemeID": "BRN",
                            "_text": "C25323854040"
                        }
                    },
                    {
                        "ID": {
                            "_schemeID": "SST",
                            "_text": "NA"
                        }
                    },
                    {
                        "ID": {
                            "_schemeID": "TTX",
                            "_text": "NA"
                        }
                    }
                ],
                "PostalAddress": {
                    "CityName": {
                        "_text": "Petaling Jaya"
                    },
                    "PostalZone": {
                        "_text": "47800"
                    },
                    "CountrySubentityCode": {
                        "_text": "10"
                    },
                    "AddressLine": {
                        "Line": {
                            "_text": "Jalan PJU 7/6 , Mutiara Damansara 10"
                        }
                    },
                    "Country": {
                        "IdentificationCode": {
                            "_listID": "ISO3166-1",
                            "_listAgencyID": "6",
                            "_text": "MYS"
                        }
                    }
                },
                "PartyLegalEntity": {
                    "RegistrationName": {
                        "_text": "Kering Eyewear Malaysia Sdn Bhd"
                    }
                },
                "Contact": {
                    "Telephone": {
                        "_text": "+60TBD"
                    },
                    "ElectronicMail": {
                        "_text": "TBD@TBD.com"
                    }
                }
            }
        },
        "AccountingCustomerParty": {
            "Party": {
                "PartyIdentification": [
                    {
                        "ID": {
                            "_schemeID": "TIN",
                            "_text": "IG56003500071"
                        }
                    },
                    {
                        "ID": {
                            "_schemeID": "BRN",
                            "_text": "770625-01-5324"
                        }
                    },
                    {
                        "ID": {
                            "_schemeID": "SST",
                            "_text": "202405123456"
                        }
                    }
                ],
                "PostalAddress": {
                    "CityName": {
                        "_text": "JALAN KUCHAI MAJU 13 KUALA LUMPUR"
                    },
                    "PostalZone": {
                        "_text": "58200"
                    },
                    "CountrySubentityCode": {
                        "_text": "14"
                    },
                    "AddressLine": {
                        "Line": {
                            "_text": "A-5-8, KUCHAI EXCHANGE, NO. 43,"
                        }
                    },
                    "Country": {
                        "IdentificationCode": {
                            "_listID": "ISO3166-1",
                            "_listAgencyID": "6",
                            "_text": "MYS"
                        }
                    }
                },
                "PartyLegalEntity": {
                    "RegistrationName": {
                        "_text": "UNIQUE I SDN BHD"
                    }
                },
                "Contact": {
                    "Telephone": {
                        "_text": "+60123456789"
                    },
                    "ElectronicMail": {
                        "_text": "EUGENIU@gmail.com"
                    }
                }
            }
        },
        "PaymentTerms": {
            "Note": {
                "_text": "Bank trans 60 days in. date EM"
            }
        },
        "TaxTotal": {
            "TaxAmount": {
                "_currencyID": "MYR",
                "_text": "0.00"
            },
            "TaxSubtotal": {
                "TaxableAmount": {
                    "_currencyID": "MYR",
                    "_text": "630.00"
                },
                "TaxAmount": {
                    "_currencyID": "MYR",
                    "_text": "0.00"
                },
                "Percent": {
                    "_text": "0.00"
                },
                "TaxCategory": {
                    "ID": {
                        "_text": "06"
                    },
                    "TaxScheme": {
                        "ID": {
                            "_schemeID": "UN/ECE 5153",
                            "_schemeAgencyID": "6",
                            "_text": "OTH"
                        }
                    }
                }
            }
        },
        "LegalMonetaryTotal": {
            "LineExtensionAmount": {
                "_currencyID": "MYR",
                "_text": "630.00"
            },
            "TaxExclusiveAmount": {
                "_currencyID": "MYR",
                "_text": "630.00"
            },
            "TaxInclusiveAmount": {
                "_currencyID": "MYR",
                "_text": "630.00"
            },
            "PayableAmount": {
                "_currencyID": "MYR",
                "_text": "630.00"
            }
        },
        "InvoiceLine": [
            {
                "ID": {
                    "_text": "1"
                },
                "InvoicedQuantity": {
                    "_unitCode": "PCE",
                    "_text": "0.000"
                },
                "LineExtensionAmount": {
                    "_currencyID": "MYR",
                    "_text": "0.00"
                },
                "TaxTotal": {
                    "TaxAmount": {
                        "_currencyID": "MYR",
                        "_text": "0.00"
                    },
                    "TaxSubtotal": {
                        "TaxableAmount": {
                            "_currencyID": "MYR",
                            "_text": "0.00"
                        },
                        "TaxAmount": {
                            "_currencyID": "MYR",
                            "_text": "0.00"
                        },
                        "Percent": {
                            "_text": "0.00"
                        },
                        "TaxCategory": {
                            "ID": {
                                "_text": "06"
                            },
                            "TaxScheme": {
                                "ID": {
                                    "_schemeID": "UN/ECE 5153",
                                    "_schemeAgencyID": "6",
                                    "_text": "OTH"
                                }
                            }
                        }
                    }
                },
                "Item": {
                    "Description": {
                        "_text": "GG0854SK-004 56 Sunglass WOMAN INJECTION"
                    },
                    "CommodityClassification": {
                        "ItemClassificationCode": {
                            "_listID": "CLASS",
                            "_text": "017"
                        }
                    }
                },
                "Price": {
                    "PriceAmount": {
                        "_currencyID": "MYR",
                        "_text": "630.00"
                    }
                },
                "ItemPriceExtension": {
                    "Amount": {
                        "_currencyID": "MYR",
                        "_text": "0.00"
                    }
                }
            }
        ]
    }
}'

Responses

🟢200Success

application/json

Body

array of:

invoice_number

string

optional

Invoice Number of Document

reference_number

string

optional

Reference Number of Document. Must be unique globally.

pos_id

string

optional

Point of Sale Terminal ID

status

string

optional

Valid - Validated with LHDN. This reflects an actual status in LHDN as Cancelled as well.
Invalid - Failed validation. This reflects an actual status in LHDN as Cancelled as well.
InProgress - Pending status update from LHDN
Submitted - Submitted to LHDN. This reflects an actual status in LHDN as Cancelled as well.
InQueue - Pending to be submitted to LHDN
PendingApproval - On Hold until user manually approves it to be submitted to LHDN
Void - The document is in a void status.
Draft - The document is in a draft mode. (This can only happen if document is created manually via UI and saved as Draft)
Cancelled - The document is in a Cancelled status. This reflects an actual status in LHDN as Cancelled as well.

issued_at

string

optional

Date of document

outlet_code

string

optional

Outlet Code

currency_code

string

optional

currency_rate

integer

optional

seller

object

optional

tin

string

required

name

string

required

string

required

address

string

required

city

string

required

postcode

string

required

state

string

required

contact

string

required

id_number

string

required

sst_number

string

required

ttx_number

string

required

buyer

object

optional

tin

string

required

name

string

required

string

required

address

string

required

city

string

required

postcode

string

required

state

string

required

contact

string

required

id_number

string

required

sst_number

string

required

membership_id

string

required

items

array [object {10}]

optional

integer

required

quantity

integer

required

subtotal

number

required

unit_price

number

required

description

string

required

measurement

string

required

discount_rate

integer

required

total_excl_tax

number

required

total_incl_tax

number

required

discount_amount

integer

required

quantity

integer

optional

sub_total

number

optional

discount_amount

integer

optional

total_excl_tax

number

optional

service_charge_rate

integer

optional

service_charge_amount

integer

optional

sst_rate

number

optional

sst_amount

number

optional

total_incl_tax

number

optional

rounding

number

optional

total

integer

optional

Examples

Needs AttentionSuccessRejected

{
  "status": "OK",
  "message": "",
  "data": {
    "attention": [
      {
        "reference_number": "10050",
        "payload": {
          "buyer": {
            "code": null,
            "id_type": "BRN",
            "tin": "C61901366810",
            "id_number": "201903007118",
            "name": "MEDHURST, GRIMES AND SIPES SDN. BHD.",
            "email": "kendall.purdy@reilly.net",
            "address1": "72684 Murl Light Apt. 668",
            "address2": null,
            "address3": null,
            "city": "Lake Tedfort",
            "postcode": "29311",
            "state": "01",
            "country": "MYS",
            "sst_number": "W10-1060-26389071",
            "phone": "0125168978",
            "membership_id": null,
            "is_foreign": "false"
          },
          "shipping": {
            "code": null,
            "id_type": null,
            "tin": null,
            "id_number": null,
            "name": null,
            "email": null,
            "address1": null,
            "address2": null,
            "address3": null,
            "city": null,
            "postcode": null,
            "state": null,
            "country": "MYS"
          },
          "annex": {
            "custom_form_number": null,
            "incoterms": null,
            "fta": null,
            "certified_exporter_number": null,
            "custom_k2_number": null,
            "other_charges_description": null,
            "other_charges_amount": null
          },
          "status": "valid",
          "source": "ERP",
          "type": "01",
          "reference_number": "10050",
          "invoice_number": "INV/6990761",
          "original_einvoice_reference_number": null,
          "po_number": "PO/8555",
          "pos_id": null,
          "issued_at": "2024-04-10",
          "outlet_code": "HQ",
          "currency_code": "MYR",
          "currency_rate": null,
          "frequency": null,
          "billing_period_start": null,
          "billing_period_end": null,
          "subtotal": "447.92",
          "discount_rate": "0",
          "discount_amount": "0",
          "total_excl_tax": "447.92",
          "sales_tax_amount": "0",
          "service_tax_amount": "35.83",
          "gst_amount": "0",
          "ttx_amount": "0",
          "hvgt_amount": "0",
          "lvst_amount": "0",
          "total_tax_amount": "35.83",
          "total_incl_tax": "483.75",
          "service_fee_rate": "0",
          "service_fee_amount": "0",
          "rounding": "0",
          "total_payable_amount": "483.75",
          "payment_mode": null,
          "suppliers_bank_account_number": null,
          "payment_terms": null,
          "prepayment_amount": null,
          "prepayment_datetime": null,
          "prepayment_reference_number": null,
          "bill_reference_number": null,
          "items": [
            {
              "id": "1",
              "classification": "022",
              "product_tariff_code": null,
              "code": "123",
              "description": "ullam et ex qui",
              "long_description": "ullam et ex qui ullam et ex qui ullam et ex qui \n ullam et ex qui",
              "quantity": "8",
              "measurement": "UNIT",
              "unit_price": "55.99",
              "subtotal": "447.92",
              "discount_rate": "0",
              "discount_amount": "0",
              "fee_rate": "0.00",
              "fee_amount": "0",
              "charge_rate": "0",
              "charge_amount": "0.00",
              "total_excl_tax": "447.92",
              "sales_tax_rate": "0",
              "sales_tax_amount": "0",
              "service_tax_rate": "0.08",
              "service_tax_amount": "35.83",
              "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": "483.75",
              "details_tax_exemption": null,
              "exempt_tax_amount": null,
              "country_of_origin": null
            }
          ]
        },
        "lhdn_uin": "",
        "lhdn_validated_at": "",
        "lhdn_long_id": "",
        "id": "9c0d00a3-3515-4857-8329-9925e58e2703",
        "internal_error_message": "[\"The supplier field is required.\",\"The supplier.id type field is required.\",\"The supplier.tin field is required.\",\"The supplier.id number field is required.\",\"The supplier.name field is required.\",\"The supplier.email field is required.\",\"The supplier.address1 field is required.\"]"
      }
    ],
    "in_queue": [],
    "rejected": []
  }
}