Xuất hoá đơn điện tử qua API

Hạ Tầng xuất hoá đơn điện tử theo mã số thuế của bạn, qua chính tài khoản của bạn ở nhà cung cấp hoá đơn (xem hướng dẫn đầy đủ để biết các nhà cung cấp được hỗ trợ). Kết nối tài khoản một lần ở Cài đặt thanh toán → Nhà cung cấp hoá đơn, rồi thêm khối invoice vào thanh toán để hoá đơn được xuất khi đơn hàng đã trả tiền, hoặc tạo hoá đơn riêng.

Kèm thanh toán (xuất khi đã thanh toán)

import { Hatang } from "@hatang/sdk";

const hatang = new Hatang(); // HATANG_API_KEY có payments:write

const { data: payment, error } = await hatang.payments.createOrder({
  order_id: "SO-1002",
  amount: 275_000,
  ipn_url: "https://shop.example.com/api/hatang/ipn",
  invoice: {
    mode: "publish",
    buyer: { name: "Nguyen Van Khach", tax_code: "0109876543", email: "[email protected]" },
    items: [{ name: "Gói dịch vụ tháng 9", quantity: 1, unit_price: 250_000, vat_rate: 10 }],
  },
});

IPN và payments.get cho biết trạng thái và số hoá đơn (payment.invoice).

Xuất riêng, ví dụ cho một khoản chuyển khoản không gắn với đơn hàng

const { data: invoice, error } = await hatang.einvoices.create({
  mode: "publish",
  transaction_id: "txn_123",
  buyer: { name: "Nguyen Van Khach" },
  items: [{ name: "Cà phê hạt 1 kg", quantity: 1, unit_price: 91_667, vat_rate: 8 }],
});

Ở development, kết nối tài khoản demo của nhà cung cấp: hoá đơn là hoá đơn sandbox thật nhưng không bao giờ gửi tới cơ quan thuế.

Tìm hiểu thêm

• Kết nối nhà cung cấp, vòng đời hoá đơn, bản nháp, lỗi và thay thế: Hoá đơn điện tử
• Thanh toán mà hoá đơn đi kèm: Nhận thanh toán VietQR