Trung tâm developer / kiến thức công khai / Bài viết kỹ thuật

Tích hợp máy in

Hướng dẫn này mô tả lộ trình triển khai cho in hóa đơn và nhãn. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ. Ghi chú kỹ thuật này là điểm bắt đầu có cấu trúc. Hãy xác nhận model, Android, firmware, SDK, phiên bản ứng dụng và phụ kiện trước khi xem là kết quả triển khai.

Trao đổi dự án

v1.0.0 / Bài viết kỹ thuậtNguồn đã kiểm tra: 2026-08-30

Phạm vi model: Phạm vi model: SUNMI / V2s / V2s PLUS / Android 11. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
Phiên bản Android: Phiên bản Android: V2s / V2s PLUS / Android 11 / SUNMI. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
Firmware: Firmware: Ghi nhận ranh giới của in hóa đơn và nhãn. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
SDK / giao diện: SDK / giao diện: SUNMI / LineApi / CommandApi / QueryApi. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
Bản dựng ứng dụng: Bản dựng ứng dụng: Xác định lộ trình kỹ thuật cho in hóa đơn và nhãn. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.

Phạm vi tài liệu nhà sản xuất

Phạm vi tài liệu nhà sản xuất: Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
Cơ sở nguồn: Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng.
Tham chiếu công khai: Xác minh in hóa đơn và nhãn. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.

Bề mặt API

Bề mặt API: woyou.aidlservice.jiuiv5 / IWoyouService
Bề mặt API: LineApi / initLine / addText / printText / printBarCode / printQrCode / printBitmap
Bề mặt API: CommandApi / sendEscCommand / sendTsplCommand
Bề mặt API: QueryApi / getStatus / getInfo
Bề mặt API: Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.

Phạm vi và điều kiện tiên quyết

Phạm vi và điều kiện tiên quyết: Xác định lộ trình kỹ thuật cho in hóa đơn và nhãn.
Phạm vi model: SUNMI / V2s / V2s PLUS / Android 11.
Bản dựng ứng dụng: in hóa đơn và nhãn.
Quyền và sở hữu: Ghi nhận ranh giới của in hóa đơn và nhãn.

Quyền và sở hữu

Quyền và sở hữu: Ghi nhận ranh giới của in hóa đơn và nhãn.
Phạm vi và điều kiện tiên quyết: Xác định lộ trình kỹ thuật cho in hóa đơn và nhãn.
Trạng thái bằng chứng: Trạng thái bằng chứng: Ủy quyền, dữ liệu sản phẩm, quyền media, tương thích, khả dụng và hỗ trợ được ghi thành các hồ sơ riêng.

Xử lý lỗi

Xử lý lỗi: Ghi nhận ranh giới của in hóa đơn và nhãn. Trạng thái bằng chứng: Ủy quyền, dữ liệu sản phẩm, quyền media, tương thích, khả dụng và hỗ trợ được ghi thành các hồ sơ riêng.

Giới hạn đã biết

Giới hạn đã biết: Ghi nhận ranh giới của in hóa đơn và nhãn.
Cơ sở nguồn: Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng.
Kiểm thử UnitWeave: Trạng thái bằng chứng: Ủy quyền, dữ liệu sản phẩm, quyền media, tương thích, khả dụng và hỗ trợ được ghi thành các hồ sơ riêng.

Lộ trình triển khai

01
Lộ trình triển khai 01: Xác định lộ trình kỹ thuật cho in hóa đơn và nhãn. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
02
Lộ trình triển khai 02: Bề mặt API: SUNMI / LineApi / CommandApi / QueryApi. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
03
Lộ trình triển khai 03: Danh sách xác minh: Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
04
Lộ trình triển khai 04: Xử lý lỗi: Ghi nhận ranh giới của in hóa đơn và nhãn. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
05
Lộ trình triển khai 05: Trạng thái bằng chứng: Trạng thái bằng chứng: Ủy quyền, dữ liệu sản phẩm, quyền media, tương thích, khả dụng và hỗ trợ được ghi thành các hồ sơ riêng.
06
Lộ trình triển khai 06: Phạm vi và điều kiện tiên quyết: Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
07
Lộ trình triển khai 07: Xác định lộ trình kỹ thuật cho in hóa đơn và nhãn. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.

Danh sách xác minh

