Link xem hóa đơn

Lấy link xem hóa đơn điện tử đã phát hành, hoặc link PDF mới từ nhà cung cấp.

Dùng khi khách cần xem hoặc tải hóa đơn điện tử. Hóa đơn phải phát hành xong mới có link.

Endpoint: GET /invoices/{id}/link, phạm vi invoices.read.

Request

GET https://api-demo.nexerp.vn/api/open/v1/invoices/{id}/link?pdf=false

Trên môi trường thật, thay phần địa chỉ gốc bằng địa chỉ NexERP cấp. Header: X-Api-Key.

Tham số	Nằm ở	Kiểu	Mô tả
`id`	đường dẫn	chuỗi UUID	Bắt buộc. `id` của hóa đơn
`pdf`	query	boolean	Không bắt buộc, mặc định `false`. Gửi `true` để lấy link file PDF mới từ nhà cung cấp

curl -s "$BASE/invoices/0b3c5a2e-6f43-4f0e-9a52-6e2f6d6a7c11/link" -H "X-Api-Key: $KEY"
curl -s "$BASE/invoices/0b3c5a2e-6f43-4f0e-9a52-6e2f6d6a7c11/link?pdf=true" -H "X-Api-Key: $KEY"

{ "link": "https://tracuu.vidu.example/invoice/A1B2C3D4E5F6", "pdf": false, "source": "stored" }

Trường phản hồi

Trường	Kiểu	Ý nghĩa
`link`	chuỗi URL	Link xem hoặc tải hóa đơn
`pdf`	boolean	`true` khi link trỏ tới file PDF
`source`	chuỗi	`stored`: link đã lưu lúc phát hành. `provider`: link vừa hỏi nhà cung cấp

Hai cách lấy link

Không có pdf=true: trả link đã lưu lúc phát hành (source: "stored"), không gọi nhà cung cấp.
Có pdf=true, hoặc chưa có link lưu: NexERP hỏi nhà cung cấp link mới (source: "provider"). Link PDF hết hạn sau khoảng 1 giờ.

Mỗi hóa đơn chỉ được hỏi link mới tối đa một lần mỗi 60 giây.

Mã trả về khác

Trường hợp	Mã	Việc cần làm
Nhà cung cấp đang bận	429, kèm header `Retry-After`	Chờ đủ số giây rồi thử lại. Link cũ nếu có nằm trong `error.details.link`
Chưa phát hành xong	409 `einvoice.link_not_ready`	Chờ trạng thái `issued`
Nhà cung cấp lỗi hoặc không trả link	502 `einvoice.link_unavailable`	Thử lại sau

Lưu ý

Lưu view_url của hóa đơn để dùng lại.
Chỉ gọi /link?pdf=true khi khách thật sự cần file PDF.