Doanh nghiệp & Thuế opengov/customs/exchange-rates

Tỷ giá tính thuế xuất nhập khẩu do cơ quan hải quan công bố — tỷ giá dùng

Để quy đổi trị giá hải quan khi tính thuế, KHÁC với tỷ giá mua bán của ngân hàng thương mại. Đơn vị: đồng Việt Nam cho một đơn vị ngoại tệ. ĐIỀU PHẢI BIẾT TRƯỚC KHI DÙNG: nguồn công bố hai loại bản ghi và endpoint này trả cả hai, phân biệt bằng trường `nhom`. `hien_hanh` là bảng tỷ giá của tuần hiện hành, đo được 29 ngoại tệ. `usd_theo_tuan` là LỊCH SỬ tỷ giá USD theo từng tuần, đo được 41 tuần. Vì vậy lọc `currency=USD` trả về nhiều dòng (lịch sử), còn lọc `currency=EUR` trả về một dòng (hiện hành) — đó là tính chất của nguồn, không phải lỗi. Dòng mới nhất là dòng có `hieu_luc_tu` lớn nhất. `ty_gia` trả về dạng SỐ đã quy đổi sẵn từ cách viết của nguồn (nguồn dùng dấu chấm phân nhóm nghìn và dấu phẩy thập phân theo quy ước Việt Nam). `hieu_luc_tu` theo ISO 8601 dạng ngày, không kèm múi giờ vì nguồn công bố ngày hiệu lực chứ không công bố thời điểm. Dịch vụ này KHÔNG phục vụ họ tên cán bộ cập nhật hay phê duyệt tỷ giá; những trường đó bị loại tại tầng dịch vụ.

GET https://api-tools.hitechcloud.vn/api/opengov/customs/exchange-rates Đã chép

Cần khoá API

Tham số

currency string · truy vấn

Lọc theo mã ngoại tệ ISO 4217, ví dụ USD, EUR, JPY. Không phân biệt chữ hoa/thường. Mã không có trong bảng trả 404 kèm gợi ý lấy danh sách mã đang niêm yết. Bỏ trống để lấy toàn bộ bảng.

Mã trả về

200 Thành công.

401 Thiếu hoặc sai khoá API. Gửi kèm header X-API-Key.

404 Không tìm thấy dữ liệu tương ứng.

429 Vượt hạn mức của khoá. Xem header Retry-After.

$response = Http::withHeaders([ 'X-API-Key' => env('HITECH_API_KEY'), ])->get('https://api-tools.hitechcloud.vn/api/opengov/customs/exchange-rates', [ 'currency' => 'GIA_TRI', ]); $data = $response->json();

import os, requests res = requests.get( "https://api-tools.hitechcloud.vn/api/opengov/customs/exchange-rates", headers={"X-API-Key": os.environ["HITECH_API_KEY"]}, params={ "currency": "GIA_TRI", }, ) data = res.json()