IncomeTax » aisino

{{toc}}

h1. Specification

h1. Programming Guide

h2. Jar version 

|_. version |_. Description                                |

| 1.0       | Init                                         |

h2. Jar File Download

"Jar":/redmine/attachments/790

"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.

> * *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*

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

h2. CommonConstant

|_. Name     |_. values                                                                                                     |

| INTERFACE_ | LOGIN, INVOICE_ISSUANCE, INVOICE_INQUIRY, INVOICE_CANCEL, INVOICE_PURCHASE_INQUIRY, INVOICE_PURCHASE_REJECT  |