# Giới thiệu về Abit

Abit là giải pháp của Nitco.ltd chuyên cung cấp các giải pháp hỗ trợ các Nhà bán hàng, Doanh nghiệp Kinh doanh Online và Offline trên đa nền tảng với 2 sản phẩm và dịch vụ chính

### Abitstore.vn - Phần mềm quản lý bán hàng đa kênh

*Abitstore chuyên các giải pháp về quản lý đơn hàng đa kênh (Fanpage, Shopee, TikTok Shop, Lazada, Ladipage, Website , Wordpress, Magento, Zalo, POS), quản lý kho, quản lý xuất nhập, kiểm kho, giúp xác nhận và in đơn nhanh chóng, đẩy đơn sang đơn vị vận chuyển nhanh chóng, công cụ quản lý đơn đóng gói, đơn hoàn về tránh thất thoát đơn hàng*

### Abitmes.vn - Phần mềm chat đa kênh

*Chuyên cung cấp giải pháp về chat đa kênh tập trung, hỗ trợ quản lý comment, inbox trên các nền tảng Fanpage, Shopee, TikTok Shop, Zalo OA trên một giao diện giúp tiết kiệm thời gian CSKH*


# Giới thiệu về Abit Open API

Abit Open API cung cấp các giải pháp để tương tác giữa hệ thống Abit với các hệ thống, phần mềm ngoài bao gồm các dữ liệu về sản phẩm, đơn hàng, khách hàng, tương tác với khách hàng thông qua sự cấp quyền và cho phép của khách hàng Abit

Một số API mà Abit đang hỗ trợ

<details>

<summary>Đơn hàng</summary>

Api lấy danh sách đơn hàng gần nhất, có lọc theo ngày và sắp xếp theo thời gian

</details>

<details>

<summary>Sản phẩm</summary>

Hỗ trợ lấy danh sách sản phẩm trên tài khoản của shop

</details>

<details>

<summary>Khách hàng</summary>

Api lấy danh sách khách hàng theo giới gian, cho phép lọc và sắp xếp

</details>

<details>

<summary>Chăm sóc khách hàng</summary>

API tương tác với Zalo cá nhân khách hàng

</details>


# Khởi tạo Access Token

Để tương tác với các phân hệ của Abit như lấy danh sách khách hàng, đơn hàng, sản phẩm, chat với khách hàng trên Fanpage thì cần khởi tạo mã Access Token này

### Khởi tạo Access Token

Để có thể cấp quyền cho các ứng dụng bên ngoài có thể truy cập vào Abit để lấy thông tin , shop cần thực hiện một số khai báo để lấy **Access Token** mà Abit sinh ra để dùng trên mỗi lần ứng dụng ngoài Request đến API

Để khai báo cấp quyền, Quý khách hàng đăng nhập vào Abit , vào mục **Cấu hình ⇒ Thông tin shop**. Click vào tab **Đối tác**&#x20;

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2FQSvR9jSSUZMap6HAJKAV%2Ftao-access-token-abit.png?alt=media&amp;token=fb014cd4-6132-4d63-a7c4-3b211fb788ff" alt=""><figcaption></figcaption></figure>

Bấm vào button **Tạo Access Token**, nhập thông tin đăng nhập của bạn trên Abit để hệ thống xác nhận và sinh ra mã Access Token . Mã này được dùng thường xuyên nên bạn cần lưu lại và sử dụng trong trường hợp bạn muốn sử dụng các API request đến Abit để lấy thông tin Đơn hàng, khách hàng, sản phẩm, API chat Abitmes

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2F02uldy6BlWPiWbN9f9tB%2Ftoke-abit.jpg?alt=media&amp;token=e4ee4ed9-cc9e-4ff5-aa47-783570771b19" alt=""><figcaption></figcaption></figure>


# Danh sách khách hàng

API lấy danh sách khách hàng của shop trên Abit

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/accounts/getlistAccountbyPartner)

<mark style="color:green;">`POST /`</mark>accounts/getlistAccountbyPartner

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>filter_by</td><td>string</td><td>filter_by có 2 giá trị <strong>UPDATE</strong> và <strong>CREATE</strong></td></tr><tr><td>order_by</td><td>string</td><td>order_by có 2 giá trị <strong>DESC</strong> và <strong>ASC</strong></td></tr><tr><td>date_time_start</td><td>datetime</td><td>Thời gian bắt đầu lọc , định dạng Y-m-d H:i:s <br>Ví dụ : <strong>2025-03-13 08:00:00</strong></td></tr><tr><td>date_time_end</td><td>datetime</td><td>Thời gian kết thúc lọc , định dạng Y-m-d H:i:s <br>Ví dụ : <strong>2025-03-13 23:59:59</strong></td></tr><tr><td>page</td><td>int</td><td>Phân trang, lấy kết quả ở trang thứ mấy, mặc định giá trị là <strong>0</strong></td></tr><tr><td>limit</td><td>int</td><td>Giới hạn kết quả trả ra, mặc định là <strong>10</strong></td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
"access_token":"MWM4MmFjYjYzYzYwOTkxOTg1OGVjNTA1NjcxY2QwZDc=",
"partner_name":"bizfly",
"filter_by":"CREATE",
"order_by":"DESC",
"date_time_start":"2023-05-01 00:00:00",
"date_time_end":"2023-08-14 23:59:59",
"page":0,
"limit":3
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
  "total": 1,
  "data": [
    {
      "accountid": 7374504,
      "account_no": "ACC468389",
      "account_no_shop": "",
      "accountname": "test",
      "phone": "0377500000",
      "otherphone": "0982500000",
      "email1": "abc@gmail.com",
      "email2": null,
      "chanel": null,
      "status": 0,
      "diachigiaohang": "Hapulico VTP",
      "created_at": "2023-07-17 14:16:12",
      "updated_at": "2023-08-21 10:09:44",
      "account_label": "",
      "bill_street": "Hapulico VTP 1",
      "diachivanphong": "Hapulico VTP 2",
      "diachi_vat": "Hapulico VTP 3",
      "thongdiep": null,
      "birthday": "0000-00-00",
      "use_zalo": 0,
      "gioi_tinh": "",
      "owner_name": "HN - Thuỳ Linh",
      "productstorename": "HTX Hà Nội",
      "nguonkhach": ""
    }
  ]
}
```

{% endtab %}
{% endtabs %}


# Chi tiết khách hàng

API lấy chi tiết thông tin một khách hàng của shop trên Abit

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/accounts/getdetailtAccountbyPartner)

<mark style="color:green;">`POST /`</mark>accounts/getdetailtAccountbyPartner

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>accountid</td><td>int</td><td>ID của khách hàng lấy từ API danh sách khách hàng</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
"access_token":"MWM4MmFjYjYzYzYwOTkxOTg1OGVjNTA1NjcxY2QwZDc=",
"partner_name":"bizfly",
"accountid":"7374504"
}
```

{% endtab %}

{% tab title="Response" %}

```json
[
  {
    "accountid": 7374504,
    "account_no": "ACC468389",
    "account_no_shop": "",
    "accountname": "test",
    "phone": "0377500000",
    "otherphone": "0982500000",
    "email1": "abc@gmail.com",
    "email2": null,
    "chanel": null,
    "status": 0,
    "diachigiaohang": "Hapulico VTP",
    "created_at": "2023-07-17 14:16:12",
    "updated_at": "2023-08-21 10:09:44",
    "account_label": "",
    "bill_street": "Hapulico VTP 1",
    "diachivanphong": "Hapulico VTP 2",
    "diachi_vat": "Hapulico VTP 3",
    "thongdiep": null,
    "birthday": "0000-00-00",
    "use_zalo": 0,
    "gioi_tinh": "",
    "listInvoices": [
      {
        "invoiceid": 7374639,
        "invoice_no": "TT6723139-96",
        "subject": "test",
        "diachigiaohang": "Hapulico VTP",
        "invoicestatus": "Huy DNX",
        "created_at": "2023-07-17 14:19:55",
        "total": "50500490.000",
        "nguoinhanhang": "test"
      },
      {
        "invoiceid": 7374711,
        "invoice_no": "TT6723200-86",
        "subject": "test",
        "diachigiaohang": "Hapulico VTP",
        "invoicestatus": "AutoCreated",
        "created_at": "2023-07-17 14:22:54",
        "total": "10000000.000",
        "nguoinhanhang": "test"
      }
    ]
  }
]
```

{% endtab %}
{% endtabs %}


# Danh sách báo giá

API cho phép lấy danh sách báo giá của shop, hỗ trợ lọc theo ngày, có phân trang, sắp xếp

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/quotes/getlistQuotesbyPartner)

<mark style="color:green;">`POST /`</mark>`quotes/getlistQuotesbyPartner`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>quotestage</td><td>arrray</td><td><p>Mặc định là [] , nếu bạn muốn lọc theo nhiều trạng thái báo giá trên Abit thì truyền theo mã quote code</p><p><br>Một số trạng thái mặc định ( Created, Delivered, Reviewed, Accepted, Rejected, Success) </p><pre class="language-postman_json"><code class="lang-postman_json">
[
  "Created",
  "Delivered",
  "Reviewed",
  "Accepted",
  "Rejected",
  "Success"
]
</code></pre><p></p></td></tr><tr><td>productstoreid</td><td>int</td><td>ID Kho hàng, lấy danh sách này ở API <a href="/api-mo-rong/danh-sach-kho-chi-nhanh"><strong>Danh sách kho - Chi nhán</strong>h</a></td></tr><tr><td>filter_by</td><td>string</td><td>filter_by có 2 giá trị <strong>UPDATE</strong> và <strong>CREATE</strong></td></tr><tr><td>order_by</td><td>string</td><td>order_by có 2 giá trị <strong>DESC</strong> và <strong>ASC</strong></td></tr><tr><td>date_time_start</td><td>datetime</td><td>Thời gian bắt đầu lọc , định dạng Y-m-d H:i:s <br>Ví dụ : <strong>2025-03-13 08:00:00</strong></td></tr><tr><td>date_time_end</td><td>datetime</td><td>Thời gian kết thúc lọc , định dạng Y-m-d H:i:s <br>Ví dụ : <strong>2025-03-13 23:59:59</strong></td></tr><tr><td>page</td><td>int</td><td>Phân trang, lấy kết quả ở trang thứ mấy, mặc định giá trị là <strong>0</strong></td></tr><tr><td>limit</td><td>int</td><td>Giới hạn kết quả trả ra, mặc định là <strong>10</strong></td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
    "access_token": "ZjZjNjFlNGM3MjkzNTUxYzE1NmI4NGQ0MmY3NzU5OGQ=",
    "partner_name": "Abit",
    "quotestage": [
        "Created"
    ],
    "productstoreid": "",
    "filter_by": "UPDATE",
    "order_by": "DESC",
    "date_time_start": "2025-11-01 00:00:00",
    "date_time_end": "2025-11-28 23:59:59",
    "page": 0,
    "limit": 10
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "total": 3,
    "data": [
        {
            "quoteid": 87297241,
            "subject": "Báo giá 3 sản phẩm 4",
            "dienthoai": "0983730200",
            "idcongty": 1,
            "quotestage": "Created",
            "validtill": "2025-12-27",
            "ngaybaogia": "2025-11-27 13:19:11",
            "contactid": 0,
            "total": "12539000.000",
            "subtotal": "12539000.000",
            "s_h_amount": "0.000",
            "quote_no": "BG15500-21",
            "carrier": null,
            "shipping": null,
            "type": null,
            "adjustment": "0.000",
            "taxtype": "group",
            "discount_percent": "0.000",
            "discount_amount": "0.000",
            "accountid": 7027446,
            "tenkhachhang": "nguyenthanhtung",
            "terms_conditions": "",
            "currency_id": 1,
            "ship_street": "TEst",
            "bill_street": "",
            "ghichu": "",
            "lydohuy": "",
            "giamgia": "0.000",
            "phuthu": "0.000",
            "phivanchuyen": "0.000",
            "taxtotal_quote": "0.000",
            "productstoreid": 1,
            "alias": "",
            "tennv": "Họ teenNhân Viên dê mô",
            "reminder_datetime": null,
            "ngaylayhangdukien": "2025-11-08",
            "tylethanhcong": 0,
            "listProduct": [
                {
                    "productid": 60025106,
                    "price": "10625000.000",
                    "amount": "1.000",
                    "storeId": 1,
                    "productName": "Bơm  SB30- 3Hp - 28,5-->30,5m3/h\r\n- Động cơ motor 1 pha \r\n- Thiết bị bảo vệ quá dòng \r\n- Công suất : 3",
                    "productcode": "SB30",
                    "ma_ke_toan": "",
                    "barcode": null,
                    "ma_goc": null,
                    "usageunit": "Cái",
                    "weight": "0",
                    "time_baohanh": 0,
                    "imagename": "[{\"id\":1,\"isDefault\":true,\"imgSrc\":\"https://seapoolvn.com/wp-content/uploads/2019/09/luu-y-khi-lap-dat-may-bom-nuoc-be-boi-emaux.jpg\"}]",
                    "url_key": null,
                    "link_drive": null,
                    "brandname": "Emaux",
                    "vendorname": null,
                    "origin": null,
                    "pricebook_id": 0,
                    "pricebook_name": "",
                    "discount_percent": "0.000",
                    "discount_amount": "0.000",
                    "tax1": "0.000",
                    "qtyinstock": null
                },
                {
                    "productid": 71680298,
                    "price": "935000.000",
                    "amount": "1.000",
                    "storeId": 1,
                    "productName": "Thùng rác nhựa 240L - HDPE giá rẻ - Xanh biển - 204L-XANHBIEN",
                    "productcode": "204L-XANHBIEN",
                    "ma_ke_toan": "52030637297",
                    "barcode": "",
                    "ma_goc": "204L-XANHBIEN",
                    "usageunit": "Cái",
                    "weight": "11000",
                    "time_baohanh": 0,
                    "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/2a6f0dbe4f95a93607341287277e1ddb\"}]",
                    "url_key": "",
                    "link_drive": null,
                    "brandname": "",
                    "vendorname": "",
                    "origin": "",
                    "pricebook_id": 0,
                    "pricebook_name": "",
                    "discount_percent": "0.000",
                    "discount_amount": "0.000",
                    "tax1": "0.000",
                    "qtyinstock": null
                },
                {
                    "productid": 86184674,
                    "price": "979000.000",
                    "amount": "1.000",
                    "storeId": 1,
                    "productName": "Thùng rác nhựa 240L - HDPE giá rẻ - Vàng - 240L-VANG",
                    "productcode": "240L-VANG",
                    "ma_ke_toan": "52030637295",
                    "barcode": "",
                    "ma_goc": null,
                    "usageunit": "Cái",
                    "weight": "11000",
                    "time_baohanh": 0,
                    "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/773548b499f1ac822ad6baab61ae3884\"}]",
                    "url_key": "",
                    "link_drive": null,
                    "brandname": "",
                    "vendorname": null,
                    "origin": "",
                    "pricebook_id": 0,
                    "pricebook_name": "",
                    "discount_percent": "0.000",
                    "discount_amount": "0.000",
                    "tax1": "0.000",
                    "qtyinstock": null
                }
            ]
        },
        {
            "quoteid": 87290328,
            "subject": "Báo giá 3 sản phẩm",
            "dienthoai": "0983730200",
            "idcongty": 1,
            "quotestage": "Created",
            "validtill": "2025-12-27",
            "ngaybaogia": "2025-11-27 11:45:09",
            "contactid": 0,
            "total": "12539000.000",
            "subtotal": "12539000.000",
            "s_h_amount": "0.000",
            "quote_no": "BG15499-86",
            "carrier": null,
            "shipping": null,
            "type": null,
            "adjustment": "0.000",
            "taxtype": "group",
            "discount_percent": "0.000",
            "discount_amount": "0.000",
            "accountid": 7027446,
            "tenkhachhang": "nguyenthanhtung",
            "terms_conditions": "",
            "currency_id": 1,
            "ship_street": "TEst",
            "bill_street": "",
            "ghichu": "",
            "lydohuy": "",
            "giamgia": "0.000",
            "phuthu": "0.000",
            "phivanchuyen": "0.000",
            "taxtotal_quote": "0.000",
            "productstoreid": 1,
            "alias": "",
            "tennv": "Họ teenNhân Viên dê mô",
            "reminder_datetime": null,
            "ngaylayhangdukien": "2025-11-08",
            "tylethanhcong": 0,
            "listProduct": [
                {
                    "productid": 60025106,
                    "price": "10625000.000",
                    "amount": "1.000",
                    "storeId": 1,
                    "productName": "Bơm  SB30- 3Hp - 28,5-->30,5m3/h\r\n- Động cơ motor 1 pha \r\n- Thiết bị bảo vệ quá dòng \r\n- Công suất : 3",
                    "productcode": "SB30",
                    "ma_ke_toan": "",
                    "barcode": null,
                    "ma_goc": null,
                    "usageunit": "Cái",
                    "weight": "0",
                    "time_baohanh": 0,
                    "imagename": "[{\"id\":1,\"isDefault\":true,\"imgSrc\":\"https://seapoolvn.com/wp-content/uploads/2019/09/luu-y-khi-lap-dat-may-bom-nuoc-be-boi-emaux.jpg\"}]",
                    "url_key": null,
                    "link_drive": null,
                    "brandname": "Emaux",
                    "vendorname": null,
                    "origin": null,
                    "pricebook_id": 0,
                    "pricebook_name": "",
                    "discount_percent": "0.000",
                    "discount_amount": "0.000",
                    "tax1": "0.000",
                    "qtyinstock": null
                },
                {
                    "productid": 71680298,
                    "price": "935000.000",
                    "amount": "1.000",
                    "storeId": 1,
                    "productName": "Thùng rác nhựa 240L - HDPE giá rẻ - Xanh biển - 204L-XANHBIEN",
                    "productcode": "204L-XANHBIEN",
                    "ma_ke_toan": "52030637297",
                    "barcode": "",
                    "ma_goc": "204L-XANHBIEN",
                    "usageunit": "Cái",
                    "weight": "11000",
                    "time_baohanh": 0,
                    "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/2a6f0dbe4f95a93607341287277e1ddb\"}]",
                    "url_key": "",
                    "link_drive": null,
                    "brandname": "",
                    "vendorname": "",
                    "origin": "",
                    "pricebook_id": 0,
                    "pricebook_name": "",
                    "discount_percent": "0.000",
                    "discount_amount": "0.000",
                    "tax1": "0.000",
                    "qtyinstock": null
                },
                {
                    "productid": 86184674,
                    "price": "979000.000",
                    "amount": "1.000",
                    "storeId": 1,
                    "productName": "Thùng rác nhựa 240L - HDPE giá rẻ - Vàng - 240L-VANG",
                    "productcode": "240L-VANG",
                    "ma_ke_toan": "52030637295",
                    "barcode": "",
                    "ma_goc": null,
                    "usageunit": "Cái",
                    "weight": "11000",
                    "time_baohanh": 0,
                    "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/773548b499f1ac822ad6baab61ae3884\"}]",
                    "url_key": "",
                    "link_drive": null,
                    "brandname": "",
                    "vendorname": null,
                    "origin": "",
                    "pricebook_id": 0,
                    "pricebook_name": "",
                    "discount_percent": "0.000",
                    "discount_amount": "0.000",
                    "tax1": "0.000",
                    "qtyinstock": null
                }
            ]
        }
    ]
}
```

{% endtab %}
{% endtabs %}


# Tạo đơn hàng

API cho phép tạo đơn hàng trên Abit từ các hệ thống ngoài. Các nền tảng như Woocommerce, Shopify, Sapo, Haravan, Magento thì Abit có API riêng để kết nối

Để lấy url API tạo đơn về Abit, Quý khách hàng đăng nhập vào tài khoản của Quý khách trên Abit, vào menu bên tay phải "Kết nối đa kênh ⇒ Đồng bộ Website - Ladipage" , copy url API tạo đơn như trong ảnh

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2FSl9tHmVWkUYrFWhCRbD6%2Furl-api-dong-bo-dong-hang-ve-Abit.png?alt=media&amp;token=2ef6f264-eaaa-441f-aafe-29a84e3a180d" alt=""><figcaption></figcaption></figure>

Phương thức: <mark style="color:green;">POST</mark>

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**<br>

<table><thead><tr><th>Tên trường</th><th width="174.83203125">Yêu cầu</th><th>Diễn giải</th></tr></thead><tbody><tr><td>name</td><td>Bắt buộc</td><td>Tên khách hàng</td></tr><tr><td>telephone</td><td>Bắt buộc</td><td>Điện thoại khách</td></tr><tr><td>name_receiver</td><td>Bắt buộc</td><td>Tên người nhận hàng (có thể để giống tên khách)</td></tr><tr><td>invoicestatus</td><td>Bắt buộc</td><td>Trạng thái đơn hàng, mặc định <strong>AutoCreated</strong></td></tr><tr><td>city</td><td>Không yêu cầu</td><td>Tỉnh/thành phố, có thể để để trống</td></tr><tr><td>district</td><td>Không yêu cầu</td><td>Quận/huyện, có thể để để trống</td></tr><tr><td>address</td><td>Bắt buộc</td><td>Địa chỉ khách hàng</td></tr><tr><td>note</td><td>Không yêu cầu</td><td>Ghi chú</td></tr><tr><td>mavandon</td><td>Không yêu cầu</td><td>Là mã vận đơn của đơn vị vận chuyển nếu có</td></tr><tr><td>hinhthucvc</td><td>Không Yêu cầu</td><td>Hình thức vận chuyển, Mỗi đơn vị vận chuyển có mã code khác nhau. Abit gửi bạn mã code của các nhà vận chuyển để Abit ghi nhận được<br><br><strong>VIETTELPOST</strong> - Viettel Post<br><strong>GHTK</strong> - Giao hàng tiết kiệm<br><strong>GHN</strong> - Giao hàng nhanh<br><strong>JNT</strong> - Vận chuyển J&#x26;T<br><strong>BESTINC</strong> - Vận chuyển Best INC<br><strong>SPX</strong> - Vận chuyển Shopee Express<br><strong>VNPOST</strong> - Vận chuyển VNPOST</td></tr><tr><td>discount_percent</td><td>Không yêu cầu</td><td>Phần trăm giảm giá, mặc định <strong>0.000</strong></td></tr><tr><td>discount_amount</td><td>Không yêu cầu</td><td>Giá trị giảm , mặc định <strong>0.000</strong></td></tr><tr><td>s_h_amount</td><td>Không yêu cầu</td><td>Phí vận chuyển Mặc định:<strong>0.000</strong></td></tr><tr><td>ghichu1</td><td>Không yêu cầu</td><td>Trường ghi chú thứ 1</td></tr><tr><td>ghichu2</td><td>Không yêu cầu</td><td>Trường ghi chú thứ 2</td></tr><tr><td>notevanchuyen</td><td>Không yêu cầu</td><td>Ghi chú vận chuyển cho đơn hàng</td></tr><tr><td>giamgia</td><td>Không yêu cầu</td><td>Giá trị mặc định: <strong>0</strong></td></tr><tr><td>phuthu</td><td>Không yêu cầu</td><td>Giá trị mặc định: <strong>0</strong></td></tr><tr><td>phivanchuyen</td><td>Không yêu cầu</td><td>Giá trị mặc định: <strong>0</strong></td></tr><tr><td>adjustment</td><td>Không yêu cầu</td><td>Giá trị mặc định: <strong>0.000</strong></td></tr><tr><td>taxtype</td><td>Bắt buộc</td><td>Giá trị mặc định: <strong>individual</strong></td></tr><tr><td>deposits</td><td>Không yêu cầu</td><td>Giá trị mặc định: <strong>0.000</strong></td></tr><tr><td>subtotal</td><td>Bắt buộc</td><td>Tiền hàng, mặc định : <strong>0</strong></td></tr><tr><td>taxtotal_invoice</td><td> </td><td>Giá trị mặc định: <strong>0.000</strong></td></tr><tr><td>total</td><td>Bắt buộc</td><td>Tổng tiền hàng + phụ thu - giảm trừ (nếu có) : mặc định :<strong>0</strong></td></tr><tr><td>accountid</td><td>Không yêu cầu</td><td>Id khách hàng, mặc định :<strong>0</strong></td></tr><tr><td>list_pageitem</td><td>Không yêu cầu</td><td>Id page hoặc url website để xác định nguồn đơn hàng</td></tr><tr><td>listProduct</td><td>Bắt buộc</td><td>Mảng các giá trị về sản phẩm trong đơn hàng</td></tr><tr><td><ul><li>price</li></ul></td><td>Bắt buộc</td><td>Giá sản phẩm</td></tr><tr><td><ul><li>amount</li></ul></td><td>Bắt buộc</td><td>Số lượng bán</td></tr><tr><td><ul><li>productName</li></ul></td><td>Bắt buộc</td><td>Tên sản phẩm</td></tr><tr><td><ul><li>productcode</li></ul></td><td>Bắt buộc</td><td>Mã sản phẩm, thông tin Mã hàng trên Website, ladingpage cần trùng với Mã hàng mục sản phẩm trên Abitstore.vn</td></tr><tr><td><ul><li>weight</li></ul></td><td>Không yêu cầu</td><td>Trọng lượng tính bằng Gram</td></tr><tr><td><ul><li>discount_percent_product</li></ul></td><td>Không yêu cầu</td><td><strong>Giảm giá %</strong> trên từng sản phẩm nếu có, mặc định: 0</td></tr><tr><td><ul><li>discount_amount_product</li></ul></td><td>Không yêu cầu</td><td><strong>Giá trị giảm %</strong> trên từng sản phẩm nếu có, mặc định: <strong>0</strong></td></tr><tr><td><ul><li>tax1</li></ul></td><td>Không yêu cầu</td><td>Thuế trên từng sản phẩm: mặc định : <strong>0</strong></td></tr><tr><td><ul><li>qtyinstock</li></ul></td><td>Không yêu cầu</td><td>Số lượng sản phẩm: Mặc định : 0</td></tr><tr><td><ul><li>storeId</li></ul></td><td>Không yêu cầu</td><td>ID của Kho hàng - Chi nhánh nếu bạn muốn đồng bộ đơn về kho - chi nhánh nào trên Abit, nếu ko nhập thì Abit tạo đơn về kho - chi nhánh mặc định</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
[
    {
        "name": "Hoang Xuan 3",
        "telephone": "0975114488",
        "name_receiver": "Mr Du",
        "invoicestatus": "AutoCreated",
        "city": "",
        "district": "",
        "address": "203 Minh Khai",
        "note": "",
        "mavandon":"853214r534543",
        "hinhthucvc": "VIETTELPOST",
        "discount_percent": "0.000",
        "discount_amount": "0.000",
        "s_h_amount": "0.000",
        "ghichu1": "",
        "ghichu2": "",
        "notevanchuyen": "Ghi chú vận chuyển riêng cho đơn hàng này",
        "giamgia": "0",
        "phuthu": "0",
        "phivanchuyen": "0",
        "adjustment": "0.000",
        "taxtype": "individual",
        "deposits": 15000,
        "subtotal": 450000,
        "taxtotal_invoice": "0.000",
        "total": 450000,
        "accountid": 0,
        "list_pageitem": "289582808317941",
        "listProduct": [
            {
                "price": "250000",
                "amount": "2",
                "storeId": 1,
                "productName": "SP Xoay 3 vòng",
                "productcode": "xoay-3-vong11",
                "weight": "100",
                "discount_percent_product": "0",
                "discount_amount_product": "0",
                "tax1": "0",
                "qtyinstock": "0"
            },
            {
                "price": "298000",
                "amount": "3",
                "storeId": 1,
                "productName": "Giày Boot Nam Cao Cổ Khâu Đế Màu Đen Da Sần M89-38",
                "productcode": "M89-38222",
                "weight": "100",
                "discount_percent_product": "0",
                "discount_amount_product": "0",
                "tax1": "0",
                "qtyinstock": "0"
            }
        ]
    }
]
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "status": "success",
    "code": "200",
    "message": "Tạo đơn hàng thành công",
    "invoiceid": "95965995",
    "invoice_no": "EG87609211A33"
}
```

