Tài liệu Open API tích hợp AMIS Kế toán Doanh nghiệp

(Cần đăng ký và xây đựng theo chuẩn của Amis kế toán)

Hướng dẫn build project callback

    “Success”:true/false,

    “ErrorCode”: “Mã lỗi”,

    “ErrorMessage”: “Mô tả lỗi”,

    “Data”: “Dữ liệu phản hồi”

}

True: Thành công

False: Thất bại

Nhận về app_id

Xem hướng dẫn

(Tạo mới/ Lấy từ Amis kế toán về)

Xem hướng dẫn

Sau khi tải về import vào postman và config script các thông tin cần thiết

    “app_id“: “{app_id}”,

    “access_code“: “{access_code}”,

    “org_company_code“: “{org_company_code}“

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “[Danh sách trả về]”

}

Lấy đúng access_token từ Data (access_token hiệu lực 12h, giá trị của token được trả về theo thông tin expired_time)

    “data_type“: 1, //kiểu dữ liệu lấy về

    “skip“: 0, //số lượng bỏ qua

    “take“: 1000, //số lượng lấy về

    “app_id“: “{app_id}“, //app_id được cung cấp

    “last_sync_time”: “{last_sync_time}”

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “[Danh sách account_object trả về]”

}

Danh sách đối tượng trả về Data khi Response thành công

0: nữ

1: nam

1: là cá nhân

(lấy ở API get_dictionary với data_type = 6)

Dành cho nhân viên (is_employee: true)

    “data_type“: 2, //kiểu dữ liệu lấy về

    “skip“: 0, //số lượng bỏ qua

    “take“: 1000, //số lượng lấy về

    “app_id“: “{app_id}“, //app_id được cung cấp

    “last_sync_time”: “{last_sync_time}”

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “[Danh sách inventory_item trả về]”

}

Danh sách đối tượng trả về Data khi Response thành công

0 Là Vật tư hàng hóa

1: Là thành phẩm

2: Là dịch vụ

3: Là Nguyên vật liệu

1: Thêm

    “data_type“: 3, //kiểu dữ liệu lấy về

    “skip“: 0, //số lượng bỏ qua

    “take“: 1000, //số lượng lấy về

    “app_id“: “{app_id}“, //app_id được cung cấp

    “last_sync_time”: “{last_sync_time}”

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “[Danh sách stock trả về]”

}

Danh sách đối tượng trả về Data khi Response thành công

1: Thêm

    “data_type“: 4, //kiểu dữ liệu lấy về

    “skip“: 0, //số lượng bỏ qua

    “take“: 1000, //số lượng lấy về

    “app_id“: “{app_id}“, //app_id được cung cấp

    “last_sync_time”: “{last_sync_time}”

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data”: “[Danh sách unit trả về]”

}

Danh sách đối tượng trả về Data khi Response thành công

1: Thêm

    “data_type“: 5, //kiểu dữ liệu lấy về

    “skip“: 0, //số lượng bỏ qua

    “take“: 1000, //số lượng lấy về

    “app_id“: “{app_id}“, //app_id được cung cấp

    “last_sync_time”: “{last_sync_time}”

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data”: “[Danh sách account trả về]”

}

Danh sách đối tượng trả về Data khi Response thành công

1: Thêm

    “data_type“: 6, //kiểu dữ liệu lấy về

    “skip“: 0, //số lượng bỏ qua

    “take“: 1000, //số lượng lấy về

    “app_id“: “{app_id}“, //app_id được cung cấp

    “last_sync_time”: “{last_sync_time}”

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “[Danh sách organization_unit trả về]”

}

Danh sách đối tượng trả về Data khi Response thành công

1: Tổng công ty/công ty

2: Công ty con/chi nhánh

4: Phòng ban

    “data_type“: 8, //kiểu dữ liệu lấy về

    “skip“: 0, //số lượng bỏ qua

    “take“: 1000, //số lượng lấy về

    “app_id“: “{app_id}“, //app_id được cung cấp

    “last_sync_time”: “{last_sync_time}”

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data”: “[Danh sách bank trả về]”

}

