Thông tin tạo phiếu sửa chữa

FPT gửi thông tin về GMS. GMS tạo phiếu sửa chữa dựa trên các thông tin FPT cung cấp

1. Cấu trúc

api/v1/jobcard/receive

POST http://abc.vn/api/v1/jobcard/receive

Content-type: application/x-www-form-urlencoded

Request Body

Name	Type	Description
Data	array	Mãng chứa dữ liệu phiếu (xem phần mô tả)
Checksum	string	checksum
RequestTime	string	Thời điểm thực hiện request Định dạng yyyyMMddHHmmss
ApiUser	string	Tài khoản API (GMS cung cấp)

200 Thực hiện thành công

{"code":"1"}

400 Thực hiện bị lỗi

2. Mô tả

Tham số	Bắt buộc	Kiểu dữ liệu	Mô tả
id	REQUIRED	string	ID request (nếu trùng ID, gms sẽ cập nhật thông tin)
imei		string	Imei máy
ten	REQUIRED	string	Tên khách hàng
sdt	REQUIRED	string	Số điện thoại khách hàng
diachi		string	Địa chỉ khách hàng
tinhtrang		string	Tình trạng máy
mota	REQUIRED	string	Mô tả lỗi
manv		string	Mã nhân viên chuyển máy
tennv		string	Tên nhân viên chuyển máy
sodonvanchuyen		string	Số đơn vận chuyển
hinhthucvanchuyen		string	Hình thức vận chuyển

3. Ví dụ

3.1 Ví dụ 1: gửi request

ApiUser=ApiTestUser
RequestTime=20180808114600
Checksum=9B1B6BCE17660E46D8322F2D0FDF6B341E206B0D
Data=
[
  {
    "id":"1",
    "imei": "350293019310101",
    "ten": "Nguyễn Văn A",
    "sdt": "0909000000",
    "diachi": "47 đường 12 thủ đức",
    "tinhtrang": "máy cũ",
    "mota": "vô nước",
    "manv": "nv001",
    "tennv": "Nguyễn Thị N",
    "sodonvanchuyen": "",
    "hinhthucvanchuye": ""
  }
]

3.2 Ví dụ 2: response thành công

HTTP status code = 200

{"code":"1"}

3.3 Ví dụ 3: response thông tin lỗi

HTTP status code = 400

Item đầu tiên có index = 0

{"code":"0","message":"imei1, imei2","detail":[{"index":"0","err":"Sai kiểu dữ liệu."},{"index":"1","err":"Lỗi số điện thoại."}]}

• Số phiếu thứ nhất (đầu tiên) bị lỗi "Sai kiểu dữ liệu".

• Số phiếu thứ hai bị lỗi "Lỗi số điện thoại".

4. Test với Postman

Phản hồi thành công

Phản hồi với thông tin lỗi