• 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);
InvoiceSubmissionResponseBean responseBean = service.submitEInvoice(Connection conn, List<InvoiceSubmissionRequestBean> beanList, boolean insertTable);

CommonConstant = my.aisino.einvoice.constant.CommonConstant

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

• docCode - From Keys (TAX_DOC_SUMMARY)
• issueMode - CommonConstant.ISSUE_MODE_EINVOICE_* (YES=e-invoice; NO=consolidate)
• 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
RETURN_CODE_	SUCCESS, ABNORMAL
INVOICE_STATUS_	VALID, INVALID, CANCELLED, SUBMITTED
CONFIRM_STATUS_CODE_	AWAITING, ACCEPTED, REJECTED
CANCEL_CODE_	WRONG_BUYER, WRONG_INVOICE, OTHERS
INVOICE_TYPE_CODE_	INVOICE, CREDIT_NOTE, DEBIT_NOTE, REFUND_NOTE, SELF_BILLED_INVOICE, SELF_BILLED_CREDIT_NOTE, SELF_BILLED_DEBIT_NOTE, SELF_BILLED_REFUND_NOTE
TAX_DOC_STATUS_	PENDING, VERIFIED, SUCCESS, FAIL, REJECT, DELETED
CURRENCY_CODE_	MALAYSIA_RINGGIT
COUNTRY_	MALAYSIA, SINGAPORE, BRUNEI_DARUSSALAM, THAILAND, INDONESIA, TAIWAN
COUNTRY_CODE_	MALAYSIA, SINGAPORE, BRUNEI_DARUSSALAM, THAILAND, INDONESIA, TAIWAN
STATE_	ALL, JOHOR, KEDAH, KELANTAN, MELAKA, NEGERI_SEMBILAN, PAHANG, PULAU_PENANG, PERAK, PERLIS, SELANGOR, TERRENGANU, SABAH, SARAWAK, WILAYAH_PERSEKUTUAN_KUALA_LUMPUR, WILAYAH_PERSEKUTUAN_LABUAN, WILAYAH_PERSEKUTUAN_PUTRAJAYA, NOT_APPLICABLE
MEASUREMENT_	METRE, CENTIMETRE, KILOMETRE, LITRE, KILOGRAM, GRAM
CLASSIFICATION_REF_NO_	CONSOLIDATED, OTHERS, VOUCHER_GIFT_CARD
CLASSIFICATION_CODE_	CONSOLIDATED, ECOMMERCE_TO_BUYER, ECOMMERCE_SELF_BILLED_TO_SELLER, OTHERS, CLASSIFICATION_CODE_SELF_BILLED_OTHERS, CLASSIFICATION_CODE_SELF_BILLED_MONETARY_PAYMENT_TO_AGENTS, CLASSIFICATION_CODE_VOUCHER_GIFT_CARD
CLASSIFICATION_GROUP_	CLASS, PRODUCT_TARIFF_CODE
TAX_TYPE_	SALES, SERVICE, TOURISM, HIGH_VALUE_GOODS, LOW_VALUE_GOODS, NOT_APPLICABLE, TAX_EXEMPTION
ID_TYPE_	BRN, NRIC, PASSPORT, ARMY
TIN_	GENERAL_PUBLIC, FOREIGN_BUYER, FOREIGN_SUPPLIER, BUYER
ENTITY_	COSWAY, ECOSWAY, RANK_DISTRIBUTOR, KIMIA_SUCHI, KIMIA_SUCHI_MARKETING, VITAL_DEGREE
	EINVOICE_REQUEST_IND, EXCLUDING_POSTING
BUSINESS_SYSTEM_	SALES, BONUS, HFEE
CONSOLIDATE_INV_IND_	YES, NO
ISSUE_MODE_EINVOICE_	YES, NO
_DEFAULT	BUYER_NAME_DEFAULT, MANDATORY_VALUES_DEFAULT