Tài liệu tham khảo IIAPI

Tài liệu tham khảo API đầy đủ cho tích hợp hóa đơn điện tử IIAPI.

URL Cơ sở

Production: https://api.your-domain.com/api/iiapi
Development: http://localhost:3000/api/iiapi

Điểm cuối Hóa đơn

Tạo Hóa đơn GTGT (VAT Invoice)

POST /vat-invoices
Content-Type: application/json

{
  "seller": {
    "taxCode": "0123456789",
    "name": "Công ty Của Bạn",
    "address": "123 Đường phố"
  },
  "buyer": {
    "taxCode": "9876543210",
    "name": "Công ty Khách hàng",
    "address": "456 Đại lộ"
  },
  "invoiceDate": "2024-01-15",
  "currencyCode": "VND",
  "items": [
    {
      "itemName": "Sản phẩm",
      "quantity": 10,
      "unitPrice": 100000,
      "amount": 1000000,
      "vatRate": 10,
      "vatAmount": 100000
    }
  ],
  "totalAmount": 1000000,
  "totalVatAmount": 100000,
  "totalPayment": 1100000
}

Tạo Hóa đơn POS

POST /pos-sale-invoices
Content-Type: application/json

{
  "invoiceDate": "2024-01-15",
  "items": [
    {
      "itemName": "Cà phê",
      "quantity": 2,
      "unitPrice": 50000,
      "amount": 100000
    }
  ],
  "totalAmount": 100000,
  "totalPayment": 100000,
  "paymentMethod": "CASH"
}

Quản lý Hóa đơn

Gửi Hóa đơn

POST /invoices/:id/submit
Content-Type: application/json

{
  "clientName": "default"
}

Hủy Hóa đơn

POST /invoices/:id/cancel
Content-Type: application/json

{
  "reason": "Yêu cầu của khách hàng"
}

Lấy thông tin Hóa đơn

GET /invoices/:id

Liệt kê Hóa đơn

GET /invoices?status=ACCEPTED&dateFrom=2024-01-01&dateTo=2024-01-31

Trạng thái Hóa đơn

Trạng thái	Mô tả
DRAFT	Đã tạo, chưa gửi
PENDING	Đã gửi đến T-VAN
SIGNED	Đã ký số
SENT	Đã gửi đến CQT
ACCEPTED	CQT chấp nhận
REJECTED	CQT từ chối
CANCELLED	Đã hủy

Mã lỗi

Mã	Mô tả
IIAPI_001	Mã số thuế không hợp lệ
IIAPI_002	Thiếu trường bắt buộc
IIAPI_003	Kết nối T-VAN thất bại
IIAPI_004	Hóa đơn đã được gửi
IIAPI_005	CQT từ chối

Liên quan

• Các loại Hóa đơn
• Webhooks
• Tuân thủ