Tài liệu tham khảo API T-VAN

Tài liệu tham khảo API đầy đủ cho tích hợp T-VAN.

URL Cơ sở

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

Điểm cuối Thông tin Thuế

Lấy Thông tin Thuế

GET /tax-info/:taxCode

Phản hồi:
{
  "taxCode": "0123456789",
  "companyName": "CÔNG TY TNHH ABC",
  "address": "123 Nguyễn Huệ, Quận 1",
  "representative": "Nguyễn Văn A",
  "status": "ACTIVE",
  "registrationDate": "2020-01-15"
}

Tra cứu Hàng loạt

POST /tax-info/batch
Content-Type: application/json

{
  "taxCodes": ["0123456789", "9876543210"]
}

Phản hồi:
{
  "results": [
    { "taxCode": "0123456789", "found": true, "status": "ACTIVE", ... },
    { "taxCode": "9876543210", "found": false }
  ]
}

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

Xác thực Hóa đơn

POST /invoice/validate
Content-Type: application/json

{
  "invoiceNumber": "AA/24E0001234",
  "sellerTaxCode": "0123456789",
  "invoiceDate": "2024-01-15"
}

Phản hồi:
{
  "isValid": true,
  "status": "VALID",
  "invoiceNumber": "AA/24E0001234",
  "totalAmount": 1100000
}

Phản hồi Lỗi

{
  "error": {
    "code": "TVAN_002",
    "message": "Không tìm thấy mã số thuế"
  }
}

Mã lỗi

Mã	Mô tả
TVAN_001	Định dạng mã số thuế không hợp lệ
TVAN_002	Không tìm thấy mã số thuế
TVAN_003	Kết nối quá hạn
TVAN_004	Lỗi nhà cung cấp
TVAN_005	Vượt quá giới hạn tốc độ

Sử dụng Đa Client

Chỉ định client trong header yêu cầu:

GET /tax-info/0123456789
X-TVAN-Client: backup

Hoặc trong tham số truy vấn:

GET /tax-info/0123456789?client=backup

Liên quan

• Tra cứu Thuế
• Xác thực Hóa đơn
• Tuân thủ