Content Comparison

Table of Contents

minLevel	1
maxLevel	2
outline	false
type	list
printable	false

Base Url: /smartfin/api/v1/wh

Retrieve Warehouse’s Data

...

POST/smartfin/api/v1/wh/select

Retrieve all of the warehouse’s data under the current user

Authentication / Authorization

API Key

Headers

Schema

...

Headers:

Content-Type: application/json

Authorization：

string - JWT <<YOUR_API_KEY_HERE>> (required)

Request

Example:

JSON Body:

Code Block
{}

Response

Example:

Code Block

{
    "error_code": 0,
    "value": {
        "whs": [
            {
                "wh_id": 174,
                "wh_name": "JIJI",
                "update_time": null,
                "update_by": null,
                "create_by": 2,
                "create_time": "2023-11-01 11:50:35",
                "user_id": null,
                "wh_entity": "KIKIK",
                "wh_add": "OOOO",
                "company_id": 119,
                "c_name": "test2",
                "u_name": null
            },
            {
                "wh_id": 165,
                "wh_name": "2",
                "update_time": "2023-08-23 14:31:04",
                "update_by": 65,
                "create_by": 2,
                "create_time": "2023-08-23 14:07:39",
                "user_id": 65,
                "wh_entity": "KKK1",
                "wh_add": "KKK",
                "company_id": 119,
                "c_name": "test2",
                "u_name": "Careers"
            },
        ],
        "dropdown_list": {
            "wh_entity": [
                "KKK1",
                "\u4e2d\u50a8\u65b0\u6e2f",
                "MARK",
                "WAREHOUSE",
                "CAR",
                "KIKIK",
                "TEST",
                "CAR1",
                "4",
                "SALESX",
                "NEW E",
                "LOLOLO1",
                "XX",
                "2",
                "\u5170\u8003\u660c\u76db",
                "DGG",
                "1",
                "HAHA",
                "SALES",
                "34",
                "MARKS",
                "BUY ENTITY",
                "ADMIN",
                "MARKX",
                "KKK"
            ],
            "wh_name": [
                "\u4e2d\u50a8\u65b0\u6e2f",
                "54546",
                "MARK",
                "WAREHOUSE",
                "CAR",
                "NEW NAME",
                "TEST",
                "CAR1",
                "55",
                "4",
                "SALESX",
                "\u9752\u5c9b\u6e2f-\u7eac\u56db\u8def",
                "XX",
                "222",
                "2",
                "\u5170\u8003\u660c\u76db",
                "BUY NAME",
                "1",
                "HAHA",
                "SALES",
                "JIJI",
                "MARKS",
                "MARKX",
                "ADMIN",
                "KKK"
            ],
            "validation": []
        }
    }
}

Schema

...

In whs ,

Code Block
whs - array[object]

An array of object that contains warehouse’s data

Code Block
update_time, u_name, update_by - string

Information about last updated time for the data and the user who updating the data.

Code Block
create_time, c_name, create_by - string

Information about created time for the data and the user who creating the data.

Code Block
user_id, wh_id, company_id - integer

user_id - User Id ( who the data belongs to)
entity_id - A unique ID assigned to the data. This ID can be used to retrieve warehouse data.
company_id - The main company Id for the data.

Code Block
wh_name, wh_entity, wh_add - string

wh_name - Warehouse name
wh_entity - Warehouse Entity
wh_add - Warehouse address

Info

wh_name , wh_entity and wh_add cannot be duplicated,

Eg. wh_name of ‘WAREHOUSE' , wh_entity of ‘ENTITY’ wh_add of 'ADDRESS’ will not allow to be stored if the same wh_name , wh_entity and wh_add has been created in database.

In dropdown_list ,

Code Block
wh_entity , wh_name - array[string]

a list of string that serve as dropdown list for selection purpose.

Code Block
validation - array[string]

a list of validation that been used to indicate the name of array in dropdown_list that is not able to add a new value (it is empty, all of the array are able to update and add a new value

Update / Insert Warehouse Data

...

POST/smartfin/api/v1/wh/upsert

Insert new or update existing warehouse data in database

Authentication / Authorization

API Key

Headers

Schema

...

Headers:

Content-Type: application/json

Authorization：

string - JWT <<YOUR_API_KEY_HERE>> (required)

Request

Example:

JSON Body:

Code Block

{
   "insert_list":[
      {
         "wh_name":"MARK",
         "wh_entity":"TEST1",
         "wh_add":"TEST_ADDRESS",
         "company_id":119
      }
   ],
   "update_list":[
      {
         "wh_id":174,
         "wh_name":"WH_NAME",
         "wh_entity":"TEST2",
         "wh_add":"TESTADD1",
         "company_id":119
      }
   ]
}

Schema

...

Code Block
insert_list - array[object]

Contain the same parameters as whs in response body of https://mafint.atlassian.net/wiki/spaces/MAD/pages/2128248833/Warehouses#Retrieve-Warehouse%E2%80%99s-Data ( Refer to the definition of each parameter )
wh_id does not need to be parsed and not required in this array
Consists of new warehouse data to be inserted into database.

Code Block
update_list - array[object]

Contain the same parameters as whs in response body of https://mafint.atlassian.net/wiki/spaces/MAD/pages/2128248833/Warehouses#Retrieve-Warehouse%E2%80%99s-Data ( Refer to the definition of each parameter )
Consists of existing warehouse data to be updated into database.

Warning

Insert process would fail if there is an existing warehouse with the same wh_name, wh_entity and same wh_name

Update process would fail if there is an existing warehouse with the same wh_name, wh_entity and same wh_name

Response:

Same as the response body from https://mafint.atlassian.net/wiki/spaces/MAD/pages/2128248833/Warehouses#Retrieve-Warehouse%E2%80%99s-Data ( Refer to the definition of each parameter )

Delete Warehouse Data

...

DELETE/smartfin/api/v1/wh/delete

Deletes single / multiple warehouse data according to its wh_id

Authentication / Authorization

API Key

Headers

Schema

...

Headers:

Content-Type: application/json

Authorization：

string - JWT <<YOUR_API_KEY_HERE>> (required)

Request

Example:

JSON Body:

Code Block
{ "del_ids":[109] }

Code Block
del_ids - array[integer]

An array that consists of unique wh_id, that user would like to delete from.

Response:

Same as the response body from https://mafint.atlassian.net/wiki/spaces/MAD/pages/2128248833/Warehouses#Retrieve-Warehouse%E2%80%99s-Data ( Refer to the definition of each parameter )

Version	Old Version 1	New Version Current
Changes made by	Kook Siong Then	Kook Siong Then
Saved on	Nov 02, 2023	Nov 16, 2023

Content Comparison

Versions Compared

Key

Base Url: /smartfin/api/v1/wh

Retrieve Warehouse’s Data

POST/smartfin/api/v1/wh/select

Authentication / Authorization

Headers

Request

Response

Update / Insert Warehouse Data

POST/smartfin/api/v1/wh/upsert

Authentication / Authorization

Headers

Request

Response:

Delete Warehouse Data

DELETE/smartfin/api/v1/wh/delete

Authentication / Authorization

Headers

Request

Response: