Kết nối hệ thống bên ngoài

Cách đọc trang này

Ba mức, nói cho đúng từng cái

Không phải kết nối nào cũng cùng một trạng thái. Để khỏi nói tròn, chúng tôi tách rõ ba mức:

Dùng được ngay. Chạy trong nội bộ phần mềm, không phụ thuộc ai bên ngoài.
Cắm khóa là chạy. Phần mềm đã có sẵn mã gọi API thật - dựng yêu cầu, ký chữ ký, đọc phản hồi - và đã kiểm thử logic ngoại tuyến. Khi bạn nhập khóa của nhà cung cấp vào phần cấu hình, hệ thống chuyển từ chế độ mô phỏng sang gọi thật ngay, không phải viết thêm mã. Việc còn lại là đối chiếu với môi trường thử của từng nhà cung cấp khi bạn có tài khoản.
Khung sẵn. Giao diện và chỗ cấu hình đã có, nhưng phần gọi thật tới nhà cung cấp đó chưa viết - hiện chạy bản mặc định mô phỏng.

Nguyên tắc suy biến an toàn. Kết nối nào chưa cấu hình thì hệ thống báo rõ là chưa chạy và chạy bản mô phỏng. Không có màn hình nào hiện thành công giả. Bạn sẽ không rơi vào cảnh tưởng đã phát hành hóa đơn mà thực ra chưa.

Cắm khóa là chạy

Mã gọi thật đã có, chờ khóa và đối chiếu

Những kết nối này đã viết mã gọi API thật và kiểm thử logic ngoại tuyến. Nhập khóa của nhà cung cấp là chạy; phần còn lại là đối chiếu sandbox, và với vài cái là thủ tục đăng ký.

Hóa đơn điện tử qua ViettelPhát hành và hủy hóa đơn khởi tạo từ máy tính tiền theo Nghị định 70/2025 và Thông tư 32/2025. Mã gọi thật đã có cho Viettel; các tổ chức khác như VNPT, MISA, EasyInvoice mới ở mức khung sẵn. Cần chứng thư số và tài khoản với tổ chức truyền nhận để phát hành thật.
Cổng thanh toán VNPay, PayOS, MoMoDựng liên kết hoặc mã QR có ký chữ ký, và xác thực thông báo trả tiền báo về từ cổng. Nhập mã đối tác và khóa bí mật ở cấu hình là chuyển từ mã QR chuyển khoản sang gọi cổng thật. Logic ký và đọc thông báo đã kiểm thử ngoại tuyến.
Bán hàng đa sàn thương mại điện tửỦy quyền và kéo đơn thật từ TikTok Shop, Shopee, Lazada về để ghi sổ, đồng bộ tồn và giá, và tính khấu trừ theo Nghị định 117/2025. Xem bán hàng tại quầy và bộ hướng dẫn để biết cách nối.
Gửi tin qua tin nhắn và ZaloGửi phiếu, hóa đơn, nhắc công nợ và tin khuyến mãi qua đầu số tin nhắn hoặc tài khoản chính thức trên Zalo. Nhập khóa và mã mẫu ở cấu hình là gửi thật. Tin khuyến mãi vẫn bắt buộc có sự đồng ý của khách.
Xác minh định danh và mã số thuếGọi thật dịch vụ định danh điện tử đã cấu hình để xác thực chủ hộ và kế toán, và tra cứu mã số thuế. Chưa cấu hình thì dùng bản kiểm định dạng nội bộ. Riêng định danh chính thức qua VNeID cần pháp nhân đăng ký hệ thống với Bộ Công an.
Chữ ký sốKý qua dịch vụ ký từ xa hoặc thiết bị ký cắm trực tiếp. Mã gọi đã có; khuôn chữ ký đầy đủ cho hóa đơn cần đối chiếu với môi trường thử của nhà cung cấp chữ ký số.

Khung sẵn, chưa gọi thật

Đã có chỗ cắm, phần gọi thật viết sau

Nộp tờ khai điện tửSố liệu từ sổ tổng hợp thành tờ khai và kết xuất tệp XML để nộp. Kết xuất đã chạy nhưng đang theo mẫu cũ, cần cập nhật sang mẫu Nghị định 68/2026. Phần nộp thẳng lên hệ thống thuế điện tử cần chữ ký số và thủ tục của bên nộp.
Các tổ chức truyền nhận hóa đơn khácVNPT, MISA, EasyInvoice đã có chỗ trong cấu hình nhưng phần gọi thật chưa viết. Chọn Viettel nếu cần phát hành ngay.
Thiết bị ký bằng phần cứng chuyên dụngKý qua thiết bị bảo mật đặt tại chỗ. Khung đã có, phần tích hợp thật viết khi có nhu cầu.

Theo kế hoạch

Chưa có, và nói rõ là chưa

Thanh toán giữ hộ trên sàn B2BCổng giữ tiền, tự trích phần thuế khấu trừ tại nguồn theo Nghị định 117/2025 rồi mới quyết toán phần còn lại cho người bán. Chưa có kết nối. Hiện phần khấu trừ được ghi nhận và báo cáo trong hệ thống, còn dòng tiền đi ngoài phần mềm.
Đơn vị vận chuyểnGiao vận và đối soát cho đơn trên sàn B2B. Theo kế hoạch, chưa có kết nối.

Ràng buộc nằm ngoài phần mềm. Vài thứ không phụ thuộc việc viết mã: định danh chính thức qua VNeID cần đăng ký với Bộ Công an; mỗi cổng thanh toán và tổ chức truyền nhận cần một lần đối chiếu với môi trường thử của họ để chốt; cổng tra cứu thuế công khai có mã xác nhận.

Cách các kết nối được dựng

Bốn nguyên tắc chung

Không làm treo nghiệp vụ. Mọi lượt gọi ra ngoài chạy song song với công việc chính, có giới hạn thời gian chờ và tự thử lại. Tổ chức truyền nhận hỏng thì đơn vẫn hoàn tất và sổ vẫn ghi; hóa đơn chuyển sang trạng thái chờ.
Đổi nhà cung cấp không sửa phần mềm. Địa chỉ dịch vụ, nhà cung cấp và thông tin đăng nhập đều là cấu hình. Thêm hoặc đổi một bên là cắm thêm một mô-đun, phần lõi giữ nguyên.
Thông tin kết nối được mã hóa. Mật khẩu và khóa dịch vụ mã hóa khi lưu, giao diện chỉ hiện là đã có hay chưa. Mỗi kết nối có nút thử để kiểm tra trước khi dùng thật.
Số thuế không phó mặc bên ngoài. Dù nối với dịch vụ nào, con số thuế vẫn do bộ máy thuế của hệ thống tính từ cấu hình pháp lý. Bên ngoài chỉ nhận và trả kết quả xử lý.

Nói lại cho gọn. Phần chạy trong nội bộ - bán hàng, kho, khách hàng, mua hàng, sổ sách theo Thông tư 152/2025, tính thuế, lập tờ khai, báo cáo, sàn B2B - dùng được ngay. Phần đi ra ngoài phần lớn đã có mã gọi thật, chờ bạn nhập khóa và đối chiếu với nhà cung cấp; một số ít còn là khung hoặc theo kế hoạch. Trang này nói rõ từng cái đang ở mức nào.