Base Finance+ API

Tổng hợp APIs của các apps thuộc bộ Base Finance+

Một số lưu ý:

(1) Cách khai báo và mã hóa dữ liệu đầu vào dạng bảng

Xét ví dụ, để tạo 1 Đơn bán hàng tại Base Income, cần cung cấp dữ liệu đầu vào cho bảng Sản phẩm (Items).

B1: Tại key "custom_item_lines", khai báo (các) bảng chứa dữ liệu đầu vào và cấu trúc đọc của từng bảng.

• Nếu tại đầu gửi, dữ liệu được chứa tại 1 bảng có key "san_pham", gồm 4 cột là Tên sản phẩm, Tên mã dòng tiền vào, Số tiền (không gồm thuế), Tên chính sách thuế, thì khai báo cấu trúc đọc là "san_pham:name.1-code.2-amount_excl.3-tax_policy.4", trong đó 1, 2, 3, 4 là index cột tương ứng tại đầu gửi dữ liệu.

• Nếu tại đầu gửi, dữ liệu được chứa tại nhiều bảng, thì ngăn cách giữa các cấu trúc đọc bằng dấu phẩy.

B2: Tại key "san_pham", khai báo giá trị trong bảng được mã hóa như sau:

• B2.1: Tạo mảng dữ liệu theo cấu trúc:
  [
  ‘0’ => ‘Sản phẩm Alpha’,
  ‘1’ => ‘A01’
  ‘2’ => 10000000,
  ‘3’ => VAT 10%
  ]

• B2.2: Dùng hàm json_encode (PHP)

• B2.3: Dùng hàm base64_encode (PHP)

Tương tự, thực hiện lặp lại B2 với mỗi key/bảng chứa dữ liệu đầu vào cho bảng Sản phẩm (Items).

(2) Cách khai báo và mã hóa dữ liệu đầu vào tại Danh mục báo cáo

Xét ví dụ, để tạo 1 khoản Giảm trừ doanh thu tại Base Income và muốn gắn Danh mục báo cáo (Reporting Categories) cho khoản giảm trừ này, với Chiều dữ liệu là Khu vực (mã chiều = khuvuc) và Thẻ là Miền Bắc (ID của thẻ = 3).

• B1: Tạo mảng dữ liệu theo cấu trúc:
  [ { "dimension_code": node_id } ]
  tức là:
  [ { "khuvuc": 3 } ]

• B2: Dùng hàm base64_encode (PHP)