{% endtab %}
{% endtabs %}


# Danh sách đơn hàng

API cho phép lấy danh sách đơn hàng gần nhất trên shop, hỗ trợ lọc theo ngày, có phân trang, lấy danh sách đơn hàng tối đa trong vòng 3 tháng gần đây

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/invoices/getlistInvoicebyPartner)

<mark style="color:green;">`POST /`</mark>`invoices/getlistInvoicebyPartner`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>invoicestatus</td><td>arrray</td><td><p>Mặc định là [] , nếu bạn muốn lọc theo nhiều trạng thái đơn hàng trên Abit thì truyền theo định dạng , Danh sách Mã trạng thái đơn hàng lấy trong API <strong>Trạng thái đơn hàng ,</strong> <br>Đơn hoả tốc truyền trạng thái <mark style="color:red;"><strong>Donhoatoc</strong></mark></p><pre class="language-postman_json"><code class="lang-postman_json">
[
  "AutoCreated",
  "Thanhcong"
]
</code></pre></td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng Shopee , TikTok Shop , ID Fanpage... được kết nối vào Abit, lấy thông tin ID trong mục <strong>Kết nối đa kênh =⇒ Kết nối sàn TMĐT</strong></td></tr><tr><td>productstoreid</td><td>int</td><td>ID Kho hàng, lấy danh sách này ở API <a href="/api-mo-rong/danh-sach-kho-chi-nhanh"><strong>Danh sách kho - Chi nhán</strong>h</a></td></tr><tr><td>filter_by</td><td>string</td><td>filter_by có 2 giá trị <strong>UPDATE</strong> và <strong>CREATE</strong></td></tr><tr><td>order_by</td><td>string</td><td>order_by có 2 giá trị <strong>DESC</strong> và <strong>ASC</strong></td></tr><tr><td>date_time_start</td><td>datetime</td><td>Thời gian bắt đầu lọc , định dạng Y-m-d H:i:s <br>Ví dụ : <strong>2025-03-13 08:00:00</strong></td></tr><tr><td>date_time_end</td><td>datetime</td><td>Thời gian kết thúc lọc , định dạng Y-m-d H:i:s <br>Ví dụ : <strong>2025-03-13 23:59:59</strong></td></tr><tr><td>page</td><td>int</td><td>Phân trang, lấy kết quả ở trang thứ mấy, mặc định giá trị là <strong>0</strong></td></tr><tr><td>limit</td><td>int</td><td>Giới hạn kết quả trả ra, mặc định là <strong>10</strong></td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
    "access_token": "MWM4MmFjYjYzYzYwOTkxOTg1OGVjNTA1NjcxY2QwZDc=",
    "partner_name": "bizfly",
    "ecommerce_id": "1234567",
    "productstoreid": 1,
    "invoicestatus": [
        "AutoCreated",
        "Thanhcong"
    ],
    "filter_by": "UPDATE",
    "order_by": "DESC",
    "date_time_start": "2023-05-01 00:00:00",
    "date_time_end": "2023-08-08 23:59:59",
    "page": 0,
    "limit": 10
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "total": 1,
    "data": [
        {
            "invoiceid": 79003479,
            "invoice_no": "EG71346245A72",
            "subject": "Vy",
            "dienthoai": "0988800090",
            "diachigiaohang": "203 Minh Khai, Hai Bà Trưng, Hà Nội",
            "pushed": 0,
            "storeid": "1",
            "invoicestatus": "AutoCreated",
            "createdtime": "2025-04-29 12:06:05",
            "modifiedtime": "2025-06-14 09:39:48",
            "smownerid": 14166,
            "total": "770000.000",
            "accountid": 0,
            "total_giavon": "100000.000",
            "subtotal": "770000.000",
            "s_h_amount": "0.000",
            "discount_amount": "0.000",
            "mavandon": "",
            "donvi_vc": "",
            "phivanchuyenthuctra": "0.000",
            "giamgiadonhang": "0.000",
            "tiendatcoc": "0.000",
            "cuoccod": "",
            "CodAmount": 0,
            "cf_889": "0",
            "tongcuocdi": "",
            "ngaygui": null,
            "idprofile": "23928637000116784",
            "type_invoice": "1",
            "trungdon": "",
            "nguoinhanhang": "Vy",
            "ngayxacnhan": null,
            "confirm_order": null,
            "mahang": "(1)BN0097,(1)120L-DEN-19082024...",
            "ghichu1": "",
            "notevanchuyen": "",
            "provinceCode": "01",
            "districtcode": "007",
            "is_print": 0,
            "tracking_no": null,
            "chanel": "Fanpage",
            "nhanvien": "",
            "staff_cskh": 0,
            "type_client": 0,
            "other_vandon": null,
            "idpage": "2013792605578989",
            "idpost": "",
            "paymentby_voucher": "0.000",
            "paymentby_card": "0.000",
            "paymentby_cash": "0.000",
            "paymentby_other": "0.000",
            "thongdiep": "0988800090...",
            "taxtotal_invoice": "0.000",
            "taxtype": "individual",
            "eoi_fee_and_tax_amount": null,
            "commission_value": null,
            "eoi_escrow_amount": null,
            "eoi_refund_amount_to_buyer": null,
            "is_doisoat": 0,
            "eoi_service_fee": null,
            "eoi_commission_fee": null,
            "salescommission": "0",
            "eoi_fee_voucher_xtra_service_fee_amount": null,
            "eoi_fee_flash_sales_service_fee_amount": null,
            "eoi_actual_shipping_fee": null,
            "ecommerce_id": "0",
            "eoi_buyer_total_amount": null,
            "eoi_original_price": null,
            "eoi_seller_discount": "0.00",
            "eoi_platform_discount": null,
            "eoi_shippingprovider_discount": null,
            "eoi_voucher_from_seller": null,
            "eoi_voucher_from_platform": null,
            "eoi_coins": null,
            "eoi_buyer_paid_shipping_fee": "0.00",
            "eoi_buyer_transaction_fee": null,
            "eoi_cross_border_tax": null,
            "eoi_payment_promotion": null,
            "eoi_seller_transaction_fee": null,
            "eoi_seller_lost_compensation": null,
            "eoi_seller_coin_cash_back": null,
            "eoi_final_shipping_fee": null,
            "eoi_final_seller_service_fee_list_fee_amount": null,
            "eoi_shopee_shipping_rebate": null,
            "eoi_shipping_fee_discount_from_3pl": null,
            "eoi_seller_shipping_discount": null,
            "eoi_estimated_shipping_fee": null,
            "eoi_seller_voucher_code": null,
            "eoi_drc_adjustable_refund": null,
            "eoi_cost_of_goods_sold": null,
            "eoi_original_cost_of_goods_sold": "750000.00",
            "eoi_original_platform_discount": null,
            "eoi_seller_return_refund": null,
            "eoi_reverse_shipping_fee": null,
            "eoi_final_product_vat_tax": null,
            "eoi_rts_sla": null,
            "eoi_rts_time": null,
            "eoi_tts_sla": null,
            "eoi_order_id": null,
            "eoi_cancel_order_sla": null,
            "eoi_cancel_reason": null,
            "eoi_cancel_user": null,
            "eoi_fulfillment_type": 0,
            "return_order_id": null,
            "return_tracking_no": null,
            "return_shipping_provider": null,
            "is_trahang_hoantien": 0,
            "eoi_fee_affiliate_ads_commission_amount": null,
            "eoi_fee_affiliate_commission_amount_before_pit": null,
            "eoi_fee_affiliate_partner_commission_amount": null,
            "eoi_fee_bonus_cashback_service_fee_amount": null,
            "eoi_fee_cofunded_promotion_service_fee_amount": null,
            "eoi_fee_credit_card_handling_fee_amount": null,
            "eoi_fee_dt_handling_fee_amount": null,
            "eoi_fee_epr_pob_service_fee_amount": null,
            "eoi_fee_live_specials_fee_amount": null,
            "eoi_fee_mall_service_fee_amount": null,
            "eoi_fee_pre_order_service_fee_amount": null,
            "eoi_fee_referral_fee_amount": null,
            "eoi_fee_refund_administration_fee_amount": null,
            "eoi_fee_sfp_service_fee_amount": null,
            "eoi_fee_tsp_commission_amount": null,
            "eoi_tax_anti_dumping_duty_amount": null,
            "eoi_tax_customs_clearance_amount": null,
            "eoi_tax_customs_duty_amount": null,
            "eoi_tax_gst_amount": null,
            "eoi_tax_import_vat_amount": null,
            "eoi_tax_isr_amount": null,
            "eoi_tax_iva_amount": null,
            "eoi_tax_local_vat_amount": null,
            "eoi_tax_pit_amount": null,
            "eoi_tax_sst_amount": null,
            "eoi_tax_vat_amount": null,
            "eoi_revenue_breakdown_cod_service_fee_amount": null,
            "eoi_revenue_breakdown_refund_cod_service_fee_amount": null,
            "eoi_revenue_breakdown_refund_subtotal_before_discount_amount": null,
            "eoi_revenue_breakdown_seller_discount_amount": null,
            "eoi_revenue_breakdown_seller_discount_refund_amount": null,
            "eoi_revenue_breakdown_subtotal_before_discount_amount": null,
            "eoi_return_shipping_fee_amount": null,
            "eoi_exchange_shipping_fee_amount": null,
            "eoi_replacement_shipping_fee_amount": null,
            "eoi_return_shipping_label_fee_amount": null,
            "eoi_shipping_insurance_fee_amount": null,
            "eoi_signature_confirmation_fee_amount": null,
            "eoi_customer_shipping_fee_offset_amount": null,
            "eoi_fbm_shipping_cost_amount": null,
            "eoi_fbt_fulfillment_fee_amount": null,
            "eoi_fbt_shipping_cost_amount": null,
            "eoi_promo_shipping_incentive_amount": null,
            "eoi_shipping_fee_subsidy_amount": null,
            "is_hachtoan": 0,
            "hachtoan_datetime": "0000-00-00 00:00:00",
            "deliveried_date": "2026-05-20 15:30:20",
            "shiped_return_date": "2026-05-24 15:30:20",
            "date_scanreturned": "2026-05-26 15:30:20",
            "listProduct": [
                {
                    "productid": 67098801,
                    "price": "250000.000",
                    "amount": "1.000",
                    "storeId": 1,
                    "productName": "GIÀY SNEAKER NAM BN0097 - Đen đỏ - 161218640236",
                    "productcode": "BN0097",
                    "usageunit": "Cái",
                    "unit_price": "250000.000",
                    "weight": "0",
                    "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/fafef0cff452975bc6a87a8a7a67ef7a\"}]",
                    "discount_percent": "0.000",
                    "discount_amount": "0.000",
                    "tax1": "8.000",
                    "vitri": "",
                    "qtyinstock": null
                },
                {
                    "productid": 80243256,
                    "price": "500000.000",
                    "amount": "1.000",
                    "storeId": 1,
                    "productName": "Thùng rác 120 lít-GT 120 A",
                    "productcode": "120L-DEN-19082024",
                    "usageunit": "Cái",
                    "unit_price": "500000.000",
                    "weight": "10000",
                    "imagename": "[{\"id\":1,\"isDefault\":true,\"imgSrc\":\"https://static.abit.vn/sanpham/shop_1/2025/06/08/jpg/2025-06-08-11-24-10-6845106a13defC2_ZPzr6h7.jpg\"}]",
                    "discount_percent": "0.000",
                    "discount_amount": "0.000",
                    "tax1": "0.000",
                    "vitri": "",
                    "qtyinstock": null
                }
            ]
        }
    ]
}
```

{% endtab %}
{% endtabs %}


# Trạng thái đơn hàng

API lấy danh sách trạng thái đơn hàng của shop

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/invoices/invoiceStatusForPartner)

<mark style="color:green;">`POST /`</mark>invoices/invoiceStatusForPartner

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
  "access_token": "MWM4MmFjYjYzYzYwOTkxOTg1OGVjNTA1NjcxY2QwZDc=",
  "partner_name": "bizfly"
}
```

{% endtab %}

{% tab title="Response" %}

```json
[
  {
    "invoicestatusid": 17,
    "invoicestatus": "blacklist",
    "namestatus": "Blacklist",
    "color": "#737373",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 6,
    "invoicestatus": "Chochuyenkhoan",
    "namestatus": "Chờ chuyển khoản",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 46,
    "invoicestatus": "Chonhaphang",
    "namestatus": "Chờ nhập hàng",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 42,
    "invoicestatus": "Choship",
    "namestatus": "Chờ ship",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 2,
    "invoicestatus": "Chuachot",
    "namestatus": "Chưa chốt được",
    "color": "#77ab5c",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 26,
    "invoicestatus": "Chuaphatduoc",
    "namestatus": "Chưa phát được",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 49,
    "invoicestatus": "Chuyenhang",
    "namestatus": "Chuyển hàng",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 27,
    "invoicestatus": "Chuyenhoan",
    "namestatus": "Chuyển hoàn",
    "color": "#9e55a4",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 45,
    "invoicestatus": "Chuyenkhoanloi",
    "namestatus": "Chuyển khoản lỗi",
    "color": "#d52609",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 24,
    "invoicestatus": "CODDathutien",
    "namestatus": "COD-đã thu tiền",
    "color": "#3dbcb3",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 54,
    "invoicestatus": "Giaohangcovande",
    "namestatus": "Giao hàng - Có vấn đề",
    "color": "#c50bd1",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 5,
    "invoicestatus": "Hengoilai",
    "namestatus": "Hẹn gọi lại",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 37,
    "invoicestatus": "Huyvandon",
    "namestatus": "Huỷ vận đơn",
    "color": "#d52609",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 8,
    "invoicestatus": "Huy DNX",
    "namestatus": "Hủy đơn",
    "color": "#d52609",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 57,
    "invoicestatus": "Yeucauhuy",
    "namestatus": "Khách - Yêu cầu hủy",
    "color": "#d52609",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 1,
    "invoicestatus": "AutoCreated",
    "namestatus": "Khách mới",
    "color": "#00a65a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 55,
    "invoicestatus": "Khonglayduochang",
    "namestatus": "Không lấy được hàng",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 39,
    "invoicestatus": "Khongnghemay",
    "namestatus": "Không nghe máy",
    "color": "#d52609",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 44,
    "invoicestatus": "Lead",
    "namestatus": "Lead",
    "color": "#00a65a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 58,
    "invoicestatus": "Matdonhang",
    "namestatus": "Mất đơn hàng",
    "color": "#d52609",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 18,
    "invoicestatus": "Muatructiep",
    "namestatus": "Mua trực tiếp",
    "color": "#3dbcb3",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 29,
    "invoicestatus": "Daphathoanthanhcong",
    "namestatus": "Phát hoàn thành công",
    "color": "#9e55a4",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 30,
    "invoicestatus": "Daphatthanhcong",
    "namestatus": "Phát thành công",
    "color": "#3dbcb3",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 40,
    "invoicestatus": "Saiso",
    "namestatus": "Sai số",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 41,
    "invoicestatus": "Shipnoithanh",
    "namestatus": "Ship nội thành",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 48,
    "invoicestatus": "Thanhcong",
    "namestatus": "Thành công",
    "color": "#243ae0",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 35,
    "invoicestatus": "Tratienchonguoigui",
    "namestatus": "Trả tiền người gửi",
    "color": "#3dbcb3",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 47,
    "invoicestatus": "Trungdon",
    "namestatus": "Trùng đơn",
    "color": "#d52609",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 43,
    "invoicestatus": "Tuchoinhan",
    "namestatus": "Từ chối nhận",
    "color": "#9e55a4",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 51,
    "invoicestatus": "Dachot",
    "namestatus": "Đã chốt",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 4,
    "invoicestatus": "Sent",
    "namestatus": "Đã gửi",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 20,
    "invoicestatus": "Daguibuudien",
    "namestatus": "Đã gửi BĐ",
    "color": "#2e96f7",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 14,
    "invoicestatus": "Dain",
    "namestatus": "Đã in",
    "color": "#006633",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 31,
    "invoicestatus": "Dathutien",
    "namestatus": "Đã thu tiền",
    "color": "#3dbcb3",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 36,
    "invoicestatus": "Deleted",
    "namestatus": "Đã xoá đơn",
    "color": "#d52609",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 50,
    "invoicestatus": "Dadoisoat",
    "namestatus": "Đã đối soát",
    "color": "#044284",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 52,
    "invoicestatus": "Dadoisoatmotphan",
    "namestatus": "Đã đối soát -Một phần",
    "color": "#8e44ad",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 56,
    "invoicestatus": "Dadonggoi",
    "namestatus": "Đã đóng gói",
    "color": "#452b87",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 60,
    "invoicestatus": "Dathangtruoc",
    "namestatus": "Đặt hàng trước",
    "color": "#009688",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 3,
    "invoicestatus": "Approved",
    "namestatus": "Đề nghị xuất",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 38,
    "invoicestatus": "Dienthoaiban",
    "namestatus": "Điện thoại bận",
    "color": "#efb71a",
    "showhidden": 1,
    "timetonextaction": null
  },
  {
    "invoicestatusid": 59,
    "invoicestatus": "Donhoatoc",
    "namestatus": "Đơn hỏa tốc ⚡",
    "color": "#eb6b43",
    "showhidden": 1,
    "timetonextaction": null
  }
]
```

{% endtab %}
{% endtabs %}


# List đơn hàng

API cho phép lấy danh sách đơn hàng theo thời gian và cho phép phân trang, sắp xếp theo thời gian từ tài khoản của shop sau khi được cấp quyền

{% openapi src="<https://petstore3.swagger.io/api/v3/openapi.json>" path="/pet/findByStatus" method="get" %}
<https://petstore3.swagger.io/api/v3/openapi.json>
{% endopenapi %}


# Update trạng thái đơn hàng

API cho phép update trạng thái đơn hàng , danh sách trạng thái đơn hàng của Abit lấy ở API "Trạng thái đơn hàng"

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/invoices/updateStatusInvoice)

<mark style="color:green;">`POST /`</mark>invoices/updateStatusInvoice

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>invoiceid</td><td>int</td><td>ID đơn hàng trên Abit , lấy ID đơn trong API <strong>Danh sách đơn hàng</strong></td></tr><tr><td>invoicestatus</td><td>string</td><td>Mã trạng thái đơn hàng được dùng trên Abit,danh sách này lấy trong API <strong>Trạng thái đơn hàng</strong></td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
  "access_token": "MWM4MmFjYjYzYzYwOTkxOTg1OGVjNTA1NjcxY2QwZDc=",
  "partner_name": "bizfly",
  "invoiceid": 123456,
  "invoicestatus": "Dadonggoi"
}
```

{% endtab %}
{% endtabs %}


# Danh sách đơn trả hàng - hoàn tiền

Danh sách các đơn hàng Hoàn, chỉ có các đơn Trả hàng hoàn tiền

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/invoices/getlistInvoiceReturnAndRefund)

<mark style="color:green;">`POST /`</mark>`invoices/getlistInvoiceReturnAndRefund`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng Shopee , TikTok Shop , ID Fanpage... được kết nối vào Abit, lấy thông tin ID trong mục <strong>Kết nối đa kênh =⇒ Kết nối sàn TMĐT</strong></td></tr><tr><td>productstoreid</td><td>int</td><td>ID Kho hàng, lấy danh sách này ở API <a href="/api-mo-rong/danh-sach-kho-chi-nhanh"><strong>Danh sách kho - Chi nhán</strong>h</a></td></tr><tr><td>filter_by</td><td>string</td><td>filter_by có 2 giá trị <strong>UPDATE</strong> và <strong>CREATE</strong></td></tr><tr><td>order_by</td><td>string</td><td>order_by có 2 giá trị <strong>DESC</strong> và <strong>ASC</strong></td></tr><tr><td>date_time_start</td><td>datetime</td><td>Thời gian bắt đầu lọc , định dạng Y-m-d H:i:s <br>Ví dụ : <strong>2025-03-13 08:00:00</strong></td></tr><tr><td>date_time_end</td><td>datetime</td><td>Thời gian kết thúc lọc , định dạng Y-m-d H:i:s <br>Ví dụ : <strong>2025-03-13 23:59:59</strong></td></tr><tr><td>page</td><td>int</td><td>Phân trang, lấy kết quả ở trang thứ mấy, mặc định giá trị là <strong>0</strong></td></tr><tr><td>limit</td><td>int</td><td>Giới hạn kết quả trả ra, mặc định là <strong>10</strong></td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
  "access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
  "partner_name": "Abit",
  "ecommerce_id":"",
  "productstoreid":1,
  "filter_by": "UPDATE",
  "order_by": "DESC",
  "date_time_start": "2025-05-01 00:00:00",
  "date_time_end": "2025-08-08 23:59:59",
  "page": 0,
  "limit": 10
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "total": 1,
    "data": [
        {
            "invoiceid": 93564672,
            "invoice_no": "TT86722558A86",
            "subject": "260304918AX21Q",
            "dienthoai": "******49",
            "diachigiaohang": "******áng Tám, Phường 13, Quận 10, TP. Hồ Chí Minh",
            "storeid": "23777",
            "invoicestatus": "Daphathoanthanhcong",
            "createdtime": "2026-03-04 15:03:44",
            "modifiedtime": "2026-03-07 13:37:10",
            "smownerid": 52285,
            "total": "0.000",
            "accountid": 0,
            "total_giavon": "1",
            "subtotal": "293620.000",
            "s_h_amount": "0.000",
            "discount_amount": "0.000",
            "mavandon": "SPXVN0632141838793",
            "donvi_vc": "SPX",
            "phivanchuyenthuctra": "0.000",
            "giamgiadonhang": "0.000",
            "tiendatcoc": "248977.000",
            "cuoccod": "",
            "CodAmount": 0,
            "cf_889": "0",
            "tongcuocdi": "",
            "ngaygui": null,
            "idprofile": "66903111",
            "type_invoice": "1",
            "trungdon": "",
            "nguoinhanhang": "H****y",
            "ngayxacnhan": null,
            "confirm_order": null,
            "mahang": "(2)L59-SOCDENCAOCAP-S",
            "ghichu1": "",
            "notevanchuyen": "",
            "provinceCode": "",
            "districtcode": "",
            "is_print": 0,
            "tracking_no": "SPXVN0632141838793",
            "chanel": "Shopee",
            "nhanvien": "demo",
            "staff_cskh": 0,
            "type_client": 0,
            "other_vandon": null,
            "idpage": "79482846",
            "idpost": "",
            "paymentby_voucher": null,
            "paymentby_card": null,
            "paymentby_cash": null,
            "paymentby_other": null,
            "thongdiep": "Mã SP: L59-SOCDENCAOCAP-S Tên SP: Sọc Đen Bản Cao Cấp,S ( 1m50 -1m63), Giá bán: 146810",
            "taxtotal_invoice": "0.000",
            "taxtype": "individual",
            "eoi_fee_and_tax_amount": null,
            "commission_value": "0.00",
            "eoi_escrow_amount": "218795.00",
            "eoi_refund_amount_to_buyer": "0.00",
            "is_doisoat": 1,
            "eoi_service_fee": "14745.00",
            "eoi_commission_fee": "39639.00",
            "salescommission": "0",
            "eoi_fee_voucher_xtra_service_fee_amount": null,
            "eoi_fee_flash_sales_service_fee_amount": null,
            "eoi_actual_shipping_fee": "38000.00",
            "ecommerce_id": "79482846",
            "eoi_buyer_total_amount": "248977.00",
            "eoi_original_price": "598000.00",
            "eoi_seller_discount": "304380.00",
            "eoi_platform_discount": "0.00",
            "eoi_shippingprovider_discount": null,
            "eoi_voucher_from_seller": "0.00",
            "eoi_voucher_from_platform": "44043.00",
            "eoi_coins": "600.00",
            "eoi_buyer_paid_shipping_fee": "0.00",
            "eoi_buyer_transaction_fee": "0.00",
            "eoi_cross_border_tax": "0.00",
            "eoi_payment_promotion": "0.00",
            "eoi_seller_transaction_fee": "14417.00",
            "eoi_seller_lost_compensation": "0.00",
            "eoi_seller_coin_cash_back": "0.00",
            "eoi_final_shipping_fee": 0,
            "eoi_final_seller_service_fee_list_fee_amount": 0,
            "eoi_shopee_shipping_rebate": "38000.00",
            "eoi_shipping_fee_discount_from_3pl": "0.00",
            "eoi_seller_shipping_discount": "0.00",
            "eoi_estimated_shipping_fee": "38000.00",
            "eoi_seller_voucher_code": "VCXFA70K0403",
            "eoi_drc_adjustable_refund": "0.00",
            "eoi_cost_of_goods_sold": "293620.00",
            "eoi_original_cost_of_goods_sold": "293620.00",
            "eoi_original_platform_discount": "0.00",
            "eoi_seller_return_refund": "0.00",
            "eoi_reverse_shipping_fee": "1620.00",
            "eoi_final_product_vat_tax": "0.00",
            "eoi_rts_sla": "0",
            "eoi_rts_time": null,
            "eoi_tts_sla": "0",
            "eoi_order_id": "260304918AX21Q",
            "eoi_cancel_order_sla": "0",
            "eoi_cancel_reason": null,
            "eoi_cancel_user": null,
            "eoi_fulfillment_type": 0,
            "return_order_id": "2603120VHV1B3YD",
            "return_tracking_no": "SPXVN0612180613533",
            "return_shipping_provider": null,
            "is_trahang_hoantien": 0,
            "eoi_fee_affiliate_ads_commission_amount": "0.00",
            "eoi_fee_affiliate_commission_amount_before_pit": null,
            "eoi_fee_affiliate_partner_commission_amount": null,
            "eoi_fee_bonus_cashback_service_fee_amount": null,
            "eoi_fee_cofunded_promotion_service_fee_amount": null,
            "eoi_fee_credit_card_handling_fee_amount": null,
            "eoi_fee_dt_handling_fee_amount": null,
            "eoi_fee_epr_pob_service_fee_amount": null,
            "eoi_fee_live_specials_fee_amount": null,
            "eoi_fee_mall_service_fee_amount": null,
            "eoi_fee_pre_order_service_fee_amount": null,
            "eoi_fee_referral_fee_amount": null,
            "eoi_fee_refund_administration_fee_amount": null,
            "eoi_fee_sfp_service_fee_amount": null,
            "eoi_fee_tsp_commission_amount": null,
            "eoi_tax_anti_dumping_duty_amount": null,
            "eoi_tax_customs_clearance_amount": null,
            "eoi_tax_customs_duty_amount": null,
            "eoi_tax_gst_amount": null,
            "eoi_tax_import_vat_amount": null,
            "eoi_tax_isr_amount": null,
            "eoi_tax_iva_amount": null,
            "eoi_tax_local_vat_amount": null,
            "eoi_tax_pit_amount": "1468.00",
            "eoi_tax_sst_amount": null,
            "eoi_tax_vat_amount": "2936.00",
            "eoi_revenue_breakdown_cod_service_fee_amount": null,
            "eoi_revenue_breakdown_refund_cod_service_fee_amount": null,
            "eoi_revenue_breakdown_refund_subtotal_before_discount_amount": null,
            "eoi_revenue_breakdown_seller_discount_amount": null,
            "eoi_revenue_breakdown_seller_discount_refund_amount": null,
            "eoi_revenue_breakdown_subtotal_before_discount_amount": null,
            "eoi_return_shipping_fee_amount": null,
            "eoi_exchange_shipping_fee_amount": null,
            "eoi_replacement_shipping_fee_amount": null,
            "eoi_return_shipping_label_fee_amount": null,
            "eoi_shipping_insurance_fee_amount": null,
            "eoi_signature_confirmation_fee_amount": null,
            "eoi_customer_shipping_fee_offset_amount": null,
            "eoi_fbm_shipping_cost_amount": null,
            "eoi_fbt_fulfillment_fee_amount": "0.00",
            "eoi_fbt_shipping_cost_amount": null,
            "eoi_promo_shipping_incentive_amount": null,
            "eoi_shipping_fee_subsidy_amount": null,
            "is_hachtoan": 1,
            "ecom_username": "nnghaivy655",
            "ecom_buyer_uid": "66903111",
            "hachtoan_datetime": "2026-03-04 15:03:44",
            "return_status": "ACCEPTED",
            "return_type": "RETURN_AND_REFUND",
            "return_reason": "Thiếu hàng / thiếu phụ kiện.",
            "return_text_reason": "Shop giao thiếu hàng 1 quần",
            "response_deadline": "",
            "eoi_return_product": "[{\"add_on_deal_id\":0,\"amount\":2,\"hot_listing_item\":false,\"images\":[\"http://mms.img.susercontent.com/vn-11134207-820l4-mhvo2wrjcdzye32\",\"http://mms.img.susercontent.com/vn-11134207-7ra0g-m8h577p9cw1w48\",\"http://mms.img.susercontent.com/vn-11134207-820l4-mhvodso1log04e3\",\"http://mms.img.susercontent.com/vn-11134207-820l4-mhvodmfd7hretd4\",\"http://mms.img.susercontent.com/vn-11134207-7ra0g-m8hf57trn2ero9c\",\"http://mms.img.susercontent.com/vn-11134207-7ra0g-m8h58afiokg78e2\",\"http://mms.img.susercontent.com/vn-11134207-7ra0g-m8h5cjmsyk6ys7c\"],\"is_add_on_deal\":false,\"is_main_item\":false,\"item_id\":25232281215,\"item_price\":146810,\"item_sku\":\"L59\",\"model_id\":256197201044,\"name\":\"[Lời tạm biệt thanh lý]Quần ống suông bản cao cấp chất liệu tuytsi kẻ sọc trơn không nhăn , độ bền cao , thoáng mát L59\",\"refund_amount\":124488.5,\"variation_sku\":\"L59-SOCDENCAOCAP-S\"}]",
            "productstoreid": 23777
        }
    ]
}
```

