Project

General

Profile

Specification » History » Revision 16

Revision 15 (Soh Keong, 06/05/2024 11:57 AM) → Revision 16/73 (Soh Keong, 06/06/2024 10:11 AM)

{{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, List<InvoiceSubmissionRequestBean> beanList); 
 </pre> 

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

 # *conn*             - Database connection. 
 # *beanList*         - InvoiceSubmissionRequestBean List. 
 > * *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*  

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

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

 > * *productList* 
 > ** *productName*          - Max length : 300 
 > ** *productCode*          - Max length :    18 
 > ** *measurement*          - 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* 
 > *** *percent* 
 > *** *perUnitAmount* 
 > *** *measurement* 
 > *** *quantity* 
 > *** *netAmount* 
 > *** *tax* 

   3. *responseBean* 

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


 h3. queryEInvoice 

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

 # *conn*             - Database connection. 
 # *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* 

 h3. cancelEInvoice 

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

 # *conn*             - Database connection. 
 # *bean*             - Object. 
 > * *cancelCode*     - CommonConstant.CANCEL_CODE_*  
 > * *cancelReason* - (Mandatory for CommonConstant.CANCEL_CODE_OTHERS)  
 > * *invoiceIds* - List of Integer 

   3. *responseBean* 

 > * *success* - true / false