Danh sách đối tượng trả về Data khi Response thành công

    “data_type“: 14, //kiểu dữ liệu lấy về

    “skip“: 0, //số lượng bỏ qua

    “take“: 1000, //số lượng lấy về

    “app_id“: “{app_id}“, //app_id được cung cấp

    “last_sync_time”: “{last_sync_time}”

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data”: “[Danh sách bank trả về]”

}

Danh sách đối tượng trả về Data khi Response thành công

1: Thêm

    “app_id“: “{app_id}”, //kiểu dữ liệu lấy về

    “org_company_code“:”{org_company_code}”

    “dictionary“: [Danh sách account_object sử dụng]

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “Hệ thống đã ghi nhận yêu cầu đồng bộ vào hàng đợi, dữ liệu sẽ được đồng bộ sang hệ thống AMIS Kế toán sớm nhất có thể. Sau khi xử lý xong yêu cầu đồng bộ, hệ thống sẽ trả kết quả đồng bộ vào đường dẫn callback mà đối tác đã cung cấp cho AMIS kế toán.”

}

Phản hồi ghi nhận kết quả trả về Data khi Response thành công

0: nữ

1: nam

1: là cá nhân

(lấy ở API get_dictionary với data_type = 6)

Dành cho nhân viên (is_employee: true)

1: Thêm

    “app_id“: “{app_id}”, //kiểu dữ liệu lấy về

    “org_company_code”: “{org_company_code}”

    “dictionary“: [Danh sách inventory_category sử dụng]

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “Hệ thống đã ghi nhận yêu cầu đồng bộ vào hàng đợi, dữ liệu sẽ được đồng bộ sang hệ thống AMIS Kế toán sớm nhất có thể. Sau khi xử lý xong yêu cầu đồng bộ, hệ thống sẽ trả kết quả đồng bộ vào đường dẫn callback mà đối tác đã cung cấp cho AMIS kế toán.”

}

Phản hồi ghi nhận kết quả trả về Data khi Response thành công

1: Thêm

    “app_id“: “{app_id}”, //kiểu dữ liệu lấy về

    “org_company_code”: “{org_company_code}”

    “dictionary“: [Danh sách inventory_item sử dụng]

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “Hệ thống đã ghi nhận yêu cầu đồng bộ vào hàng đợi, dữ liệu sẽ được đồng bộ sang hệ thống AMIS Kế toán sớm nhất có thể. Sau khi xử lý xong yêu cầu đồng bộ, hệ thống sẽ trả kết quả đồng bộ vào đường dẫn callback mà đối tác đã cung cấp cho AMIS kế toán.”

}

Phản hồi ghi nhận kết quả trả về Data khi Response thành công

0 Là Vật tư hàng hóa

1: Là thành phẩm

2: Là dịch vụ

3: Là Nguyên vật liệu

1: Thêm

    “app_id“: “{app_id}”, //kiểu dữ liệu lấy về

    “org_company_code“: “{org_company_code}”

    “dictionary“: [Danh sách inventory_category sử dụng]

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “Hệ thống đã ghi nhận yêu cầu đồng bộ vào hàng đợi, dữ liệu sẽ được đồng bộ sang hệ thống AMIS Kế toán sớm nhất có thể. Sau khi xử lý xong yêu cầu đồng bộ, hệ thống sẽ trả kết quả đồng bộ vào đường dẫn callback mà đối tác đã cung cấp cho AMIS kế toán.”

}

Phản hồi ghi nhận kết quả trả về Data khi Response thành công

1: Thêm

    “app_id“: “{app_id}”, //kiểu dữ liệu lấy về

    “org_company_code“: “{org_company_code}”

    “dictionary“: [Danh sách stock sử dụng]

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “Hệ thống đã ghi nhận yêu cầu đồng bộ vào hàng đợi, dữ liệu sẽ được đồng bộ sang hệ thống AMIS Kế toán sớm nhất có thể. Sau khi xử lý xong yêu cầu đồng bộ, hệ thống sẽ trả kết quả đồng bộ vào đường dẫn callback mà đối tác đã cung cấp cho AMIS kế toán.”

}

Phản hồi ghi nhận kết quả trả về Data khi Response thành công

