Hướng dẫn sử dụng ứng dụng Trạm cân

1.1 Đăng nhập

Mở ứng dụng Trạm cân từ Start Menu hoặc biểu tượng trên màn hình nền. Việc đăng nhập diễn ra ở trình duyệt, không nhập mật khẩu trong ứng dụng.

Ứng dụng mở cửa sổ chờ

Trạm cân hiện cửa sổ “Đang chờ đăng nhập…” và tự mở trình duyệt. Cứ để cửa sổ này nguyên đó, đừng đóng.

Đăng nhập trên trình duyệt

Trình duyệt mở trang GreenCoco Portal — Cổng vận hành. Nhập tên đăng nhập hoặc email và mật khẩu của tài khoản nội bộ, rồi bấm Đăng nhập.

Máy trạm cố định

Tick Ghi nhớ thông tin đăng nhập nếu đây là máy đặt cố định tại trạm cân. Ô này không lưu mật khẩu vào máy — nó chỉ kéo dài thời gian ứng dụng được vào thẳng, xem bảng ngay dưới đây.

Quay lại cửa sổ Trạm cân

Đăng nhập xong thì quay lại cửa sổ Trạm cân — ứng dụng tự vào màn hình Cân. Nếu máy đã đăng nhập sẵn từ trước, cả ba bước này chạy tự động trong vài giây và bạn không thấy gì cả.

Nếu hiện “Không thể đăng nhập”, bấm Thử lại. Vẫn không được thì xem bảng lỗi thường gặp.

1.2 Màn hình Cân có gì

Màu của số hiển thị khối lượng nói lên điều gì

1.3 Cân một lượt — 6 bước

Chọn nhân viên

Gõ tên hoặc số điện thoại vào ô Nhân viên, rồi bấm chọn trong danh sách gợi ý.

Mẹo

Gõ Le ra được Lê Thị Huyền, Lê Thị Yến và Nguyễn Lê Hoàng Cô Trang — không cần bỏ dấu cho đúng.

Chọn sản phẩm

Làm tương tự với ô Sản phẩm — tìm theo tên hoặc theo mã, ví dụ RM-BROWNMEAT-DRY. Khi đã chọn đủ cả hai, ô trạng thái đổi sang Sẵn sàng cân và nút lớn đổi thành Bắt đầu cân.

Bấm “Bắt đầu cân”

Nút đổi thành Hủy cân, hai ô chọn bị khóa lại để không chọn nhầm giữa chừng, và dòng trạng thái ghi “Đang chờ số cân ổn định...”.

Đặt hàng lên bàn cân

Đặt hàng lên bàn cân và để yên. Ứng dụng tự ghi nhận khi cả ba điều kiện cùng đúng:

• số cân lớn hơn 0;
• đầu cân báo ổn định;
• số đó giữ nguyên qua 3 lần đọc liên tiếp — khoảng ⅓ đến ¾ giây.

Không cần bấm thêm nút nào. Nếu tay còn chạm vào hàng hoặc bàn cân còn rung thì số không ổn định, ứng dụng cứ chờ tiếp.

Thứ tự đúng

Luôn bấm Bắt đầu cân trước, đặt hàng sau. Ứng dụng không bao giờ ghi nhận số 0, nên bấm trước là an toàn.

Xác nhận kết quả

Dòng	Ý nghĩa
Khối lượng từ cân	Số đọc trực tiếp từ đầu cân, còn cả bì.
Khối lượng bì (tare)	Số sẽ bị trừ đi.
Khối lượng thực	Đây là số được lưu. Bằng khối lượng từ cân trừ đi bì.
Nhân viên · Số điện thoại	Người được ghi nhận cho lượt cân này.
Sản phẩm	Mặt hàng đang cân.

Đúng thì bấm Lưu. Sai thì bấm Hủy — không có gì được lưu, bạn cân lại từ bước 3.

Kiểm tra đã lưu

Lượt cân xuất hiện ở đầu bảng Lượt cân hôm nay với nhãn xanh Đã gửi.

Hai ô nhân viên và sản phẩm cũng tự xóa để sẵn sàng cho lượt kế tiếp — có thể tắt trong Cài đặt.

