Xuất hóa đơn điện tử ngay trong phần mềm của bạn
Một endpoint API duy nhất cho trọn vòng đời hóa đơn: tạo nháp, duyệt, phát hành và lấy file PDF/XML. Không cần tự tích hợp từng nhà cung cấp hóa đơn, không cần đội vận hành mở thêm một hệ thống riêng để xuất hóa đơn thủ công.
Một endpoint, trọn vòng đời của một hóa đơn
Toàn bộ thao tác đi qua một địa chỉ API duy nhất — POST https://api.pay2s.vn/api/v1/einvoices — và phân biệt bằng trường action. Đội phát triển của bạn chỉ cần tích hợp một lần.
Kiểm tra kết nối
Xác minh kết nối tới nhà cung cấp hóa đơn điện tử đã đồng bộ mẫu số, ký hiệu trước khi vận hành.
Tạo hóa đơn nháp
Đẩy dữ liệu người mua và dòng hàng hóa lên hệ thống, sinh hóa đơn nháp đúng chuẩn của nhà cung cấp.
Gửi duyệt nháp
Chuyển nháp sang trạng thái chờ phát hành theo đúng quy trình kiểm soát nội bộ của doanh nghiệp.
Phát hành hóa đơn
Phát hành chính thức hóa đơn đã duyệt. Môi trường thật có thêm bước xác nhận an toàn trước khi phát hành.
Tra cứu & đồng bộ trạng thái
Hệ thống của bạn chủ động lấy trạng thái mới nhất của hóa đơn bất cứ lúc nào, không phụ thuộc thao tác tay.
Lấy file PDF / XML
Tải file hóa đơn hoàn chỉnh dạng base64 để lưu trữ, đính kèm email cho khách hoặc nạp vào phần mềm kế toán.
Tích hợp trong 3 bước
Luồng tích hợp được thiết kế để một lập trình viên có thể hoàn thành phần nối API trong thời gian ngắn, phần còn lại đại lý Hóa Đơn Tự Động đồng hành cùng bạn.
Kết nối nhà cung cấp hóa đơn
Liên kết tài khoản hóa đơn điện tử bạn đang dùng — FPT, Bkav, Mắt Bão, Viettel, MISA hoặc M-Invoice — vào Pay2S và đồng bộ mẫu hóa đơn một lần duy nhất.
Gọi API với khóa bảo mật riêng
Mỗi yêu cầu ký bằng bộ header X-Partner-Code, X-Access-Key, X-Timestamp và chữ ký X-Signature theo HMAC-SHA256 — dữ liệu hóa đơn được xác thực toàn vẹn trên đường truyền.
Phát hành và đồng bộ trạng thái
Tạo nháp, phát hành, lấy file ngay trong luồng nghiệp vụ của phần mềm. Nói thẳng để bạn chủ động thiết kế: API hiện chưa đẩy webhook trạng thái hóa đơn — hệ thống của bạn kiểm tra trạng thái qua detail / sync, đơn giản và dễ kiểm soát.
Chi tiết làm nên sự khác biệt khi vận hành thật
Những điểm nhỏ nhưng quyết định việc xuất hóa đơn tự động có chạy ổn định ở quy mô lớn hay không.
Chống xuất trùng bằng external_ref
Mỗi yêu cầu gắn một mã tham chiếu riêng từ hệ thống của bạn. Gửi lặp lại một yêu cầu không tạo ra hai hóa đơn — lỗi trùng hóa đơn được chặn ngay từ tầng API.
Tự điền thông tin người mua theo mã số thuế
Kết hợp API tra cứu mã số thuế: khách B2B chỉ cần cung cấp MST, hệ thống tự lấy tên đơn vị, địa chỉ và kiểm tra trạng thái hoạt động trước khi lập hóa đơn.
Tách bạch Sandbox và môi trường thật
Kiểm thử toàn bộ luồng trên môi trường sandbox với kết nối riêng. Phát hành thật chỉ chạy khi được cấp quyền và có xác nhận rõ ràng — không có chuyện hóa đơn test lẫn vào hóa đơn thật.
Không khóa theo nhà cung cấp hóa đơn
Phần mềm của bạn chỉ nói chuyện với Pay2S. Đổi nhà cung cấp hóa đơn điện tử sau này không bắt bạn viết lại tích hợp.
API này dành cho ai?
Phần mềm kế toán & POS
Nhúng khả năng phát hành hóa đơn điện tử vào sản phẩm của bạn mà không phải ký hợp đồng, tích hợp riêng với từng nhà cung cấp hóa đơn.
Chuỗi cửa hàng có hệ thống riêng
Hóa đơn phát hành tập trung từ hệ thống bán hàng sẵn có, đồng nhất mẫu số và dữ liệu trên toàn chuỗi.
Nền tảng SaaS bán cho nhiều khách
Một tích hợp dùng chung cho nhiều doanh nghiệp thuê bao — mỗi doanh nghiệp kết nối tài khoản hóa đơn của chính họ.
Đội ngũ phát triển & đối tác tích hợp
Tài liệu rõ ràng, một endpoint, chữ ký chuẩn HMAC-SHA256 và môi trường test riêng — tích hợp nhanh, dễ bàn giao.
Điều kiện sử dụng: gói Basic trở lên
API hóa đơn điện tử hoạt động trên các gói Pay2S trả phí (từ Basic 150.000đ/tháng) với tài khoản đã bật tính năng hóa đơn điện tử. Phí gói hóa đơn của nhà cung cấp hóa đơn tính riêng theo chính sách từng hãng — đại lý sẽ tư vấn trọn gói để bạn dự trù đúng chi phí. Xem chi tiết tại bảng giá Pay2S.
Câu hỏi thường gặp
API hóa đơn điện tử khác gì xuất hóa đơn tự động trên Pay2S?
Xuất hóa đơn tự động trên Pay2S chạy theo sự kiện tiền về: giao dịch được đối soát là hóa đơn phát hành. Còn API hóa đơn điện tử dành cho phần mềm của bạn chủ động ra lệnh — tạo nháp, phát hành, lấy file — tại đúng thời điểm nghiệp vụ bạn muốn, kể cả khi khoản thu không đi qua luồng đối soát.
Tôi có phải tự tích hợp với từng nhà cung cấp hóa đơn không?
Không. Bạn kết nối tài khoản của nhà cung cấp hóa đơn (FPT, Bkav, Mắt Bão, Viettel, MISA, M-Invoice...) vào Pay2S một lần; mọi thao tác sau đó đi qua một API thống nhất của Pay2S.
Làm sao lấy file hóa đơn về lưu trữ?
Dùng action files để nhận file PDF và XML dạng base64 của hóa đơn đã phát hành, sau đó lưu vào hệ thống của bạn hoặc gửi cho khách hàng.
Có kiểm thử được trước khi chạy thật không?
Có. API tách môi trường sandbox và production theo từng kết nối. Phát hành trên môi trường thật cần được Pay2S cấp quyền và yêu cầu phải kèm xác nhận phát hành rõ ràng, tránh phát hành nhầm trong quá trình test.
Làm sao tránh xuất trùng một hóa đơn hai lần?
Mỗi yêu cầu tạo hóa đơn mang mã tham chiếu external_ref do hệ thống của bạn sinh. Pay2S dùng mã này để nhận diện và chặn các yêu cầu trùng lặp.
Tìm hiểu thêm luồng tự động theo giao dịch tại trang xuất hóa đơn tự động và bài hướng dẫn API hóa đơn điện tử Pay2S.
Sẵn sàng nhúng xuất hóa đơn vào phần mềm của bạn?
Đăng ký Pay2S, kết nối nhà cung cấp hóa đơn và bắt đầu với môi trường sandbox ngay hôm nay. Cần người đồng hành cấu hình và kiểm thử, đại lý Hóa Đơn Tự Động hỗ trợ bạn từ bước đầu tiên.