Customer

API ระบบลูกค้า

• Customer List
• Customer Info
• Add Customer
• data-validate

Customer List

แสดงข้อมูลลูกค้าทีละหลาย ๆ รายการ

EndPoint

GET /SMLJavaRESTService/v3/api/customer

Parameter:

Request Header:

Required SMLRequestHeader

Query Parameter:

Name	Description	default
page	หน้าที่ต้องการแสดงข้อมูล	1
size	จำนวนรายการต่อ 1 หน้า	20

example:

GET http://localhost:8086/SMLJavaRESTService/v3/api/customer?page=1&size=2

Response Success:

HTTP Status : 200

Field Name	Description	Example
success	สถานะการดำเนินการ	true
data	รายละเอียดข้อมูลลูกค้า	Customer Data Object
pages	รายละเอียดหน้าข้อมูล	Pageable Data Object

example:

{
  "success": true,
  "data": [
    {
      "code": "AR001",
      "name": "บริษัท ทดสอบ จำกัด",
      "status": 0,
      "latitude": 0,
      "longitude": 0,
      "branch_status": 0,
      "branch_code": "",
      "tax_id": "",
      "sale_code": "",
      "area_code": "",
      "credit_status": 0,
      "credit_day": 0,
      "credit_money": 0,
      "price_level": 0
    },
    {
      "code": "AR002",
      "prefixname": "นาย",
      "name": "****** ********",
      "address": "หมู่ที่ XX ตำบลม่วงเตี้ย อำเภอวิเศษชัยชาญ จังหวัดอ่างทอง",
      "status": 0,
      "latitude": 0,
      "longitude": 0,
      "branch_status": 0,
      "branch_code": "",
      "tax_id": "XXXXXXXXXXXXX",
      "sale_code": "",
      "area_code": "",
      "credit_status": 0,
      "credit_day": 0,
      "credit_money": 0,
      "price_level": 0
    }
  ],
  "pages": {
    "size": 2,
    "page": 1,
    "total_record": 807,
    "max_page": 404
  }
}

Response Error:

HTTP Status : 500

Field Name	Description	Example
error		true
code		string
message		string

example:

{
  "error": true,
  "code": "99",
  "message": "Error Message"
}

Customer Information

เป็นการดึงข้อมูลลูกค้ามาแสดงทีละ 1 รายการโดยจะต้องระบุรหัสลูกค้า

EndPoint

GET /SMLJavaRESTService/v3/api/customer/{code}

Parameter:

Request Header:

Required SMLRequestHeader

Path Parameter:

Name	Description	Example
code	รหัสลูกค้า	AR00001

example:

GET http://localhost:8086/SMLJavaRESTService/v3/api/customer/AR00001

Response Success:

HTTP Status : 200

Field Name	Description	Example
success		true
data		Inventory Data Object

{
  "success": true,
  "data": {
    "code": "AR00001",
    "prefixname": null,
    "name": "ลูกค้าทั่วไป",
    "address": "0 0",
    "tambon": "100101",
    "amper": "1001",
    "province": "10",
    "zipcode": "0",
    "email": null,
    "telephone": "99999999",
    "remark": null,
    "status": 0,
    "latitude": 0,
    "longitude": 0,
    "customer_type": null,
    "branch_status": 0,
    "branch_code": null,
    "tax_id": null,
    "area_code": null,
    "sale_code": "SMLADMIN",
    "credit_status": 0,
    "credit_day": 0,
    "credit_money": 0,
    "price_level": 0
  }
}

Response Error:

HTTP Status : 500

Field Name	Description	Example
error		true
code		string
message		string

example:

{
  "error": true,
  "code": "99",
  "message": "Error Message"
}

Add Customer

เพิ่มข้อมูลลูกค้า

EndPoint

POST /SMLJavaRESTService/v3/api/customer

Header

Required SMLRequestHeader

Body Data:

JSON body with Customer Request Attrubte

example

POST /SMLJavaRESTService/v3/api/customer/
Content-Type: application/json
GUID: SMLX
provider: DEBUG
databaseName: debug

{
  "code" : "AR0001",
  "name1" : "Customer Name",
  "address" : "Customer Address",
  "province" : "01",
  "amper" : "0101",
  "tambon" : "010101",
  "telephone" : "",
  "customer_detail" : {
    "account_code" : "130000",
    "tax_id" : "0000000000000",
    "card_id": "0000000000000"
  },
  "member": [
    {
      "code": "AR0001",
      "regist_date": "2017-10-01",
      "expire_date": "2047-12-31",
      "is_staff": 0
    }
  ]
}

Data Validate

ตรวจสอบข้อมูลก่อนที่จะทำการเพิ่ม หรือ แก้ไข

EndPoint

POST /SMLJavaRESTService/v3/api/customer/validate

POST /SMLJavaRESTService/v3/api/customer/validate

