Lấy thông tin mẫu số hóa đơn

Phương thức này dùng để lấy các mẫu hóa đơn đã lập tờ khai.

Doanh nghiệp có mã của cơ qua thuế và không có mã của cơ quan thuế URL gọi api sẽ khác nhau.

ví dụ: 1K21TYY (ký hiệu năm 2021) :

• 1 là loại hóa đơn (1:HD GTGT,2:HD Bán Hàng,6; PXK Vận chuyển nội bộ)
• K là ký hiệu loại hóa đơn: (K:DN không mã CQT,C:DN có mã CQT)
• 21 là 2 số cuối của năm trên ngày hóa đơn(21:2021,22:2022)
• T ký hiệu quy địn của CQT
• YY là 2 ký hiệu tùy chọn của doanh nghiệp, các chữ cái trong bảng chữ cái.
• ký hiệu sẽ đổi của năm 2022 là :1K22TYY

1. Request

Kiểu doanh nghiệp	Method	<BaseURL&gt
Không mã	GET	<BaseURL>/itg/InvoicePublishing/templates
Có mã	GET	<BaseURL>/code/itg/InvoicePublishing/templates

1.1 Header

Content-Type: application-json
Authorization: Bearer <token>
CompanyTaxCode: "Mã số thuế đăng nhập"

1.2 URI Parameter

Name	Diễn giải
invyear	năm cần lấy mẫu hóa đơn

1.3 Response

Kết quả trả về Json dạng:

{
    "Success": <false/true>,
    "Data": "<Dữ liệu trả về>",
    "ErrorCode": "<Trống hoặc Mã lỗi>",
    "Errors": "",
    "CustomData":""
}

2. Ví dụ:

2.1 Request

https://testapi.meinvoice.vn/integration/invoice/templates?invoiceWithCode=true&ticket=false&year=2024

2.2 Response

{
    "Success": true,
    "ErrorCode": null,
    "Errors": [],
    "Data": "[{\"IPTemplateID\":\"05b1df98-9d1a-4812-bbb6-d03b3a8dc22c\",\"CompanyID\":15388,\"TemplateName\":\"Hóa đơn GTGT 123\",\"InvTemplateNo\":\"1\",\"InvSeries\":\"1K21TYY\",\"OrgInvSeries\":\"1KTYY\",\"TemplateType\":0,\"InvoiceType\":1,\"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\":\"4f021e07-3e54-4e96-90f2-07606c9b6469\",\"IsCustomTemplate\":false}]",
    "CustomData": null
}

3. Mô tả đối tượng trả về trong Data Response trả về:

/// <summary>
/// Mẫu hóa đơn
/// </summary>
public class TemplateData
{
    /// <summary>
    /// ID mẫu
    /// </summary>
    public Guid IPTemplateID { get; set; }
    /// <summary>
    /// ID công ty
    /// </summary>
    public int CompanyID { get; set; }
    /// <summary>
    /// Tên mẫu
    /// </summary>
    public string TemplateName { get; set; }
    /// <summary>
    /// Mẫu số
    /// </summary>
    public string InvTemplateNo { get; set; }
    /// <summary>
    /// Ký hiệu
    /// </summary>
    public string InvSeries { get; set; }

    /// <summary>
    /// Ký hiệu
    /// </summary>
    public string OrgInvSeries { get; set; }
    /// <summary>
    /// Loại mẫu (stimul, xslt,...)
    /// </summary>
    public int TemplateType { get; set; }
    /// <summary>
    /// Loại hóa đơn (GTGT, bán hàng, xuất kho,...)
    /// </summary>
    public int InvoiceType { get; set; }
    /// <summary>
    /// Nghiệp vụ
    /// </summary>
    public int BusinessAreas { get; set; }
    /// <summary>
    /// Thứ tự
    /// </summary>
    public int SortOrder { get; set; }
    /// <summary>
    /// Ngày ký
    /// </summary>
    public DateTime? SignedDate { get; set; }
    /// <summary>
    /// Ngày tạo
    /// </summary>
    public DateTime CreatedDate { get; set; }
    /// <summary>
    /// Người tạo
    /// </summary>
    public string CreatedBy { get; set; }
    /// <summary>
    /// Ngày sửa
    /// </summary>
    public DateTime ModifiedDate { get; set; }
    /// <summary>
    /// Người sửa
    /// </summary>
    public string ModifiedBy { get; set; }
    /// <summary>
    /// Ngừng hoạt động
    /// </summary>
    /// <returns></returns>
    public bool Inactive { get; set; }
    /// <summary>
    /// Nội dung file mẫu
    /// </summary>
    public byte[] TemplateContent { get; set; }
    /// <summary>
    /// ID mẫu mặc định
    /// </summary>
    public Guid DefaultTemplateID { get; set; }
    /// <summary>
    /// Có phải mẫu custom không
    /// </summary>
    public bool IsCustomTemplate { get; set; }
    /// <summary>
    /// kế thừa từ mẫu cũ hay không
    /// </summary>
    public bool IsInheritFromOldTemplate { get; set; }

    /// <summary>
    /// Phiên bản mẫu xslt
    /// </summary>
    public int? XsltVersion { get; set; }
    /// <summary>
    /// Đã phát hành hđ hay chưa
    /// </summary>
    public bool IsPublished { get; set; }
}