{% endtab %}
{% endtabs %}


# Kết nối tài khoản Zalo

Kết nối tài khoản Zalo của nhân viên Sale - Tư vấn để tương tác với chính Khách hàng, Báo giá, Đơn hàng mà họ đang quản lý giúp tăng tỷ lệ chốt đơn, báo giá và trải nghiệm khách hàng

<mark style="color:orange;">**Abit được thiết kế mỗi tài khoản nhân viên của shop được kết nối và dùng với một tài khoản Zalo tương ứng. Khi có những biến động, thay đổi về trạng thái, nội dung liên quan đến Khách hàng, Đơn hàng, Báo giá thì Abit sẽ gửi tự động tin nhắn Zalo cho Khách hàng theo SĐT trong báo giá, khách hàng và đơn hàng đó.**</mark>

Để kết nối tài khoản Zalo của nhân viên tư vấn - Sale thì các bạn Sale, tư vấn **tự thao tác kết nối Zalo cá nhân** vào sau khi đăng nhập vào Abit bằng tài khoản của họ. Thao tác theo các mục sau

{% stepper %}
{% step %}

### Truy cập vào menu Kết Nối Đa Kênh

Vào tiếp mục Kết nối Zalo để bắt đầu thực hiện kết nối
{% endstep %}

{% step %}

### Click vào button Kết nối Zalo cá nhân

Sau khi bạn bấm vào button này thì Abit sẽ chuyển sang một trang mới. Bạn bấm Tạo mã QR đăng nhập . Mã QR hiện ra, dùng Zalo trên điện thoại của bạn để quét và xác nhận đăng nhập. Chú ý không thao tác đăng nhập Zalo này trên trình duyệt web nào khác

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2F75qNich6JX2o16nxpDfA%2Fbutton-ket-noi-zalo.png?alt=media&amp;token=d720be31-9e6f-4feb-9ce1-25cef4c65582" alt=""><figcaption><p>Bấm button Kết nối Zalo để thêm tài khoản Zalo cá nhân của nhân viên vào Abit</p></figcaption></figure>

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2FIFLUPR618SMxsENLE6ko%2Fqr-dang-nhap-zalo-ca-nhan.png?alt=media&amp;token=1cc3ce88-0dbc-4235-ac63-0054afa2686c" alt=""><figcaption><p>Nhấn Tạo QR đăng nhập để quét mã trên ứng dụng Zalo để xác nhận đăng nhập</p></figcaption></figure>

{% endstep %}
{% endstepper %}


# API gửi tin nhắn Zalo

API cho phép gửi tin nhắn Zalo cá nhân của Tư vấn - sale đến một số điện thoại Zalo của khách hàng

Sau khi kết nối các tài khoản Zalo của nhân viên Sale vào Abit. Bạn có thể cấu hình kịch bản CSKH và bán hàng tự động. Abit **NÓI KHÔNG VỚI SPAM** vì vậy Quý khách hàng dùng và tương tác với khách hàng nên như người dùng thật bởi tin nhắn được gửi bởi chính Zalo của nhân viên kinh doanh của shop. Đây là các nick zalo có thể hằng ngày vẫn đang trao đổi công việc với khách hàng. Việc gửi tin nhắn với nội dung thể nào để gây thiện cảm với khách hàng, **Sale mà như Không Sale** thì lại là nghệ thuật bán hàng của Shop :smile: và tất nhiên Zalo cá nhân cũng có các giới hạn được thiết kế bởi đội ngũ của Zalo như Số lần tìm kiếm SĐT / giờ, số lần gửi tin nhắn cho người lạ, số lần gửi kết bạn/ngày và để tránh việc Zalo đánh giá là Spam tin nhắn, Abit cũng có cấu hình các giới hạn trên tối đa

Sau một thời gian nghiên cứu thì Abit đã có thể giúp các shop bán hàng trên Zalo cá nhân một cách hiệu quả hơn, nâng cao tỷ lệ chốt đơn, gia tăng doanh số bán hàng với tệp khách cũ một cách tự động với một số tính năng <mark style="color:red;">**CÓ THỂ CẤU HÌNH TRÊN ABIT**</mark>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> xác nhận đơn hàng</summary>

Đơn hàng khách đặt từ các nguồn Ladipage, Website, Fanpage với SĐT khách hàng. Abit có thể gửi tin nhắn tự động với Zalo cá nhân của khách hàng thông qua SĐT khách đặt đơn

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động inbox Zalo</strong></mark> cá nhân theo tiến trình đơn hàng</summary>

Đơn hàng được gửi sang đơn vị vận chuyển từ Abit và Abit có thể dùng các Zalo đã kết nối và care đơn hàng đó để gửi tự động khi trạng thái của đơn hàng thay đổi

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> inbox theo kịch bản trước và sau bán hàng</summary>

* **Trước bán hàng** thì hỏi thăm , trao đổi với khách tự động thường xuyên với các Doanh nghiệp hay gửi báo giá, đơn hàng chưa chốt được, Tránh trường hợp nhân viên nhiều đơn và bỏ rơi khách hàng thì Abit luôn gửi tự động cho khách để hỏi thăm, thúc đẩy việc chốt đơn, chốt báo giá. Nhiều khi khách mua hàng, chốt hợp đồng vì sự nhiệt tình của Sale :joy:
* **Sau bán hàng** ( Đơn hàng giao thành công) thì hẹn lịch trong cấu hình sau 15 ngày, 30 ngày, 45 ngngày ... để Abit gửi nội dung theo kịch bản mà bạn cấu hình để bán thêm, bán chéo sản phẩm, giúp upsale hiệu quả hơn

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> gửi tin nhắn Zalo theo kịch bản Sinh nhật</summary>

**Trước ngày sinh nhật** khách hàng trên Zalo, có các mốc thời gian có thể cấu hình để gửi nội dung khuyến mại, voucher , quà tặng trước ngày sinh của khách \
**Trong ngày sinh nhật** thì gửi nội dung chúc mừng sinh nhật

**Sau ngày sinh nhật** thì cấu hình nội dung gửi bán hàng tiếp :smile:

</details>

<details>

<summary><mark style="color:green;"><strong>Chủ động</strong></mark> tạo chiến dịch Remarketing 0 ĐỒNG  khách hàng cũ</summary>

* Bạn có thể tạo các chiến dịch gửi text, gửi text kèm nhiều ảnh theo nội dung bạn muốn để bán hàng cho khách hàng cũ thông qua Zalo cá nhân. Lọc tệp khách này trong Báo giá, Đơn hàng, Khách hàng. Hỗ trợ lọc dc giới tính, độ tuổi
* Import tệp SĐT ở ngoài vào Abit và gửi tin nhắn tới tệp khách hàng đó dễ dàng
* Load danh sách bạn bè của Zalo nhân viên và gửi tin nhắn đến tệp đó (Comming soon)

</details>

### Gửi tin nhắn Zalo bằng API của Abit với các <mark style="color:red;">HỆ THỐNG NGOÀI ABIT</mark>

Mỗi một nick Zalo của nhân viên sau khi kết nối vào Abit đều có thể đứng từ hệ thống ngoài để gọi đến <mark style="color:purple;">**URL API**</mark> đó và gửi <mark style="color:purple;">**BODY**</mark> theo định dạng của Abit thiết kế để gửi tin nhắn đến SĐT mà shop truyền vào

Để lấy URL này, Quý khách hàng vào phần  danh sách Zalo vừa kết nối, có mục <mark style="color:blue;">**URL API**</mark> trên mỗi nick Zalo nhân viên và gửi đến url trên với body định dạng như mẫu dưới đây

Phương thức: <mark style="color:green;">POST</mark>

{% tabs %}
{% tab title="URL API Example" %}

```
https://new.abitstore.vn/zalo/sendMessageZalo/2/{ma-shop}/{ma-truy-cap}
```

{% endtab %}

{% tab title="Body" %}

```json
{
"send_from_number": "84942813663",
"send_to_number": "84975387753",
"message": "Nội dung gửi tin nhắn Zalo đến Khách hàng",
"action": "make_friend"
}
```

{% endtab %}
{% endtabs %}

<table><thead><tr><th>Tham số</th><th>Giá trị</th></tr></thead><tbody><tr><td><pre><code>send_from_number
</code></pre></td><td>SĐT Zalo dùng để gửi, chú ý copy đúng định dạng số dạng <mark style="color:$danger;"><strong>84</strong></mark><strong>975xxxxxxx</strong></td></tr><tr><td><pre><code>send_to_number
</code></pre></td><td>SĐT Zalo người nhận</td></tr><tr><td><pre><code>message
</code></pre></td><td>Nội dung tin nhắn Text gửi cho khách hàng của bạn, có thể dùng thẻ gọi <strong>{{gioitinh}}</strong> hoặc <strong>{{name}}</strong> trong nội dung  tin nhắn để gọi giới tính <strong>(Anh/Chị)</strong> và Tên Zalo hiển thị của Khách</td></tr><tr><td><pre><code>action
</code></pre></td><td>Dùng trong trường hợp cần gửi tin nhắn kèm hành động gửi Yêu cầu kết bạn. Tham số truyền vào là  <strong>make_friend</strong> hoặc để trống</td></tr></tbody></table>


# API gửi hình ảnh Zalo

API cho phép gửi tin nhắn - hình ảnh Zalo cá nhân của Tư vấn - sale đến một số điện thoại Zalo của khách hàng

Sau khi kết nối các tài khoản Zalo của nhân viên Sale vào Abit. Bạn có thể cấu hình kịch bản CSKH và bán hàng tự động. Abit **NÓI KHÔNG VỚI SPAM** vì vậy Quý khách hàng dùng và tương tác với khách hàng nên như người dùng thật bởi tin nhắn được gửi bởi chính Zalo của nhân viên kinh doanh của shop. Đây là các nick zalo có thể hằng ngày vẫn đang trao đổi công việc với khách hàng. Việc gửi tin nhắn với nội dung thể nào để gây thiện cảm với khách hàng, **Sale mà như Không Sale** thì lại là nghệ thuật bán hàng của Shop :smile: và tất nhiên Zalo cá nhân cũng có các giới hạn được thiết kế bởi đội ngũ của Zalo như Số lần tìm kiếm SĐT / giờ, số lần gửi tin nhắn cho người lạ, số lần gửi kết bạn/ngày và để tránh việc Zalo đánh giá là Spam tin nhắn, Abit cũng có cấu hình các giới hạn trên tối đa

Sau một thời gian nghiên cứu thì Abit đã có thể giúp các shop bán hàng trên Zalo cá nhân một cách hiệu quả hơn, nâng cao tỷ lệ chốt đơn, gia tăng doanh số bán hàng với tệp khách cũ một cách tự động với một số tính năng <mark style="color:red;">**CÓ THỂ CẤU HÌNH TRÊN ABIT**</mark>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> xác nhận đơn hàng</summary>

Đơn hàng khách đặt từ các nguồn Ladipage, Website, Fanpage với SĐT khách hàng. Abit có thể gửi tin nhắn tự động với Zalo cá nhân của khách hàng thông qua SĐT khách đặt đơn

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động inbox Zalo</strong></mark> cá nhân theo tiến trình đơn hàng</summary>

Đơn hàng được gửi sang đơn vị vận chuyển từ Abit và Abit có thể dùng các Zalo đã kết nối và care đơn hàng đó để gửi tự động khi trạng thái của đơn hàng thay đổi

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> inbox theo kịch bản trước và sau bán hàng</summary>

* **Trước bán hàng** thì hỏi thăm , trao đổi với khách tự động thường xuyên với các Doanh nghiệp hay gửi báo giá, đơn hàng chưa chốt được, Tránh trường hợp nhân viên nhiều đơn và bỏ rơi khách hàng thì Abit luôn gửi tự động cho khách để hỏi thăm, thúc đẩy việc chốt đơn, chốt báo giá. Nhiều khi khách mua hàng, chốt hợp đồng vì sự nhiệt tình của Sale :joy:
* **Sau bán hàng** ( Đơn hàng giao thành công) thì hẹn lịch trong cấu hình sau 15 ngày, 30 ngày, 45 ngngày ... để Abit gửi nội dung theo kịch bản mà bạn cấu hình để bán thêm, bán chéo sản phẩm, giúp upsale hiệu quả hơn

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> gửi tin nhắn Zalo theo kịch bản Sinh nhật</summary>

**Trước ngày sinh nhật** khách hàng trên Zalo, có các mốc thời gian có thể cấu hình để gửi nội dung khuyến mại, voucher , quà tặng trước ngày sinh của khách \
**Trong ngày sinh nhật** thì gửi nội dung chúc mừng sinh nhật

**Sau ngày sinh nhật** thì cấu hình nội dung gửi bán hàng tiếp :smile:

</details>

<details>

<summary><mark style="color:green;"><strong>Chủ động</strong></mark> tạo chiến dịch Remarketing 0 ĐỒNG  khách hàng cũ</summary>

* Bạn có thể tạo các chiến dịch gửi text, gửi text kèm nhiều ảnh theo nội dung bạn muốn để bán hàng cho khách hàng cũ thông qua Zalo cá nhân. Lọc tệp khách này trong Báo giá, Đơn hàng, Khách hàng. Hỗ trợ lọc dc giới tính, độ tuổi
* Import tệp SĐT ở ngoài vào Abit và gửi tin nhắn tới tệp khách hàng đó dễ dàng
* Load danh sách bạn bè của Zalo nhân viên và gửi tin nhắn đến tệp đó (Comming soon)

</details>

### Gửi tin nhắn Zalo bằng API của Abit với các <mark style="color:red;">HỆ THỐNG NGOÀI ABIT</mark>

Mỗi một nick Zalo của nhân viên sau khi kết nối vào Abit đều có thể đứng từ hệ thống ngoài để gọi đến <mark style="color:purple;">**URL API**</mark> đó và gửi <mark style="color:purple;">**BODY**</mark> theo định dạng của Abit thiết kế để gửi tin nhắn đến SĐT mà shop truyền vào

Để lấy URL này, Quý khách hàng vào phần  danh sách Zalo vừa kết nối, có mục <mark style="color:blue;">**URL API**</mark> trên mỗi nick Zalo nhân viên và gửi đến url trên với body định dạng như mẫu dưới đây

Phương thức: <mark style="color:green;">POST</mark>

{% tabs %}
{% tab title="URL API Example" %}

```
https://new.abitstore.vn/zalo/sendImageZalo/2/{ma-shop}/{ma-truy-cap}
```

{% endtab %}

{% tab title="Body" %}

```json
{
"send_from_number": "84942813663",
"send_to_number": "84975387753",
"message": "Abit là phần mềm quản lý bán hàng đa kênh online hỗ trợ vận hành đơn hàng trên nhiều gian hàng, chat tập trung nhiều Fanpage, Gian hàng",
"image_url": "https://blog.abitstore.vn/photos/1/huongdan/api-zalo-ca-nhan.jpg"
}
```

{% endtab %}
{% endtabs %}

<table><thead><tr><th>Tham số</th><th>Giá trị</th></tr></thead><tbody><tr><td><pre><code>send_from_number
</code></pre></td><td>SĐT Zalo dùng để gửi. Bắt buộc phải có thông tin, chú ý copy đúng định dạng số dạng <mark style="color:$danger;"><strong>84</strong></mark><strong>975xxxxxxx</strong></td></tr><tr><td><pre><code>send_to_number
</code></pre></td><td>SĐT Zalo người nhận</td></tr><tr><td><pre><code>message
</code></pre></td><td>Nội dung tin nhắn Text gửi cho khách hàng của bạn, có thể dùng thẻ gọi <strong>{{gioitinh}}</strong> hoặc <strong>{{name}}</strong> trong nội dung  tin nhắn để gọi giới tính <strong>(Anh/Chị)</strong> và Tên Zalo hiển thị của Khách, trường này có thể bỏ trống nếu không gửi gì</td></tr><tr><td><pre><code>image_url
</code></pre></td><td>Dùng trong trường hợp cần gửi ảnh sản phẩm, chương trình khuyến mại cho khách hàng. Nó có thể là các đường dẫn ảnh bất kỳ trên internet, kích thước ảnh nên là ảnh vuông để có kết quả tốt nhất (1000px X 1000px)</td></tr></tbody></table>


# API gửi File tài liệu Zalo

API cho phép gửi File tài liệu (PDF, Word, Exel, File Ảnh) từ Zalo cá nhân của Tư vấn - sale đến một số điện thoại Zalo của khách hàng

Sau khi kết nối các tài khoản Zalo của nhân viên Sale vào Abit. Bạn có thể cấu hình kịch bản CSKH và bán hàng tự động. Abit **NÓI KHÔNG VỚI SPAM** vì vậy Quý khách hàng dùng và tương tác với khách hàng nên như người dùng thật bởi tin nhắn được gửi bởi chính Zalo của nhân viên kinh doanh của shop. Đây là các nick zalo có thể hằng ngày vẫn đang trao đổi công việc với khách hàng. Việc gửi tin nhắn với nội dung thể nào để gây thiện cảm với khách hàng, **Sale mà như Không Sale** thì lại là nghệ thuật bán hàng của Shop :smile: và tất nhiên Zalo cá nhân cũng có các giới hạn được thiết kế bởi đội ngũ của Zalo như Số lần tìm kiếm SĐT / giờ, số lần gửi tin nhắn cho người lạ, số lần gửi kết bạn/ngày và để tránh việc Zalo đánh giá là Spam tin nhắn, Abit cũng có cấu hình các giới hạn trên tối đa

Sau một thời gian nghiên cứu thì Abit đã có thể giúp các shop bán hàng trên Zalo cá nhân một cách hiệu quả hơn, nâng cao tỷ lệ chốt đơn, gia tăng doanh số bán hàng với tệp khách cũ một cách tự động với một số tính năng <mark style="color:red;">**CÓ THỂ CẤU HÌNH TRÊN ABIT**</mark>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> xác nhận đơn hàng</summary>

Đơn hàng khách đặt từ các nguồn Ladipage, Website, Fanpage với SĐT khách hàng. Abit có thể gửi tin nhắn tự động với Zalo cá nhân của khách hàng thông qua SĐT khách đặt đơn

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động inbox Zalo</strong></mark> cá nhân theo tiến trình đơn hàng</summary>

Đơn hàng được gửi sang đơn vị vận chuyển từ Abit và Abit có thể dùng các Zalo đã kết nối và care đơn hàng đó để gửi tự động khi trạng thái của đơn hàng thay đổi

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> inbox theo kịch bản trước và sau bán hàng</summary>

* **Trước bán hàng** thì hỏi thăm , trao đổi với khách tự động thường xuyên với các Doanh nghiệp hay gửi báo giá, đơn hàng chưa chốt được, Tránh trường hợp nhân viên nhiều đơn và bỏ rơi khách hàng thì Abit luôn gửi tự động cho khách để hỏi thăm, thúc đẩy việc chốt đơn, chốt báo giá. Nhiều khi khách mua hàng, chốt hợp đồng vì sự nhiệt tình của Sale :joy:
* **Sau bán hàng** ( Đơn hàng giao thành công) thì hẹn lịch trong cấu hình sau 15 ngày, 30 ngày, 45 ngngày ... để Abit gửi nội dung theo kịch bản mà bạn cấu hình để bán thêm, bán chéo sản phẩm, giúp upsale hiệu quả hơn

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> gửi tin nhắn Zalo theo kịch bản Sinh nhật</summary>

**Trước ngày sinh nhật** khách hàng trên Zalo, có các mốc thời gian có thể cấu hình để gửi nội dung khuyến mại, voucher , quà tặng trước ngày sinh của khách \
**Trong ngày sinh nhật** thì gửi nội dung chúc mừng sinh nhật

**Sau ngày sinh nhật** thì cấu hình nội dung gửi bán hàng tiếp :smile:

</details>

<details>

<summary><mark style="color:green;"><strong>Chủ động</strong></mark> tạo chiến dịch Remarketing 0 ĐỒNG  khách hàng cũ</summary>

* Bạn có thể tạo các chiến dịch gửi text, gửi text kèm nhiều ảnh theo nội dung bạn muốn để bán hàng cho khách hàng cũ thông qua Zalo cá nhân. Lọc tệp khách này trong Báo giá, Đơn hàng, Khách hàng. Hỗ trợ lọc dc giới tính, độ tuổi
* Import tệp SĐT ở ngoài vào Abit và gửi tin nhắn tới tệp khách hàng đó dễ dàng
* Load danh sách bạn bè của Zalo nhân viên và gửi tin nhắn đến tệp đó (Comming soon)

</details>

### Gửi tin nhắn Zalo bằng API của Abit với các <mark style="color:red;">HỆ THỐNG NGOÀI ABIT</mark>

Mỗi một nick Zalo của nhân viên sau khi kết nối vào Abit đều có thể đứng từ hệ thống ngoài để gọi đến <mark style="color:purple;">**URL API**</mark> đó và gửi <mark style="color:purple;">**BODY**</mark> theo định dạng của Abit thiết kế để gửi tin nhắn đến SĐT mà shop truyền vào

Để lấy URL này, Quý khách hàng vào phần  danh sách Zalo vừa kết nối, có mục <mark style="color:blue;">**URL API**</mark> trên mỗi nick Zalo nhân viên và gửi đến url trên với body định dạng như mẫu dưới đây

Phương thức: <mark style="color:green;">POST</mark>

{% tabs %}
{% tab title="URL API Example" %}

```
https://new.abitstore.vn/zalo/sendFileZalo/2/{ma-shop}/{ma-truy-cap}
```

{% endtab %}

{% tab title="Body" %}

