Nếu mất internet hoặc không truy cập được Đám mây

Kết nối bị đứt: nhà cung cấp, router, giông bão, sự cố từ nhà mạng. Cơ sở không vì thế mà đóng cửa — khách vẫn đứng ở quầy thu ngân. Dưới đây là những gì tiếp tục hoạt động, những gì không, và ca làm việc cần làm gì.

Hãy phân biệt hai loại sự cố, vì chúng hành xử khác nhau:

Thu ngân cố ý không đoán nguyên nhân: mọi lỗi mạng đều có nghĩa là “làm việc cục bộ, bản ghi vào hàng đợi”.

Những gì tiếp tục hoạt động#

Thu ngân (POS web). Đây không chỉ là một trang được lưu đệm, mà là hàng đợi bản ghi thực sự trên Thiết bị:

• đơn hàng vẫn được bấm và vào hàng đợi đơn hàng (tồn tại trên Thu ngân 24 giờ);
• biên lai và ca tiền mặt — có hàng đợi thao tác riêng (mở ca, nộp và rút tiền, biên lai, hoàn trả, đóng ca). Mỗi thao tác có khóa idempotent phía client, nên việc gửi bù không làm trùng lặp gì;
• ca mở ngoại tuyến nhận số tạm thời và tiếp tục hoạt động: cổng chặn “không có ca mở thì cấm thanh toán” khi ngoại tuyến vẫn có hiệu lực, nó tính theo bộ nhớ đệm cục bộ;
• thực đơn, giá, bàn, danh mục đọc từ bộ nhớ đệm cục bộ của trình duyệt — chúng đã vào đó khi còn kết nối;
• tải lại trang không đẩy ra màn hình đăng nhập: Thu ngân mở ở “phiên suy giảm” theo ảnh chụp cục bộ và tự kết nối lại khi mạng trở lại.

In ấn. Biên lai, phiếu bếp và nhãn được in qua Bridge chạy trên cùng máy tính: Thu ngân gọi nó qua địa chỉ cục bộ của máy — việc này không cần internet.

Biên lai tài chính. Nếu Máy tính tiền tài chính được kết nối với cùng máy tính đó, biên lai được bấm qua Bridge bằng cùng kênh cục bộ: bộ nhớ tài chính tích lũy chứng từ, còn nhà vận hành dữ liệu tài chính sẽ đuổi kịp khi kết nối trở lại. Đối với FZ-54, đây là chế độ tiêu chuẩn, không phải vi phạm.

Màn hình đăng nhập. Chừng nào trình duyệt còn phiên gần đây (cửa sổ — 7 ngày), thu ngân đăng nhập và làm việc được; việc gửi dữ liệu tích lũy vẫn sẽ cần xác thực thật khi kết nối khôi phục.

Những gì không hoạt động khi mất kết nối#

• Màn hình bếp (KDS). Phiếu đến đó qua Đám mây; không có internet thì đơn hàng mới sẽ không vào bếp — chúng sẽ đến đó khi kết nối khôi phục. Trong thời gian này, bếp làm theo phiếu in, nếu bạn đã thiết lập in cho bếp, hoặc theo yêu cầu truyền miệng.
• Máy POS ngân hàng. Thanh toán bằng thẻ cần xác thực với ngân hàng — ngoại tuyến sẽ không thực hiện được. Hãy nhận tiền mặt.
• Thanh toán trực tuyến của khách (thẻ trên trang trưng bày, thanh toán hóa đơn khách từ bàn, thanh toán tại kiốt) — cần truy cập nhà cung cấp thanh toán.
• Thu ngân thứ hai và máy tính bảng của phục vụ. Các Thiết bị không đồng bộ với nhau trong mạng cục bộ: mỗi cái giữ hàng đợi riêng và tự gửi bù. Chúng tôi cố ý không làm vòng cục bộ chung (“chế độ LAN”) — đây là quyết định của chủ sản phẩm: chúng tôi tập trung vào tính tự chủ của một Thu ngân kèm in ấn.
• Báo cáo X. Bản cắt trung gian được tính trên máy chủ theo doanh số — ngoại tuyến Thu ngân sẽ từ chối thẳng thắn. Có thể đóng ca, báo cáo Z sẽ được tạo khi kết nối trở lại.
• Các mục trong trang quản trị tính toán trên máy chủ — “Đơn hàng”, “Tài chính”, “Thống kê”, “Kho”, “Nhân sự”. Chúng đọc từ Đám mây, và ngoại tuyến chỉ hiển thị cùng lắm là dữ liệu cuối cùng đã đọc được.
• Màn hình phát hàng, bảng số thứ tự, kiốt — cũng là các bề mặt Đám mây.

Ca làm việc cần làm gì#

