• Table of contents
• Specification
• Programming Guide
  • Jar version
  • Jar File Download
    • Classes
    • properties file
  • Aisino Service
    • submitEInvoice
    • queryEInvoice
    • cancelEInvoice
  • CommonConstant

Specification¶

Programming Guide¶

Jar version¶

version	Description
1.0	Init

Jar File Download¶

Jar
"Properties":

Classes¶

• my.aisino.einvoice.bean
• my.aisino.einvoice.bean.transaction
• my.aisino.einvoice.constant
• my.aisino.einvoice.service
• my.aisino.einvoice.util

properties file¶

• service.properties

1. merchant.id -

Aisino Service¶

my.aisino.einvoice.service.TransactionService service = new my.aisino.einvoice.service.TransactionService();

submitEInvoice¶

InvoiceSubmissionResponseBean responseBean = service.submitEInvoice(Connection conn, List<InvoiceSubmissionRequestBean> beanList);

CommonConstant = my.aisino.einvoice.constant.CommonConstant

1. conn - Database connection.
2. beanList - InvoiceSubmissionRequestBean List.

• docCode - From Keys (TAX_DOC_SUMMARY)
• orderId
• orderDate - Format(yyyy-MM-dd)
• orderTime - Format(HH:mm:ssZ)
• originalOrderId - For Credit Note/ Debit Note/ Refund Note
• orderTypeCode - CommonConstant.INVOICE_TYPE_CODE_* (https://sdk.myinvois.hasil.gov.my/codes/e-invoice-types/)
• currencyCode - CommonConstant.CURRENCY_CODE_* (https://sdk.myinvois.hasil.gov.my/codes/currencies/)
• totalExcludingTax
• totalIncludingTax
• totalPayableAmount
• businessSystem - CommonConstant.BUSINESS_SYSTEM_*

• supplierBean
  • addressBean
    • country - CommonConstant.COUNTRY_* (https://sdk.myinvois.hasil.gov.my/codes/countries/)
    • state - CommonConstant.STATE_* (https://sdk.myinvois.hasil.gov.my/codes/state-codes/)
    • city - Max length : 50
    • postal - Max length : 50
    • address1 - Max length : 150
    • address2 - Max length : 150
    • address3 - Max length : 150
  • contactNumber - Max length : 20
  • name - Max length : 300
  • registrationBean
    • tin
    • regSchemeId - CommonConstant.ID_TYPE_*
    • regNo
    • sst (Optional)
    • msic - https://sdk.myinvois.hasil.gov.my/codes/msic-codes/

• buyerBean
  • buyerCode - From keys (TAX_DOC_BUYER)
  • addressBean
    • country - CommonConstant.COUNTRY_* (https://sdk.myinvois.hasil.gov.my/codes/countries/)
    • state - CommonConstant.STATE_* (https://sdk.myinvois.hasil.gov.my/codes/state-codes/)
    • city - Max length : 50
    • address1 - Max length : 150
    • address2 - Max length : 150
    • address3 - Max length : 150
  • contactNumber - Max length : 20
  • name - Max length : 300
  • email
  • registrationBean
    • tin
    • regSchemeId - CommonConstant.ID_TYPE_*
    • regNo
    • sst (Optional)

• productList
  • docLineCode - From Keys (TAX_DOC_DETAIL)
  • productName - Max length : 300
  • productCode - Max length : 18
  • measurement (Optional) - CommonConstant.MEASUREMENT_* (https://sdk.myinvois.hasil.gov.my/codes/unit-types/)
  • quantity (Optional)
  • totalExcludingTax
  • unitPrice
  • subtotal
  • classificationList
    • code - CommonConstant.CLASSIFICATION_CODE_* (https://sdk.myinvois.hasil.gov.my/codes/classification-codes/)
    • group - CommonConstant.CLASSIFICATION_GROUP_*
  • taxTotalBean
    • totalTaxAmount
    • taxSubTotalList
      • taxType - CommonConstant.TAX_TYPE_* (https://sdk.myinvois.hasil.gov.my/codes/tax-types/)
      • percent (Optional)
      • perUnitAmount (Optional)
      • measurement (Optional) - CommonConstant.MEASUREMENT_* (https://sdk.myinvois.hasil.gov.my/codes/unit-types/)
      • quantity (Optional)
      • netAmount (Optional)
      • tax

• taxTotalBean
  • totalTaxAmount
  • taxSubTotalList
    • taxType - CommonConstant.TAX_TYPE_* (https://sdk.myinvois.hasil.gov.my/codes/tax-types/)
    • percent - Optional
    • perUnitAmount - Optional
    • measurement - Optional
    • quantity - Optional
    • netAmount - Optional
    • tax -

3. responseBean

• submissionUid
• acceptedDocumentList
  • orderId
  • uuid
• rejectedDocumentList
  • orderId
  • errorList
    • code
    • message

queryEInvoice¶

InvoiceInquiryResponseBean responseBean = service.queryEInvoice(Connection conn, InvoiceInquiryRequestBean bean);

1. conn - Database connection.
2. bean - Object.

• documentNum
• submissionUid
• invoiceUuid
• invoiceTypeCode
• buyerTin
• buyerName
• supplierTin
• supplierName
• totalAmountFrom
• totalAmountTo
• invoiceStatus
• confirmStatusCode
• issuedDateFrom
• issuedDateTo
• pageIndex (Mandatory)
• pageSize (Mandatory)

3. responseBean

• page
  • pageCount
  • pageNo
  • pageSize
  • totalSize

• recordList
  • buyerTin
  • confirmStatusCode
  • currency
  • description
  • documentNum
  • excludingTaxAmount
  • includingTaxAmount
  • invoiceId
  • invoiceStatus
  • invoiceTypeCode
  • invoiceUuid
  • issuedDate
  • nowTime
  • operationDate
  • operator
  • pageIndex
  • pageNo
  • pageSize
  • supplierTin
  • supplierName
  • submissionUid
  • transactionId

cancelEInvoice¶

InvoiceCancelResponseBean responseBean = service.cancelEInvoice(InvoiceCancelRequestBean bean);

1. conn - Database connection.
2. bean - Object.

• cancelCode - CommonConstant.CANCEL_CODE_*
• cancelReason - (Mandatory for CommonConstant.CANCEL_CODE_OTHERS)
• invoiceIds - List of Integer

3. responseBean

• success - true / false

CommonConstant¶

Name	values
INTERFACE_	LOGIN, INVOICE_ISSUANCE, INVOICE_INQUIRY, INVOICE_CANCEL, INVOICE_PURCHASE_INQUIRY, INVOICE_PURCHASE_REJECT