```json
{
    "send_from_number": "84975387753",
    "send_to_number": "0987009531",
    "message":"Xin chào {{gioitinh}} ! Abit gửi nội dung TEXT và Gửi dưới dạng File, có thể áp dụng gửi file PDF, Excel, Word, file Ảnh (Loại này khác với gửi Ảnh dạng Photo nhé)",
    "file_url":[
        {
            "file_url_item":"https://static.abit.vn/sanpham/shop_16777/2026/01/31/file/2026-01-31-10-38-23-697d792f17667OTc5NDE4Ci.pdf",
            "file_name_item":"Bảng giá Abit"
        },
        {
            "file_url_item":"https://thd.ancarat.vn/images/customer_code/bang_gia_bac_chon_loc_acr.png",
            "file_name_item":"Giá vàng hôm nay"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

<table><thead><tr><th>Tham số</th><th>Giá trị</th></tr></thead><tbody><tr><td><pre><code>send_from_number
</code></pre></td><td>SĐT Zalo dùng để gửi. Bắt buộc phải có thông tin, chú ý copy đúng định dạng số dạng <mark style="color:$danger;"><strong>84</strong></mark><strong>975xxxxxxx</strong></td></tr><tr><td><pre><code>send_to_number
</code></pre></td><td>SĐT Zalo người nhận</td></tr><tr><td><pre><code>message
</code></pre></td><td>Nội dung tin nhắn Text gửi cho khách hàng của bạn, có thể dùng thẻ gọi <strong>{{gioitinh}}</strong> hoặc <strong>{{name}}</strong> trong nội dung  tin nhắn để gọi giới tính <strong>(Anh/Chị)</strong> và Tên Zalo hiển thị của Khách, trường này có thể bỏ trống nếu không gửi gì</td></tr><tr><td><pre><code>file_url
</code></pre></td><td>Dùng trong trường hợp cần gửi ảnh sản phẩm, chương trình khuyến mại cho khách hàng. Nó có thể là các đường dẫn ảnh bất kỳ trên internet, kích thước ảnh nên là ảnh vuông để có kết quả tốt nhất (1000px X 1000px)<br>Abit thiết kế cho phép gửi nhiều file ảnh, file tài liệu (PDF, Word, Excel..), dữ liệu dạng <strong>Array</strong></td></tr><tr><td><pre><code>file_url_item
</code></pre></td><td>Đường dẫn file Ảnh hoặc File tài liệu đã upload lên Internet mà Abit có thể truy cập</td></tr><tr><td><pre><code>file_name_item
</code></pre></td><td>Tên file Ảnh hoặc File tài liệu hiển thị với người nhận, Nên nhập tên cụ thể của từng file để người nhận biết đó là file với nội dung gì sẽ tốt hơn</td></tr></tbody></table>

Kết quả gửi qua API sẽ như này, bạn có thể áp dụng để đứng ở các hệ thống ngoài Abit gửi file tài liệu&#x20;

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2FSyQxDYKUnfNoUWXXFPr9%2Ffile-anh-file-tai-lieu-zalo.png?alt=media&amp;token=5c9775ec-611e-45be-8128-a0cbec646a5b" alt=""><figcaption></figcaption></figure>


# API gửi File tài liệu vào nhóm Zalo

API cho phép gửi File tài liệu (PDF, Word, Exel, File Ảnh) từ Zalo cá nhân của Tư vấn - sale đến một nhóm Zalo với khách hàng

Sau khi kết nối các tài khoản Zalo của nhân viên Sale vào Abit. Bạn có thể cấu hình kịch bản CSKH và bán hàng tự động. Abit **NÓI KHÔNG VỚI SPAM** vì vậy Quý khách hàng dùng và tương tác với khách hàng nên như người dùng thật bởi tin nhắn được gửi bởi chính Zalo của nhân viên kinh doanh của shop. Đây là các nick zalo có thể hằng ngày vẫn đang trao đổi công việc với khách hàng. Việc gửi tin nhắn với nội dung thể nào để gây thiện cảm với khách hàng, **Sale mà như Không Sale** thì lại là nghệ thuật bán hàng của Shop :smile: và tất nhiên Zalo cá nhân cũng có các giới hạn được thiết kế bởi đội ngũ của Zalo như Số lần tìm kiếm SĐT / giờ, số lần gửi tin nhắn cho người lạ, số lần gửi kết bạn/ngày và để tránh việc Zalo đánh giá là Spam tin nhắn, Abit cũng có cấu hình các giới hạn trên tối đa

Sau một thời gian nghiên cứu thì Abit đã có thể giúp các shop bán hàng trên Zalo cá nhân một cách hiệu quả hơn, nâng cao tỷ lệ chốt đơn, gia tăng doanh số bán hàng với tệp khách cũ một cách tự động với một số tính năng <mark style="color:red;">**CÓ THỂ CẤU HÌNH TRÊN ABIT**</mark>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> xác nhận đơn hàng</summary>

Đơn hàng khách đặt từ các nguồn Ladipage, Website, Fanpage với SĐT khách hàng. Abit có thể gửi tin nhắn tự động với Zalo cá nhân của khách hàng thông qua SĐT khách đặt đơn

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động inbox Zalo</strong></mark> cá nhân theo tiến trình đơn hàng</summary>

Đơn hàng được gửi sang đơn vị vận chuyển từ Abit và Abit có thể dùng các Zalo đã kết nối và care đơn hàng đó để gửi tự động khi trạng thái của đơn hàng thay đổi

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> inbox theo kịch bản trước và sau bán hàng</summary>

* **Trước bán hàng** thì hỏi thăm , trao đổi với khách tự động thường xuyên với các Doanh nghiệp hay gửi báo giá, đơn hàng chưa chốt được, Tránh trường hợp nhân viên nhiều đơn và bỏ rơi khách hàng thì Abit luôn gửi tự động cho khách để hỏi thăm, thúc đẩy việc chốt đơn, chốt báo giá. Nhiều khi khách mua hàng, chốt hợp đồng vì sự nhiệt tình của Sale :joy:
* **Sau bán hàng** ( Đơn hàng giao thành công) thì hẹn lịch trong cấu hình sau 15 ngày, 30 ngày, 45 ngngày ... để Abit gửi nội dung theo kịch bản mà bạn cấu hình để bán thêm, bán chéo sản phẩm, giúp upsale hiệu quả hơn

</details>

<details>

<summary><mark style="color:green;"><strong>Tự động</strong></mark> gửi tin nhắn Zalo theo kịch bản Sinh nhật</summary>

**Trước ngày sinh nhật** khách hàng trên Zalo, có các mốc thời gian có thể cấu hình để gửi nội dung khuyến mại, voucher , quà tặng trước ngày sinh của khách \
**Trong ngày sinh nhật** thì gửi nội dung chúc mừng sinh nhật

**Sau ngày sinh nhật** thì cấu hình nội dung gửi bán hàng tiếp :smile:

</details>

<details>

<summary><mark style="color:green;"><strong>Chủ động</strong></mark> tạo chiến dịch Remarketing 0 ĐỒNG  khách hàng cũ</summary>

* Bạn có thể tạo các chiến dịch gửi text, gửi text kèm nhiều ảnh theo nội dung bạn muốn để bán hàng cho khách hàng cũ thông qua Zalo cá nhân. Lọc tệp khách này trong Báo giá, Đơn hàng, Khách hàng. Hỗ trợ lọc dc giới tính, độ tuổi
* Import tệp SĐT ở ngoài vào Abit và gửi tin nhắn tới tệp khách hàng đó dễ dàng
* Load danh sách bạn bè của Zalo nhân viên và gửi tin nhắn đến tệp đó (Comming soon)

</details>

### Gửi tin nhắn Zalo bằng API của Abit với các <mark style="color:red;">HỆ THỐNG NGOÀI ABIT</mark>

Mỗi một nick Zalo của nhân viên sau khi kết nối vào Abit đều có thể đứng từ hệ thống ngoài để gọi đến <mark style="color:purple;">**URL API**</mark> đó và gửi <mark style="color:purple;">**BODY**</mark> theo định dạng của Abit thiết kế để gửi tin nhắn đến SĐT mà shop truyền vào

Để lấy URL này, Quý khách hàng vào phần  danh sách Zalo vừa kết nối, có mục <mark style="color:blue;">**URL API**</mark> trên mỗi nick Zalo nhân viên và gửi đến url trên với body định dạng như mẫu dưới đây

Phương thức: <mark style="color:green;">POST</mark>

{% tabs %}
{% tab title="URL API Example" %}

```
https://new.abitstore.vn/zalo/sendFileToGroupZalo/2/{ma-shop}/{ma-truy-cap}
```

{% endtab %}

{% tab title="Body" %}

```json
{
    "send_from_number": "84975387753",
    "send_to_groupid": "4973309772266774852",
    "message":"Xin chào ! Abit gửi nội dung TEXT và Gửi dưới dạng File, có thể áp dụng gửi file PDF, Excel, Word, file Ảnh vào nhóm Zalo, các thẻ gọi thông tin giới tính, tên zalo ko dùng được",
    "file_url":[
        {
            "file_url_item":"https://static.abit.vn/sanpham/shop_16777/2026/01/31/file/2026-01-31-10-38-23-697d792f17667OTc5NDE4Ci.pdf",
            "file_name_item":"Bảng giá Abit"
        },
        {
            "file_url_item":"https://thd.ancarat.vn/images/customer_code/bang_gia_bac_chon_loc_acr.png",
            "file_name_item":"Giá vàng hôm nay"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

<table><thead><tr><th>Tham số</th><th>Giá trị</th></tr></thead><tbody><tr><td><pre><code>send_from_number
</code></pre></td><td>SĐT Zalo dùng để gửi. Bắt buộc phải có thông tin, chú ý copy đúng định dạng số dạng <mark style="color:$danger;"><strong>84</strong></mark><strong>975xxxxxxx</strong></td></tr><tr><td><pre><code>send_to_groupid
</code></pre></td><td>ID Nhóm Zalo với Khách hàng, Xem lấy nhóm Zalo <a href="/cham-soc-khach-hang/api-gui-tin-nhan-den-nhom-zalo">tại đây</a></td></tr><tr><td><pre><code>message
</code></pre></td><td>Nội dung tin nhắn Text gửi cho khách hàng của bạn, có thể dùng thẻ gọi <strong>{{gioitinh}}</strong> hoặc <strong>{{name}}</strong> trong nội dung  tin nhắn để gọi giới tính <strong>(Anh/Chị)</strong> và Tên Zalo hiển thị của Khách, trường này có thể bỏ trống nếu không gửi gì</td></tr><tr><td><pre><code>file_url
</code></pre></td><td>Dùng trong trường hợp cần gửi ảnh sản phẩm, chương trình khuyến mại cho khách hàng. Nó có thể là các đường dẫn ảnh bất kỳ trên internet, kích thước ảnh nên là ảnh vuông để có kết quả tốt nhất (1000px X 1000px)<br>Abit thiết kế cho phép gửi nhiều file ảnh, file tài liệu (PDF, Word, Excel..), dữ liệu dạng <strong>Array</strong></td></tr><tr><td><pre><code>file_url_item
</code></pre></td><td>Đường dẫn file Ảnh hoặc File tài liệu đã upload lên Internet mà Abit có thể truy cập</td></tr><tr><td><pre><code>file_name_item
</code></pre></td><td>Tên file Ảnh hoặc File tài liệu hiển thị với người nhận, Nên nhập tên cụ thể của từng file để người nhận biết đó là file với nội dung gì sẽ tốt hơn</td></tr></tbody></table>

Kết quả gửi qua API sẽ như này, bạn có thể áp dụng để đứng ở các hệ thống ngoài Abit gửi file tài liệu&#x20;

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2F8IYga7wNJEu5qJT4EneF%2Fzalo-gui-file-vao-nhom-zalo.png?alt=media&amp;token=bf5fb88c-3ad4-47a2-93b3-9edc2efefc03" alt=""><figcaption></figcaption></figure>


# API lấy danh sách nhóm

API cho phép gửi File tài liệu (PDF, Word, Exel, File Ảnh) từ Zalo cá nhân của Tư vấn - sale đến một nhóm Zalo với khách hàng

{% hint style="info" %}

### Sau khi kết nối Zalo của mỗi bạn Sale, Bạn có thể lấy ID Group Zalo mà bạn sale đó tham gia và gửi tin nhắn vào nhóm nào đó bất kỳ theo hướng dân sau

{% endhint %}

Lấy ID Nhóm Zalo của nick Zalo tại đây trên giao diện Abit kết nối Zalo cá nhân

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2FVx3O2i5mWH9e58CiK2B2%2Flay-group-id-zalo-ca-nhan.jpg?alt=media&amp;token=1ab11d36-b3a2-4b05-9acb-68afa81a92ec" alt=""><figcaption></figcaption></figure>

Để lấy ID Nhóm Zalo, Quý khách hàng vào phần danh sách Zalo vừa kết nối, có mục **Nhóm Zalo** trên mỗi nick Zalo nhân viên&#x20;

Cách 2: Lấy ID nhóm cần gửi theo API

Phương thức: <mark style="color:green;">POST</mark>

{% tabs %}
{% tab title="URL API Example" %}

```
https://new.abitstore.vn/zalo/listAllGroupForPartner/2/{ma-shop}/{ma-truy-cap}
```

{% endtab %}

{% tab title="Body" %}

```json
{
    "phoneNumber": "84915217486"
}
```

{% endtab %}
{% endtabs %}

<table><thead><tr><th>Tham số</th><th>Giá trị</th></tr></thead><tbody><tr><td><pre><code>phoneNumber
</code></pre></td><td>SĐT Zalo dùng để gửi. Bắt buộc phải có thông tin, chú ý copy đúng định dạng số dạng <mark style="color:$danger;"><strong>84</strong></mark><strong>975xxxxxxx</strong></td></tr></tbody></table>

Kết quả gửi qua API sẽ như này, bạn có thể áp dụng để đứng ở các hệ thống ngoài Abit gửi file tài liệu&#x20;

```postman_json
{
    "number_group": 230,
    "all_groups": [
        {
            "groupId": "2277939074805121739",
            "groupname": "Nhóm A",
            "creatorId": "2054469423625461717",
            "group_avt": "",
            "number_member": 3
        },
        {
            "groupId": "22779390748051217340",
            "groupname": "Nhóm B",
            "creatorId": "2054469423625461717",
            "group_avt": "",
            "number_member": 2
        }
    ]
}
```


# API gửi tin nhắn đến nhóm Zalo

API cho phép gửi tin nhắn đến Nhóm (Group Zalo ) . Điều kiện để gửi được là cần có thông tin Group ID của nhóm Zalo mà bạn muốn gửi tới, Để có thông tin ID Nhóm Zalo thì bạn cần lấy trên Abit

Sau khi kết nối Zalo của mỗi bạn Sale, Bạn có thể lấy ID Group Zalo mà bạn sale đó tham gia và gửi tin nhắn vào nhóm nào đó bất kỳ theo API sau

Lấy ID Nhóm Zalo của nick Zalo tại đây trên giao diện Abit kết nối Zalo cá nhân

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2FVx3O2i5mWH9e58CiK2B2%2Flay-group-id-zalo-ca-nhan.jpg?alt=media&amp;token=1ab11d36-b3a2-4b05-9acb-68afa81a92ec" alt=""><figcaption></figcaption></figure>

Để lấy URL này, Quý khách hàng vào phần danh sách Zalo vừa kết nối, có mục <mark style="color:blue;">**URL API**</mark> trên mỗi nick Zalo nhân viên và gửi đến url trên với body định dạng như mẫu dưới đây

Phương thức: <mark style="color:green;">POST</mark>

{% tabs %}
{% tab title="URL API Example" %}

```
https://new.abitstore.vn/zalo/sendMessageToGroupZalo/2/{ma-shop}/{ma-truy-cap}
```

{% endtab %}

{% tab title="Body" %}

```json
{
"send_from_number": "84975387753",
"send_to_groupid": "4973309772266774852",
"message": "Nội dung gửi tin nhắn đến nhóm Zalo bạn muốn"
}
```

{% endtab %}
{% endtabs %}

<table><thead><tr><th>Tham số</th><th>Giá trị</th></tr></thead><tbody><tr><td><pre><code>send_from_number
</code></pre></td><td>SĐT Zalo dùng để gửi, chú ý copy đúng định dạng số dạng <mark style="color:$danger;"><strong>84</strong></mark><strong>975xxxxxxx</strong></td></tr><tr><td><pre><code>send_to_groupid
</code></pre></td><td>ID Group Zalo cần gửi tin nhắn đến</td></tr><tr><td><pre><code>message
</code></pre></td><td>Nội dung tin nhắn Text gửi đến nhóm mà bạn muốn</td></tr></tbody></table>


# API gửi Text + Nhiều ảnh đến nhóm Zalo

API cho phép gửi tin nhắn TEXT + nhiều Ảnh đến Nhóm (Group Zalo ) . Điều kiện để gửi được là cần có thông tin Group ID của nhóm Zalo mà bạn muốn gửi tới

Sau khi kết nối Zalo của mỗi bạn Sale, Bạn có thể lấy ID Group Zalo mà bạn sale đó tham gia và gửi tin nhắn vào nhóm nào đó bất kỳ theo API sau

Lấy ID Nhóm Zalo của nick Zalo tại đây trên giao diện Abit kết nối Zalo cá nhân

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2FVx3O2i5mWH9e58CiK2B2%2Flay-group-id-zalo-ca-nhan.jpg?alt=media&amp;token=1ab11d36-b3a2-4b05-9acb-68afa81a92ec" alt=""><figcaption></figcaption></figure>

Để lấy URL này, Quý khách hàng vào phần danh sách Zalo vừa kết nối, có mục <mark style="color:blue;">**URL API**</mark> trên mỗi nick Zalo nhân viên và gửi đến url trên với body định dạng như mẫu dưới đây

Phương thức: <mark style="color:green;">POST</mark>

{% tabs %}
{% tab title="URL API Example" %}

```
https://new.abitstore.vn/zalo/sendImageToGroupZalo/2/{ma-shop}/{ma-truy-cap}
```

{% endtab %}

{% tab title="Body" %}

```json
{
    "send_from_number": "84975387753",
    "send_to_groupid": "4973309772266774852",
    "message":"Nội dung tin nhắn gửi đến Group",
    "caption":"Báo cáo ABC",
    "image_url": [
        "https://blog.abitstore.vn/photos/1/huongdan/api-zalo-ca-nhan.jpg",
        "https://static.abit.vn/sanpham/shop_16777/2024/09/24/jpg/2024-09-24-13-20-54-66f25a4662013_xQM9kZ9q_.jpg",
        "https://static.abit.vn/sanpham/shop_16777/2023/08/24/jpg/2023-08-24-11-37-58-64e6dea6a1a5cAAAAAAAAAA.jpg"
    ]
}
```

{% endtab %}
{% endtabs %}

<table><thead><tr><th>Tham số</th><th>Giá trị</th></tr></thead><tbody><tr><td><pre><code>send_from_number
</code></pre></td><td>SĐT Zalo dùng để gửi, chú ý copy đúng định dạng số dạng <mark style="color:$danger;"><strong>84</strong></mark><strong>975xxxxxxx</strong></td></tr><tr><td><pre><code>send_to_groupid
</code></pre></td><td>ID Group Zalo cần gửi tin nhắn đến</td></tr><tr><td><pre><code>message
</code></pre></td><td>Nội dung tin nhắn Text gửi đến nhóm mà bạn muốn</td></tr><tr><td><pre><code>caption
</code></pre></td><td>Mô tả - caption cho ảnh , để hiển thị được đẹp hơn</td></tr><tr><td><pre><code>image_url
</code></pre></td><td>Là mảng ( array) các đường dẫn ảnh trên internet, số lượng ảnh gửi có giới hạn, <strong>hoạt động tốt nhất là &#x3C; 10 ảnh</strong></td></tr></tbody></table>

Kết quả gửi text và nhiều ảnh vào nhóm Zalo có thể nhận được kết quả như hình dưới đây

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2FBh1NoC5YyYnOwuu1MmKL%2Fgui-text-nhieu-anh-den-group-zalo-api.png?alt=media&amp;token=b895858a-2f8f-4b94-854d-2421f9629ba0" alt=""><figcaption></figcaption></figure>


# Danh sách sản phẩm

API cho phép lấy danh sách sản phẩm của shop trong mục quản lý sản phẩm

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/products/listProductsforPartner)

<mark style="color:green;">`POST /`</mark>`products/listProductsforPartner`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>filter_by</td><td></td><td><p>filter_by có 2 giá trị </p><p><strong>UPDATE</strong> : Ngày update sản phẩm</p><p><strong>CREATE :</strong> Ngày tạo sản phẩm</p></td></tr><tr><td>order_by</td><td></td><td>order_by có 2 giá trị <strong>DESC</strong> và <strong>ASC</strong></td></tr><tr><td>date_time_start</td><td></td><td>Thời gian bắt đầu lọc , định dạng Y-m-d H:i:s Ví dụ : <strong>2025-03-13 08:00:00</strong></td></tr><tr><td>date_time_end</td><td></td><td>Thời gian kết thúc lọc , định dạng Y-m-d H:i:s Ví dụ : <strong>2025-03-13 23:59:59</strong></td></tr><tr><td>page</td><td>int</td><td>Phân trang, lấy kết quả ở trang thứ mấy, mặc định giá trị là <strong>0</strong></td></tr><tr><td>limit</td><td>int</td><td>Giới hạn kết quả trả ra, mặc định là <strong>10</strong></td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

<pre class="language-json"><code class="lang-json">{
  "access_token":"Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
  "partner_name":"Abit",
  "filter_by":"CREATE",
  "order_by":"DESC",
  "date_time_start":"2026-08-18 00:00:00",
<strong>  "date_time_end":"2026-08-22 23:59:59",
</strong>  "page": 0,
  "limit": 2
}
</code></pre>

{% endtab %}

{% tab title="Response" %}

```json
[
    {
        "productcode": "240L-VANG",
        "productname": "Thùng rác nhựa 240L - HDPE giá rẻ - Vàng - 240L-VANG",
        "alias": null,
        "usageunit": "Cái",
        "gia_daily": "979000.000",
        "unit_price": "979000.000",
        "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/773548b499f1ac822ad6baab61ae3884\"}]",
        "productid": 86184674,
        "weight": "11000",
        "taxpercentage": "0.000",
        "vitri": "",
        "inventorytype": 0,
        "createdtime": "2025-11-05 22:51:55",
        "modifiedtime": "2025-11-05 22:51:55",
        "status": 1,
        "tonkho_toithieu": 0,
        "tonkho_toida": 0,
        "default_image": null,
        "short_description": "Thùng rác nhựa HDPE 240L màu xanh lá đang là một trong những loại thùng rác nhựa cỡ lớn được sử dụng nhiều nhất hiện nay. Sản phẩm được làm từ chất liệu nhựa HDPE nguyên sinh có nhiều tính năng đặc biệt, có gắn bánh xe tiện dụng cho việc di chuyển được sử dụng rộng rãi.\nThông tin sản phẩm:\n- Xuất xứ: Hàng nhập khẩu\n\n- Chất liệu: Nhựa HDPE nguyên sinh\n\n- Màu sắc: Màu xanh lá cây\n\n- Gồm: 2 bánh xe\n\n- Dung tích: 240 lít\n\n- Size: (L)740 x (W)600 x ( H)1015 mm\n\n- Trọng lượng: 13kg\n\n- Bảo hành: 12 tháng\nĐặc điểm thùng rác nhựa 240L HDPE xanh lá:\n\n- Bên ngoài thùng rác được phủ bằng chất chống tia cực tím (UV) chịu được mọi điều kiện thời tiết khắc nghiệt tại Việt Nam.\n\n- Được sản xuất trên dây chuyền công nghệ cao của nước ngoài, không pha trộn thêm chất phụ phẩm, 100% được làm từ nhựa HDPE nguyên sinh đạt chuẩn Châu Âu\n\n- Thùng rác nhựa 240 lít HDPE có độ bền cơ học cao, chịu được những va đập lớn và không bị mất màu.\n\n- Thiết kế 2 bánh xe dễ dàng vận chuyển đến nơi tập kết rác.\n\n- Tay cầm thiết kế nhỏ gọn chắc chắn, thuận tiện cho việc di chuyển\n\n - Vị trí đặt: Thùng rác nhựa HDPE 240 lít được sử dụng nhiều ở các địa điểm công cộng, các khu công nghiệp, toà nhà, trường học,trung tâm thương mại..\n\nCông ty CP thương mại và dịch vụ Hành Tinh Xanh đơn vị chuyên cung cấp thùng rác nhựa 240L HDPE màu xanh lá, thùng rác nhựa composite 240L chính hãng, số lượng lớn tại Hà Nội, Đà Nẵng, tp HCM.",
        "description": "Thùng rác nhựa HDPE 240L màu xanh lá đang là một trong những loại thùng rác nhựa cỡ lớn được sử dụng nhiều nhất hiện nay. Sản phẩm được làm từ chất liệu nhựa HDPE nguyên sinh có nhiều tính năng đặc biệt, có gắn bánh xe tiện dụng cho việc di chuyển được sử dụng rộng rãi.\nThông tin sản phẩm:\n- Xuất xứ: Hàng nhập khẩu\n\n- Chất liệu: Nhựa HDPE nguyên sinh\n\n- Màu sắc: Màu xanh lá cây\n\n- Gồm: 2 bánh xe\n\n- Dung tích: 240 lít\n\n- Size: (L)740 x (W)600 x ( H)1015 mm\n\n- Trọng lượng: 13kg\n\n- Bảo hành: 12 tháng\nĐặc điểm thùng rác nhựa 240L HDPE xanh lá:\n\n- Bên ngoài thùng rác được phủ bằng chất chống tia cực tím (UV) chịu được mọi điều kiện thời tiết khắc nghiệt tại Việt Nam.\n\n- Được sản xuất trên dây chuyền công nghệ cao của nước ngoài, không pha trộn thêm chất phụ phẩm, 100% được làm từ nhựa HDPE nguyên sinh đạt chuẩn Châu Âu\n\n- Thùng rác nhựa 240 lít HDPE có độ bền cơ học cao, chịu được những va đập lớn và không bị mất màu.\n\n- Thiết kế 2 bánh xe dễ dàng vận chuyển đến nơi tập kết rác.\n\n- Tay cầm thiết kế nhỏ gọn chắc chắn, thuận tiện cho việc di chuyển\n\n - Vị trí đặt: Thùng rác nhựa HDPE 240 lít được sử dụng nhiều ở các địa điểm công cộng, các khu công nghiệp, toà nhà, trường học,trung tâm thương mại..\n\nCông ty CP thương mại và dịch vụ Hành Tinh Xanh đơn vị chuyên cung cấp thùng rác nhựa 240L HDPE màu xanh lá, thùng rác nhựa composite 240L chính hãng, số lượng lớn tại Hà Nội, Đà Nẵng, tp HCM.",
        "productcategory": "",
        "brandid": 0,
        "brandname": "",
        "ma_ke_toan": "307886948155",
        "ma_goc": "T22",
        "barcode": "",
        "created_at": "2026-08-19 14:28:26",
        "updated_at": "2026-08-19 14:29:05"
    },
    {
        "productcode": "HTD100810000",
        "productname": "HTĐ 100810",
        "alias": null,
        "usageunit": "Hộp",
        "gia_daily": "260000.000",
        "unit_price": "360000.000",
        "imagename": "[{\"id\":1,\"isDefault\":true,\"imgSrc\":\"https://d3c8heq3znktqo.cloudfront.net/wp-content/uploads/2018/01/31204546/GoodInstagramPhotos-940x627.jpeg\"},{\"id\":2,\"isDefault\":false,\"imgSrc\":\"https://c.tadst.com/gfx/750x500/moon-photography-camera.jpg\"}]",
        "productid": 85898210,
        "weight": "100",
        "taxpercentage": "10.000",
        "vitri": "",
        "inventorytype": 0,
        "createdtime": "2025-10-30 08:11:50",
        "modifiedtime": "2025-10-30 08:11:50",
        "status": 1,
        "tonkho_toithieu": 5,
        "tonkho_toida": 250,
        "default_image": null,
        "short_description": "",
        "description": "",
        "productcategory": "0",
        "brandid": 0,
        "brandname": "",
        "ma_ke_toan": "307886948155",
        "ma_goc": "T21",
        "barcode": "",
        "created_at": "2026-08-19 14:28:26",
        "updated_at": "2026-08-19 14:29:05"
    }
]
```

{% endtab %}
{% endtabs %}


# Danh sách sản phẩm (Tồn kho)

API cho phép lấy danh sách sản phẩm của shop trong mục quản lý sản phẩm

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/products/listProductsWithStockforPartner)

<mark style="color:green;">`POST /`</mark>`products/listProductsWithStockforPartner`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>productcode</td><td>string</td><td>Mã hàng sản phẩm, dùng khi bạn muốn lấy <mark style="color:$danger;"><strong>tồn kho một mã hàng</strong></mark> trên tài khoản của shop</td></tr><tr><td>productstoreid</td><td>int</td><td>ID kho hàng, chi nhánh</td></tr><tr><td>page</td><td>int</td><td>Phân trang, lấy kết quả ở trang thứ mấy, mặc định giá trị là <strong>0</strong></td></tr><tr><td>limit</td><td>int</td><td>Giới hạn kết quả trả ra, mặc định là <strong>10</strong></td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
  "access_token":"Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
  "partner_name":"Abit",
  "productcode":"ABC-001",
  "productstoreid":1,
  "page": 0,
  "limit": 2
}
```

{% endtab %}

{% tab title="Response" %}

```json
[
    {
        "productcode": "240L-VANG",
        "productname": "Thùng rác nhựa 240L - HDPE giá rẻ - Vàng - 240L-VANG",
        "alias": null,
        "usageunit": "Cái",
        "gia_daily": "979000.000",
        "unit_price": "979000.000",
        "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/773548b499f1ac822ad6baab61ae3884\"}]",
        "productid": 86184674,
        "weight": "11000",
        "taxpercentage": "0.000",
        "vitri": "",
        "inventorytype": 0,
        "created_at": "2025-11-05 22:51:55",
        "updated_at": "2025-11-05 22:51:55",
        "status": 1,
        "tonkho_toithieu": 0,
        "tonkho_toida": 0,
        "default_image": null,
        "short_description": "",
        "description": "",
        "productcategory": "",
        "brandid": 0,
        "brandname": "",
        "slton": "161.000",
        "tong_hang_dang_ve": "10"
    },
    {
        "productcode": "HTD100810000",
        "productname": "HTĐ 100810",
        "alias": null,
        "usageunit": "Hộp",
        "gia_daily": "260000.000",
        "unit_price": "360000.000",
        "imagename": "[{\"id\":1,\"isDefault\":true,\"imgSrc\":\"https://d3c8heq3znktqo.cloudfront.net/wp-content/uploads/2018/01/31204546/GoodInstagramPhotos-940x627.jpeg\"},{\"id\":2,\"isDefault\":false,\"imgSrc\":\"https://c.tadst.com/gfx/750x500/moon-photography-camera.jpg\"}]",
        "productid": 85898210,
        "weight": "100",
        "taxpercentage": "10.000",
        "vitri": "",
        "inventorytype": 0,
        "created_at": "2025-10-30 08:11:50",
        "updated_at": "2025-10-30 08:11:50",
        "status": 1,
        "tonkho_toithieu": 5,
        "tonkho_toida": 250,
        "default_image": null,
        "short_description": "",
        "description": "",
        "productcategory": "0",
        "brandid": 0,
        "brandname": "",
        "slton": 4,
        "tong_hang_dang_ve": 3
    }
]
```

{% endtab %}
{% endtabs %}


# Chi tiết sản phẩm

API cho phép lấy danh sách sản phẩm của shop trong mục quản lý sản phẩm

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/products/detailtProductsforPartner)

<mark style="color:green;">`POST /`</mark>`products/detailtProductforPartner`

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>productid</td><td>int</td><td>ID của sản phẩm, lấy trong API danh sách sản phẩm</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
  "access_token":"Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
  "partner_name":"Abit",
  "productid": 86184674
}
```

