AUTOMATE NOW

Review Misa AMIS API – 2025

Table of Contents

1. Giới thiệu về Misa AMIS API

  • Misa AMIS API kết nối là API do AMIS kế toán cung cấp để hỗ trợ các sản phẩm khác gửi đề nghị sinh chứng từ kế toán về để hạch toán trên ứng dụng kế toán của AMIS.
  • Các thông tin cần thiết để sử dụng được Misa Amis API:
    • Mã ứng dụng: AMIS kế toán sẽ cung cấp cho đối tác một mã ứng dụng (app_id), mã ứng dụng này dùng để nhận diện ứng dụng khi kết nối với AMIS kế toán. 
    • Mã kết nối: Thực hiện Thiết lập kết nối ứng dụng để lấy thông tin mã kết nối đại diện cho công ty đang sử dụng ứng dụng kế toán của AMIS.
    • Đường dẫn callback: Người dùng cung cấp cho dự án AMIS kế toán một đường dẫn API (API Callback) nhận kết quả trả về đối với những hàm được AMIS kế toán xử lý bất đồng bộ.
  • Nguồn tham khảo

2. Misa AMIS Webhook Response

  • Đáp ứng được với tất cả các loại chứng từ
  • Webhook callback url được khoá cứng trong thông tin app đã được đăng ký với Misa, một callback url sẽ dùng cho tất cả các công ty.
  • Webhook chỉ trả về thông tin success / fail của yêu cầu sinh chứng từ. Không có thông báo về yêu cầu tạo đó có được chuyển sang chứng từ chính thức hay không.

3. Misa Amiss API – Thông tin Khách Hàng

Đã đáp ứng

{

    "org_company_code": "OYOR88CX",
    "app_id": "31c69d29-837e-4b12-a702-e7b0dbf9640e",
    "dictionary": [
        {
            "dictionary_type": 1,
            "account_object_id": "bce4639d-40a5-4fa3-b0dd-7fdee4c66e8e",
            "branch_id": "526518f8-db35-40ac-a532-ca3d325a043b",
            "account_object_code": "KH0000001",
            "account_object_name": "Nguyễn Văn An",
            "country": "Việt Nam",
            "maximize_debt_amount": 0,
            "einvoice_contact_name": "Nguyễn Văn An",
            "is_remind_debt": true,
            "is_vendor": false,
            "is_customer": true,
            "inactive": false,
            "account_object_type": 1,
            "reftype": 9020,
            "reftype_category": 9020,
            "closing_amount": 0
        }
    ]
}
image

Khách hàng đã tạo trên Misa AMIS

{
    "data_type": 1,
    "branch_id": null,
    "skip": 0,
    "take": 100,
    "app_id": "31c69d29-837e-4b12-a702-e7b0dbf9640e",
    "last_sync_time": null
}

Hạn chế

  • Chưa có API cập nhật thông tin khách hàng
  • Chưa có API lấy khách hàng theo Mã khách hàng
  • API lấy danh sách khách hàng chưa tối ưu. Với lượng dữ liệu lớn (> 5000 dòng) thường gặp lỗi timeout hoặc trả về kết quả chậm do cơ chế filter/ sort by chưa tốt

4. Misa AMIS API – Nhóm Khách Hàng

Hạn chế

  • Không có API để lấy danh sách nhóm khách hàng. 

5. Misa Amis API – Quản Lý Vật Tư

Đã đáp ứng

{
    "org_company_code": "OYOR88CX",
    "app_id": "31c69d29-837e-4b12-a702-e7b0dbf9640e",
    "dictionary": [
        {
            "dictionary_type": 3,
            "inventory_item_id": "12183be9-61a3-4f16-9deb-616509d22b53",
            "inventory_item_name": "VTOP00002OP1",
            "inventory_item_code": "VTOP00002OP1",
            "inventory_item_type": 0,
            "minimum_stock": 0.0,
            "inventory_item_category_code_list": "HH",
            "inventory_item_category_name_list": "Hàng hóa",
            "inventory_item_category_id_list": "4087476a-ede8-4d0d-888a-a05fc215ceeb",
            "inventory_item_category_misa_code_list": ";/00004/;",
            "branch_id": "526518f8-db35-40ac-a532-ca3d325a043b",
            "discount_type": 0,
            "base_on_formula": 0,
            "is_unit_price_after_tax": false,
            "is_system": false,
            "inactive": false,
            "is_follow_serial_number": false,
            "is_allow_duplicate_serial_number": true,
            "purchase_discount_rate": 0.0,
            "unit_price": 0.0,
            "sale_price1": 120000.0,
            "sale_price2": 0.0,
            "sale_price3": 0.0,
            "fixed_sale_price": 0.0,
            "import_tax_rate": 0.0,
            "export_tax_rate": 0.0,
            "fixed_unit_price": 0.0,
            "discount_account": "5111",
            "sale_off_account": "5111",
            "return_account": "5111",
            "inventory_account": "156",
            "cogs_account": "632",
            "sale_account": "5111",
            "reftype": 0,
            "reftype_category": 0,
            "quantityBarCode": 1,
            "allocation_type": 0,
            "allocation_time": 0,
            "allocation_account": "5111",
            "purchase_last_unit_price": 0.0,
            "is_specific_inventory_item": false,
            "has_delete_fixed_unit_price": false,
            "has_delete_unit_price": false,
            "has_delete_discount": false,
            "has_delete_unit_convert": false,
            "has_delete_norm": false,
            "has_delete_serial_type": false,
            "is_edit_multiple": false,
            "is_group": false,
            "excel_row_index": 0,
            "is_valid": false,
            "auto_refno": false,
            "state": 0
        }
    ]
}
{
    "data_type": 2,
    "branch_id": null,
    "skip": 0,
    "take": 100,
    "app_id": "31c69d29-837e-4b12-a702-e7b0dbf9640e",
    "last_sync_time": null
}
Vật tư đã tạo trên Misa AMIS

