Thêm khách hàng

• API này dùng để thêm và sửa thông tin khách hàng. Hệ thống dùng trường mobile làm key, nếu chưa tồn tại thì sẽ thêm mới khách hàng, nếu tồn tại rồi thì sẽ báo lỗi.

• Tối đa mỗi lần không quá 100 khách hàng.

Request

• Xem common request params.

curl --location 'https://pos.open.nhanh.vn/v3.0/customer/add?appId={{appId}}&businessId={{businessId}}' \
--header 'Authorization: {{accessToken}}' \
--header 'Content-Type: application/json'
--data '[
  {
    "name": "Nguyễn Văn A",
    "mobile": "0989999998",
    "locations": {
      "cityId": 254,
      "districtId": 320,
      "wardId": 1108
    }
  },
  {
    "name": "Nguyễn Văn B",
    "mobile": "098999997"
  }
]'

• Thông tin khách hàng

Key	Type	Description
name	string $^{{\color{red}*}}$	Tên khách hàng
mobile	string $^{{\color{red}*}}$	Số điện thoại khách hàng
type	int	Loại khách hàng. 1 = Khách lẻ (default), 2 = Khách buôn
address	string	Địa chỉ khách hàng
gender	int	Giới tính khách hàng. 1 = Nam 2 = Nữ
birthday	date	Sinh nhật khách hàng (Định dạng Y-m-d)
locations	array	Mảng thông tin: Thành phố, quận huyện, phường xã. Xem bên dưới
email	string	Email khách hàng
pid	string	Số căn cước công dân
groupId	int	ID nhóm khách hàng trên Nhanh.vn
tagIds	array[]	Mảng ID nhãn khách hàng
points	int	Điểm tích lũy của khách hàng
taxCode	string	Mã số thuế
businessName	string	Tên công ty
description	string	Mô tả
facebookLink	string	Facebook link
fromCustomer	string	Số điện thoại khách hàng giới thiệu (khách hàng đã tồn tại trên hệ thống Nhanh.vn)
saleName	string	Nhân viên phụ trách (username/email của nhân viên thuộc doanh nghiệp đã tồn tại trên hệ thống Nhanh.vn)

Locations param

Key	Type	Description
cityId	int	ID thành phố (Lấy từ API location)
districtId	int	ID quận huyện (Lấy từ API location)
wardId	int	ID phường xã (Lấy từ API location)

Response

• Xem cấu trúc chung tại đây.

Failed response

• Xem các mã lỗi chung tại đây.

Successful response

{
  "code": 1,
  "data": [
    {
      "id": "(int) ID khách hàng 1",
      "mobile": "(string) Số điện thoại khách hàng"
    },
    {
      "id": "(int) ID khách hàng 2",
      "mobile": "(string) Số điện thoại khách hàng"
    }
  ]
}