{% endtab %}

{% tab title="Response" %}

```json
[
    {
        "productid": 86184674,
        "productcode": "240L-VANG",
        "ma_ke_toan": "52030637295",
        "barcode": "",
        "productcategory": "",
        "magoc": null,
        "productname": "Thùng rác nhựa 240L - HDPE giá rẻ - Vàng - 240L-VANG",
        "usageunit": "Cái",
        "gia_daily": "979000.000",
        "unit_price": "979000.000",
        "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/773548b499f1ac822ad6baab61ae3884\"}]",
        "weight": "11000",
        "status": 1,
        "hienthi_manhinh": 1,
        "tonkho_toithieu": 0,
        "tonkho_toida": 0,
        "short_description": "Thùng rác nhựa HDPE 240L màu xanh lá đang là một trong những loại thùng rác nhựa cỡ lớn được sử dụng nhiều nhất hiện nay. Sản phẩm được làm từ chất liệu nhựa HDPE nguyên sinh có nhiều tính năng đặc biệt, có gắn bánh xe tiện dụng cho việc di chuyển được sử dụng rộng rãi.\nThông tin sản phẩm:\n- Xuất xứ: Hàng nhập khẩu\n\n- Chất liệu: Nhựa HDPE nguyên sinh\n\n- Màu sắc: Màu xanh lá cây\n\n- Gồm: 2 bánh xe\n\n- Dung tích: 240 lít\n\n- Size: (L)740 x (W)600 x ( H)1015 mm\n\n- Trọng lượng: 13kg\n\n- Bảo hành: 12 tháng\nĐặc điểm thùng rác nhựa 240L HDPE xanh lá:\n\n- Bên ngoài thùng rác được phủ bằng chất chống tia cực tím (UV) chịu được mọi điều kiện thời tiết khắc nghiệt tại Việt Nam.\n\n- Được sản xuất trên dây chuyền công nghệ cao của nước ngoài, không pha trộn thêm chất phụ phẩm, 100% được làm từ nhựa HDPE nguyên sinh đạt chuẩn Châu Âu\n\n- Thùng rác nhựa 240 lít HDPE có độ bền cơ học cao, chịu được những va đập lớn và không bị mất màu.\n\n- Thiết kế 2 bánh xe dễ dàng vận chuyển đến nơi tập kết rác.\n\n- Tay cầm thiết kế nhỏ gọn chắc chắn, thuận tiện cho việc di chuyển\n\n - Vị trí đặt: Thùng rác nhựa HDPE 240 lít được sử dụng nhiều ở các địa điểm công cộng, các khu công nghiệp, toà nhà, trường học,trung tâm thương mại..\n\nCông ty CP thương mại và dịch vụ Hành Tinh Xanh đơn vị chuyên cung cấp thùng rác nhựa 240L HDPE màu xanh lá, thùng rác nhựa composite 240L chính hãng, số lượng lớn tại Hà Nội, Đà Nẵng, tp HCM.",
        "description": "Thùng rác nhựa HDPE 240L màu xanh lá đang là một trong những loại thùng rác nhựa cỡ lớn được sử dụng nhiều nhất hiện nay. Sản phẩm được làm từ chất liệu nhựa HDPE nguyên sinh có nhiều tính năng đặc biệt, có gắn bánh xe tiện dụng cho việc di chuyển được sử dụng rộng rãi.\nThông tin sản phẩm:\n- Xuất xứ: Hàng nhập khẩu\n\n- Chất liệu: Nhựa HDPE nguyên sinh\n\n- Màu sắc: Màu xanh lá cây\n\n- Gồm: 2 bánh xe\n\n- Dung tích: 240 lít\n\n- Size: (L)740 x (W)600 x ( H)1015 mm\n\n- Trọng lượng: 13kg\n\n- Bảo hành: 12 tháng\nĐặc điểm thùng rác nhựa 240L HDPE xanh lá:\n\n- Bên ngoài thùng rác được phủ bằng chất chống tia cực tím (UV) chịu được mọi điều kiện thời tiết khắc nghiệt tại Việt Nam.\n\n- Được sản xuất trên dây chuyền công nghệ cao của nước ngoài, không pha trộn thêm chất phụ phẩm, 100% được làm từ nhựa HDPE nguyên sinh đạt chuẩn Châu Âu\n\n- Thùng rác nhựa 240 lít HDPE có độ bền cơ học cao, chịu được những va đập lớn và không bị mất màu.\n\n- Thiết kế 2 bánh xe dễ dàng vận chuyển đến nơi tập kết rác.\n\n- Tay cầm thiết kế nhỏ gọn chắc chắn, thuận tiện cho việc di chuyển\n\n - Vị trí đặt: Thùng rác nhựa HDPE 240 lít được sử dụng nhiều ở các địa điểm công cộng, các khu công nghiệp, toà nhà, trường học,trung tâm thương mại..\n\nCông ty CP thương mại và dịch vụ Hành Tinh Xanh đơn vị chuyên cung cấp thùng rác nhựa 240L HDPE màu xanh lá, thùng rác nhựa composite 240L chính hãng, số lượng lớn tại Hà Nội, Đà Nẵng, tp HCM.",
        "taxpercentage": "0.000",
        "url_key": "",
        "link_drive": null,
        "createdtime": "2025-11-05 22:51:55",
        "modifiedtime": "2025-11-05 22:51:55",
        "vitri": "",
        "dai": 0,
        "rong": 0,
        "cao": 0,
        "inventorytype": 0,
        "brandname": "",
        "brandid": 0,
        "vendorname": null,
        "vendor_id": 0,
        "guarantee": 0,
        "updated_at": "2025-11-05 22:51:55",
        "origin": "",
        "created_by": "Nhân Viên dê mô Họ teen",
        "edited_by": null,
        "convert_unit": null,
        "has_unit_convert": 0,
        "tax_free": 0
    }
]
```

{% endtab %}
{% endtabs %}


# Webhook đơn hàng

Ngoài API lấy danh sách đơn hàng, khách hàng, sản phẩm thì Abit có xây dựng Webhook để đẩy dữ liệu về các URL webhook được shop cấu hình trên Abit cho nhiều mục đích khác nhau

Để cấu hình webhook đơn hàng, Quý khách hàng có thể truy cập menu **Cấu hình ⇒ Thông tin shop ⇒ Tab Đối tác**

Click vào icon **Cấu hình gửi thông báo** để tiến hành khai báo URL Webhook để tiếp nhận thông tin mà Abit đẩy về theo URL đó

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2FUREINpN4zJPpJCbQZ3uS%2Fwebhook-abit.png?alt=media&amp;token=a54ac6ce-fdb2-44e4-a7f5-12ae0e624601" alt=""><figcaption><p>Chọn trạng thái đơn hàng khi có biến động về trạng thái thì sẽ bắn thông tin đơn hàng về URL API Webhook</p></figcaption></figure>

{% tabs %}
{% tab title="Json example" %}

```json
{
   "invoice_date":"2025-04-30T17:00:00.000Z",
   "eoi_order_id":"578675043107439962",
   "adjustment":0,
   "sales_commission":0,
   "sub_total":69000,
   "total":76700,
   "discount_amount":0,
   "discount_percent":0,
   "s_h_amount":7700,
   "mahang":"(1)AOTHUN...",
   "campaign":"",
   "campaign_group":"",
   "channel":"TIKTOK_SHOP",
   "nhanvien":"demo",
   "order_source":"TIKTOK_SHOP",
   "message":"SL: 1 - Mã SP: AOTHUN - Tên SP: Ao thun có cổ -  Giá bán: 69000",
   "ecom_doanhso":76700,
   "ecom_username":"7495809628279114074",
   "order_source_name":"VN - Shop thời trang",
   "created_at":"2025-05-01T16:57:31.000Z",
   "products":"[{\"currency\":\"VND\",\"display_status\":\"AWAITING_SHIPMENT\",\"id\":\"578675043107571034\",\"is_gift\":false,\"original_price\":\"95000\",\"package_id\":\"1161280609977664858\",\"package_status\":\"TO_FULFILL\",\"platform_discount\":0,\"product_id\":\"1731307057752475541\",\"product_name\":\"Áo thun nam nữ\",\"sale_price\":\"69000\",\"seller_discount\":26000,\"seller_sku\":\"AOTHUN\",\"shipping_provider_id\":\"6841743441349706241\",\"shipping_provider_name\":\"Ju0026T Express\",\"sku_id\":\"1731307086149617557\",\"sku_image\":\"https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/fa5523810cfd4622944b1785f100eaa4~tplv-aphluv4xwc-origin-jpeg.jpeg?dr=15568u0026t=555f072du0026ps=933b5bdeu0026shp=54477afbu0026shcp=3c3d9ffbu0026idc=my2u0026from=1413970683\",\"sku_name\":\"ÁO XE MÁY CỜ, L (48-58kg) (u003C1.68m)\",\"sku_type\":\"NORMAL\",\"tracking_number\":\"\",\"quantity\":1}]",
   "phone_number":"(+84)098*****63",
   "donvi_vc":"JNT",
   "tiendatcoc":0,
   "receiver":"D** A** k***",
   "address":"Viet Nam  Ha Noi  Quoc Oai  Qu****** Ch*******************",
   "tracking_no":"8590632397119",
   "invoicestatus":"Daphatthanhcong",
   "idanh":"",
   "name":"578675043107439961",
   "invoice_no":"EG71409856A45",
   "invoice_id":79069511,
   "updated_at":"2025-05-13T15:15:00.000Z",
   "invoice_status":"Daphatthanhcong"
}
```

{% endtab %}
{% endtabs %}

Trên API của đối tác, cần phản hồi về kết quả nhận tin từ webhook của Abit bắn về để Abit ghi nhận kết quả

```
{"Received":"true"}
```


# Webhook tin nhắn

Webhook này cho phép nội dung tin nhắn và các thông tin liên quan đến tin nhắn khi có khách hàng nhắn tin trên Fanpage

Để cấu hình Webhook cho Fanpage đã kết nối vào Abit, Quý khách hàng đăng nhập vào phần mềm chat đa kênh Abitmes . Quý khách hàng tiến hành kết nối Fanpage vào Abit bẳng cách Truy cập vào mục **Cài đặt ⇒ Cấu hình Facebook ⇒ Kết nối Fanpage**

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2FWBN7wBy4sJ3rts7DzRgS%2Fket-noi-fanpage-facebook-abit.png?alt=media&amp;token=ba4faa1a-0844-4dd1-a380-42f5d3133985" alt=""><figcaption></figcaption></figure>

Click vào tab **"TỪNG PAGE VÀ TỪNG POST"** để cấu hình url webhook cho Fanpage mà bạn cần bắn tin nhắn đi đến hệ thống khác

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2Fu8Lccjr6mmd8srHoDEhS%2Fcau-hinh-webhook-abitmes-facebook.png?alt=media&amp;token=fec806e4-e591-4313-bfd5-d79ad1fdeb07" alt=""><figcaption></figcaption></figure>

Nhập url webhook để Abit bắn thông tin về hệ thống của bạn khi có tin nhắn của khách hàng trên Fanpage, Các hệ thống ngoài Abit sẽ tiếp nhận và tương tác với khách hàng thông qua các [**API ABITMES**](/api-abitmes/gui-tin-nhan)

<figure><img src="https://3069215855-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F91ushNBhdXBKtwOIS6Yg%2Fuploads%2F9IIusPJrlybkaeMoWDvC%2Fcau-hinh-webhook-abitmes-facebook.png?alt=media&amp;token=19dc1571-489a-460b-abd2-7b62035ff120" alt=""><figcaption></figcaption></figure>

Json example webhook bắn ra

{% tabs %}
{% tab title="Body" %}

```
{
   "app_id":null,
   "attachment":[
      
   ],
   "id_conversion":"",
   "id_new_message":"m_OUC46TpKMsqxoSooqYQq2DaiTWSom8JOcZ-wha_P_BcDaao6Ux4iw93sH6qPAxIP47BHbCO_5-ZFTvtr2_7NGA",
   "id_page":"2013792605578989",
   "idcongty":1,
   "message":"Nội dung inbox",
   "page_scopeid":"2384322928258187",
   "type":0,
   "is_phone":0,
   "use_webhook":1,
   "url_webhook":"https://domain.com/url_webhook",
   "content":{
      "type":"",
      "data":[
         
      ]
   },
   "ai_disabled":false,
   "page_name": "Name Of Fanpage",
   "customer_name": "Name Of Client",
   "number_phone": "0987654321",
   "create_at": "1774578456000",
   "country_code": "",
   "sent_by_shop":0
}
```

{% endtab %}
{% endtabs %}

Diễn giải tham số

<table><thead><tr><th width="189.31134033203125">Name</th><th width="115.32904052734375">Type</th><th>Description</th></tr></thead><tbody><tr><td><strong>id_new_message</strong></td><td>string</td><td>ID tin nhắn mà khách hàng vừa nhắn trên page</td></tr><tr><td><strong>id_page</strong></td><td>string</td><td>ID fanpage được kết nối vào Abit</td></tr><tr><td><strong>idcongty</strong></td><td>int</td><td>ID công ty - khách hàng Abit</td></tr><tr><td><strong>message</strong></td><td>string</td><td>Nội dung tin nhắn khách vừa nhắn</td></tr><tr><td><strong>type</strong></td><td>int</td><td><p>Loại tin nhăns có 2 giá trị </p><p><strong>0 - Tin nhắn trong inbox</strong><br><strong>1 - Tin nhắn là comment trên page</strong></p></td></tr><tr><td><strong>is_phone</strong></td><td>int</td><td>Thể hiện nội dung tin nhắn có SĐT hay không<br>0 - Khách chưa cho số điện thoại<br>1 -  Khách đã cung cấp SĐT</td></tr><tr><td><strong>use_webhook</strong></td><td>int</td><td>Fanpage Có dùng Webhook hay không</td></tr><tr><td><strong>url_webhook</strong></td><td>string</td><td>Đường dẫn nội dung tin nhắn sẽ bắn về</td></tr><tr><td><mark style="color:red;"><strong>ai_disabled</strong></mark></td><td></td><td><strong>true</strong> hoặc <strong>false</strong> - Hai giá trị thể hiện việc có dùng AI Agent khi nhân viên support bật - tắt chế độ trả lời tự động với khách này</td></tr><tr><td><strong>page_name</strong></td><td>string</td><td>Tên Fanpage</td></tr><tr><td><strong>customer_name</strong></td><td>string</td><td>Tên khách hàng</td></tr><tr><td><strong>number_phone</strong></td><td>string</td><td>Số điện thoại của khách đã từng cho</td></tr><tr><td><strong>create_at</strong></td><td>timestamps</td><td>Thời gian Unix timestamps</td></tr><tr><td><strong>country_code</strong></td><td>string</td><td>Mã quốc gia, có thể cấu hình - định nghĩa quốc gia ở phần kết nối Fanpage trên Abit</td></tr><tr><td><strong>sent_by_shop</strong></td><td>int</td><td><strong>0</strong> - Tin nhắn được gửi bởi khách hàng đến Fanpage<br><strong>1</strong> - Tin nhắn được gửi từ Fanpage đến khách hàng</td></tr></tbody></table>

Sau khi bắn đến url webhook của Quý khách hàng, Quý khách hàng cần phản hồi lại trên API của quý khách hàng trạng thái tiếp nhận thông tin mà Abit gửi đến

Nếu tiếp nhận thành công gói tin thì phản hồi

{% tabs %}
{% tab title="Body" %}

```
{received:true}
```

{% endtab %}
{% endtabs %}

Nếu tiếp nhận gói tin thất bại hoặc có lỗi thì phản hồi

{% tabs %}
{% tab title="Body" %}

```
{received:false, message:'customer_error_message'}
```

{% endtab %}
{% endtabs %}


# Gửi tin nhắn

Quý khách hàng - đối tác có thể dùng API này để tương tác với khách hàng trên fanpage ( gửi tin nhắn, hình ảnh...)

Sau khi nhận thông tin từ webook gửi về, xem cấu hình nhận tin nhắn - thông báo trên Fanpage mục [Webhook tin nhắn](/webhook/webhook-tin-nhan) , Quý khách hàng sẽ có các thông tin cần thiết như id hội thoại, id fanpage, pagescopeid, text message từ Fanpage gửi về. Để tương tác và reply lại khách , Quý khách hàng - đối tác cần tạo Access Token để tương cấp quyền xác thực trên mỗi request đến API của Abitmes, Xem mục Khởi tạo [Access Token](/khoi-tao-access-token) để lấy quyền truy cập và tương tác.

URL API: [https://api.abitmes.vn](https://api.abitmes.vn/)

<mark style="color:green;">`POST /`</mark>`api/partner/{ma_shop}/{access_token}/send-message?page_id={id_page}`&#x20;

Trong đó:

| Name            | Value                                                                                                                                                                                        |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| {ma\_shop}      | tương ứng là Tên khách hàng khi khởi tạo Access Token, Xem [**tại đây**](/khoi-tao-access-token)                                                                                             |
| {access\_token} | Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo [<mark style="color:red;">**Access Token**</mark> ](/gioi-thieu-ve-abit-open-api#khoi-tao-access-token) |
| {id\_page}      | Là ID Fanpage , giá trị này có thể trả về trên boby webhook của tin nhắn                                                                                                                     |

**Url example:** <https://api.abitmes.vn/api/partner/Abit/NWUxMzU5ZmZjZjc5YzAyYTY1YTcyNWE0ZTQ2OTdmM2Q=/send-message?page_id=2013792605578989>

API này Abit mô phỏng và giữ nguyên định dạng body chuẩn của Facebook theo tài liệu của Facebook\
<https://developers.facebook.com/docs/messenger-platform/send-messages>

Thử nghiệm với Postman:

<https://api.postman.com/collections/2953703-42320021-a4aa-4b8d-a9d0-1029d557ebb7?access_key=PMAT-01K5QWGH0NYSG2B7CPY3Q0WFBV>

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

<mark style="color:orange;">**Gửi tin nhắn Text cơ bản cho khách**</mark>

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>recipient</td><td></td><td>Thông tin người nhận tin nhắn phản hồi</td></tr><tr><td>id</td><td>string</td><td>ID của khách chat trên fanpage, giá trị này tương ứng là <strong>page_scopeid</strong> trong boby json của webhook bắn về</td></tr><tr><td>message</td><td></td><td>Nội dung tin nhắn phản hồi khách hàng</td></tr><tr><td>text</td><td>string</td><td>Loại tin nhắn phản hồi khách hàng, trong ví dụ là tin nhắn text phản hồi khách</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
    "recipient": {
        "id": "2298104106936206"
    },
    "message": {
        "text": "hello 3"
    }
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "error": 0,
    "data": {
        "recipient_id": "2298104106936206",
        "message_id": "m__NF_55z0NiqkoAzzxL02eKUlmN3hacJV4y1OXCAslPGGvgnfIGU_MAzV-6qDkpZhcaqwDiaETWUW2xsyFFKPaQ"
    }
}
```

{% endtab %}
{% endtabs %}

<mark style="color:orange;">**Gửi 1 ảnh**</mark>

{% tabs %}
{% tab title="Body" %}

```json
{
   "recipient":{
      "id":"2298104106936206"
   },
   "message":{
      "attachment":{
         "type":"image",
         "payload":{
            "url":"https://blog.abitstore.vn/frontend/assets/img/trangchu/banner-abitstore.jpg",
            "is_reusable":true
         }
      }
   }
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "error": 0,
    "data": {
        "recipient_id": "2298104106936206",
        "message_id": "m_WXfwQr2F7t4wX8K8Ji-No6UlmN3hacJV4y1OXCAslPHqAIctqob-3KyogDm8szEHqUufZLl3WnmQEIfi7zesRg",
        "attachment_id": "839896582031502"
    }
}
```

{% endtab %}
{% endtabs %}

<mark style="color:orange;">**Gửi nhiều ảnh**</mark>

{% tabs %}
{% tab title="Body" %}

```json
{
   "recipient":{
      "id":"2298104106936206"
   },
   "message":{
      "attachments": [
      {
        "type": "image",
        "payload": {
          "url": "https://blog.abitstore.vn/frontend/assets/img/trangchu/banner-abitstore.jpg"
        }
      },
      {
        "type": "image",
        "payload": {
          "url": "https://blog.abitstore.vn/photos/MrChinh.SEO/1.jpg"
        }
      }
    ]
   }
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "error": 0,
    "data": {
        "recipient_id": "2298104106936206",
        "message_id": "m_5ZzmrZn7NnvZNcqp26yuR6UlmN3hacJV4y1OXCAslPElfD5czAvpuwDdp6loR3tzGFy22OQUeizANneF5ebmwg"
    }
}
```

{% endtab %}
{% endtabs %}


# Shopee - Đánh giá xấu - tiêu cực

API cho phép lấy danh sách comment, đánh giá 1-2-3 sao trên Shopee theo từng gian hàng, Tối đa là 100 comment gần đây

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/ecommerce/getBadCommentShopeebyPartner)

<mark style="color:green;">`POST /`</mark>ecommerce/getBadCommentShopeebyPartner

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng Shopee được kết nối vào Abit, lấy thông tin ID trong mục Kết nối đa kênh =⇒ Kết nối sàn TMĐT</td></tr><tr><td>page</td><td>int</td><td>Phân trang, lấy kết quả ở trang thứ mấy, mặc định giá trị là <strong>0</strong></td></tr><tr><td>limit</td><td>int</td><td>Giới hạn kết quả trả ra, mặc định là <strong>10</strong></td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
  "access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
  "partner_name": "Abit",
  "ecommerce_id":"51249294",
  "page":0,
  "limit":100
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "status": "success",
    "bad_rate_3": [
        {
            "comment_id": 72936263774,
            "comment": "",
            "buyer_username": "o3suf_k_0k",
            "order_sn": "2509091BQNG6VB",
            "item_id": 22085856414,
            "model_id": 0,
            "create_time": 1757745568,
            "rating_star": 3,
            "editable": "EDITABLE",
            "hidden": false,
            "media": [],
            "model_id_list": [
                166206891683
            ]
        },
        {
            "comment_id": 72927433864,
            "comment": "",
            "buyer_username": "ngocdo2345",
            "order_sn": "250903H6SDNNGF",
            "item_id": 20686052499,
            "model_id": 0,
            "create_time": 1757741384,
            "rating_star": 3,
            "editable": "EDITABLE",
            "hidden": false,
            "media": [],
            "model_id_list": [
                108232639315
            ]
        },
        {
            "comment_id": 72927433859,
            "comment": "",
            "buyer_username": "ngocdo2345",
            "order_sn": "250903H6SDNNGF",
            "item_id": 1042554796,
            "model_id": 0,
            "create_time": 1757741384,
            "rating_star": 3,
            "editable": "EDITABLE",
            "hidden": false,
            "media": [],
            "model_id_list": [
                222245188480
            ]
        },
        {
            "comment_id": 72889373051,
            "comment": "CNội dung comment xuất 3 sao",
            "buyer_username": "nanh323_",
            "order_sn": "25090816CT59AK",
            "item_id": 23654968567,
            "model_id": 0,
            "create_time": 1757723613,
            "rating_star": 3,
            "editable": "EDITABLE",
            "hidden": false,
            "media": {
                "image_url_list": [
                    "https://mms.img.susercontent.com/vn-111341403-820l4-mekqv6zeyo0629"
                ],
                "video_url_list": [
                    "https://down-tx-sg.vod.susercontent.com/api/v4/111120103/mms/vn-11110103-6v8gv-mekqvlwltv5w05.16000101757723529.mp4"
                ]
            },
            "model_id_list": [
                69716651983
            ]
        },
        {
            "comment_id": 72795552711,
            "comment": "",
            "buyer_username": "thutholthu",
            "order_sn": "250907TK1GHP68",
            "item_id": 22085856414,
            "model_id": 0,
            "create_time": 1757604616,
            "rating_star": 3,
            "editable": "EDITABLE",
            "hidden": false,
            "media": [],
            "model_id_list": [
                166206891682
            ]
        }
    ],
    "bad_rate_1": [
        {
            "comment_id": 72864240143,
            "comment": "Nội dung comment xuất 1 sao",
            "buyer_username": "sauqn",
            "order_sn": "2509093FA9WRV4",
            "item_id": 18086077225,
            "model_id": 0,
            "create_time": 1757668819,
            "rating_star": 1,
            "editable": "EDITABLE",
            "hidden": false,
            "media": {
                "image_url_list": [
                    "https://mms.img.susercontent.com/vn-11sss134103-820l4-mejub9zhyio101"
                ]
            },
            "model_id_list": [
                207125499393
            ]
        }
    ],
    "code": 200
}
```

{% endtab %}
{% endtabs %}


# Báo cáo hàng xuất - tốc độ bán

API cho phép lấy danh sách sản phẩm hàng xuất khỏi kho, tốc độ bán hàng để lấy hàng được xuất đi và chuẩn bị hàng hoá được tốt hơn

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/report/partner_baocaohangxuat)

