Overview - Tourwell Open APIs

API Integration Guide — Chiết tính Nâng cao

Core ↔ Mobile Lite

Phạm vi: Dành cho team Mobile Lite tích hợp với hệ thống Core (ERP)

API Endpoints

GET /quotations/{id} — Lấy chi tiết chiết tính

Dùng khi: Mobile Lite mở lại chiết tính đã có (quotation_id được truyền vào qua URL params)

Response thành công (200):

POST /quotations/{id}/costs — Thêm 1 dòng chi phí
Dùng khi: User thêm dòng mới vào bảng tính

Request Body:

Response (201):

IMPORTANT
Mobile Lite phải lưu id: 789 vào local state ngay sau khi nhận response. Mọi thao tác PATCH / DELETE đều cần dùng cost_id này.

PATCH /quotations/{id}/costs/{cost_id} — Sửa 1 dòng chi phí

Dùng khi: User chỉnh bất kỳ field nào (auto-save sau debounce 1.5s)

Request Body:

Response (200):

Danh sách trường thông tin:

Parameter Description
description (string) Tên dịch vụ
supplier_id (integer) 0 = chưa chọn NCC
price (number) Đơn giá (server tự parse format "1,500,000")
quantity (number) Số lượng
period (number) Số kỳ/ngày
unit (string) Đơn vị tính
vat (number) % VAT
vat_mode (string) percent hoặc fixed
vat_type (string) ex-vat hoặc inc-vat
note (string) Ghi chú
check_in (string) Format: dd/mm/yyyy
check_out (string) Format: dd/mm/yyyy
schedule_id (integer) ID ngày lịch trình (0 nếu không có)
currency_code (string) VD: VND, USD
exchange_rate (number) Tỷ giá (1 nếu VND)

Parameter	Description
description (string)	Tên dịch vụ
supplier_id (integer)	0 = chưa chọn NCC
price (number)	Đơn giá (server tự parse format "1,500,000")
quantity (number)	Số lượng
period (number)	Số kỳ/ngày
unit (string)	Đơn vị tính
vat (number)	% VAT
vat_mode (string)	percent hoặc fixed
vat_type (string)	ex-vat hoặc inc-vat
note (string)	Ghi chú
check_in (string)	Format: dd/mm/yyyy
check_out (string)	Format: dd/mm/yyyy
schedule_id (integer)	ID ngày lịch trình (0 nếu không có)
currency_code (string)	VD: VND, USD
exchange_rate (number)	Tỷ giá (1 nếu VND)

DELETE /quotations/{id}/costs/{cost_id} — Xóa 1 dòng chi phí

Dùng khi: User xác nhận xóa — gọi ngay lập tức, không debounce
Không cần Request Body

Response (200):

PUT /quotations/{id} — Cập nhật bảng giá bán (price rules / dự thu)

Dùng khi: User thay đổi đơn giá bán, số lượng khách theo loại

Request Body:

Response (200):

PUT /quotations/{id}/finalize — Hoàn tất chiết tính
Dùng khi: User bấm nút "Tải về" / "Hoàn tất"

Request Body:

back_url: là URL trang Báo giá trên Core. Mobile App tự lưu từ lúc khởi tạo và gửi lại ở bước này.

Response (200):

Sau khi nhận response → redirect browser về redirect_url.