Nhãn	Nghĩa là
Đang gửi	Đang gửi lên máy chủ, chờ vài giây.
Đã gửi	Máy chủ đã nhận. Lượt cân này chắc chắn được lưu.
Dòng biến mất	Máy chủ từ chối — kết quả không được lưu, phải cân lại.

1.4 Ý nghĩa dòng trạng thái

Dòng chữ nhỏ ngay dưới con số cân cho biết ứng dụng đang ở đâu trong quy trình.

1.5 Khối lượng bì (tare)

Khối lượng bì là khối lượng của rổ, khay hoặc pallet đựng hàng. Ứng dụng trừ số này ra khỏi mọi lượt cân rồi mới lưu.

• Đặt trong Cài đặt → Quy trình cân → Khối lượng bì (tare).
• Mặc định là 0, tức không trừ gì cả.
• Công thức: Khối lượng thực = Khối lượng từ cân − bì, và kết quả không bao giờ âm — bì lớn hơn số cân thì kết quả là 0.
• Số bì đang áp dụng luôn hiển thị ở khung đen bên phải màn hình Cân, nên bạn kiểm tra được trước khi cân.

1.6 Hủy một lượt cân

1.7 Mất mạng thì không lưu được

• Nếu ô trạng thái API báo Chưa kết nối, hoặc mạng rớt đúng lúc bấm Lưu, ứng dụng hiện thông báo “Không thể gửi dữ liệu” và bỏ kết quả cân.
• Dòng vừa xuất hiện trong Lượt cân hôm nay sẽ biến mất.
• Phải cân lại sau khi mạng phục hồi.

Vì vậy: luôn liếc ô trạng thái API trước khi bắt đầu ca cân. Nếu nó không xanh thì gọi kỹ thuật trước, đừng cân rồi mất công cân lại.

1.8 Đăng xuất

Bấm Đăng xuất ở góc dưới trái — tên tài khoản đang đăng nhập hiển thị ngay cạnh. Ứng dụng hỏi lại trước khi thoát.

Cuối ca bình thường thì chỉ cần đóng ứng dụng, không cần đăng xuất.

2.1 Nhân viên

Thêm nhân viên mới

Số điện thoại, mã nội bộ và ghi chú đều tùy chọn — nhưng nên nhập số điện thoại, vì người vận hành có thể tìm nhân viên theo số này. Mã nhân viên (NV-10004…) do hệ thống tự cấp.

2.2 Sản phẩm

Sản phẩm được tạo trên hệ thống trung tâm, không thêm được từ trạm cân. Bấm Tải từ máy chủ để lấy danh sách mới. Công tắc Hiển thị dùng để ẩn mặt hàng không còn cân nữa.

2.3 Lịch sử cân

Chọn Nhân viên, Sản phẩm, Từ ngày, Đến ngày rồi bấm Áp dụng bộ lọc. Bấm Xóa bộ lọc để xem lại tất cả.

Dòng cuối trang cho biết Tổng số, Đã đồng bộ (máy chủ đã nhận) và Chờ đồng bộ.

2.4 Xuất Excel

Bấm Xuất Excel ở góc phải khối bộ lọc.

3.1 Tải và cài ứng dụng

Tải bộ cài về máy tính của trạm cân:

Tải xong, chuột phải vào tệp → Install, rồi chọn Yes ở hộp thoại Windows hỏi quyền Administrator. Trình cài đặt sẽ:

• cài vào C:\Program Files\Grcoco\WeighingStationApp\ cho mọi tài khoản Windows trên máy;
• tạo lối tắt Start Menu, và lối tắt Desktop nếu bạn tick trong wizard;
• tự đóng ứng dụng đang chạy khi nâng cấp lên phiên bản mới.

3.2 Lần đầu chạy: chọn máy chủ

Bộ cài không đặt sẵn địa chỉ máy chủ nào, nên lần đầu mở ứng dụng sau khi cài, màn hình Thiết lập trạm cân hiện ra trước màn hình đăng nhập. Chỉ làm một lần, thường là lúc kỹ thuật viên lắp máy — trước khi giao cho bộ phận cân.

Chọn môi trường

Ba lựa chọn, chọn một:

Địa chỉ đằng sau mỗi lựa chọn:

Kiểm tra kết nối — bắt buộc

Bấm Kiểm tra kết nối. Ứng dụng gọi thử cả hai máy chủ và báo từng dòng một. Chỉ khi cả hai đều đạt thì nút Lưu và tiếp tục mới sáng lên.