1: Thêm

    “app_id“: “{app_id}”, //kiểu dữ liệu lấy về

    “org_company_code”: “{org_company_code}”

    “dictionary“: [Danh sách unit sử dụng]

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “Hệ thống đã ghi nhận yêu cầu đồng bộ vào hàng đợi, dữ liệu sẽ được đồng bộ sang hệ thống AMIS Kế toán sớm nhất có thể. Sau khi xử lý xong yêu cầu đồng bộ, hệ thống sẽ trả kết quả đồng bộ vào đường dẫn callback mà đối tác đã cung cấp cho AMIS kế toán.”

}

Phản hồi ghi nhận kết quả trả về Data khi Response thành công

1: Thêm

    “app_id“: “{app_id}”, //kiểu dữ liệu lấy về

    “org_company_code”: “{org_company_code}”

    “dictionary“: [Danh sách account sử dụng]

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “Hệ thống đã ghi nhận yêu cầu đồng bộ vào hàng đợi, dữ liệu sẽ được đồng bộ sang hệ thống AMIS Kế toán sớm nhất có thể. Sau khi xử lý xong yêu cầu đồng bộ, hệ thống sẽ trả kết quả đồng bộ vào đường dẫn callback mà đối tác đã cung cấp cho AMIS kế toán.”

}

Phản hồi ghi nhận kết quả trả về Data khi Response thành công

1: Thêm

    “app_id“: “{app_id}”, //kiểu dữ liệu lấy về

    “org_company_code”: “{org_company_code}”

    “dictionary“: [Danh sách organization_unit sử dụng]

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “Hệ thống đã ghi nhận yêu cầu đồng bộ vào hàng đợi, dữ liệu sẽ được đồng bộ sang hệ thống AMIS Kế toán sớm nhất có thể. Sau khi xử lý xong yêu cầu đồng bộ, hệ thống sẽ trả kết quả đồng bộ vào đường dẫn callback mà đối tác đã cung cấp cho AMIS kế toán.”

}

Phản hồi ghi nhận kết quả trả về Data khi Response thành công

1: Tổng công ty/công ty

2: Công ty con/chi nhánh

4: Phòng ban

    “app_id“: “{app_id}”, //kiểu dữ liệu lấy về

    “org_company_code”: “{org_company_code}”

    “voucher“: [Danh sách sa_voucher sử dụng]

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “Hệ thống đã ghi nhận yêu cầu đồng bộ vào hàng đợi, dữ liệu sẽ được đồng bộ sang hệ thống AMIS Kế toán sớm nhất có thể. Sau khi xử lý xong yêu cầu đồng bộ, hệ thống sẽ trả kết quả đồng bộ vào đường dẫn callback mà đối tác đã cung cấp cho AMIS kế toán.”

}

Phản hồi ghi nhận kết quả trả về Data khi Response thành công

– có thể chỉ sử dụng account_object_code cũng có thể mapping được với danh mục

0: Không chiết khấu

1: Theo mặt hàng

2: Theo % hóa đơn

3: Theo số tiền trên tổng hóa đơn

có thể chỉ sử dụng employee_code cũng có thể mapping được với danh mục

0: Không kèm hóa đơn;

1: Nhận kèm hóa đơn;

2: Không có hóa đơn

0: Nhập tay

1.Hóa đơn giá trị gia tăng;

2.Hóa đơn bán hàng;

3.Phiếu xuất kho kiêm vận chuyển hàng hóa nội bộ;

4.Phiếu xuất kho gửi bán hàng đại lý;

5.Hóa đơn xuất khẩu;

6.Hóa đơn bán hàng (dành cho tổ chức, cá nhân trong khu phi thuế quan)

0: Chưa xuất,

1: Đã xuất,

2: Để trắng (đối với hóa đơn bán hàng mà tất cả mặt hàng đều có tính chất dịch vụ)

3: là xuất một phần

3530: Bán hàng hóa, dịch vụ trong nước chưa thu tiền

3531: Bán hàng hóa, dịch vụ trong nước – Tiền mặt

3532: Bán hàng xuất khẩu

3534: Bán hàng đại lý bán đúng giá – Chưa thu tiền