Danh sách xác minh 01: Xác minh in hóa đơn và nhãn. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
Danh sách xác minh 02: Phạm vi model: SUNMI / V2s / V2s PLUS / Android 11. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
Danh sách xác minh 03: Phiên bản Android: V2s / V2s PLUS / Android 11 / SUNMI. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
Danh sách xác minh 04: Xử lý lỗi: Ghi nhận ranh giới của in hóa đơn và nhãn. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.
Danh sách xác minh 05: Trạng thái bằng chứng: Trạng thái bằng chứng: Ủy quyền, dữ liệu sản phẩm, quyền media, tương thích, khả dụng và hỗ trợ được ghi thành các hồ sơ riêng.
Danh sách xác minh 06: Xác minh in hóa đơn và nhãn. Dùng LineApi cho văn bản, cột, mã vạch và QR; chỉ dùng CommandApi cho ESC/POS hoặc TSPL, truy vấn QueryApi và xác minh khổ giấy, in lại cùng phiên bản dịch vụ.

Điều kiện xuất bản

Ghi chú được xuất bản phải liên kết nguồn công khai, giữ tuyên bố trong phạm vi nguồn đó, nêu kết quả nghiệm thu có định danh và loại trừ tài liệu riêng tư hoặc của khách hàng.

Điều kiện xuất bản 01: Ghi chú được xuất bản phải liên kết nguồn công khai, giữ tuyên bố trong phạm vi nguồn đó, nêu kết quả nghiệm thu có định danh và loại trừ tài liệu riêng tư hoặc của khách hàng.
Điều kiện xuất bản 02: Ghi nhận ranh giới của in hóa đơn và nhãn.
Điều kiện xuất bản 03: Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng.
Điều kiện xuất bản 04: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.
Điều kiện xuất bản 05: Trạng thái bằng chứng: Ủy quyền, dữ liệu sản phẩm, quyền media, tương thích, khả dụng và hỗ trợ được ghi thành các hồ sơ riêng.

Giấy phép và xuất xứ

Giấy phép và xuất xứ: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.

Tham chiếu mẫu

Tham chiếu mẫu: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.

Cơ sở nguồn

Nguồn gốc tài liệu

Nguồn đã kiểm tra: 2026-08-30

Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.

SUNMI Integration GuideSUNMI / Tài liệu chính thức của SUNMI: SUNMI Integration Guide. Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng. / Nguồn đã kiểm tra: 2026-08-30
Nguồn gốc tài liệu: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.
Mở tham chiếu
Introduction to SUNMI Printing ServicesSUNMI / Tài liệu chính thức của SUNMI: Introduction to SUNMI Printing Services. Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng. / Nguồn đã kiểm tra: 2026-08-30
Nguồn gốc tài liệu: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.
Mở tham chiếu
APIs for Printing Thermal ReceiptsSUNMI / Tài liệu chính thức của SUNMI: APIs for Printing Thermal Receipts. Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng. / Nguồn đã kiểm tra: 2026-08-30
Nguồn gốc tài liệu: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.
Mở tham chiếu
APIs for Printing Instruction SetsSUNMI / Tài liệu chính thức của SUNMI: APIs for Printing Instruction Sets. Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng. / Nguồn đã kiểm tra: 2026-08-30
Nguồn gốc tài liệu: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.
Mở tham chiếu
APIs for Querying PrinterSUNMI / Tài liệu chính thức của SUNMI: APIs for Querying Printer. Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng. / Nguồn đã kiểm tra: 2026-08-30
Nguồn gốc tài liệu: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.
Mở tham chiếu
SDK Versions of Devices With Built-in PrintersSUNMI / Tài liệu chính thức của SUNMI: SDK Versions of Devices With Built-in Printers. Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng. / Nguồn đã kiểm tra: 2026-08-30
Nguồn gốc tài liệu: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.
Mở tham chiếu
SUNMI Device's Android VersionSUNMI / Tài liệu chính thức của SUNMI: SUNMI Device's Android Version. Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng. / Nguồn đã kiểm tra: 2026-08-30
Nguồn gốc tài liệu: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.
Mở tham chiếu
SunmiPrinterXSampleSUNMI / Tham chiếu mẫu: SunmiPrinterXSample. Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng. / Nguồn đã kiểm tra: 2026-08-30 / b3df54b59f56f6a670429bdfca9383b95319dcd8
Nguồn gốc tài liệu: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.
Mở tham chiếu
Android package visibilityAndroid Developers / Nguồn công khai của SUNMI và Android: Android package visibility. Cơ sở nguồn cho biết ghi chú triển khai công khai đến từ đâu. Nội dung này tách biệt với kiểm thử phần cứng của UnitWeave và nghiệm thu của khách hàng. / Nguồn đã kiểm tra: 2026-08-30
Nguồn gốc tài liệu: Nội dung triển khai được duy trì tại đây theo cấu trúc và cách diễn đạt của UnitWeave. URL nguồn vẫn nằm trong hồ sơ xuất xứ để ghi công và kiểm tra phiên bản; chúng không thay thế hướng dẫn.
Mở tham chiếu