1.0 INTRODUCTION

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.

2.0 SENDING JSON CONTENT TO AMS API

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.

3.0 TESTING JSON CONTENT TO AMS API USING POSTMAN 3.0

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.

Contact Us

Netiquette Software PTE LTD
11 Woodlands Close #06-33,
Woodlands 11, Singapore 737853

Sales & Support +65 6223 1157
Fax +65 6422 1169


More>>

Follow Us On