<mark style="color:green;">`POST /`</mark>report/partner\_baocaohangxuat

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>date_time_start</td><td>string</td><td>Thời gian bắt đầu, định dạng mẫu "2025-10-30 00:00:00"</td></tr><tr><td>date_time_end</td><td>string</td><td>Thời gian kết thúc, định dạng mẫu "2025-10-30 23:59:59"</td></tr><tr><td>type_date</td><td>string</td><td>Loại thời gian muốn lọc , có các giá trị<br><mark style="color:$primary;"><strong>create_date</strong></mark> : Ngày tạo đơn hàng trên Abit<br><mark style="color:$primary;"><strong>send_date</strong></mark> : Ngày gửi hàng cho đơn vị vận chuyển</td></tr><tr><td>productstoreid</td><td>int</td><td>ID Kho hàng, lấy danh sách này ở API <a href="/api-mo-rong/danh-sach-kho-chi-nhanh"><strong>Danh sách kho - Chi nhán</strong>h</a></td></tr><tr><td>chanel</td><td>array</td><td>Kênh bán hàng bạn muốn lọc<br>TIKTOK_SHOP<br>Shopee<br>Fanpage<br>Website<br>ladipage<br>POS</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng Shopee được kết nối vào Abit, lấy thông tin ID trong mục Kết nối đa kênh =⇒ Kết nối sàn TMĐT</td></tr><tr><td>packer_name</td><td>string</td><td>Lọc theo tài khoản nhân viên quét đóng hàng</td></tr><tr><td>ownerid</td><td>int</td><td>Lọc theo nhân viên được gán đơn hàng, nhân viên care đơn hàng này</td></tr><tr><td>invoice_type</td><td>int</td><td>Loại đơn hàng trên Abit<br>0 - Đơn hàng bình thường<br>1 - Đơn đặt hàng trước<br>2 - Đơn sản phẩm ảo<br>3 - Đơn hàng COD<br>4 - Đơn hàng Affiliate</td></tr><tr><td>vanchuyen</td><td>string</td><td>Lọc theo đơn vị vận chuyển. Mã đơn vị vận chuyển trên Abit<br><strong>JNT</strong> - JT Express<br><strong>VIETTELPOST</strong> - Đơn vị vận chuyển Viettelpost<br><strong>GHTK</strong> - Giao hàng tiết kiệm<br><strong>SPX</strong> - Shopee Xpress</td></tr><tr><td>is_hachtoan</td><td>string</td><td>Đơn hàng đã  hạch toán hay chưa hạch toán, có các giá trị<br><strong>true</strong> - Đã hạch toán<br><strong>false</strong> - Chưa hạch toán</td></tr><tr><td>handle_inv</td><td>string</td><td>Trạng thái xử lý của đơn hàng theo thời gian<br><mark style="color:$success;"><strong>CHUAIN</strong></mark> - Đơn hàng chưa in trên Abit<br><mark style="color:$success;"><strong>DAIN</strong></mark> - Đơn hàng đã in trên Abit<br><mark style="color:$success;"><strong>CHUADONGHANG</strong></mark> - Đơn hàng chưa được đóng gói<br><mark style="color:$success;"><strong>DADONGHANG</strong></mark> - Đã đóng hàng<br><mark style="color:$success;"><strong>DON1SANPHAM</strong></mark> - Đơn 1 sản phẩm<br><mark style="color:$success;"><strong>DONNHIEUSANPHAM</strong></mark> - Đơn nhiều sản phẩm<br><mark style="color:$success;"><strong>COTINNHAN</strong></mark> - Có tin nhắn từ khách hàng<br><mark style="color:$success;"><strong>KHONGCOTINNHAN</strong></mark> - Đơn hàng không có tin nhắn của khách</td></tr><tr><td>page</td><td>int</td><td>Phân trang, lấy kết quả ở trang thứ mấy, mặc định giá trị là <strong>0</strong></td></tr><tr><td>limit</td><td>int</td><td>Giới hạn kết quả trả ra, mặc định là <strong>10</strong></td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
    "access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
    "partner_name": "Abit",
    "date_time_start": "2025-10-28 00:00:00",
    "date_time_end": "2025-10-31 23:59:59",
    "type_date": "create_date",
    "productstoreid": "1",
    "chanel": [
        "Shopee",
        "TIKTOK_SHOP"
    ],
    "ecommerce_id": "",
    "packer_name": "",
    "ownerid": "",
    "invoice_type": "",
    "vanchuyen": "",
    "is_hachtoan": "",
    "handle_inv": "",
    "limit": 50,
    "page": 0
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "number_product": 3,
    "listproduct": [
        {
            "soluongdon": 2,
            "productid": 74470262,
            "soluongban": "2.000",
            "hachtoan": "2.000",
            "tienhang": "378000.000000",
            "giabanTB": "189,000",
            "soluongTB": "1.0",
            "productname": "Quần ống suông kẻ sọc bản cao cấp chất liệu tuytsi kẻ sọc không nhăn , độ bền cao , thoáng ",
            "productcode": "L59-SOCDENCAOCAP-M",
            "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/vn-11134207-7ra0g-m8h5f37ih9vo93\"}]"
        },
        {
            "soluongdon": 1,
            "productid": 74467895,
            "soluongban": "1.000",
            "hachtoan": "1.000",
            "tienhang": "189000.000000",
            "giabanTB": "189,000",
            "soluongTB": "1.0",
            "productname": "Quần ống suông kẻ sọc bản cao cấp chất liệu tuytsi kẻ sọc không nhăn , độ bền cao , thoáng ",
            "productcode": "L59-SOCDENCAOCAP-L",
            "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/vn-11134207-7ra0g-m8h5f37ih9vo93\"}]"
        },
        {
            "soluongdon": 1,
            "productid": 74467737,
            "soluongban": "1.000",
            "hachtoan": "1.000",
            "tienhang": "319000.000000",
            "giabanTB": "319,000",
            "soluongTB": "1.0",
            "productname": "Quần kaki Cargo Pant định lượng 340gsm phong cách thời trang Street Wear Unisex - MÀU ĐEN - L3-DEN-S",
            "productcode": "L3-DEN-S",
            "imagename": "[{\"isDefault\":true,\"imgSrc\":\"https://cf.shopee.vn/file/sg-11134201-7rccx-ls9pvn5cv0dv19\"}]"
        }
    ],
    "date_diffround": 4
}
```

{% endtab %}
{% endtabs %}


# Báo cáo tài chính đa kênh

API cho phép lấy danh sách sản phẩm hàng xuất khỏi kho, tốc độ bán hàng để lấy hàng được xuất đi và chuẩn bị hàng hoá được tốt hơn

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/report/partner_doanhsotheokenh)

<mark style="color:green;">`POST /`</mark>report/partner\_doanhsotheokenh

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>date_time_start</td><td>string</td><td>Thời gian bắt đầu, định dạng mẫu "2025-10-30 00:00:00"</td></tr><tr><td>date_time_end</td><td>string</td><td>Thời gian kết thúc, định dạng mẫu "2025-10-30 23:59:59"</td></tr><tr><td>type_date</td><td>string</td><td>Loại thời gian muốn lọc , có các giá trị<br><mark style="color:$primary;"><strong>create_date</strong></mark> : Ngày tạo đơn hàng trên Abit<br><mark style="color:$primary;"><strong>send_date</strong></mark> : Ngày gửi hàng cho đơn vị vận chuyển</td></tr><tr><td>productstoreid</td><td>int</td><td>ID Kho hàng, lấy danh sách này ở API <a href="/api-mo-rong/danh-sach-kho-chi-nhanh"><strong>Danh sách kho - Chi nhán</strong>h</a></td></tr><tr><td>chanel</td><td>array</td><td>Kênh bán hàng bạn muốn lọc, hỗ trợ lọc nhiều kênh bán hàng<br>TIKTOK_SHOP<br>Shopee<br>Fanpage<br>Website<br>ladipage<br>POS</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng Shopee , TikTok Shop , ID Fanpage... được kết nối vào Abit, lấy thông tin ID trong mục <strong>Kết nối đa kênh =⇒ Kết nối sàn TMĐT</strong></td></tr><tr><td>is_hachtoan</td><td>string</td><td>Đơn hàng đã  hạch toán hay chưa hạch toán, có các giá trị<br><strong>true</strong> - Đã hạch toán<br><strong>false</strong> - Chưa hạch toán</td></tr><tr><td>invoice_no</td><td>string</td><td>Mã đơn hàng Abit</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
    "access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
    "partner_name": "Abit",
    "date_time_start": "2025-10-28 00:00:00",
    "date_time_end": "2025-10-31 23:59:59",
    "type_date": "create_date",
    "productstoreid": "1",
    "chanel": [
        "Shopee",
        "TIKTOK_SHOP"
    ],
    "ecommerce_id": "",
    "is_hachtoan": "",
    "invoice_no": ""
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "Shopee": [
        {
            "tongdon": 124,
            "tongdoanhso": "20326274.00",
            "total_chuyenhoan": "140250.000",
            "total": "20303080.000",
            "subtotal": "23687434.000",
            "tongtienhang": "23687434.00",
            "total_giavon": "0.000",
            "tienhangtruocgiam": "32693000.00",
            "tongsanpham": "140",
            "tiendatcoc": "5801258.000",
            "eoi_seller_discount": "9005566.00",
            "phivanchuyen": "0.000",
            "eoi_shopee_shipping_rebate": "3209400.00",
            "eoi_estimated_shipping_fee": "3879500.00",
            "s_h_amount": "175500.000",
            "eoi_platform_discount": "0.00",
            "eoi_fee_voucher_xtra_service_fee_amount": null,
            "eoi_fee_flash_sales_service_fee_amount": null,
            "eoi_fee_affiliate_ads_commission_amount": null,
            "eoi_tax_vat_amount": "233574.00",
            "eoi_tax_pit_amount": "116788.00",
            "chietkhauhoadon": "473280.000",
            "hoahongaffiliate": "0.00",
            "freeship_extra": "2558243.00",
            "eoi_original_platform_discount": "0.00",
            "eoi_seller_return_refund": "0.00",
            "eoi_voucher_from_seller": "0.00",
            "eoi_seller_coin_cash_back": "0.00",
            "eoi_voucher_from_platform": "3517556.00",
            "eoi_shipping_fee_discount_from_3pl": "0.00",
            "eoi_reverse_shipping_fee": "100440.00",
            "eoi_seller_shipping_discount": "0.00",
            "eoi_escrow_tax": "0.00",
            "eoi_coins": "23900.00",
            "eoi_buyer_paid_shipping_fee": "175500.00",
            "eoi_buyer_transaction_fee": "0.00",
            "eoi_seller_transaction_fee": "1171698.00",
            "eoi_actual_shipping_fee": "3384900.00",
            "ecommerce_id": "1136315819",
            "storename": "VN-Shop 1",
            "chanel": "Shopee",
            "tongdoanhthu": 18248568,
            "hoahong_platform": "0",
            "eoi_service_fee": "1082623.00"
        },
        {
            "tongdon": 9,
            "tongdoanhso": "3060240.00",
            "total_chuyenhoan": "0.000",
            "total": "3060240.000",
            "subtotal": "3529000.000",
            "tongtienhang": "3529000.00",
            "total_giavon": "0.000",
            "tienhangtruocgiam": "3529000.00",
            "tongsanpham": "0",
            "tiendatcoc": "641760.000",
            "eoi_seller_discount": "0.00",
            "phivanchuyen": "0.000",
            "eoi_shopee_shipping_rebate": "83200.00",
            "eoi_estimated_shipping_fee": "258800.00",
            "s_h_amount": "0.000",
            "eoi_platform_discount": "0.00",
            "eoi_fee_voucher_xtra_service_fee_amount": null,
            "eoi_fee_flash_sales_service_fee_amount": null,
            "eoi_fee_affiliate_ads_commission_amount": null,
            "eoi_tax_vat_amount": "35290.00",
            "eoi_tax_pit_amount": "17645.00",
            "chietkhauhoadon": "0.000",
            "hoahongaffiliate": "0.00",
            "freeship_extra": "415715.00",
            "eoi_original_platform_discount": "0.00",
            "eoi_seller_return_refund": "0.00",
            "eoi_voucher_from_seller": "0.00",
            "eoi_seller_coin_cash_back": "0.00",
            "eoi_voucher_from_platform": "468760.00",
            "eoi_shipping_fee_discount_from_3pl": "0.00",
            "eoi_reverse_shipping_fee": "0.00",
            "eoi_seller_shipping_discount": "0.00",
            "eoi_escrow_tax": "0.00",
            "eoi_coins": "0.00",
            "eoi_buyer_paid_shipping_fee": "0.00",
            "eoi_buyer_transaction_fee": "0.00",
            "eoi_seller_transaction_fee": "173275.00",
            "eoi_actual_shipping_fee": "83200.00",
            "ecommerce_id": "1192304315",
            "storename": "VN-Shop 2",
            "chanel": "Shopee",
            "tongdoanhthu": 2754205,
            "hoahong_platform": "0",
            "eoi_service_fee": "132870.00"
        }
    ],
    "TikTok_Shop": [],
    "Fanpage": [],
    "Lazada": [],
    "Kenh_khac": [],
    "POS": [],
    "Website": [],
    "Ladipage": [],
    "Callcenter": [],
    "Overviewbychanel": {
        "doanhsoshopee": 412209053,
        "chuyenhoanshopee": 3114835,
        "all_doanhso": 412209053,
        "all_doanhthu": 409621431,
        "all_tienhang": 528198257,
        "all_chuyenhoan": 3114835,
        "all_hoahongaffiliate": 0,
        "all_hoahong_platform": 0,
        "all_trogia_platform": 2013000,
        "all_phidichvusan": 22796063,
        "all_phi_flash_sales": 0,
        "all_phi_voucher_xtra_service": 0,
        "all_phi_affiliate_ads": 0,
        "all_thue_vat": 5070230,
        "all_thue_tncn": 2535198,
        "all_phithanhtoan": 25735347,
        "all_freeship_extra": 55418897,
        "all_tongdatcoc": 162155586,
        "all_chietkhauhoadon": 230111743,
        "all_tongtienhangtruocgiam": 758310000,
        "all_phivanchuyentamtinh": 73338800,
        "all_phivanchuyenkhachthuctra": 1693900,
        "all_tongdon": 2381,
        "all_tongsanpham": 177,
        "all_voucher_from_platform": 108215682,
        "all_voucher_from_seller": 5700070,
        "all_total_giavon": 304000,
        "all_hoanxu": 3277600,
        "all_phivanchuyenthucte": 0,
        "all_tienkhachtra": 412209053,
        "all_trogiavanchuyen_platform": 57396000
    }
}
```

{% endtab %}
{% endtabs %}


# (Shopee) Báo cáo doanh thu

API cho phép lấy danh sách doanh thu theo đơn hàng của một gian hàng đã kết nối vào Abit, giá trị trả về API tương ứng với giá trị bạn nhìn thấy trong mục Doanh thu trên Seller Center của Shopee

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/ecommerce/getEscrowListByPartner)

<mark style="color:green;">`POST /ecommerce/getEscrowListByPartner`</mark>

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>date_time_start</td><td>string</td><td>Thời gian bắt đầu, định dạng mẫu "2025-10-30 00:00:00"</td></tr><tr><td>date_time_end</td><td>string</td><td>Thời gian kết thúc, định dạng mẫu "2025-10-30 23:59:59"</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng Shopee , TikTok Shop ... được kết nối vào Abit, lấy thông tin ID trong mục <strong>Kết nối đa kênh =⇒ Kết nối sàn TMĐT</strong></td></tr><tr><td>page</td><td>int</td><td>Phân trang dữ liệu, mặc định là 0,</td></tr><tr><td>limit</td><td>int</td><td>Số bản ghi dữ liệu sẽ được lấy ra, Shopee hỗ trợ lấy tối đa 100 bản ghi/ trang</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
    "access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
    "partner_name": "Abit",
    "date_time_start": "2025-10-28 00:00:00",
    "date_time_end": "2025-10-31 23:59:59",
    "ecommerce_id": "208830782",
    "page": 0,
    "limit": 10
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "status": "success",
    "escrow_list": [
        {
            "escrow_release_time": 1774348282,
            "order_sn": "260319H65QBEVT",
            "payout_amount": 115515
        },
        {
            "escrow_release_time": 1774344049,
            "order_sn": "260319HDT69AS1",
            "payout_amount": 55447
        },
        {
            "escrow_release_time": 1774337604,
            "order_sn": "260319HV152RCJ",
            "payout_amount": 104488
        }
    ],
    "code": 200
}
```

{% endtab %}
{% endtabs %}

Thông tin giá trị API trả về, Shop có thể tham khảo thông tin tại đây <https://open.shopee.com/documents/v2/v2.payment.get_escrow_list?module=97&type=1>


# (Shopee) Ví Shopee

API cho phép lấy danh sách giao dịch TIỀN VÀO, TIỀN RA của một gian hàng đã kết nối vào Abit, giá trị trả về API tương ứng với giá trị bạn nhìn thấy trong mục Doanh thu trên Seller Center của Shopee

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/ecommerce/getWalletTransactionListByPartner)

<mark style="color:green;">`POST /ecommerce/getWalletTransactionListByPartner`</mark>

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>date_time_start</td><td>string</td><td>Thời gian bắt đầu, định dạng mẫu "2025-10-30 00:00:00"</td></tr><tr><td>date_time_end</td><td>string</td><td>Thời gian kết thúc, định dạng mẫu "2025-10-30 23:59:59"</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng Shopee , TikTok Shop ... được kết nối vào Abit, lấy thông tin ID trong mục <strong>Kết nối đa kênh =⇒ Kết nối sàn TMĐT</strong></td></tr><tr><td>page</td><td>int</td><td>Phân trang dữ liệu, mặc định là 0,</td></tr><tr><td>limit</td><td>int</td><td>Số bản ghi dữ liệu sẽ được lấy ra, Shopee hỗ trợ lấy tối đa 100 bản ghi/ trang</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
    "access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
    "partner_name": "Abit",
    "date_time_start": "2025-10-28 00:00:00",
    "date_time_end": "2025-10-31 23:59:59",
    "ecommerce_id": "208830782",
    "page": 0,
    "limit": 10
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "status": "success",
    "transaction_list": [
        {
            "transaction_id": 222276629898990118,
            "status": "COMPLETED",
            "wallet_type": "shopee_pay",
            "transaction_type": "ESCROW_VERIFIED_ADD",
            "amount": 391825,
            "current_balance": 10502090,
            "create_time": 1773482395,
            "reason": "",
            "order_sn": "260306DAP0YRQC",
            "refund_sn": "",
            "withdrawal_type": "",
            "transaction_fee": 0,
            "description": "Doanh Thu từ Đơn Hàng #260306DAP0YRQC",
            "buyer_name": "nguynxinh0239",
            "pay_order_list": [],
            "withdrawal_id": 0,
            "root_withdrawal_id": 0,
            "remarks": {
                "free_sample_order_id": null,
                "ppp_project_id": null
            },
            "transaction_tab_type": "wallet_order_income",
            "money_flow": "MONEY_IN",
            "outlet_shop_name": ""
        },
        {
            "transaction_id": 222180971565289723,
            "status": "COMPLETED",
            "wallet_type": "shopee_pay",
            "transaction_type": "ADJUSTMENT_FOR_RR_AFTER_ESCROW_VERIFIED",
            "amount": -33040,
            "current_balance": 10110265,
            "create_time": 1773425378,
            "reason": "",
            "order_sn": "260216SCVDN808",
            "refund_sn": "",
            "withdrawal_type": "",
            "transaction_fee": 0,
            "description": "Điều chỉnh Đơn hàng 260216SCVDN808 do phát sinh Trả hàng/Hoàn tiền",
            "buyer_name": "vitalii2752",
            "pay_order_list": [],
            "withdrawal_id": 0,
            "root_withdrawal_id": 0,
            "remarks": {
                "free_sample_order_id": null,
                "ppp_project_id": null
            },
            "transaction_tab_type": "wallet_adjustment_filter",
            "money_flow": "MONEY_OUT",
            "outlet_shop_name": ""
        },
        {
            "transaction_id": 222112380316816342,
            "status": "COMPLETED",
            "wallet_type": "shopee_pay",
            "transaction_type": "ESCROW_VERIFIED_ADD",
            "amount": 35425,
            "current_balance": 9611461,
            "create_time": 1773384495,
            "reason": "",
            "order_sn": "260307H435RVDB",
            "refund_sn": "",
            "withdrawal_type": "",
            "transaction_fee": 0,
            "description": "Doanh Thu từ Đơn Hàng #260307H435RVDB",
            "buyer_name": "katran2743",
            "pay_order_list": [],
            "withdrawal_id": 0,
            "root_withdrawal_id": 0,
            "remarks": {
                "free_sample_order_id": null,
                "ppp_project_id": null
            },
            "transaction_tab_type": "wallet_order_income",
            "money_flow": "MONEY_IN",
            "outlet_shop_name": ""
        }
    ],
    "code": 200
}
```

{% endtab %}
{% endtabs %}

Thông tin giá trị API trả về shop có thể tham khảo tại đây: <https://open.shopee.com/documents/v2/v2.payment.get_wallet_transaction_list?module=97&type=1>


# (Shopee) Chi tiết doanh thu

API lấy chi tiết doanh thu, chi phí của một đơn hàng Shopee, giá trị trả về API tương ứng với giá trị bạn nhìn thấy trong mục Doanh thu trên Seller Center của Shopee

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/ecommerce/getEscrowDetailByPartner)