1. Tiếp tục bấm. Ngay khi mất kết nối, trên Thu ngân xuất hiện băng-rôn màu hổ phách “ngoại tuyến” và chip “N chưa gửi”. Đây là chế độ bình thường: đơn hàng đã nhận, biên lai đã in, tiền đã thu.
2. In biên lai cho khách như thường lệ. In ấn là cục bộ — giấy vẫn ra.
3. Làm việc trên cùng Thiết bị và cùng trình duyệt. Hàng đợi nằm trên máy tính này: không thể chuyển sang máy tính bảng thứ hai và “gửi bù từ đó”.
4. Không xóa bộ nhớ đệm trình duyệt, không đăng xuất khỏi Tài khoản, không mở Thu ngân ở chế độ ẩn danh — làm vậy sẽ xóa mất đơn hàng và biên lai chưa gửi.
5. Có thể tải lại trang. Hàng đợi vẫn tồn tại qua tải lại trang và khởi động lại trình duyệt.
6. Không bấm một đơn hàng hai lần “cho chắc”: hệ thống được bảo vệ chống trùng lặp khi gửi bù, nhưng hai đơn hàng khác nhau thì nó sẽ tính đúng là hai.
7. Không nhận thẻ — Máy POS ngoại tuyến không xác thực được. Dùng tiền mặt, hoặc nếu khách muốn thì xuất Hóa đơn thanh toán sau.
8. Băng-rôn đỏ “N chưa gửi được” có nghĩa là một phần bản ghi không gửi đi được ngay cả sau khi kết nối khôi phục (hết hạn hoặc máy chủ từ chối). Đây là lý do để gọi quản lý, chứ không phải để che băng-rôn đi.

Điều gì sẽ xảy ra khi kết nối trở lại#

Việc gửi bù bắt đầu tự động — theo sự kiện “mạng đã có”, khi quay lại tab và theo bộ hẹn giờ.

• Chip “N chưa gửi” giảm dần và biến mất. Đơn hàng xuất hiện trong mục “Đơn hàng” và trên màn hình bếp, biên lai nhận số, kho được trừ theo định mức nguyên liệu.
• Sẽ không có trùng lặp. Mỗi đơn hàng có định danh phía client, mỗi thao tác Thu ngân có khóa idempotent; máy chủ nhận ra sự lặp lại và không áp dụng lần thứ hai.
• Ca ngoại tuyến được thay bằng ca thật. Số ca tạm thời được ghi đè bằng số thật trong mọi biên lai và giao dịch còn đang trong hàng đợi.
• Báo cáo Z được tạo cho ca đã đóng ngoại tuyến.
• Không có gì bị xóa âm thầm. Những bản ghi không gửi được (quá 24 giờ hoặc máy chủ trả lỗi không thể khôi phục) sẽ vào danh sách riêng “chưa gửi được” (lưu 7 ngày, tối đa 100 bản ghi) và hiển thị bằng băng-rôn đỏ kèm khả năng ẩn thủ công.

Thứ tự được giữ nguyên: hàng đợi được gửi bù tuần tự, và với các lỗi tạm thời của máy chủ thì thử lại với khoảng chờ tăng dần.

Hạn chế#

• Ngoại tuyến chỉ khả dụng cho thu ngân và in ấn — và chỉ có vậy. Màn hình bếp, máy POS ngân hàng và đồng bộ giữa các thiết bị trong mạng cục bộ đều không hoạt động khi không có internet; toàn bộ vòng LAN hoàn chỉnh được quyết định là không làm.
• Hàng đợi gắn với thiết bị và trình duyệt. Nó nằm trong bộ nhớ của một trình duyệt cụ thể: máy tính khác, trình duyệt khác hoặc chế độ ẩn danh không thấy được nó.
• Thời gian sống của hàng đợi là 24 giờ đối với đơn hàng và giao dịch thu ngân. Quá một ngày không có kết nối — các bản ghi sẽ vào danh sách “chưa gửi”, chứ không âm thầm biến mất.
• Phiên ngoại tuyến kéo dài 7 ngày. Sau đó thu ngân sẽ yêu cầu đăng nhập thông thường, mà không có mạng thì không thể đăng nhập.
• Báo cáo X không khả dụng ngoại tuyến — nó được tính trên máy chủ.
• Các bề mặt dành cho khách (gian hàng, ki-ốt) chỉ giữ hàng đợi một giờ — chúng được thiết kế cho sự cố mạng di động tạm thời của khách, chứ không phải để hoạt động không có internet.
• Thu ngân Android. Nhận đơn hàng và biên lai tài chính cục bộ hoạt động ngoại tuyến, còn ghi vào sổ đăng ký biên lai và ca tiền mặt ngoại tuyến thì chưa (đã lên kế hoạch). Nguồn xác thực ngoại tuyến ở đó là bộ nhớ tài chính.
• Chạy thử “rút cáp” trên máy đăng ký tài chính thực tế vẫn chưa được thực hiện. Chế độ ngoại tuyến của thu ngân đã được đóng bằng mã và kiểm thử tự động (bao gồm cả e2e “ngoại tuyến trong phiên”), còn việc kiểm tra trên phần cứng thật bởi chủ sở hữu vẫn nằm trong kế hoạch — chúng tôi nói thẳng điều này, chứ không trình bày như đã hoàn thành.

