Bỏ qua để đến nội dung chính

📦 API v1.2.2 – Hóa đơn đầu vào, thanh toán qua máy POS và biến động ghi nợ ACB

Phiên bản v1.2.2 bổ sung tài liệu cho 11 API mới thuộc 3 nhóm tính năng, đồng thời rà soát và chuẩn hóa lại toàn bộ tài liệu tham số, mã lỗi và code mẫu theo đúng hành vi thực tế của hệ thống.

🧾 Hóa đơn đầu vào​

Tự động lấy hóa đơn mua vào của doanh nghiệp từ Tổng cục Thuế (hỗ trợ nhà cung cấp XCyber). Xem Tổng quan hóa đơn đầu vào.

  • POST /v1/e-invoice/input/connect – Kết nối tài khoản Thuế
  • POST /v1/e-invoice/input/disconnect – Ngắt kết nối tài khoản Thuế
  • POST /v1/e-invoice/input/sync – Đồng bộ hóa đơn đầu vào
  • POST /v1/e-invoice/input/list – Danh sách hóa đơn đầu vào
  • POST /v1/e-invoice/input/detail – Chi tiết hóa đơn đầu vào
  • POST /v1/e-invoice/input/preview-base64 – Tải bản thể hiện PDF

🏪 Thanh toán qua máy POS​

Tạo đơn hàng và đẩy trực tiếp xuống máy POS Payoo để khách hàng thanh toán bằng thẻ hoặc QR. Xem Thanh toán qua máy POS.

  • POST /v1/create-pos-bill – Tạo đơn hàng POS
  • GET /v1/get-detail-pos-bill – Chi tiết đơn hàng POS
  • PUT /v1/update-pos-bill – Hủy đơn hàng POS

🏦 Biến động ghi nợ (ACB)​

Đăng ký nhận thông báo giao dịch tiền ra trên số tài khoản gốc ACB.

🛠️ Cải tiến tài liệu​

  • Code mẫu thống nhất 5 ngôn ngữ (cURL, NestJS, C#, Java, PHP) cho toàn bộ API, đã kiểm thử chữ ký. Code mẫu cố định múi giờ UTC+7 và không escape ký tự tiếng Việt khi tạo chữ ký, tránh lỗi 90, 91, 97.
  • Ghi nhớ ngôn ngữ lập trình đã chọn trên mọi trang.
  • Danh sách mã lỗi bổ sung nhóm Mã lỗi hệ thống và giới hạn tần suất gọi API; mỗi API có bảng mã lỗi riêng.
  • Chuẩn hóa tham số theo hệ thống thực tế, trong đó có các thay đổi cần lưu ý khi tích hợp:
    • Chi hộ VietinBank: dùng debitAccountNumber, records[].creditAccountNumber, records[].creditBankBin (thay cho sender* / receiver*).
    • Chi hộ BIDV: dùng creditBankBin, creditIssueDate, creditIssueAddress; phân trang tra cứu bằng skipCount / maxResultCount.
    • Direct Debit: tra cứu giao dịch bằng transactionId.
    • Cấu hình tài khoản DN: accountType nhận giá trị business-account / business-household-account.

✨ Trải nghiệm trang tài liệu​

  • 🌐 Đa ngôn ngữ (Tiếng Việt / English): tài liệu API và SDK có bản tiếng Anh tại developers.tingee.vn/en. Chuyển ngôn ngữ bằng nút VI | EN trên thanh điều hướng, giữ nguyên trang đang xem. Bản tiếng Anh áp dụng cho phiên bản tài liệu mới nhất; Sandbox hiện chỉ có tiếng Việt.
  • 🤖 Hỏi AI trên từng trang: thanh công cụ dưới tiêu đề mỗi trang gồm Hỏi AI (mở ChatGPT, Claude, Perplexity, Grok hoặc Cursor kèm sẵn nội dung trang), Sao chép Markdown để dán vào công cụ AI, và .md để xem bản Markdown của trang.
  • 🧰 Tài nguyên cho nhà phát triển theo ngôn ngữ: OpenAPI, Postman Collection, llms.txt / llms-full.txt có bản tiếng Việt (tại gốc) và bản tiếng Anh (tại /en/), ví dụ https://developers.tingee.vn/en/openapi.json. Xem Bộ công cụ cho nhà phát triển.
  • 🌙 Tối ưu Dark mode: khối code, Response mẫu, banner Sandbox, sơ đồ luồng và nhãn phiên bản hiển thị nền tối, dễ đọc hơn khi bật chế độ tối.
  • 📱 Menu điều hướng đồng bộ với sidebar: menu "Các chức năng chính" trên mobile và thanh điều hướng trên desktop hiển thị đầy đủ các mục của tài liệu (bổ sung Lưu ý quan trọng, Changelog...) và đúng theo phiên bản đang xem.
  • 🎨 Giao diện mới: header, sidebar và mục lục dạng thẻ bo góc, thẳng hàng trong cùng một khung. Mục lục bên phải tự đánh dấu mục đang đọc; trên màn hình vừa (1000–1200px), mục lục dính ngay dưới header và luôn hiện tên mục hiện tại. Thêm thẻ lối tắt tới Sandbox dưới mục lục.
  • 🧪 Sandbox gọn gàng hơn: thanh "Quay lại" và nội dung các trang Sandbox được căn thẳng hàng với header.