End User Guide

Netiquette Accounting Management System accelerates your financial close, by providing a strong expense management, offering streamlined and auditable revenue management and ensures complete real-time visibility into the financial performance of the business.

Netiquette Accounting Management System seamlessly integrates with Netiquette Inventory Management to streamline critical business processes, such as quote-to-cash, enabling everyone to work from a single source of finance, sales and customer data.

To use Netiquette’s Inventory Management System (AMS)’s cloud service, a client must first gain authentication pass into our system. The following steps will highlight all the required steps.

1. Provide your company id and IP address by emailing to support@netiquette.com.sg.

2. Netiquette will generate symmetric keys (Eg: 1Y5iye5OwWj/Wpg7WR/PjA==) for each company.

3. The registered IP address can then proceed to use our AMS cloud services by sending JSON request to the web server.

4. The clienttempid will be automatically generated and encrypted into the handshake id using AES-128 bit (Advanced Encryption Standard) as specified by the NIST (National Institution of Standards and Technology) under FIPS-197. Both clienttempid and handshake id will be used as user authentication and will be inserted along with the JSON request.

5. The format of a sample JSON request is as follows:

   {"hsp":"EE3E9DE465D66D38DA6437A76DBB3DB3","comid":"demo","accno":"demo1234","date":"2015-9-14","amt":"0.00","fcamt":"0.00","batchno":"abc12","execrate ":"1","reference":"demo","reference2":"demo","taxcode":"","taxper":"","desp":"","desp2":"","tranid":"j8001","clienttempid":"1234"}

   No	Consume Data Details	Field ID/ Name	Description
   1	Handshake ID	hsp	The encrypted string produced by clienttempid.
   2	Company ID	comid	The company id is generated by Netiquette to identify each registered company.
   3	Account No	accountno	Refer "GET ACCOUNT" tab in documentation
   4	Date	date
   5	Amount	amt	In local currency only and debit will be positive value and credit will be in negative value
   6	Foreign Amount	fcamt	In foreign currency only and debit will be positive value and credit will be in negative value
   7	Batch No	batchno
   8	Exchange Rate	execrate	Put 1 for local currency
   9	Reference Number 1	reference
   10	Reference Number 2	reference2
   11	Tax Code	taxcode	Empty if not tax account.
   12	Tax Percentage	taxper	Zero if not tax account
   13	Description 1	desp
   14	Description 2	desp
   15	Transaction ID	tranid	Only when send to ledger if one set of transaction id is tally
   16	Client Temp ID	clienttempid	This is the user generated id used to identify and authenticate the user.

6. In the above content example, the handshake id is “EE3E9DE465D66D38DA6437A76DBB3DB3” while the client temporary id is “1234”.

7. The web server will then pass the request to the application server to be processed. Note that all the communication will be only established on at least 256 bit SSL encryption.

8. Upon successful processing, the application server will generate an appropriate response content. A sample response content is shown and explained below.

   {"status":"Success","detail":"","entry":"","clienttempid":1234}

   No	Response Data Details	Field ID/ Name	Description
   1	Status	status	Shows the status of the request. Can be either “Success” or “Failure”
   2	Detail	detail	The error messages returned upon failure.
   3	Entry No	entry	Unique ID for each entry
   4	Client Temp ID	clienttempid	This is the user generated id used to identify and authenticate the user.

9. The web server will then pass back the response content back to the client.

In this example, we will be using Postman 3.0 for sending a sample request JSON request to the AMS API server.

1. Download Postman 3.0 extension for your Google Chrome browser.

   

2. A popup alert will ask your permission to add this application. Press “Add app”

   

3. Once the installations has finished, you can launch the app by either accessing the Google App Launcher from your desktop or from your Google Chrome Browser.

   

4. At the app login page, you can choose either to login using your Google Account or simple press “Go to the app” to directly use the app. You can also register for account on the same page.

   

5. On the main page of Postman, copy and paste the link https://crm.netiquette.com.sg/api/balcheck.cfm into the url section. Change the method to “POST”

   

6. Next go to the “Body” tab section of the application, change the request data type to “raw”. Paste the following JSON request to the textfield.

   {"hsp":"EE3E9DE465D66D38DA6437A76DBB3DB3","comid":"demo","accno":"demo1234","date":"2015-9-14","amt":"0.00","fcamt":"0.00","batchno":"abc12","execrate ":"1","reference":"demo","reference2":"demo","taxcode":"","taxper":"","desp":"","desp2":"","tranid":"j8001","clienttempid":"1234"}

   

7. Press “Send”. The sample result will be shown as follows:

   {"status":"Success","detail":"","entry":"","clienttempid":1234}

   

   As shown on the result, the sent request content returns an error content message because the Handshake ID is not valid.