Lưu và tiếp tục

Bấm Lưu và tiếp tục. Chọn Máy chủ thật thì ứng dụng lưu và chuyển thẳng sang màn hình đăng nhập. Chọn Máy chủ thử thì hỏi lại một lần nữa:

3.3 Nơi lưu dữ liệu

Tất cả nằm trong C:\ProgramData\WeighingStationApp\, dùng chung cho mọi tài khoản Windows trên máy.

Một dòng nhật ký khi cân thành công trông như sau:

2026-08-23 16:49:36.412 +07:00 [INF] Weighing saved: employee=d1533a7a-…,
product=5ee524ba-…, net=5,92 kg, tare=0,00, localId=…

3.4 Màn hình Cài đặt

Vào bằng nút Cài đặt ở góc dưới trái.

Kết nối cân

Máy chủ

Thẻ này quyết định trạm gửi phiếu cân về đâu và đăng nhập ở đâu. Mỗi môi trường là một cơ sở dữ liệu và một danh sách tài khoản hoàn toàn tách biệt; địa chỉ của từng môi trường xem ở mục 3.2.

Nhập địa chỉ không có dấu / ở cuối.

Nhãn môi trường

Góc phải thẻ Máy chủ hiện nhãn cho biết trạm đang ở đâu: MÁY CHỦ THẬT (nền xanh) hoặc MÁY CHỦ THỬ (nền cam). Đây là cách nhanh nhất để biết một máy đang gửi dữ liệu đi đâu.

Quy trình cân

• Khối lượng bì (tare) — xem mục 1.5. Giá trị ≥ 0, tối đa 2 chữ số thập phân.
• Tự động xóa lựa chọn sau khi cân — Bật (mặc định) thì mỗi lần lưu xong, hai ô nhân viên và sản phẩm tự trống. Tắt nếu một người cân nhiều lượt liên tiếp cùng một mặt hàng.

3.5 Kiểm tra và Lưu

Kiểm tra kết nối chạy lần lượt ba mục và dừng ở mục đầu tiên bị lỗi:

Thành công hết thì hiển thị thông báo “Cổng COM, máy chủ API và máy chủ đăng nhập đều trả lời bình thường.” Không đạt thì báo đúng mục nào hỏng, ví dụ “Địa chỉ API: Không kết nối được tới máy chủ. Sai tên miền, hoặc máy tính chưa ra được Internet.” Mỗi lần gọi chờ tối đa 10 giây.

3.6 Vùng Nâng cao

Cả hai đều hỏi xác nhận trước khi chạy.

4.1 Đấu nối

1. Nối cổng RS-232 của đầu cân — DI-28SS hoặc PWE-200 — vào máy tính. Máy đời mới không có cổng COM thì dùng bộ chuyển USB ↔ RS-232.
2. Cài driver của bộ chuyển nếu Windows chưa tự nhận.
3. Xác định số cổng COM: Device Manager → Ports (COM & LPT), sẽ thấy dòng kiểu Prolific USB-to-Serial Comm Port (COM3).
4. Cắm điện và bật đầu cân.

4.2 Cấu hình đầu cân

Đầu cân phải ở chế độ in liên tục — tùy máy ghi là Prt.Co, Cont hoặc Stream — tức là tự động gửi số ra cổng nối tiếp liên tục.

Thông số truyền: 9600 baud, 8 bit dữ liệu, không chẵn lẻ, 1 bit dừng (8-N-1). Nếu đầu cân đặt baud khác thì đổi trên đầu cân, hoặc chỉnh cho khớp trong mục Cài đặt.

4.3 Chọn đúng đầu cân trong ứng dụng

Trạm hiện đang chạy với tùy chọn DIGI DI-28SS và đọc PWE-200 bình thường — hai đầu cân này gửi khung dữ liệu gần giống nhau. Nếu muốn chuyển hẳn sang tùy chọn PWE-200 thì chỉ cần đổi một mục duy nhất: Cài đặt → Kết nối cân → Đầu cân (đầu hiển thị) → chọn PWE-200 → Lưu thay đổi. Cổng COM, baud và địa chỉ API giữ nguyên.

4.4 Bảng lỗi thường gặp

C:\ProgramData\WeighingStationApp\logs\app-<yyyyMMdd>.log