Vật tư đã tạo trên Misa AMIS

Hạn chế

  • Chưa có API cập nhật thông tin vật tư
  • Chưa có API lấy sản phẩm theo Mã vật tư
  • API lấy danh sách vật tư chưa tối ưu. Với lượng dữ liệu lớn (> 5000 dòng) thường gặp lỗi timeout hoặc trả về kết quả chậm do cơ chế filter/ sort by chưa tốt

6. Misa Amis API – Dữ Liệu Nhóm Vật Tư

Hạn chế

  • Không có API để lấy danh sách nhóm vật tư
  • Trong trường hợp cần đồng bộ thông tin nhóm vật tư cho sản phẩm phải thông qua bảng mapping mà khách hàng cung cấp.

7. Misa Amis API – Chính sách Giá Vật Tư

Hạn chế

  • Không có API lấy chính sách giá của vật tư
  • Không có API cập nhật chính sách giá của vật tư

8. Misa Amis API – Quản Lý Tồn kho

Đã đáp ứng

{
    "app_id": "31c69d29-837e-4b12-a702-e7b0dbf9640e",
    "branch_id": "25029007-23ae-4f02-ac8c-b7e7f3a6037a",
    "skip": "0",
    "take": "100",
    "last_sync_time": "2025-01-01"
}

9. Misa Amis API – Tạo Chứng Từ

  • Bao gồm các loại chứng từ sau
    • Đơn đặt hàng
    • Đơn bán hàng
    • Phiếu xuất kho
    • Phiếu thu
    • Phiếu chi

Đã đáp ứng

{
  "org_company_code": "OYOR88CX",
  "app_id": "31c69d29-837e-4b12-a702-e7b0dbf9640e",
  "voucher": [
    {
      "detail": [
        {
          "ref_detail_id": "80a5ce98-d274-4987-8e7c-996905406a0a",
          "refid": "e318db11-4d33-477f-b026-c236e812bc89",
          "inventory_item_id": "9fb16695-2b19-494f-81ff-3c48efcfeba4",
          "unit_id": "71112249-98ce-4334-a06d-34736155fa35",
          "account_object_id": "59c6376b-cbdd-411c-b498-ba07e5e29b38",
          "sort_order": 1,
          "is_promotion": false,
          "quantity": 2,
          "amount": 240000,
          "amount_oc": 240000,
          "discount_rate": null,
          "main_convert_rate": null,
          "main_quantity": 2,
          "main_unit_id": "71112249-98ce-4334-a06d-34736155fa35",
          "main_unit_name": "Cái",
          "main_unit_price": 120000,
          "discount_amount": 0,
          "vat_rate": -1,
          "vat_amount": 0,
          "description": "",
          "inventory_item_name": "VTOP00002OP1",
          "exchange_rate_operator": "*",
          "inventory_item_code": "VTOP00002OP1",
          "unit_name": "Cái",
          "unit_price": 120000,
          "is_unit_price_after_tax": false,
          "quantity_delivered": 0,
          "quantity_remain": 0,
          "status": 0,
          "is_description": false,
          "discount_type": 1,
          "discount_rate_voucher": 0,
          "state": 1
        }
      ],
      "voucher_type": 20,
      "is_get_new_id": true,
      "org_refid": "e318db11-4d33-477f-b026-c236e812bc89",
      "is_allow_group": false,
      "org_reftype": 3520,
      "org_reftype_name": "Đơn đặt hàng",
      "act_voucher_type": 0,
      "refid": "e318db11-4d33-477f-b026-c236e812bc89",
      "refno": "DH00001",
      "branch_id": "526518f8-db35-40ac-a532-ca3d325a043b",
      "account_object_id": "59c6376b-cbdd-411c-b498-ba07e5e29b38",
      "account_object_address": "123 Nguyễn Văn Linh, Quận 7, Tp.HCM",
      "status": 0,
      "delivered_status": 0,
      "due_day": 0,
      "refdate": "2025-06-17",
      "is_calculated_cost": false,
      "exchange_rate": 1,
      "account_object_name": "Trịnh Ngọc Liên",
      "account_object_code": "1080470014",
      "journal_memo": "Đơn hàng test 00001",
      "shipping_address": "123 Nguyễn Văn Linh, Quận 7, Tp.HCM",
      "currency_id": "VND",
      "discount_type": 1,
      "discount_rate_voucher": 0,
      "total_amount_made": 0,
      "revenue_status": 0,
      "total_receipted_amount": 0,
      "is_invoiced": false,
      "check_quantity": false,
      "excel_row_index": 0,
      "is_valid": false,
      "reftype": 3520,
      "auto_refno": false,
      "state": 1
    }
  ]
}
image 2

Yêu cầu tạo đơn đặt hàng được gửi lên Misa Amis

Hạn chế

  • Không có Misa Amis API hỗ trợ lấy danh sách chứng từ.
  • Không có Misa Amis API để lấy về lấy chứng từ theo Mã chứng từ.
  • Kết quả của yêu cầu sinh chứng từ không được trả về ở response của request đã gọi mà sẽ được thông báo qua webhook. 
  • Khi yêu cầu tạo đơn chứng từ được kế toán duyệt và chuyển thành chứng từ, hệ thống Misa Amis AMIS không có thông báo về ID của chứng từ được tạo.
  • Khi gửi yêu cầu sinh chứng từ, không liên kết được với các chứng từ đã tồn tại trên hệ thống do chưa có cách để lấy thông tin ID của các chứng từ này.
  • Nếu muốn các chứng từ được liên kết với nhau, chúng cần phần được gửi chung trong một request.

Related Articles