Xử lý sự cố#

Thu ngân yêu cầu đăng nhập dù trước đó đã hoạt động. Phiên đã quá bảy ngày hoặc trình duyệt đã bị xóa dữ liệu. Không có mạng thì không thể đăng nhập — hãy khôi phục kết nối.

Chip “N chưa gửi” không giảm. Kiểm tra xem kết nối đã thực sự trở lại chưa (mở bất kỳ trang web nào) và giữ tab thu ngân ở trạng thái hoạt động: việc gửi bổ sung diễn ra theo sự kiện mạng, khi quay lại tab và theo bộ hẹn giờ. Nếu chip giữ nguyên một con số — hãy xem banner đỏ: một phần bản ghi có thể đã vào “chưa gửi”.

Xuất hiện banner đỏ “N chưa gửi”. Các bản ghi không được máy chủ chấp nhận: đã hết hạn một ngày hoặc phản hồi không thể khôi phục (ví dụ: quyền truy cập bị thu hồi). Đơn hàng và biên lai trong danh sách này cần được xử lý thủ công — hãy đối chiếu với biên lai giấy của ca.

Đơn hàng đã được nhập ngoại tuyến nhưng không thấy trên bếp. Đúng là như vậy: phiếu sẽ được gửi đến màn hình bếp khi kết nối được khôi phục. Khi chưa có mạng, bếp được phục vụ bằng phiếu in.

Biên lai không in được ngoại tuyến. Vậy vấn đề không phải ở internet: hãy kiểm tra xem bridge trên máy tính này đã chạy chưa và máy in đã được kết nối chưa — Cenaly Hardware Bridge. Bridge và thu ngân giao tiếp trong cùng một máy.

Sau khi khôi phục kết nối xuất hiện đơn hàng trùng. Việc gửi bổ sung không thể tạo ra trùng lặp — hãy kiểm tra xem có phải cùng một đơn hàng đã được nhập tay hai lần không, và hủy đơn thừa trong mục “Đơn hàng”.

Câu hỏi thường gặp#

Thu ngân có hoạt động mà không có internet không?#

Có: nhập đơn hàng, in biên lai và tài chính hóa chúng qua bridge trên cùng máy tính đó. Mọi thứ cần gửi lên đám mây đều được tích lũy trong hàng đợi trên thiết bị và tự động gửi bổ sung.

Dữ liệu có bị mất không?#

Không. Hàng đợi tồn tại qua việc tải lại trang và khởi động lại trình duyệt, còn những gì không gửi được sẽ vào danh sách “chưa gửi” hiển thị rõ, chứ không biến mất. Chỉ có thể mất dữ liệu thủ công — bằng cách xóa dữ liệu trình duyệt.

Có thể nhập biên lai theo 54-FZ ngoại tuyến không?#

Có, nếu máy đăng ký tài chính được kết nối với cùng máy tính như bridge: bộ nhớ tài chính tích lũy tài liệu và truyền cho nhà điều hành dữ liệu tài chính khi kết nối trở lại. Đây là chế độ được luật quy định.

Tại sao màn hình bếp không hoạt động?#

Phiếu đi qua đám mây. Chúng tôi không có mạng cục bộ giữa thu ngân và màn hình bếp — đây là quyết định có chủ đích: chúng tôi đảm bảo tính tự chủ của thu ngân kèm in ấn, chứ không phải toàn bộ sảnh. Khi chưa có mạng, bếp được duy trì bằng phiếu in.

Khách có thể mở thực đơn khi chúng tôi không có internet không?#

Có — gian hàng được phân phối từ CDN và không phụ thuộc vào internet của bạn. Đơn hàng do khách tạo sẽ đến được đám mây, nhưng tại cơ sở bạn chỉ thấy nó sau khi kết nối được khôi phục.

Làm gì với thanh toán bằng thẻ?#

Thu tiền mặt: máy POS ngân hàng cần xác thực với ngân hàng.

Thu ngân chịu được bao lâu không có kết nối?#

Một ngày đối với hàng đợi đơn hàng và giao dịch thu ngân, bảy ngày — đối với phiên. Thực tế điều này có nghĩa là: bạn sẽ làm việc cả ca một cách yên tâm.

Các mục liên quan#

• Thu ngân (POS) — đơn hàng, thanh toán, các chế độ phục vụ và mục “Làm việc ngoại tuyến”
• Ca tiền mặt và báo cáo Z — mở ca, giao dịch, báo cáo X và Z
• Cenaly Hardware Bridge — bridge trên máy tính POS, máy in và máy đăng ký tài chính
• In cho bếp — phiếu theo trạm khi màn hình bếp không khả dụng
• Màn hình bếp (KDS) — cách phiếu đến bếp
• Ngày đầu tiên: quán cà phê, nhà hàng, căng tin — những gì cần bật ngay