# Bút toán * /api/accounting/transaction: Tính năng này dùng để lấy danh sách bút toán ở trên Nhanh.vn. Dữ liệu sẽ được phân trang, mỗi trang tối đa không quá 100 bút toán. ## Request * Xem các [common request params](/v2/readme.md#request-params) * Các key của mảng **data array** dùng để tạo **data** json string: | Key | Type | Description | | ----------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | page | int | Phân trang, giá trị mặc định sẽ là 1. | | icpp | int | Số lượng sản phẩm trên 1 trang. Tối đa không quá 50. Mặc định nếu không set giá trị gì sẽ là 20. | | sort | array | Sắp xếp kết quả, dữ liệu gửi lên là 1 mảng kiểu \[Tiêu chí sắp xếp => cách sắp xếp (asc: tăng dần hoặc desc giảm dần)] Giá trị mặc định sẽ là \[id => desc].Các tiêu chí có thể là: id: id bút toán, date: ngày thu chi, amount: số tiền bút toán | | id | int | Tìm bút toán theo ID | | typeDate | int | Tìm theo kiểu ngày.Giá trị 1: Lọc theo ngày giao dịch,2: Lọc theo ngày tạo(Mặc định nếu không set giá trị sẽ là 1) | | fromDate | date | Tìm kiếm thời gian bất đầu từ ngày định dạng (yyyy-mm-dd). VD: 2022-09-25 | | toDate | date | Tìm kiếm thời gian đến ngày (yyyy-mm-dd). VD: 2022-09-25 | | type | int | Tìm kiếm theo loại phiếu (xem ở Loại phiếu bên dưới) | | mode | int | Tìm kiếm theo kiểu bút toán(Xem ở Kiểu bút toán bên dưới) | | filterMode | int | Tìm kiếm theo loại hoạch toán.Giá trị 1: Tự động,2: Không tự động | | contactType | int | Tìm kiếm theo loại đối tượng.Giá trị 1: Khách hàng,2: Nhà cung cấp,3: Dịch vụ trả góp,4: Nhân viên,20: Khác,21:Sàn thương mại điện tử, | ## Response * JSON decode the response to get the structure: | Key | Type | Description | | -------- | ----- | ----------------------------------------- | | code | int | 1 = success or 0 = failed | | messages | array | is an array of error messages if code = 0 | | data | array | is an array of transaction list | ```javascript [ "totalPages": 30, // int "transactions": [ [], // each transaction item, all properties are listed in the table below ... ] ] ``` | Key | Type | Description | | --------------- | ----------- | ---------------------------------------------------------------------------------- | | id | int | ID bút toán | | date | date | Ngày thu chi | | type | int | Loại của bút toán (xem bảng Loại phiếu bên dưới) | | mode | int | Kiểu bút toán (xem bảng Kiểu bút toán bên dưới) | | contactId | int | ID đối tương bút toán | | contactName | string(255) | Tên đối tương bút toán | | contactCode | string(255) | Mã đối tương bút toán | | itemId | int | ID chứng từ bút toán | | source | string(255) | Chứng từ bút toán | | amount | doulbe | Số tiền của bút toán | | accountDebitId | int | ID Tài khoản debit account của bút toán | | accountDebit | doulbe | Tài khoản debit account của bút toán | | accountCreditId | int | ID Tài khoản credit của bút toán | | accountCredit | doulbe | Tài khoản credit của bút toán | | description | string(255) | Ghi chú của bút toán | | depotId | int | ID kho doanh nghiệp | | createdById | int | ID người tạo bút toán | | createdUserName | string | Tên người tạo bút toán | | createdDateTime | string | Thời gian giờ tạo bút toán, định dạng yyyy-mm-dd hh:mm:ss, vd: 2025-04-14 20:00:00 | ### Loại phiếu | Type | Name | | ---- | ----------------- | | 1 | Báo nợ (Rút tiền) | | 2 | Báo có (Nộp tiền) | | 3 | Phiếu thu | | 4 | Phiếu chi | | 5 | Phiếu trả hàng | | 6 | Phiếu bán hàng | | 7 | Khác | | 8 | Phiếu nhập | | 9 | Phiếu xuất | | 12 | Kết chuyển | ### Kiểu bút toán | Mode | Name | | ---- | --------------------------------------- | | 1 | Nhập nhà cung cấp | | 2 | Xuất trả nhà cung cấp | | 3 | Bán hàng | | 4 | Hàng trả lại | | 5 | Bán sỉ | | 6 | Trả lại bán sỉ | | 7 | Nhập máy cũ | | 8 | Bảo hành | | 9 | Xuất linh kiện | | 15 | Chuyển quỹ | | 20 | Hạch toán trả góp | | 21 | Công nợ đầu kì | | 22 | Đơn hàng | | 23 | Đơn hàng trả lại | | 24 | Nhập nhà cung cấp VAT | | 25 | Xuất nhà cung cấp VAT | | 26 | XNK khác | | 27 | Thu hộ trả góp | | 28 | Nhập VAT | | 29 | Xuất VAT | | 30 | Xác nhận nhận tiền thanh toán | | 31 | Xác nhận chi tiền thanh toán vận chuyển | | 32 | Phiếu nhập quà tặng | | 33 | Phiếu xuất quà tặng | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://apidocs.nhanh.vn/v2/accounting/transaction.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.