Lấy trạng thái hóa đơn/vé điển tử
sau khi phát hành

Mô tả chi tiết

1. Request

1.1 Url API

Method	URL API (BaseUrl lấy ở mô tả chung)
POST	<BaseUrl>/status

1.2 Header

Content-Type: application-json
Authorization: Bearer <token lấy ở api Lấy token Authorization>

1.3 Params

Tên	Bắt buộc	Mặc định	Diễn giải
invoiceWithCode	không	false	true/false : đánh dấu có phải HĐ/Vé thuộc loại có mã của CQT hay không
invoiceCalcu	không	false	true/false : đánh dấu có phải hóa đơn máy tính tiền hay không
inputType	không	1	loại thông tin đầu vào ở body(1:mã tra cứu,2:refID của HĐ/Vé)

1.4 Body

list string chứa mã tra cứu hoặc refid của hóa đơn(type đánh dấu ở params)

1.5 Response

{
    "success": true,
    "errorCode": null,
    "descriptionErrorCode": null,
    "errors": [],
    "data": "list đối tượng InvoiceStatus",
    "customData": ""
}

2 Mô tả đối tượng InvoiceStatus

/// <summary>
/// Trạng thái phát hành hóa đơn
/// </summary>
public class InvoiceStatus
{
/// <summary>
/// Mã tra cứu
/// </summary>
public string TransactionID { get; set; }
/// <summary>
/// Trạng thái phát hành
/// </summary>
public int PublishStatus { get; set; }
/// <summary>
/// Loại hóa đơn: 0 - Gốc; 1 - thay thế; 2 - điều chỉnh
/// </summary>
public int ReferenceType { get; set; }
/// <summary>
/// Mã cơ quan thuế cấp - đối với hóa đơn có mã
/// </summary>
public string InvoiceCode { get; set; }
/// <summary>
/// Trạng thái gửi hóa đơn sang Cơ quan thuế
///     - Không có mã: (0: chưa gửi CQT; 1: Đã gửi CQT; 2: CQT tiếp nhận; 3: CQT không tiếp nhận; 4: gửi lỗi)
///     - Có mã: (0: chờ cấp mã; 1: gửi lỗi; 2: đã cấp mã; 3: từ chối cấp mã)
/// </summary>
public int SendTaxStatus { get; set; }
/// <summary>
/// Trạng thái gửi hóa đơn cho khách hàng (0: Chưa gửi; 1: Đã gửi)
/// </summary>
public bool IsSentEmail { get; set; }
/// <summary>
/// Xóa hóa đơn
/// </summary>
public bool IsDelete { get; set; }
/// <summary>
/// Ngày xóa bỏ hóa đơn
/// </summary>
public DateTime? DeletedDate { get; set; }
/// <summary>
/// Lý do xóa hóa đơn
/// </summary>
public string DeletedReason { get; set; }
/// <summary>
/// Người mua đã nhận hóa đơn: 0: Chưa nhận được; 1: Đã nhận được
/// </summary>
public int ReceivedStatus { get; set; }
}

3. Ví dụ:

3.1 Request

URL: https://testapi.meinvoice.vn/api/integration/invoice/status
HEADERS:
    Content-Type: application-json
    Authorization: Bearer <token lấy ở api Lấy token Authorization>
PARAMS:
    invoiceWithCode:true
    invoiceCalcu:false
    inputType:1
BODY:
    ["M9CKT_180J"]

3.2 Response

{
"success": true,
"errorCode": null,
"descriptionErrorCode": null,
"errors": [],
"data": "[{\"TransactionID\":\"M9CKT_180J\",\"PublishStatus\":1,\"ReferenceType\":0,\"InvoiceCode\":\"21B02D9C84A1BC4019A8BFC1AB2F686709\",\"SendTaxStatus\":2,\"IsSentEmail\":false,\"IsDelete\":false,\"DeletedDate\":null,\"DeletedReason\":null,\"ReceivedStatus\":0}]",
"customData": ""
}

4 Tài liệu tham khảo (Curl Postman)

curl --location 'https://testapi.meinvoice.vn/api/integration/invoice/status?invoiceWithCode=true&invoiceCalcu=false&inputType=1' \
--header 'Authorization: Bearer <token lấy ở api Lấy token Authorization>' \
--header 'Content-Type: application/json' \
--header 'Cookie: TS01df89db=010fb97404d42f4857c5776f84b78c86176edea1141a8bb9f3e2aa76610444232e1a52c55fab18258c0f85d084650ac8b9b72e14ed' \
--data '["M9CKT_180J"]'