Phát hành hóa đơn/vé điện tử lên hệ thống MISA
Mô tả chi tiết
1. Request
1.1 Url API
Method | URL API (BaseUrl lấy ở mô tả chung) |
---|---|
POST | <BaseUrl>(https://testapi.meinvoice.vn/api/integration/invoice) |
1.2 Header
Content-Type: application-json
Authorization: Bearer <token lấy ở api Lấy token Authorization>
1.3 Body
đôi tượng InvoiceParameter
{
"SignType": <loại ký số>,
"InvoiceData": <list đối tượng InvoiceData>,
"PublishInvoiceData": <list đối tượng PublishInvoiceData>
}
1.4 Response
{
"success": true/false <Trạng thái khi call API trả về>,
"errorCode": "<Mã lỗi nếu có>",
"descriptionErrorCode": "<mô tả mã lỗi nếu có>",
"createInvoiceResult": "<List thông tin createInvoiceResult>",
"publishInvoiceResult": "<List thông tin publishInvoiceResult>"
}
2 Mô tả đối tượng InvoiceParameter trong request
/// <summary>
/// đối tượng parameter của API phát hành HĐ/vé
/// </summary>
public class InvoiceParameter
{
/// <summary>
/// Kiểu ký số khi phát hành
///1:Ký số bằng USB hoặc tệp tin, 2:Ký số bằng HSM, 3:Ký số bằng HSM bất đồng bộ,
///4:Không Ký số, vé điên tử không mã, 5:Không Ký số, hóa đơn máy tính tiền
/// </summary>
public int SignType { get; set; }
/// <summary>
/// list đối tượng InvoiceData là json thông tin của HĐ/Vé
/// </summary>
public List<InvoiceData> InvoiceData { get; set; }
/// <summary>
/// list đối tượng PublishInvoiceData là json thông tin phát hành HĐ/Vé sau khi đc ký số
/// </summary>
public List<PublishInvoiceData> PublishInvoiceData { get; set; }
}
2.1 Mô tả đối tượng InvoiceData
Xem chi tiết tại đây: InvoiceData
2.2 Mô tả đối tượng PublishInvoiceData
Xem chi tiết tại đây: PublishInvoiceData
3 Mô tả đối tượng trong response
3.1 Mô tả đối tượng createInvoiceResult
Xem chi tiết tại đây: CreateInvoiceResult
3.2 Mô tả đối tượng publishInvoiceResult
Xem chi tiết tại đây: publishInvoiceResult
4 Mô tả và ví dụ cho các loại hóa đơn/vé cụ thể
4.1 Phát hành hóa đơn/vé ký bằng USB/File mềm (SignType=1)
Xem chi tiết tại đây.
4.2 Phát hành hóa đơn/vé ký bằng HSM (SignType=2)
Xem chi tiết tại đây.
4.2 Phát hành hóa đơn/vé bất đồng bộ ký bằng HSM (SignType=3)
Xem chi tiết tại đây.
4.2 Phát hành vé không mã, không ký số (SignType=4)
Xem chi tiết tại đây.
4.2 Phát hành hóa đơn máy tính tiền, không ký số (SignType=5)
Xem chi tiết tại đây.