{
  "code" : "AR0001",
  "name1" : "Customer Name",
  "address" : "Customer Address",
  "province" : "01",
  "amper" : "0101",
  "tambon" : "010101",
  "telephone" : "",
  "customer_detail" : {
    "account_code" : "130000",
    "tax_id" : "0000000000000",
    "card_id": "0000000000000"
  }
}

Response

{
    "success": true,
    "data": {
        "code": "AR0001",
        "codeOld": null,
        "name1": "Customer Name",
        "name2": null,
        "nameEng1": "Customer Name Eng",
        "nameEng2": null,
        "address": "Customer Address",
        "addressEng": null,
        "tambon": "010101",
        "amper": "0101",
        "province": "01",
        "zipCode": null,
        "telephone": "",
        "fax": null,
        "email": null,
        "website": null,
        "description": null,
        "birthDay": null,
        "arType": null,
        "remark": null,
        "status": null,
        "guidCode": null,
        "arStatus": null,
        "docFormatCode": null,
        "prefixname": null,
        "firstName": null,
        "lastName": null,
        "priceLevel": null,
        "pointBalance": 0.0,
        "saleShiftId": null,
        "smsPhonenumber": null,
        "homeAddress": null,
        "homeName": null,
        "moo": null,
        "soi": null,
        "road": null,
        "roomNo": null,
        "floor": null,
        "building": null,
        "sex": null,
        "country": null,
        "registerDate": null,
        "armCode": null,
        "arCodeMain": null,
        "arBranchCode": null,
        "armApprove": null,
        "armApproveDate": null,
        "nfcId": null,
        "armTier": null,
        "lastUpdateTime": null,
        "interco": null,
        "armRegisterDate": null,
        "armRegister": null,
        "createDatetime": null,
        "lastUpdateDateTime": null,
        "createCode": null,
        "lastUpdateCode": null,
        "cis": null,
        "codeRef1": null,
        "nameWithUnderScroll": null,
        "customerDetail": {
            "arCode": null,
            "areaCode": null,
            "saleCode": null,
            "logisticArea": null,
            "payBillCode": null,
            "keepChqCode": null,
            "payBillDate": null,
            "keepChqDate": null,
            "salePriceLevel": null,
            "creditSale": null,
            "creditCode": null,
            "formName": null,
            "payBillCondition": null,
            "keepMoneyCondition": null,
            "paymentPerson": null,
            "creditPerson": null,
            "keepMoneyPerson": null,
            "discountItem": null,
            "discountBill": null,
            "creditGroup": null,
            "creditGroupCode": null,
            "creditMoney": 0.0,
            "creditMoneyMax": 0.0,
            "creditDay": null,
            "creditReason": null,
            "creditStatus": null,
            "creditDate": null,
            "creditStatusReason": null,
            "tradeLicense": null,
            "vatLicense": null,
            "taxId": "0000000000000",
            "taxType": null,
            "taxRate": 0.0,
            "accountCode": "130000",
            "shippingType": null,
            "closeReason": null,
            "closeDate": null,
            "groupMain": null,
            "groupSub1": null,
            "groupSub2": null,
            "groupSub3": null,
            "groupSub4": null,
            "picture3": null,
            "picture4": null,
            "refDoc1": null,
            "refDoc2": null,
            "refDoc3": null,
            "dimension1": null,
            "dimension2": null,
            "dimension3": null,
            "dimension4": null,
            "dimension5": null,
            "currencyCode": null,
            "latitude": 0.0,
            "longitude": 0.0,
            "cardId": "0000000000000",
            "passbookCode": null,
            "setTaxType": null,
            "branchType": null,
            "branchCode": null,
            "areaPaybill": null,
            "reasonDisableCredit": null,
            "closeCreditDate": null,
            "closeReason1": null,
            "closeReason2": null,
            "closeReason3": null,
            "closeReason4": null,
            "dimension6": null,
            "dimension7": null,
            "dimension8": null,
            "dimension9": null,
            "dimension10": null,
            "disableAutoCloseCredit": null,
            "apCodeRef": null,
            "saleType": null,
            "lineId": null,
            "facebook": null,
            "customerTypeCode": null,
            "arChannelCode": null,
            "arLocationTypeCode": null,
            "brCustCode": null,
            "arSubType1Code": null,
            "arVehicleCode": null,
            "arEquipmentCode": null,
            "arSubEquipment": null,
            "arProjectCode": null,
            "arShoptype1Code": null,
            "arShoptype2Code": null,
            "arShoptype3Code": null,
            "arShoptype4Code": null,
            "arShoptype5Code": null,
            "subArShoptype5Code": null,
            "arProjectCodeName": null,
            "arShoptype6Code": null,
            "arShoptype7Code": null,
            "arProjectDateEnd": null,
            "nfcAsset": null,
            "pastDueDay": null,
            "mobileSales": null
        }
    }
}