Project

General

Profile

Specification » History » Revision 10

Revision 9 (Soh Keong, 05/29/2024 11:16 AM) → Revision 10/73 (Soh Keong, 05/29/2024 12:14 PM)

{{toc}} 

 h1. Specification 

 h1. Programming Guide 

 h2. Jar version  

 |_. version |_. Description                                  | 
 | 1.0         | Init                                           | 

 h2. Jar File Download 

 "Jar": 
 "Properties": 

 h3. Classes 

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

 h3. properties file 

 * *service.properties* 

 # *merchant.id*         - 

 h2. Aisino Service 

 <pre> 
 my.aisino.einvoice.service.TransactionService service = new my.aisino.einvoice.service.TransactionService(); 
 </pre> 

 h3. submitEInvoice 

 <pre> 
 InvoiceSubmissionResponseBean responseBean = service.submitEInvoice(Connection conn, InvoiceSubmissionRequestBean bean); 
 </pre> 

 <pre> 
 CommonConstant = my.aisino.einvoice.constant.CommonConstant 
 </pre> 

 # *conn*             - Database connection. 
 # *bean*             - Object. 
 > * *orderId* 
 > * *orderDate*       - Format(yyyy-MM-dd) 
  
 > * *orderTime*       - Format(HH:mm:ssZ) 
  
 > * *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*  

 > * *buyerBean*  
 > ** *address*  
 > *** *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 
  
 > ** *registrationList* 
 > *** *brn*        (Optional) 
 > *** *tin*        (Optional) 
 > *** *nric*       (Optional) 
 > *** *passport* (Optional) 
 > *** *army*       (Optional) 
 > *** *sst*        (Optional) 

 > * *productList* 
 > ** *productName* - Max length : 300 
 > ** *productCode* - Max length :    18 
 > ** *measurement* - CommonConstant. (https://sdk.myinvois.hasil.gov.my/codes/unit-types/) 
 > ** *quantity*    (Optional)  
 > ** *totalExcludingTax* 
 > ** *unitPrice* 
 > ** *subtotal* 
 > ** *classificationList* 
 > *** *code* 
 > *** *group* 
 > ** *taxTotalBean* 
 > *** *totalTaxAmount* 
 > *** *taxSubTotalList* 
 > **** *taxType* 
 > **** *percent*            (Optional) 
 > **** *perUnitAmount*      (Optional) 
 > **** *baseUnitMeasure*    (Optional) 
 > **** *netAmount*          (Optional) 
 > **** *tax* 

 > * *taxTotalBean* 
 > ** *totalTaxAmount* 
 > ** *taxSubTotalList* 
 > *** *taxType* 
 > *** *percent* 
 > *** *perUnitAmount* 
 > *** *baseUnitMeasure* 
 > *** *netAmount* 
 > *** *tax* 

   3. *responseBean* 

 > * *submissionUid* 
 > * *acceptedDocumentList* 
 > ** *orderId* 
 > ** *uuid* 
 > * *rejectedDocumentList* 
 > ** *orderId* 
 > ** *errorList* 
 > *** *code* 
 > *** *message* 


 h3. queryEInvoice queryInvoice 

 <pre> 
 InvoiceInquiryResponseBean responseBean = service.queryEInvoice(Connection service.queryInvoice(Connection conn, InvoiceInquiryRequestBean bean); 
 </pre> 

 # *conn*             - Database connection. 
 # *bean*             - Object. 
 > * *documentNum* 
 > * *submissionUid* 
 > * *invoiceUuid* 
 > * *invoiceTypeCode* 
 > * *buyerTin* 
 > * *buyerName* 
 > * *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* 
 > ** *submissionUid* 
 > ** *transactionId* 

 h3. cancelEInvoice 

 <pre> 
 InvoiceCancelResponseBean responseBean = service.cancelEInvoice(InvoiceCancelRequestBean bean); 
 </pre> 

 # *conn*             - Database connection. 
 # *bean*             - Object. 
 > * *cancelCode* 
 > * *cancelReason* 
 > * *invoiceIds* - List of Integer 

   3. *responseBean* 

 > * *success* - true / false