3535: Bán hàng đại lý bán đúng giá – Tiền mặt

3536: Bán hàng nhận ủy thác xuất khẩu

3537: Bán hàng hóa, dịch vụ trong nước – Chuyển khoản

3538: Bán hàng đại lý bán đúng giá – Chuyển khoản

3570: Bán dịch vụ trong nước chưa thu tiền

3571: Bán dịch vụ trong nước – Tiền mặt

3572: Bán dịch vụ trong nước – Chuyển khoản

Bắt buộc khi is_sale_with_outward = true

Thông tin phiếu xuất kho (in_outward)

có thể chỉ sử dụng employee_code cũng có thể mapping được với danh mục

2020: Xuất kho bán hàng

0: Không chiết khấu

1: Theo mặt hàng

2: Theo % hóa đơn

3: Theo số tiền trên tổng hóa đơn

có thể chỉ sử dụng employee_code cũng có thể mapping được với danh mục

+ Có sử dụng hóa đơn điện tử: inv_type_id = null

+ Không sử dụng hóa đơn điện tử: giá trị của inv_type_id chi tiết như sau :

1.Hóa đơn giá trị gia tăng;

2.Hóa đơn bán hàng;

3.Phiếu xuất kho kiêm vận chuyển hàng hóa nội bộ;

4.Phiếu xuất kho gửi bán hàng đại lý;

5.Hóa đơn xuất khẩu;

6.Hóa đơn bán hàng (dành cho tổ chức, cá nhân trong khu phi thuế quan)

3560: Hóa đơn bán hàng hóa, dịch vụ trong nước

– có thể chỉ cần dùng inventory_item_code cũng có thể mapping với danh mục

(lấy ở API get_dictionary với data_type = 2)

0: Là vật tư hàng hoá

1: Là thành phẩm

2: Là dịch vụ

3: Là nguyên vật liệu

– có thể chỉ cần dùng stock_code cũng có thể mapping với danh mục

(lấy ở API get_dictionary với data_type = 3)

– Có thể chỉ cần dùng unit_name cũng có thể mapping với danh mục

0%: 0

5%: 5

8%: 8

10%: 10

KCT: -1

KKKNT: -2

KHAC: -3

(lấy ở API get_dictionary với data_type = 6)

    “app_id“: “{app_id}”, //kiểu dữ liệu lấy về

    “org_company_code”: “{org_company_code}”

    “voucher“: [Danh sách sa_order sử dụng]

}

    “Success“: true,

    “ErrorMessage“: “”,

    “Data“: “Hệ thống đã ghi nhận yêu cầu đồng bộ vào hàng đợi, dữ liệu sẽ được đồng bộ sang hệ thống AMIS Kế toán sớm nhất có thể. Sau khi xử lý xong yêu cầu đồng bộ, hệ thống sẽ trả kết quả đồng bộ vào đường dẫn callback mà đối tác đã cung cấp cho AMIS kế toán.”

}

Phản hồi ghi nhận kết quả trả về Data khi Response thành công

– có thể chỉ sử dụng account_object_code cũng có thể mapping được với danh mục

0: Chưa giao

1: Đang giao

2: Đã giao đủ

(Default = 0)

0: Không chiết khấu

1: Theo mặt hàng

2: Theo % hóa đơn

3: Số tiền trên tổng hóa đơn

(Default = 0)

có thể chỉ sử dụng employee_code cũng có thể mapping được với danh mục

3520: Đơn đặt hàng

0: chưa ghi doanh số 1 đã ghi doanh số (Default = 0)

0: Chưa thực hiện

1: Đang thực hiện

2: Hoàn thành

3: Đã hủy bỏ

(Default = 0)

– có thể chỉ cần dùng inventory_item_code cũng có thể mapping với danh mục

(lấy ở API get_dictionary với data_type = 2)

– Có thể chỉ cần dùng unit_name cũng có thể mapping với danh mục

– có thể chỉ cần dùng stock_code cũng có thể mapping với danh mục

– Có thể chỉ cần dùng unit_name cũng có thể mapping với danh mục

0%: 0

5%: 5

8%: 8

10%: 10

KCT: -1

KKKNT: -2

KHAC: -3