<mark style="color:green;">`POST /ecommerce/getEscrowDetailByPartner`</mark>

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng Shopee , TikTok Shop ... được kết nối vào Abit, lấy thông tin ID trong mục <strong>Kết nối đa kênh =⇒ Kết nối sàn TMĐT</strong></td></tr><tr><td>order_id</td><td>string</td><td>ID của đơn hàng Shopee</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
    "access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
    "partner_name": "Abit",
    "ecommerce_id":"208830782",
    "order_id": "2603253ME9W8MK"
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "status": "success",
    "response": {
        "buyer_payment_info": {
            "bcrs_deposit": 0,
            "bulky_handling_fee": 0,
            "buyer_paid_extended_warranty": 0,
            "buyer_paid_installation_fee": 0,
            "buyer_payment_method": "ShopeePay Linked Bank Account",
            "buyer_service_fee": 0,
            "buyer_tax_amount": 0,
            "buyer_total_amount": 150750,
            "credit_card_promotion": 0,
            "discount_pix": 0,
            "footwear_tax": 0,
            "icms_tax_amount": 0,
            "import_duty_and_excise_tax": 0,
            "import_processing_charge": 0,
            "import_tax_amount": 0,
            "initial_buyer_txn_fee": 0,
            "insurance_premium": 0,
            "iof_tax_amount": 0,
            "is_paid_by_credit_card": false,
            "lvg_sales_tax_adjustment": 0,
            "merchant_subtotal": 225000,
            "seller_voucher": 0,
            "shipping_fee": 0,
            "shipping_fee_sst_amount": 0,
            "shopee_coins_redeemed": 0,
            "shopee_voucher": -74250,
            "total_tax_and_fees_amount": 0,
            "trade_in_bonus": 0,
            "trade_in_discount": 0,
            "vat": 0
        },
        "buyer_user_name": "hutrng847",
        "order_income": {
            "actual_installation_fee": 0,
            "actual_shipping_fee": 41000,
            "ads_escrow_top_up_fee_or_technical_support_fee": 0,
            "bcrs_deposit": 0,
            "buyer_paid_extended_warranty": 0,
            "buyer_paid_shipping_fee": 0,
            "buyer_payment_method": "ShopeePay Linked Bank Account",
            "buyer_total_amount": 150750,
            "buyer_transaction_fee": 0,
            "campaign_fee": 0,
            "coins": 0,
            "commission_fee": 30375,
            "cost_of_goods_sold": 225000,
            "credit_card_promotion": 0,
            "credit_card_transaction_fee": 11048,
            "cross_border_tax": 0,
            "delivery_seller_protection_fee_premium_amount": 0,
            "drc_adjustable_refund": 0,
            "escrow_amount": 175582,
            "escrow_amount_after_adjustment": 175582,
            "escrow_import_tax": 0,
            "escrow_tax": 0,
            "estimated_shipping_fee": 41000,
            "fbs_fee": 0,
            "final_escrow_product_gst": 0,
            "final_escrow_shipping_gst": 0,
            "final_product_protection": 0,
            "final_product_vat_tax": 0,
            "final_return_to_seller_shipping_fee": 0,
            "final_shipping_fee": 0,
            "final_shipping_vat_tax": 0,
            "fsf_seller_protection_fee_claim_amount": 0,
            "installation_fee_paid_by_buyer": 0,
            "instalment_plan": "N/A",
            "items": [
                {
                    "activity_id": 0,
                    "activity_type": "",
                    "ams_commission_fee": 0,
                    "bcrs_deposit": 0,
                    "buyer_paid_extended_warranty": 0,
                    "discount_from_coin": 0,
                    "discount_from_voucher_seller": 0,
                    "discount_from_voucher_shopee": 24750,
                    "discounted_price": 75000,
                    "installation_fee_paid_by_buyer": 0,
                    "is_b2c_shop_item": false,
                    "is_main_item": false,
                    "item_id": 57805219077,
                    "item_name": "Áo thun unisex nam nữ",
                    "item_sku": "",
                    "model_id": 400477744456,
                    "model_name": "ÁO TRẮNG - Việt Nam,M [41-48kg] [<1.62m]",
                    "model_sku": "AOTHUN",
                    "original_price": 150000,
                    "promotion_list": [
                        {
                            "promotion_id": 866137660375040,
                            "promotion_type": "seller_discount"
                        }
                    ],
                    "quantity_purchased": 1,
                    "seller_discount": 75000,
                    "seller_order_processing_fee": 0,
                    "selling_price": 75000,
                    "shopee_discount": 0
                },
                {
                    "activity_id": 0,
                    "activity_type": "",
                    "ams_commission_fee": 0,
                    "bcrs_deposit": 0,
                    "buyer_paid_extended_warranty": 0,
                    "discount_from_coin": 0,
                    "discount_from_voucher_seller": 0,
                    "discount_from_voucher_shopee": 24750,
                    "discounted_price": 75000,
                    "installation_fee_paid_by_buyer": 0,
                    "is_b2c_shop_item": false,
                    "is_main_item": false,
                    "item_id": 57805219077,
                    "item_name": "Áo thun unisex nam nữ",
                    "item_sku": "",
                    "model_id": 400477744458,
                    "model_name": "ÁO TRẮNG - Việt Nam,XL [58-65kg]",
                    "model_sku": "AOTHUN",
                    "original_price": 150000,
                    "promotion_list": [
                        {
                            "promotion_id": 866137660375040,
                            "promotion_type": "seller_discount"
                        }
                    ],
                    "quantity_purchased": 1,
                    "seller_discount": 75000,
                    "seller_order_processing_fee": 0,
                    "selling_price": 75000,
                    "shopee_discount": 0
                },
                {
                    "activity_id": 0,
                    "activity_type": "",
                    "ams_commission_fee": 0,
                    "bcrs_deposit": 0,
                    "buyer_paid_extended_warranty": 0,
                    "discount_from_coin": 0,
                    "discount_from_voucher_seller": 0,
                    "discount_from_voucher_shopee": 24750,
                    "discounted_price": 75000,
                    "installation_fee_paid_by_buyer": 0,
                    "is_b2c_shop_item": false,
                    "is_main_item": false,
                    "item_id": 57805219077,
                    "item_name": "Áo thun unisex nam nữ",
                    "item_sku": "",
                    "model_id": 410477750965,
                    "model_name": "ÁO TRẮNG - Việt Nam,S [30-40kg]",
                    "model_sku": "AOTHUN",
                    "original_price": 150000,
                    "promotion_list": [
                        {
                            "promotion_id": 866137660375040,
                            "promotion_type": "seller_discount"
                        }
                    ],
                    "quantity_purchased": 1,
                    "seller_discount": 75000,
                    "seller_order_processing_fee": 0,
                    "selling_price": 75000,
                    "shopee_discount": 0
                }
            ],
            "order_ams_commission_fee": 0,
            "order_chargeable_weight": 0,
            "order_discounted_price": 225000,
            "order_original_price": 450000,
            "order_seller_discount": 225000,
            "order_selling_price": 225000,
            "original_cost_of_goods_sold": 225000,
            "original_price": 450000,
            "original_shopee_discount": 0,
            "overseas_return_service_fee": 0,
            "payment_promotion": 0,
            "pix_discount": 0,
            "prorated_coins_value_offset_return_items": 0,
            "prorated_payment_channel_promo_bank_offset_return_items": 0,
            "prorated_payment_channel_promo_shopee_offset_return_items": 0,
            "prorated_pix_discount_offset_return_items": 0,
            "prorated_seller_voucher_offset_return_items": 0,
            "prorated_shopee_voucher_offset_return_items": 0,
            "return_to_seller_shipping_fee_sst": 0,
            "reverse_shipping_fee": 0,
            "reverse_shipping_fee_sst": 0,
            "rsf_seller_protection_fee_claim_amount": 0,
            "sales_tax_on_lvg": 0,
            "seller_coin_cash_back": 0,
            "seller_discount": 225000,
            "seller_lost_compensation": 0,
            "seller_order_processing_fee": 0,
            "seller_return_refund": 0,
            "seller_shipping_discount": 0,
            "seller_transaction_fee": 11048,
            "seller_voucher_code": [],
            "service_fee": 3000,
            "shipping_fee_discount_from_3pl": 0,
            "shipping_fee_sst": 0,
            "shipping_seller_protection_fee_amount": 1620,
            "shopee_discount": 0,
            "shopee_shipping_rebate": 41000,
            "tax_registration_code": "8056930682",
            "tenure_info_list": [
                {
                    "instalment_plan": "N/A"
                }
            ],
            "th_import_duty": 0,
            "total_adjustment_amount": 0,
            "trade_in_bonus_by_seller": 0,
            "vat_on_imported_goods": 0,
            "voucher_from_seller": 0,
            "voucher_from_shopee": 74250,
            "withholding_pit_tax": 1125,
            "withholding_tax": 0,
            "withholding_vat_tax": 2250
        },
        "order_sn": "2603253ME9W8MK",
        "return_order_sn_list": []
    },
    "code": 200
}
```

{% endtab %}
{% endtabs %}

Thông tin giá trị API trả về shop có thể tham khảo tại đây: <https://open.shopee.com/documents/v2/v2.payment.get_escrow_detail?module=97&type=1>


# (Shopee) Chi tiết doanh thu nhiều đơn

API lấy chi tiết doanh thu, chi phí của một đơn hàng Shopee, giá trị trả về API tương ứng với giá trị bạn nhìn thấy trong mục Doanh thu trên Seller Center của Shopee

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/ecommerce/getMutipleEscrowDetailByPartner)

<mark style="color:green;">`POST /ecommerce/getMutipleEscrowDetailByPartner`</mark>

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng Shopee , TikTok Shop ... được kết nối vào Abit, lấy thông tin ID trong mục <strong>Kết nối đa kênh =⇒ Kết nối sàn TMĐT</strong></td></tr><tr><td>order_ids</td><td>string</td><td>chuỗi string ID của đơn hàng Shopee, nhiều đơn ghép lại </td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
    "access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
    "partner_name": "Abit",
    "ecommerce_id":"208830782",
    "order_id": "260819QP36XT66,260819R83TMN26"
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "status": "success",
    "response": [
        {
            "escrow_detail": {
                "buyer_payment_info": {
                    "ads_voucher_discount": 0,
                    "bcrs_deposit": 0,
                    "bulky_handling_fee": 0,
                    "buyer_paid_extended_warranty": 0,
                    "buyer_paid_installation_fee": 0,
                    "buyer_payment_method": "Cash on Delivery",
                    "buyer_service_fee": 0,
                    "buyer_tax_amount": 0,
                    "buyer_total_amount": 81000,
                    "credit_card_promotion": 0,
                    "discount_pix": 0,
                    "footwear_tax": 0,
                    "icms_tax_amount": 0,
                    "import_duty_and_excise_tax": 0,
                    "import_processing_charge": 0,
                    "import_tax_amount": 0,
                    "initial_buyer_txn_fee": 0,
                    "insurance_premium": 0,
                    "iof_tax_amount": 0,
                    "is_paid_by_credit_card": false,
                    "lvg_sales_tax_adjustment": 0,
                    "merchant_subtotal": 75000,
                    "seller_voucher": 0,
                    "shipping_fee": 6000,
                    "shipping_fee_sst_amount": 0,
                    "shopee_coins_redeemed": 0,
                    "shopee_voucher": 0,
                    "shopeevip_subtotal": 0,
                    "total_tax_and_fees_amount": 0,
                    "trade_in_bonus": 0,
                    "trade_in_discount": 0,
                    "vat": 0
                },
                "buyer_user_name": "imrs1u2st_",
                "order_income": {
                    "actual_installation_fee": 0,
                    "actual_shipping_fee": 35700,
                    "ads_escrow_top_up_fee_or_technical_support_fee": 0,
                    "bcrs_deposit": 0,
                    "buyer_paid_extended_warranty": 0,
                    "buyer_paid_shipping_fee": 6000,
                    "buyer_payment_method": "Cash on Delivery",
                    "buyer_total_amount": 81000,
                    "buyer_transaction_fee": 0,
                    "campaign_fee": 0,
                    "coins": 0,
                    "commission_fee": 12375,
                    "cost_of_goods_sold": 75000,
                    "credit_card_promotion": 0,
                    "credit_card_transaction_fee": 4860,
                    "cross_border_tax": 0,
                    "delivery_seller_protection_fee_premium_amount": 0,
                    "drc_adjustable_refund": 0,
                    "escrow_amount": 44460,
                    "escrow_import_tax": 0,
                    "escrow_tax": 0,
                    "estimated_shipping_fee": 35700,
                    "fbs_fee": 0,
                    "final_escrow_product_gst": 0,
                    "final_escrow_shipping_gst": 0,
                    "final_product_protection": 0,
                    "final_product_vat_tax": 0,
                    "final_return_to_seller_shipping_fee": 0,
                    "final_shipping_fee": -6000,
                    "final_shipping_vat_tax": 0,
                    "fsf_seller_protection_fee_claim_amount": 0,
                    "installation_fee_paid_by_buyer": 0,
                    "instalment_plan": "N/A",
                    "items": [
                        {
                            "activity_id": 0,
                            "activity_type": "",
                            "ams_commission_fee": 6480,
                            "bcrs_deposit": 0,
                            "buyer_paid_extended_warranty": 0,
                            "discount_from_coin": 0,
                            "discount_from_voucher_seller": 0,
                            "discount_from_voucher_shopee": 0,
                            "discounted_price": 75000,
                            "installation_fee_paid_by_buyer": 0,
                            "is_b2c_shop_item": false,
                            "is_main_item": false,
                            "item_id": 8709103725,
                            "item_name": "[20 MÀU] Sơ mi nhóm, áo hoa quả pijamas đi biển hawaii nam nữ, chụp kỷ yếu Giá Rẻ Hôm Nay - TIATOSHOP",
                            "item_sku": "",
                            "line_item_id": 240814003221965,
                            "model_id": 225976871141,
                            "model_name": "ÁO MỎ NEO,XXXL [75-95kg]",
                            "model_sku": "AO_MO_NEO_XXXL",
                            "original_price": 150000,
                            "promotion_list": [
                                {
                                    "promotion_id": 866110732959744,
                                    "promotion_type": "seller_discount"
                                }
                            ],
                            "quantity_purchased": 1,
                            "seller_discount": 75000,
                            "seller_order_processing_fee": 0,
                            "selling_price": 75000,
                            "shopee_discount": 0
                        }
                    ],
                    "order_ams_commission_fee": 6480,
                    "order_chargeable_weight": 0,
                    "order_discounted_price": 75000,
                    "order_original_price": 150000,
                    "order_seller_discount": 75000,
                    "order_selling_price": 75000,
                    "original_cost_of_goods_sold": 75000,
                    "original_price": 150000,
                    "original_shopee_discount": 0,
                    "overseas_return_service_fee": 0,
                    "payment_promotion": 0,
                    "pix_discount": 0,
                    "prorated_coins_value_offset_return_items": 0,
                    "prorated_payment_channel_promo_bank_offset_return_items": 0,
                    "prorated_payment_channel_promo_shopee_offset_return_items": 0,
                    "prorated_pix_discount_offset_return_items": 0,
                    "prorated_seller_voucher_offset_return_items": 0,
                    "prorated_shopee_voucher_offset_return_items": 0,
                    "return_to_seller_shipping_fee_sst": 0,
                    "reverse_shipping_fee": 0,
                    "reverse_shipping_fee_sst": 0,
                    "rsf_seller_protection_fee_claim_amount": 0,
                    "sales_tax_on_lvg": 0,
                    "seller_coin_cash_back": 0,
                    "seller_discount": 75000,
                    "seller_lost_compensation": 0,
                    "seller_order_processing_fee": 0,
                    "seller_return_refund": 0,
                    "seller_shipping_discount": 0,
                    "seller_transaction_fee": 4860,
                    "seller_voucher_code": [],
                    "service_fee": 3000,
                    "shipping_fee_discount_from_3pl": 0,
                    "shipping_fee_sst": 0,
                    "shipping_seller_protection_fee_amount": 2700,
                    "shopee_discount": 0,
                    "shopee_shipping_rebate": 29700,
                    "tax_registration_code": "8056930682",
                    "tenure_info_list": [
                        {
                            "instalment_plan": "N/A"
                        }
                    ],
                    "th_import_duty": 0,
                    "trade_in_bonus_by_seller": 0,
                    "vat_on_imported_goods": 0,
                    "voucher_from_external_party": 0,
                    "voucher_from_seller": 0,
                    "voucher_from_shopee": 0,
                    "withholding_cit_tax": 0,
                    "withholding_pit_tax": 375,
                    "withholding_tax": 0,
                    "withholding_vat_tax": 750
                },
                "order_sn": "260819QP36XT66",
                "return_order_sn_list": []
            }
        },
        {
            "escrow_detail": {
                "buyer_payment_info": {
                    "ads_voucher_discount": 0,
                    "bcrs_deposit": 0,
                    "bulky_handling_fee": 0,
                    "buyer_paid_extended_warranty": 0,
                    "buyer_paid_installation_fee": 0,
                    "buyer_payment_method": "Cash on Delivery",
                    "buyer_service_fee": 0,
                    "buyer_tax_amount": 0,
                    "buyer_total_amount": 132000,
                    "credit_card_promotion": 0,
                    "discount_pix": 0,
                    "footwear_tax": 0,
                    "icms_tax_amount": 0,
                    "import_duty_and_excise_tax": 0,
                    "import_processing_charge": 0,
                    "import_tax_amount": 0,
                    "initial_buyer_txn_fee": 0,
                    "insurance_premium": 0,
                    "iof_tax_amount": 0,
                    "is_paid_by_credit_card": false,
                    "lvg_sales_tax_adjustment": 0,
                    "merchant_subtotal": 150000,
                    "seller_voucher": 0,
                    "shipping_fee": 0,
                    "shipping_fee_sst_amount": 0,
                    "shopee_coins_redeemed": 0,
                    "shopee_voucher": -18000,
                    "shopeevip_subtotal": 0,
                    "total_tax_and_fees_amount": 0,
                    "trade_in_bonus": 0,
                    "trade_in_discount": 0,
                    "vat": 0
                },
                "buyer_user_name": "dqd_1106",
                "order_income": {
                    "actual_installation_fee": 0,
                    "actual_shipping_fee": 16500,
                    "ads_escrow_top_up_fee_or_technical_support_fee": 0,
                    "bcrs_deposit": 0,
                    "buyer_paid_extended_warranty": 0,
                    "buyer_paid_shipping_fee": 0,
                    "buyer_payment_method": "Cash on Delivery",
                    "buyer_total_amount": 132000,
                    "buyer_transaction_fee": 0,
                    "campaign_fee": 0,
                    "coins": 0,
                    "commission_fee": 23562,
                    "cost_of_goods_sold": 150000,
                    "credit_card_promotion": 0,
                    "credit_card_transaction_fee": 8568,
                    "cross_border_tax": 0,
                    "delivery_seller_protection_fee_premium_amount": 0,
                    "drc_adjustable_refund": 0,
                    "escrow_amount": 102828,
                    "escrow_import_tax": 0,
                    "escrow_tax": 0,
                    "estimated_shipping_fee": 16500,
                    "fbs_fee": 0,
                    "final_escrow_product_gst": 0,
                    "final_escrow_shipping_gst": 0,
                    "final_product_protection": 0,
                    "final_product_vat_tax": 0,
                    "final_return_to_seller_shipping_fee": 0,
                    "final_shipping_fee": 0,
                    "final_shipping_vat_tax": 0,
                    "fsf_seller_protection_fee_claim_amount": 0,
                    "installation_fee_paid_by_buyer": 0,
                    "instalment_plan": "N/A",
                    "items": [
                        {
                            "activity_id": 0,
                            "activity_type": "",
                            "ams_commission_fee": 0,
                            "bcrs_deposit": 0,
                            "buyer_paid_extended_warranty": 0,
                            "discount_from_coin": 0,
                            "discount_from_voucher_seller": 3600,
                            "discount_from_voucher_shopee": 5400,
                            "discounted_price": 75000,
                            "installation_fee_paid_by_buyer": 0,
                            "is_b2c_shop_item": false,
                            "is_main_item": false,
                            "item_id": 27684484934,
                            "item_name": "Áo thun",
                            "item_sku": "",
                            "line_item_id": 240833353208819,
                            "model_id": 291069211623,
                            "model_name": "[5]-Áo DẢI CỜ,M [41-48kg] [<1.62m]",
                            "model_sku": "MẪU 5",
                            "original_price": 150000,
                            "promotion_list": [
                                {
                                    "promotion_id": 866137660375040,
                                    "promotion_type": "seller_discount"
                                }
                            ],
                            "quantity_purchased": 1,
                            "seller_discount": 75000,
                            "seller_order_processing_fee": 0,
                            "selling_price": 75000,
                            "shopee_discount": 0
                        },
                        {
                            "activity_id": 0,
                            "activity_type": "",
                            "ams_commission_fee": 0,
                            "bcrs_deposit": 0,
                            "buyer_paid_extended_warranty": 0,
                            "discount_from_coin": 0,
                            "discount_from_voucher_seller": 3600,
                            "discount_from_voucher_shopee": 5400,
                            "discounted_price": 75000,
                            "installation_fee_paid_by_buyer": 0,
                            "is_b2c_shop_item": false,
                            "is_main_item": false,
                            "item_id": 27684484934,
                            "item_name": "ÁO TRẮNG",
                            "item_sku": "",
                            "line_item_id": 240833353208818,
                            "model_id": 291069211627,
                            "model_name": "[5]-Áo DẢI CỜ,XL [58-65kg]",
                            "model_sku": "MẪU 5",
                            "original_price": 150000,
                            "promotion_list": [
                                {
                                    "promotion_id": 866137660375040,
                                    "promotion_type": "seller_discount"
                                }
                            ],
                            "quantity_purchased": 1,
                            "seller_discount": 75000,
                            "seller_order_processing_fee": 0,
                            "selling_price": 75000,
                            "shopee_discount": 0
                        }
                    ],
                    "order_ams_commission_fee": 0,
                    "order_chargeable_weight": 0,
                    "order_discounted_price": 150000,
                    "order_original_price": 300000,
                    "order_seller_discount": 150000,
                    "order_selling_price": 150000,
                    "original_cost_of_goods_sold": 150000,
                    "original_price": 300000,
                    "original_shopee_discount": 0,
                    "overseas_return_service_fee": 0,
                    "payment_promotion": 0,
                    "pix_discount": 0,
                    "prorated_coins_value_offset_return_items": 0,
                    "prorated_payment_channel_promo_bank_offset_return_items": 0,
                    "prorated_payment_channel_promo_shopee_offset_return_items": 0,
                    "prorated_pix_discount_offset_return_items": 0,
                    "prorated_seller_voucher_offset_return_items": 0,
                    "prorated_shopee_voucher_offset_return_items": 0,
                    "return_to_seller_shipping_fee_sst": 0,
                    "reverse_shipping_fee": 0,
                    "reverse_shipping_fee_sst": 0,
                    "rsf_seller_protection_fee_claim_amount": 0,
                    "sales_tax_on_lvg": 0,
                    "seller_coin_cash_back": 0,
                    "seller_discount": 150000,
                    "seller_lost_compensation": 0,
                    "seller_order_processing_fee": 0,
                    "seller_return_refund": 0,
                    "seller_shipping_discount": 0,
                    "seller_transaction_fee": 8568,
                    "seller_voucher_code": [
                        "1819826GIAM30K12"
                    ],
                    "service_fee": 3000,
                    "shipping_fee_discount_from_3pl": 0,
                    "shipping_fee_sst": 0,
                    "shipping_seller_protection_fee_amount": 2700,
                    "shopee_discount": 0,
                    "shopee_shipping_rebate": 16500,
                    "tax_registration_code": "8056930682",
                    "tenure_info_list": [
                        {
                            "instalment_plan": "N/A"
                        }
                    ],
                    "th_import_duty": 0,
                    "trade_in_bonus_by_seller": 0,
                    "vat_on_imported_goods": 0,
                    "voucher_from_external_party": 0,
                    "voucher_from_seller": 7200,
                    "voucher_from_shopee": 10800,
                    "withholding_cit_tax": 0,
                    "withholding_pit_tax": 714,
                    "withholding_tax": 0,
                    "withholding_vat_tax": 1428
                },
                "order_sn": "260819R83TMN26",
                "return_order_sn_list": []
            }
        }
    ],
    "code": 200
}
```

{% endtab %}
{% endtabs %}

Thông tin giá trị API trả về shop có thể tham khảo tại đây: <https://open.shopee.com/documents/v2/v2.payment.get_escrow_detail?module=97&type=1>


# (TikTok) Chi tiết doanh thu

API lấy chi tiết doanh thu, chi phí của một đơn hàng TikTok Shop, giá trị trả về API là giá trị trực tiếp từ TikTok Shop trả về

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/ecommerce/tiktok/getEscrowDetailByPartner)

<mark style="color:green;">`POST /ecommerce/tiktok/getEscrowDetailByPartner`</mark>

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng TikTok Shop ... được kết nối vào Abit, lấy thông tin ID trong mục <strong>Kết nối đa kênh =⇒ Kết nối sàn TMĐT</strong></td></tr><tr><td>order_id</td><td>string</td><td>ID của đơn hàng TikTok Shop</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

<pre class="language-json"><code class="lang-json">{
    "access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
    "partner_name": "Abit",
    "ecommerce_id":"7494558197011024789",
<strong>    "order_id": "583272927048795256"
</strong>}
</code></pre>

{% endtab %}

{% tab title="Response" %}

