Lấy thông tin danh sách ký hiệu - mẫu số
hóa đơn/vé điện tử

Mô tả chi tiết

1. Request

1.1 Url API

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

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
ticket	không	false	true/false : đánh dấu có phải vé điện tử hay không
year	không	Datetime.Now.Year	truyền lên năm muốn lấy ký hiệu HĐ/Vé

2 Response

{
    "Success": true,
    "ErrorCode": null,
    "Errors": [],
    "Data": "list đối tượng InvoiceTemplateData",
    "CustomData": null
}

3 Mô tả đối tượng InvoiceTemplateData

/// <summary>
/// thông tin mẫu hóa đơn
/// </summary>
public class InvoiceTemplateData
{
    /// <summary>
    /// id mẫu hóa đơn
    /// </summary>
    public string IPTemplateID { get; set; }
    /// <summary>
    /// tên mẫu hóa đơn
    /// </summary>
    public string TemplateName { get; set; }
    /// <summary>
    /// ký hiệu mẫu hóa đơn
    /// </summary>
    public string InvSeries { get; set; }
    /// <summary>
    /// trạng thái sử dụng
    /// </summary>
    public bool Inactive { get; set; }
    /// <summary>
    /// kiểu mẫu mới or cũ (false: mẫu mới, true: mẫu cũ)
    /// </summary>
    public bool? IsInheritFromOldTemplate { get; set; }
    /// <summary>
    /// có phải mẫu hóa đơn gửi bảng tổng hợp hay không
    /// </summary>
    public bool IsSendSummary { get; set; }
    /// <summary>
    /// có phải mẫu hđ xăng dầu hay không
    /// </summary>
    public bool? IsPetrol { get; set; }
    /// <summary>
    /// có phải mẫu hóa đơn nhiều thuế suất hay không
    /// </summary>
    public bool? IsMoreVATRate { get; set; }
}

4. Ví dụ:

4.1 Request

URL: https://testapi.meinvoice.vn/api/integration/invoice/templates
HEADERS:
    Content-Type: application-json
    Authorization: Bearer <token lấy ở api Lấy token Authorization>
PARAMS:
    invoiceWithCode:true
    ticket:false
    year:2024

4.2 Response

{
"success": true,
"errorCode": null,
"descriptionErrorCode": null,
"errors": [],
"data": "[{\"IPTemplateID\":\"e0653f41-77c8-4fdb-975b-8ae8939fbf70\",\"CompanyID\":110626,\"TemplateName\":\"Hóa đơn GTGT khởi tạo từ máy tính tiền một thuế MA\",\"InvTemplateNo\":\"1\",\"InvSeries\":\"1C24MMA\",\"OrgInvSeries\":\"1CMMA\",\"TemplateType\":1,\"InvoiceType\":10,\"BusinessAreas\":0,\"SortOrder\":0,\"SignedDate\":null,\"CreatedDate\":\"0001-01-01T00:00:00+07:06\",\"CreatedBy\":null,\"ModifiedDate\":\"0001-01-01T00:00:00+07:06\",\"ModifiedBy\":null,\"Inactive\":false,\"TemplateContent\":null,\"DefaultTemplateID\":\"3a5e2bde-1316-11ed-8e9b-005056beb3e2\",\"IsCustomTemplate\":false,\"IsInheritFromOldTemplate\":false,\"XsltVersion\":null,\"IsPublished\":true,\"IsPublishedPetrol\":false,\"IsSendSummary\":false,\"IsPetrol\":null,\"IsTemplatePetrol\":null,\"MappingConfigVat\":null,\"ExpireDateType\":null,\"IsMoreVATRate\":false}]",
"customData": ""
}

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

curl --location --request GET 'https://testapi.meinvoice.vn/api/integration/invoice/templates?invoiceWithCode=true&ticket=false&year=2024' \
--header 'Authorization: Bearer <token lấy ở api Lấy token Authorization>'