VAT Invoice Processor

Upload & Process POST /api/v1/process/

Select the Bang_ke_hoa_don_da_su_dung .xlsx or .xls file. Processing runs in the background — you'll get confirmation immediately.

X-API-Key token Bang ke file

Upload BKHHDV to Lark POST /api/v1/upload-bkhhdv/

Upload a single BKHHDV .xlsx file. The server will save it locally, upload to Lark Drive, and create / update the corresponding record in Mục lục Base. so_hoa_don and gia_tri are auto-detected from the file.

BKHHDV file * Note * Số hoá đơn (optional — auto-detected from file)

Get Result GET /api/v1/result/

Check whether the output file is ready and download it. Returns 404 if processing hasn't finished yet.

API Reference Swagger UI

Method	Endpoint	Description	Responses
POST	`/api/v1/process/`	Upload `.xlsx` or `.xls`, start background job (requires X-API-Key)	202 401 400 409
POST	`/api/v1/upload-bkhhdv/`	Upload BKHHDV `.xlsx` to Lark Drive + upsert Mục lục Base record (requires X-API-Key, `note`)	200 201 401 400 409
GET	`/api/v1/result/`	Download `result.xlsx` when ready (requires X-API-Key)	200 401 404