```json
{
    "code": 0,
    "data": {
        "currency": "VND",
        "fee_and_tax_amount": "-32205",
        "order_create_time": 1774685957,
        "order_id": "583272927048795256",
        "revenue_amount": "99000",
        "settlement_amount": "66795",
        "shipping_cost_amount": "0",
        "sku_transactions": [
            {
                "fee_tax_amount": "-32205",
                "fee_tax_breakdown": {
                    "fee": {
                        "affiliate_ads_commission_amount": "0",
                        "affiliate_commission_amount": "-9900",
                        "affiliate_commission_amount_before_pit": "-9900",
                        "affiliate_commission_deposit": "0",
                        "affiliate_commission_release": "0",
                        "affiliate_partner_commission_amount": "0",
                        "bonus_cashback_service_fee_amount": "0",
                        "cofunded_creator_bonus_amount": "0",
                        "cofunded_promotion_service_fee_amount": "0",
                        "credit_card_handling_fee_amount": "0",
                        "dt_handling_fee_amount": "0",
                        "dynamic_commission_amount": "0",
                        "epr_pob_service_fee_amount": "0",
                        "external_affiliate_marketing_fee_amount": "0",
                        "fee_per_item_sold_amount": "0",
                        "flash_sales_service_fee_amount": "0",
                        "gmv_max_ad_fee_amount": "0",
                        "installation_service_fee": "0",
                        "live_specials_fee_amount": "0",
                        "mall_service_fee_amount": "0",
                        "platform_commission_amount": "-12870",
                        "platform_semi_managed_commission_fee": "0",
                        "platform_semi_managed_commission_fee_tax": "0",
                        "platform_special_service_fee_amount": "0",
                        "pre_order_service_fee_amount": "0",
                        "referral_fee_amount": "0",
                        "refund_administration_fee_amount": "0",
                        "seller_paylater_handling_fee_amount": "0",
                        "sfp_service_fee_amount": "0",
                        "shipping_fee_guarantee_service_fee": "0",
                        "smart_promotion_fee_amount": "0",
                        "tap_shop_ads_commission": "0",
                        "transaction_fee_amount": "-4950",
                        "tsp_commission_amount": "0",
                        "vn_fix_infrastructure_fee": "-3000",
                        "voucher_xtra_service_fee_amount": "0"
                    },
                    "tax": {
                        "anti_dumping_duty_amount": "0",
                        "customs_clearance_amount": "0",
                        "customs_duty_amount": "0",
                        "gst_amount": "0",
                        "import_vat_amount": "0",
                        "isr_amount": "0",
                        "iva_amount": "0",
                        "pit_amount": "-495",
                        "sales_tax_referral_fee_amount": "0",
                        "smart_promotion_fee_tax_amount": "0",
                        "sst_amount": "0",
                        "vat_amount": "-990"
                    }
                },
                "product_name": "Áo thun trắng",
                "quantity": "1",
                "revenue_amount": "99000",
                "revenue_breakdown": {
                    "cod_service_fee_amount": "0",
                    "distant_item_fee_amount": "0",
                    "refund_cod_service_fee_amount": "0",
                    "refund_subtotal_before_discount_amount": "0",
                    "seller_discount_amount": "-96000",
                    "seller_discount_refund_amount": "0",
                    "subtotal_before_discount_amount": "195000"
                },
                "settlement_amount": "66795",
                "shipping_cost_amount": "0",
                "shipping_cost_breakdown": {
                    "actual_shipping_fee_amount": "-14000",
                    "customer_paid_shipping_fee_amount": "0",
                    "distant_shipping_fee_amount": "0",
                    "exchange_shipping_fee_amount": "0",
                    "failed_delivery_subsidy_amount": "0",
                    "fbt_free_shipping_fee_amount": "0",
                    "fbt_fulfillment_fee_reimbursement_amount": "0",
                    "free_return_subsidy_amount": "0",
                    "replacement_shipping_fee_amount": "0",
                    "return_shipping_fee_amount": "0",
                    "return_shipping_fee_paid_buyer_amount": "0",
                    "return_shipping_label_fee_amount": "0",
                    "seller_self_shipping_service_fee_amount": "0",
                    "shipping_fee_discount_amount": "14000",
                    "shipping_insurance_fee_amount": "0",
                    "signature_confirmation_fee_amount": "0",
                    "supplementary_component": {
                        "customer_shipping_fee_offset_amount": "0",
                        "fbm_shipping_cost_amount": "0",
                        "fbt_fulfillment_fee_amount": "0",
                        "fbt_shipping_cost_amount": "0",
                        "platform_shipping_fee_discount_amount": "14000",
                        "promo_shipping_incentive_amount": "0",
                        "refunded_customer_shipping_fee_amount": "0",
                        "return_refund_subsidy_amount": "0",
                        "seller_shipping_fee_discount_amount": "0",
                        "shipping_fee_guarantee_reimbursement": "0",
                        "shipping_fee_subsidy_amount": "0"
                    }
                },
                "sku_id": "1734491732301285269",
                "sku_name": "AOTHUN",
                "statement_id": "7623238626767865608"
            }
        ],
        "total_count": 1
    },
    "message": "Success",
    "request_id": "20260401104857AB4C02B89168CD121658"
}
```

{% endtab %}
{% endtabs %}

Thông tin giá trị API trả về shop có thể tham khảo tại đây:&#x20;

<https://partner.tiktokshop.com/docv2/page/get-transactions-by-order-202501>


# (TikTok) Danh sách giao dịch

TikTok Shop cho phép lấy các giao dịch theo ngày, trong mỗi giao dịch sẽ có nhiều đơn hàng được thanh toán, muốn lấy danh sách các đơn hàng thì cần gọi thêm API Đối soát đơn hàng theo giao dịch

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/ecommerce/tiktok/getStatementsByPartner)

<mark style="color:green;">`POST /ecommerce/tiktok/getStatementsByPartner`</mark>&#x20;

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng TikTok Shop ... được kết nối vào Abit, lấy thông tin ID trong mục <strong>Kết nối đa kênh =⇒ Kết nối sàn TMĐT</strong></td></tr><tr><td>date_time_start</td><td>datetime</td><td>Lấy những giao dịch bắt đầu từ ngày</td></tr><tr><td>page_token</td><td>string</td><td>là phân trang của tiktok shop, lấy dữ liệu trang đầu tiên thì giá trị này không truyền gì cả, trang trang tiếp theo truyền giá trị của trường <strong>"next_page_token"</strong> ở Response trả về</td></tr><tr><td>limit</td><td>int</td><td>Số lượng giao dịch lấy ra</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
"access_token":"Y3TVmN2QxY2E2OWJjYWYyODFkZWFlZGY1ZWE0ZjhmMzM=",
"partner_name":"Abit",
"date_time_start": "2026-07-12 00:00:00",
"ecommerce_id":"7494558197011024789",
"page_token":"",
"limit":5
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "code": 0,
    "data": {
        "next_page_token": "",
        "statements": [
            {
                "adjustment_amount": "0",
                "currency": "VND",
                "fee_amount": "-1604943",
                "id": "7660720364734859028",
                "net_sales_amount": "5311000",
                "payment_id": "3656827961771526037",
                "payment_status": "SETTLED",
                "payment_time": 1783728711,
                "revenue_amount": "5311000",
                "settlement_amount": "3706057",
                "shipping_cost_amount": "0",
                "statement_time": 1783728000
            },
            {
                "adjustment_amount": "0",
                "currency": "VND",
                "fee_amount": "-1384753",
                "id": "7661102720761349905",
                "net_sales_amount": "4695000",
                "payment_id": "3657633911718119317",
                "payment_status": "SETTLED",
                "payment_time": 1783818320,
                "revenue_amount": "4695000",
                "settlement_amount": "3310247",
                "shipping_cost_amount": "0",
                "statement_time": 1783814400
            },
            {
                "adjustment_amount": "0",
                "currency": "VND",
                "fee_amount": "-2071133",
                "id": "7661435189385807632",
                "net_sales_amount": "6941000",
                "payment_id": "3658395493949867925",
                "payment_status": "SETTLED",
                "payment_time": 1783907710,
                "revenue_amount": "6941000",
                "settlement_amount": "4869867",
                "shipping_cost_amount": "0",
                "statement_time": 1783900800
            },
            {
                "adjustment_amount": "0",
                "currency": "VND",
                "fee_amount": "-1245750",
                "id": "7661827830694643473",
                "net_sales_amount": "3882000",
                "payment_id": "3659094398177806229",
                "payment_status": "SETTLED",
                "payment_time": 1783992746,
                "revenue_amount": "3882000",
                "settlement_amount": "2636250",
                "shipping_cost_amount": "0",
                "statement_time": 1783987200
            }
        ]
    },
    "message": "Success",
    "request_id": "20260714110045ECC5739CE9DC9D03C843"
}
```

{% endtab %}
{% endtabs %}

Thông tin giá trị API trả về shop có thể tham khảo tại đây:&#x20;

<https://partner.tiktokshop.com/docv2/page/get-transactions-by-order-202501>


# (TikTok) Đối soát đơn hàng theo giao dịch

TikTok Shop cho phép lấy các giao dịch theo ngày, trong mỗi giao dịch sẽ có nhiều đơn hàng được thanh toán, muốn lấy danh sách các đơn hàng thì cần gọi thêm API

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/ecommerce/tiktok/getTransactionByStatementByPartner)

<mark style="color:green;">`POST /ecommerce/tiktok/getTransactionByStatementByPartner`</mark>

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>ecommerce_id</td><td>string</td><td>ID gian hàng TikTok Shop ... được kết nối vào Abit, lấy thông tin ID trong mục <strong>Kết nối đa kênh =⇒ Kết nối sàn TMĐT</strong></td></tr><tr><td>statement_id</td><td>string</td><td>Là id của giao dịch được lấy ở bên API <a href="/api-mo-rong/tiktok-danh-sach-giao-dich">Danh sách giao dịch</a></td></tr><tr><td>page_token</td><td>string</td><td>là phân trang của tiktok shop, lấy dữ liệu trang đầu tiên thì giá trị này không truyền gì cả, trang trang tiếp theo truyền giá trị của trường <strong>"next_page_token"</strong> ở Response trả về</td></tr><tr><td>limit</td><td>int</td><td>Số lượng giao dịch lấy ra</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
"access_token":"YTVmN2QxY2E2OWJjYWYyODFkZWFlZGY1ZWE0ZjhmMzM=",
"partner_name":"Abit",
"ecommerce_id":"7494558197011024789",
"statement_id":"7661827830694643473",
"page_token":"",
"limit":5
}
```

{% endtab %}

{% tab title="Response" %}

```json
{
    "code": 0,
    "data": {
        "create_time": 1783987200,
        "currency": "VND",
        "id": "7661827830694643473",
        "next_page_token": "WzIwMjYwNzEzMDAwMDAwLDE3ODM5NTMyNzc0OTIsNzY2MjAyMjk3Nzg2MDc5ODIyNV0=",
        "payable_amount": "2636250",
        "status": "SETTLED",
        "total_count": 49,
        "total_reserve_amount": "0",
        "total_settlement_amount": "2636250",
        "total_settlement_breakdown": {
            "total_adjustment_amount": "0",
            "total_fee_tax_amount": "-1206350",
            "total_revenue_amount": "3882000",
            "total_shipping_cost_amount": "-39400"
        },
        "transactions": [
            {
                "adjustment_amount": "0",
                "fee_tax_amount": "0",
                "fee_tax_breakdown": {
                    "fee": {
                        "affiliate_ads_commission_amount": "0",
                        "affiliate_commission_amount": "0",
                        "affiliate_commission_amount_before_pit": "0",
                        "affiliate_commission_deposit": "0",
                        "affiliate_commission_release": "0",
                        "affiliate_partner_commission_amount": "0",
                        "bonus_cashback_service_fee_amount": "0",
                        "brand_amplification_program_commission": "0",
                        "brand_amplification_program_fee_tax": "0",
                        "brand_campaign_fee": "0",
                        "brand_campaign_fee_tax": "0",
                        "buyer_fault_return_shipping_fee": "0",
                        "campaign_period_fee_cfp_amount": "0",
                        "campaign_period_fee_cfp_tax_amount": "0",
                        "campaign_period_fee_sp_amount": "0",
                        "campaign_period_fee_sp_tax_amount": "0",
                        "category_led_campaign_fee_amount": "0",
                        "category_led_campaign_fee_tax_amount": "0",
                        "cofunded_creator_bonus_amount": "0",
                        "cofunded_promotion_service_fee_amount": "0",
                        "cps_shop_ads_commission_tax_amount": "0",
                        "credit_card_handling_fee_amount": "0",
                        "dt_handling_fee_amount": "0",
                        "dynamic_commission_amount": "0",
                        "epr_pob_service_fee_amount": "0",
                        "external_affiliate_marketing_fee_amount": "0",
                        "failed_delivery_shipping_fee": "0",
                        "fee_per_item_sold_amount": "0",
                        "flash_sales_service_fee_amount": "0",
                        "gmv_max_ad_fee_amount": "0",
                        "gmv_max_coupon_fee": "0",
                        "installation_service_fee": "0",
                        "insurance_fee": "0",
                        "live_specials_fee_amount": "0",
                        "mall_service_fee_amount": "0",
                        "platform_commission_amount": "0",
                        "platform_semi_managed_commission_fee": "0",
                        "platform_semi_managed_commission_fee_tax": "0",
                        "platform_special_service_fee_amount": "0",
                        "pre_order_service_fee_amount": "0",
                        "referral_fee_amount": "0",
                        "refund_administration_fee_amount": "0",
                        "seller_growth_fee_amount": "0",
                        "seller_paylater_handling_fee_amount": "0",
                        "sfp_service_fee_amount": "0",
                        "shipping_fee_guarantee_service_fee": "0",
                        "shipping_insurance_fee_tax_amount": "0",
                        "smart_promotion_fee_amount": "0",
                        "tap_shop_ads_commission": "0",
                        "transaction_fee_amount": "0",
                        "tsp_commission_amount": "0",
                        "vn_fix_infrastructure_fee": "0",
                        "voucher_xtra_service_fee_amount": "0"
                    },
                    "tax": {
                        "anti_dumping_duty_amount": "0",
                        "cedular_tax": "0",
                        "customs_clearance_amount": "0",
                        "customs_duty_amount": "0",
                        "gst_amount": "0",
                        "import_vat_amount": "0",
                        "isr_amount": "0",
                        "iva_amount": "0",
                        "pit_amount": "0",
                        "sales_tax_referral_fee_amount": "0",
                        "smart_promotion_fee_tax_amount": "0",
                        "sst_amount": "0",
                        "vat_amount": "0"
                    }
                },
                "id": "7662036436816299797",
                "order_create_time": 1783956413,
                "order_id": "585011379646924055",
                "revenue_amount": "0",
                "revenue_breakdown": {
                    "cod_service_fee_amount": "0",
                    "distant_item_fee_amount": "0",
                    "refund_cod_service_fee_amount": "0",
                    "refund_subtotal_before_discount_amount": "-195000",
                    "seller_discount_amount": "-96000",
                    "seller_discount_refund_amount": "96000",
                    "subtotal_before_discount_amount": "195000"
                },
                "settlement_amount": "0",
                "shipping_cost_amount": "0",
                "shipping_cost_breakdown": {
                    "actual_shipping_fee_amount": "0",
                    "customer_paid_shipping_fee_amount": "0",
                    "distant_shipping_fee_amount": "0",
                    "exchange_shipping_fee_amount": "0",
                    "failed_delivery_subsidy_amount": "0",
                    "fbt_free_shipping_fee_amount": "0",
                    "fbt_fulfillment_fee_reimbursement_amount": "0",
                    "fbt_key_merchant_subsidy": "0",
                    "fbt_overall_merchant_subsidy": "0",
                    "free_return_subsidy_amount": "0",
                    "logistics_service_fee": "0",
                    "replacement_shipping_fee_amount": "0",
                    "return_shipping_fee_amount": "0",
                    "return_shipping_fee_paid_buyer_amount": "0",
                    "return_shipping_label_fee_amount": "0",
                    "seller_self_shipping_service_fee_amount": "0",
                    "shipping_app_service_fee_amount": "0",
                    "shipping_fee_discount_amount": "0",
                    "shipping_fee_guarantee_reimbursement": "0",
                    "shipping_insurance_fee_amount": "0",
                    "signature_confirmation_fee_amount": "0",
                    "supplementary_component": {
                        "customer_shipping_fee": "0",
                        "customer_shipping_fee_offset_amount": "0",
                        "fbm_shipping_cost_amount": "0",
                        "fbt_fulfillment_fee_amount": "0",
                        "fbt_shipping_cost_amount": "0",
                        "platform_shipping_fee_discount_amount": "0",
                        "promo_shipping_incentive_amount": "0",
                        "refund_customer_shipping_fee": "0",
                        "refunded_customer_shipping_fee_amount": "0",
                        "return_refund_subsidy_amount": "0",
                        "seller_shipping_fee_discount_amount": "0",
                        "shipping_fee_subsidy_amount": "0"
                    },
                    "tiktok_shop_shipping_incentive_amount": "0"
                },
                "supplementary_component": {
                    "customer_payment_amount": "99000",
                    "customer_refund_amount": "-99000",
                    "platform_cofunded_discount_amount": "0",
                    "platform_cofunded_discount_refund_amount": "0",
                    "platform_discount_amount": "0",
                    "platform_discount_refund_amount": "0",
                    "retail_delivery_fee_amount": "0",
                    "retail_delivery_fee_payment_amount": "0",
                    "retail_delivery_fee_refund_amount": "0",
                    "sales_tax_amount": "0",
                    "sales_tax_payment_amount": "0",
                    "sales_tax_refund_amount": "0",
                    "seller_cofunded_discount_amount": "0",
                    "seller_cofunded_discount_refund_amount": "0"
                },
                "type": "ORDER"
            },
            {
                "adjustment_amount": "0",
                "fee_tax_amount": "0",
                "fee_tax_breakdown": {
                    "fee": {
                        "affiliate_ads_commission_amount": "0",
                        "affiliate_commission_amount": "0",
                        "affiliate_commission_amount_before_pit": "0",
                        "affiliate_commission_deposit": "0",
                        "affiliate_commission_release": "0",
                        "affiliate_partner_commission_amount": "0",
                        "bonus_cashback_service_fee_amount": "0",
                        "brand_amplification_program_commission": "0",
                        "brand_amplification_program_fee_tax": "0",
                        "brand_campaign_fee": "0",
                        "brand_campaign_fee_tax": "0",
                        "buyer_fault_return_shipping_fee": "0",
                        "campaign_period_fee_cfp_amount": "0",
                        "campaign_period_fee_cfp_tax_amount": "0",
                        "campaign_period_fee_sp_amount": "0",
                        "campaign_period_fee_sp_tax_amount": "0",
                        "category_led_campaign_fee_amount": "0",
                        "category_led_campaign_fee_tax_amount": "0",
                        "cofunded_creator_bonus_amount": "0",
                        "cofunded_promotion_service_fee_amount": "0",
                        "cps_shop_ads_commission_tax_amount": "0",
                        "credit_card_handling_fee_amount": "0",
                        "dt_handling_fee_amount": "0",
                        "dynamic_commission_amount": "0",
                        "epr_pob_service_fee_amount": "0",
                        "external_affiliate_marketing_fee_amount": "0",
                        "failed_delivery_shipping_fee": "0",
                        "fee_per_item_sold_amount": "0",
                        "flash_sales_service_fee_amount": "0",
                        "gmv_max_ad_fee_amount": "0",
                        "gmv_max_coupon_fee": "0",
                        "installation_service_fee": "0",
                        "insurance_fee": "0",
                        "live_specials_fee_amount": "0",
                        "mall_service_fee_amount": "0",
                        "platform_commission_amount": "0",
                        "platform_semi_managed_commission_fee": "0",
                        "platform_semi_managed_commission_fee_tax": "0",
                        "platform_special_service_fee_amount": "0",
                        "pre_order_service_fee_amount": "0",
                        "referral_fee_amount": "0",
                        "refund_administration_fee_amount": "0",
                        "seller_growth_fee_amount": "0",
                        "seller_paylater_handling_fee_amount": "0",
                        "sfp_service_fee_amount": "0",
                        "shipping_fee_guarantee_service_fee": "0",
                        "shipping_insurance_fee_tax_amount": "0",
                        "smart_promotion_fee_amount": "0",
                        "tap_shop_ads_commission": "0",
                        "transaction_fee_amount": "0",
                        "tsp_commission_amount": "0",
                        "vn_fix_infrastructure_fee": "0",
                        "voucher_xtra_service_fee_amount": "0"
                    },
                    "tax": {
                        "anti_dumping_duty_amount": "0",
                        "cedular_tax": "0",
                        "customs_clearance_amount": "0",
                        "customs_duty_amount": "0",
                        "gst_amount": "0",
                        "import_vat_amount": "0",
                        "isr_amount": "0",
                        "iva_amount": "0",
                        "pit_amount": "0",
                        "sales_tax_referral_fee_amount": "0",
                        "smart_promotion_fee_tax_amount": "0",
                        "sst_amount": "0",
                        "vat_amount": "0"
                    }
                },
                "id": "7662022977860798225",
                "order_create_time": 1783953277,
                "order_id": "585010626752513165",
                "revenue_amount": "0",
                "revenue_breakdown": {
                    "cod_service_fee_amount": "0",
                    "distant_item_fee_amount": "0",
                    "refund_cod_service_fee_amount": "0",
                    "refund_subtotal_before_discount_amount": "-195000",
                    "seller_discount_amount": "-96000",
                    "seller_discount_refund_amount": "96000",
                    "subtotal_before_discount_amount": "195000"
                },
                "settlement_amount": "0",
                "shipping_cost_amount": "0",
                "shipping_cost_breakdown": {
                    "actual_shipping_fee_amount": "0",
                    "customer_paid_shipping_fee_amount": "0",
                    "distant_shipping_fee_amount": "0",
                    "exchange_shipping_fee_amount": "0",
                    "failed_delivery_subsidy_amount": "0",
                    "fbt_free_shipping_fee_amount": "0",
                    "fbt_fulfillment_fee_reimbursement_amount": "0",
                    "fbt_key_merchant_subsidy": "0",
                    "fbt_overall_merchant_subsidy": "0",
                    "free_return_subsidy_amount": "0",
                    "logistics_service_fee": "0",
                    "replacement_shipping_fee_amount": "0",
                    "return_shipping_fee_amount": "0",
                    "return_shipping_fee_paid_buyer_amount": "0",
                    "return_shipping_label_fee_amount": "0",
                    "seller_self_shipping_service_fee_amount": "0",
                    "shipping_app_service_fee_amount": "0",
                    "shipping_fee_discount_amount": "0",
                    "shipping_fee_guarantee_reimbursement": "0",
                    "shipping_insurance_fee_amount": "0",
                    "signature_confirmation_fee_amount": "0",
                    "supplementary_component": {
                        "customer_shipping_fee": "0",
                        "customer_shipping_fee_offset_amount": "0",
                        "fbm_shipping_cost_amount": "0",
                        "fbt_fulfillment_fee_amount": "0",
                        "fbt_shipping_cost_amount": "0",
                        "platform_shipping_fee_discount_amount": "0",
                        "promo_shipping_incentive_amount": "0",
                        "refund_customer_shipping_fee": "0",
                        "refunded_customer_shipping_fee_amount": "0",
                        "return_refund_subsidy_amount": "0",
                        "seller_shipping_fee_discount_amount": "0",
                        "shipping_fee_subsidy_amount": "0"
                    },
                    "tiktok_shop_shipping_incentive_amount": "0"
                },
                "supplementary_component": {
                    "customer_payment_amount": "99000",
                    "customer_refund_amount": "-99000",
                    "platform_cofunded_discount_amount": "0",
                    "platform_cofunded_discount_refund_amount": "0",
                    "platform_discount_amount": "0",
                    "platform_discount_refund_amount": "0",
                    "retail_delivery_fee_amount": "0",
                    "retail_delivery_fee_payment_amount": "0",
                    "retail_delivery_fee_refund_amount": "0",
                    "sales_tax_amount": "0",
                    "sales_tax_payment_amount": "0",
                    "sales_tax_refund_amount": "0",
                    "seller_cofunded_discount_amount": "0",
                    "seller_cofunded_discount_refund_amount": "0"
                },
                "type": "ORDER"
            }
        ]
    },
    "message": "Success",
    "request_id": "20260714125113D0190F68A0347300087B"
}
```

{% endtab %}
{% endtabs %}

Thông tin giá trị API trả về shop có thể tham khảo tại đây:&#x20;

<https://partner.tiktokshop.com/docv2/page/get-transactions-by-statement-202501>


# Danh sách Kho - Chi Nhánh

API lấy danh sách Kho - Chi nhánh của một tài khoản Abit , thông tin được trả ra gồm ID kho hàng, Tên Kho và Mã kho - Chi Nhánh

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/productstore/getStoreidByPartner)

<mark style="color:green;">`POST /`</mark>productstore/getStoreidByPartner

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>page</td><td>int</td><td>Phân trang, lấy kết quả ở trang thứ mấy, mặc định giá trị là <strong>0</strong></td></tr><tr><td>limit</td><td>int</td><td>Giới hạn kết quả trả ra, mặc định là <strong>10</strong></td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
  "access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
  "partner_name": "Abit",
  "page":0,
  "limit":100
}
```

{% endtab %}

{% tab title="Response" %}

```json
[
    {
        "productstoreid": 1,
        "productstorename": "Kho vĩnh tuy 3",
        "productstore_sku": "KHOVINHTUY",
        "showhidden": 1
    },
    {
        "productstoreid": 2,
        "productstorename": "Kho SG",
        "productstore_sku": "KhoSG",
        "showhidden": 1
    },
    {
        "productstoreid": 4,
        "productstorename": "Kho 118",
        "productstore_sku": "Kho118",
        "showhidden": 1
    }
]
```

{% endtab %}
{% endtabs %}


# Danh sách Gian hàng - Nguồn đơn

Lấy danh sách Gian hàng, ID gian hàng theo Kho - Chi Nhánh và theo từng kênh

URL API: [https://new.abitstore.vn](https://new.abitstore.vn/productstore/getEcommerceViaStoreidByParner)

<mark style="color:green;">`POST /`</mark>productstore/getEcommerceViaStoreidByParner

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

<table><thead><tr><th width="149">Name</th><th width="95">Type</th><th>Description</th></tr></thead><tbody><tr><td>access_token</td><td>string</td><td>Mã Access token được khởi tạo và cấp quyền bởi chủ tài khoản Abit, Xem hướng dẫn tạo <a href="/gioi-thieu-ve-abit-open-api#khoi-tao-access-token"><mark style="color:red;"><strong>Access Token</strong></mark> </a></td></tr><tr><td>partner_name</td><td>string</td><td>Mã shop khi đăng ký Abit</td></tr><tr><td>productstoreid</td><td>int</td><td>ID kho - Chi nhánh của Abit, lấy giá trị này ở <a href="/api-mo-rong/danh-sach-kho-chi-nhanh"><strong>API  Danh sách Kho - Chi Nhánh</strong></a></td></tr><tr><td>chanel</td><td>string</td><td>Bạn có thể truyền Kênh để lấy danh sách ID Gian hàng, nguồn đơn Shopee, TIKTOK_SHOP, Fanpage, Website, Ladipage</td></tr></tbody></table>

{% tabs %}
{% tab title="Body" %}

```json
{
"access_token": "Zjg5ZDYzNmFmOGFkYmQwODVmMzVmOWM4YTRlMDFiMWQ=",
"partner_name": "Abit",
"productstoreid":1,
"chanel":""
}
```

{% endtab %}

{% tab title="Response" %}

```json
[
    {
        "ecommerce_id": "192119425",
        "resourcename": "VN-Abit Store",
        "chanel": "Shopee"
    },
    {
        "ecommerce_id": "200185074242",
        "resourcename": "Shopp Test",
        "chanel": "Lazada"
    },
    {
        "ecommerce_id": "251094",
        "resourcename": "Abit Shop",
        "chanel": "TIKI"
    },
    {
        "ecommerce_id": "1834817483438900",
        "resourcename": "Cooking and Food",
        "chanel": "Fanpage"
    },
    {
        "ecommerce_id": "289582808317941",
        "resourcename": "Abittest 3",
        "chanel": "Fanpage"
    }
]
```

{% endtab %}
{% endtabs %}