Tạo, ký và phát hành vé điện tử

Phương thức này cho phép các ứng dụng gửi lên dữ liệu vé điện tử dạng thô (chưa đúng định dạng của HĐĐT) và trả về cho ứng dụng dữ liệu ở định dạng vé điện tử. Trước khi thực hiện phát hành hóa đơn, các ứng dụng sẽ gọi đến phương thức này để tạo dữ liệu hóa đơn có định dạng điện tử. Sau đó thực hiện ký nội dung vé điện tử. Và cuối cùng là thực hiện phát hành vé điện tử.

Mô tả:
- Từ máy client của kế toán thực hiện gửi yêu cầu xuất vé điện tử
- Dữ liệu vé điện tử thô được gửi lên MISA qua API
- Server Misa cấp số hóa đơn và trả về cho Client vé điện tử có định dạng XML theo chuẩn của Cơ quan Thuế
- Từ client gọi service ký vé điện tử định dạng XML vừa nhận được
- Sau khi ký điện tử xong gọi lên MISA để phát hành
- MISA ghi nhận yêu cầu phát hành vé điện tử và trả về trạng thái cho client
- MISA thực hiện cất vé điện tử vừa nhận và xử lý các yêu cầu nghiệp vụ tương ứng

1. Tạo vé điện tử

Chú ý: Hàm API này chỉ là tạo dữ liệu vé điện tử thô (raw) ở dưới client. Để phát hành thành công 1 vé điện tử lên MISA thì phải làm đủ 3 bước: 1. Tạo vé điện tử, 2. Ký điện tử và 3. Phát hành vé điện tử

Kiểu doanh nghiệp	Method	<BaseURL&gt
Không mã	POST	<BaseURL>/itg/invoicepublishing/createinvoice
Có mã	POST	<BaseURL>/code/itg/invoicepublishing/createinvoice

1.1 Header

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

1.2 request

[
    {
        <đối tượng OriginalInvoiceData>
    }
]

Lưu ý: đối với Vé điện tử thì trong OrgInvoiceData cần đánh dấu "IsTicket": true

1.3 Respone

{
    "Success": true,
    "ErrorCode": null,
    "Errors": [],{mã lỗi nếu có}
    "Data": "[{
    \"RefID\":\"ID hóa đơn\",
    \"TransactionID\":\"Mã tra cứu\",
    \"InvNo\":\"Số hóa đơn\",
    \"InvCode\":null,
    \"InvDate\":\"Ngày hóa đơn\",
    \"InvoiceData\":"",
    \"ErrorCode\":null,{mã lỗi nếu có}
    \"ErrorData\":null,{mã lỗi nếu có}
    \"TokenCallback\":null,
    \"CallbackUrl\":null
    }]",
    "CustomData": null
}

Vé thay thế / điều chỉnh

Đối với vé thay thế điều chỉnh phần thông tin master (OriginalInvoiceData) truyền thêm các field sau để đánh dấu vé gôc

    // nếu là vé thay thế hoặc điều chỉnh thì bổ sung đoạn sau
    "ReferenceType": null,//Tính chất vé (1: thay thế; 2: điều chỉnh)
    "OrgInvoiceType": null,//Loại vé bị thay thế/điều chỉnh  (1: vé 123; 3: vé 51)
    "OrgInvTemplateNo": null,//Ký hiệu mẫu vé bị thay thế/điều chỉnh (ví dụ: 5)
    "OrgInvSeries": null,//Ký hiệu vé bị thay thế/điều chỉnh (ví dụ: K21TAA)
    "OrgInvNo": null,//Số vé bị thay thế/điều chỉnh (ví dụ: 00000001)
    "OrgInvDate": null,//Ngày vé bị thay thế/điều chỉnh   (ví dụ: 2022-01-01)

1.4 Ví dụ:

1.4.1 request

https://testapi.meinvoice.vn/api/v3/itg/invoicepublishing/createinvoice

[
    {
        "RefID": "452b2976-51e3-495e-bf88-833b23d9e8df",

        "InvSeries": "5K22GYY",
        "InvoiceName": "Vé điện tử",
        "InvDate": "2022-04-22T00:00:00+07:00",
        "CurrencyCode": "VND",
        "ExchangeRate": 1.0,
        "PaymentMethodName": "TM/CK",
        "IsTicket": true,

        "Route":"HN-SG",
        "From":"BX HN",
        "Destination":"BX MD",
        "Seat":"Ghế B01",
        "VehicleNo":"BSX:29A-8888",
        "DepatureDate":"2022-04-22T00:00:00",
        "DepatureTime":"07:00",
        "CustomField1":"loại xe",
        "CustomField2":"số tài",
        "TotalSaleAmount":  454545.454545,
        "TotalSaleAmountOC":  454545.454545,

        "TotalDiscountAmount": 0,
        "TotalDiscountAmountOC": 0,

        "TotalAmountWithoutVATOC":  454545.454545,
        "TotalAmountWithoutVAT":  454545.454545,

        "TotalVATAmountOC":  45454.54545454547,
        "TotalVATAmount":  45454.54545454547,

        "TotalAmountOC":500000.0,
        "TotalAmount": 500000.0,

        "TotalAmountInWords": "Một triệu năm trăm hai mươi hai nghìn ba trăm hai mươi ba phẩy mười hai đồng.",

        "OriginalInvoiceDetail": [
            {
                "ItemType": 1,
                "LineNumber": 1,
                "SortOrder": 1,                
                "Quantity": 1.0,
                "ItemName":"vé xe bắc nam",
                "UnitPrice": 454545.454545,
                "AmountWithoutVATOC":454545.454545,
                "AmountOC":500000.0,
                "Amount": 500000.0,
                "VATRateName": "10%",
                "VATAmountOC": 45454.54545454547,
                "VATAmount": 45454.54545454547
            }
        ],
        "TaxRateInfo": [
            {
                "VATRateName": "10%",
                "AmountWithoutVATOC": 454545.454545,
                "VATAmountOC":45454.54545454547
            }
        ]
    }
]

1.4.2 Respone

    {
    "Success": true,
    "ErrorCode": null,
    "Errors": [],
    "Data": "[{\"RefID\":\"19d02e93-cb8b-4a60-8b06-4a7387cd44cc\",\"TransactionID\":\"QWIGTN63E_\",\"InvNo\":\"00000321\",\"InvCode\":null,\"InvDate\":\"2022-09-22T00:00:00+07:00\",\"InvoiceData\":\"<?xml version=\\\"1.0\\\" encoding=\\\"utf-8\\\"?><HDon><DLHDon Id=\\\"QWIGTN63E_\\\"><TTChung><PBan>2.0.0</PBan><THDon>Hóa đơn giá trị gia tăng</THDon><KHMSHDon>1</KHMSHDon><KHHDon>C22TTT</KHHDon><SHDon>00000321</SHDon><NLap>2022-09-22</NLap><DVTTe>VND</DVTTe><TGia>1.00</TGia><HTTToan>TM/CK</HTTToan><MSTTCGP>0101243150</MSTTCGP></TTChung><NDHDon><NBan><Ten>MISA TEST</Ten><MST>2222222222-444</MST><DChi>HN</DChi><SDThoai>0971500731</SDThoai><DCTDTu>testmisa@yahoo.com</DCTDTu><STKNHang>342353535</STKNHang><TNHang>Viettinbank</TNHang><Fax>2344</Fax><Website>meinvvoice.vn</Website><TTKhac><TTin><TTruong>SellerBankAccount</TTruong><KDLieu>string</KDLieu><DLieu>342353535</DLieu></TTin><TTin><TTruong>SellerBankName</TTruong><KDLieu>string</KDLieu><DLieu>Viettinbank</DLieu></TTin><TTin><TTruong>SellerEmail</TTruong><KDLieu>string</KDLieu><DLieu>testmisa@yahoo.com</DLieu></TTin><TTin><TTruong>SellerFax</TTruong><KDLieu>string</KDLieu><DLieu>2344</DLieu></TTin><TTin><TTruong>SellerPhoneNumber</TTruong><KDLieu>string</KDLieu><DLieu>0971500731</DLieu></TTin><TTin><TTruong>SellerWebsite</TTruong><KDLieu>string</KDLieu><DLieu>meinvvoice.vn</DLieu></TTin><TTin><TTruong>SellerAddress</TTruong><KDLieu>string</KDLieu><DLieu>HN</DLieu></TTin></TTKhac></NBan><NMua><Ten>CÔNG TY CỔ PHẦN MISA</Ten><MST>0101243150</MST><DChi>Tầng 9, tòa nhà Technosoft, phố Duy Tân, Phường Dịch Vọng Hậu, Quận Cầu Giấy, Thành phố Hà Nội, Việt Nam</DChi></NMua><DSHHDVu><HHDVu><TChat>1</TChat><STT>1</STT><THHDVu>HH01</THHDVu><DVTinh>cais</DVTinh><SLuong>1.000000</SLuong><DGia>100000.000000</DGia><TLCKhau>0.0000</TLCKhau><STCKhau>0.000000</STCKhau><ThTien>100000.000000</ThTien><TSuat>10%</TSuat><TTKhac><TTin><TTruong>AmountOC</TTruong><KDLieu>numeric</KDLieu><DLieu>100000.0</DLieu></TTin><TTin><TTruong>Amount</TTruong><KDLieu>numeric</KDLieu><DLieu>100000.0</DLieu></TTin><TTin><TTruong>AmountAfterTax</TTruong><KDLieu>numeric</KDLieu><DLieu>0.0</DLieu></TTin><TTin><TTruong>DiscountAmount</TTruong><KDLieu>numeric</KDLieu><DLieu>0.0</DLieu></TTin><TTin><TTruong>UnitPriceAfterTax</TTruong><KDLieu>numeric</KDLieu><DLieu>0.0</DLieu></TTin><TTin><TTruong>VATAmount</TTruong><KDLieu>numeric</KDLieu><DLieu>10000.0</DLieu></TTin><TTin><TTruong>VATAmountOC</TTruong><KDLieu>numeric</KDLieu><DLieu>10000.0</DLieu></TTin><TTin><TTruong>SortOrder</TTruong><KDLieu>numeric</KDLieu><DLieu>1</DLieu></TTin></TTKhac></HHDVu></DSHHDVu><TToan><THTTLTSuat><LTSuat><TSuat>10%</TSuat><ThTien>100000.000000</ThTien><TThue>10000.000000</TThue></LTSuat></THTTLTSuat><TgTCThue>100000.000000</TgTCThue><TgTThue>10000.000000</TgTThue><TTCKTMai>0.000000</TTCKTMai><TgTTTBSo>110000.000000</TgTTTBSo><TgTTTBChu>Một trăm mười nghìn đồng chẵn.</TgTTTBChu><TTKhac><TTin><TTruong>TotalAmount</TTruong><KDLieu>numeric</KDLieu><DLieu>110000.0</DLieu></TTin><TTin><TTruong>TotalAmountInWordsUnsignNormalVN</TTruong><KDLieu>string</KDLieu><DLieu>Mot tram muoi nghin dong chan.</DLieu></TTin><TTin><TTruong>TotalAmountInWordsVN</TTruong><KDLieu>string</KDLieu><DLieu>Một trăm mười nghìn đồng chẵn.</DLieu></TTin><TTin><TTruong>TotalDiscountAmount</TTruong><KDLieu>numeric</KDLieu><DLieu>0.0</DLieu></TTin><TTin><TTruong>TotalSaleAmount</TTruong><KDLieu>numeric</KDLieu><DLieu>100000.0</DLieu></TTin><TTin><TTruong>TotalVATAmount</TTruong><KDLieu>numeric</KDLieu><DLieu>10000.0</DLieu></TTin><TTin><TTruong>TotalSaleAmountOC</TTruong><KDLieu>numeric</KDLieu><DLieu>100000.0</DLieu></TTin><TTin><TTruong>TotalAmountInWordsByENG</TTruong><KDLieu>string</KDLieu><DLieu>One hundred ten thousand dongs.</DLieu></TTin><TTin><TTruong>TotalAmountWithoutVAT</TTruong><KDLieu>numeric</KDLieu><DLieu>100000.0</DLieu></TTin><TTin><TTruong>TotalAmountWithoutVATOC</TTruong><KDLieu>numeric</KDLieu><DLieu>100000.0</DLieu></TTin><TTin><TTruong>TotalDiscountAmountOC</TTruong><KDLieu>numeric</KDLieu><DLieu>0.0</DLieu></TTin></TTKhac></TToan></NDHDon><TTKhac><TTin><TTruong>InvoiceTemplateID</TTruong><KDLieu>string</KDLieu><DLieu>88f54d4c-08eb-4255-97ae-ec99b82e9de6</DLieu></TTin><TTin><TTruong>RefID</TTruong><KDLieu>string</KDLieu><DLieu>19d02e93-cb8b-4a60-8b06-4a7387cd44cc</DLieu></TTin><TTin><TTruong>IsTaxReduction</TTruong><KDLieu>numeric</KDLieu><DLieu>False</DLieu></TTin><TTin><TTruong>IsTaxReduction43</TTruong><KDLieu>numeric</KDLieu><DLieu>False</DLieu></TTin><TTin><TTruong>AmountDecimalDigits</TTruong><KDLieu>string</KDLieu><DLieu>0</DLieu></TTin><TTin><TTruong>AmountOCDecimalDigits</TTruong><KDLieu>string</KDLieu><DLieu>2</DLieu></TTin><TTin><TTruong>CoefficientDecimalDigits</TTruong><KDLieu>string</KDLieu><DLieu>2</DLieu></TTin><TTin><TTruong>ExchangRateDecimalDigits</TTruong><KDLieu>string</KDLieu><DLieu>2</DLieu></TTin><TTin><TTruong>MainCurrency</TTruong><KDLieu>string</KDLieu><DLieu>VND</DLieu></TTin><TTin><TTruong>QuantityDecimalDigits</TTruong><KDLieu>string</KDLieu><DLieu>2</DLieu></TTin><TTin><TTruong>UnitPriceDecimalDigits</TTruong><KDLieu>string</KDLieu><DLieu>0</DLieu></TTin><TTin><TTruong>UnitPriceOCDecimalDigits</TTruong><KDLieu>string</KDLieu><DLieu>0</DLieu></TTin><TTin><TTruong>AppID</TTruong><KDLieu>string</KDLieu><DLieu>AB0FDDF474E1423FA43D7475AF759166</DLieu></TTin><TTin><TTruong>TransactionID</TTruong><KDLieu>string</KDLieu><DLieu>QWIGTN63E_</DLieu></TTin></TTKhac></DLHDon><DLQRCode>00020199970032F772173E44D8423E884B2483477508FB01132222222222444020110306C22TTT040332105082022092206061100006304DB22</DLQRCode><DSCKS><NBan></NBan></DSCKS></HDon>\",\"ErrorCode\":null,\"ErrorData\":null,\"TokenCallback\":null,\"CallbackUrl\":null}]",
    "CustomData": null
}

2. Ký hóa đơn

Tải bộ cài tại địa chỉ :

https://product.misa.vn/misasoftware/eInvoice/Desktop123/R4/MISAmeInvoice123_Setup_SignedService_R4_CHINHTHUC.exe

Phương thức ký qua tool (Gọi Web API Service):

2.1 Request

Method	URL
POST	- BaseURL: http://{0}:{1}/api/SignXML Trong đó - {0} là tên máy chủ . - {1} là port ký của máy chủ. Misa đang để port mặc định ký nằm trong giải port(12019;12020;12021;12022;12023) VD : http://server01:12019/api/SignXML

2.2 Header parameter

tên	Kiểu dữ liệu	Bắt buộc	Mô tả
MisaTokenKey	String	Có	Token Key của Misa. Đang để mặc định là : 491CB943-E466-4D25-B0A9-7042594F59F2

2.3 URI parameter

tên	Kiểu dữ liệu	Bắt buộc	Mô tả
PinCode	string	Có	PinCode của USB Token
XmlContent	string	Có	XML hóa đơn điện tự dược tạo ở lúc tạo XML

2.4 Response

Trường hợp thành công, HttpStatusCode = 200 (OK) và dữ liệu trả về sẽ gồm các thông tin như sau:

tên	Kiểu dữ liệu	Bắt buộc	Mô tả
PayLoad	string	Có	Chuỗi xml invoice đã được ký số
Message	string	Có	thông báo mã lỗi nếu có
Status			200

2.5 Ví dụ

Request

 POST: http://server01:12019/api/SignXML

    {
"PinCode":"12345678",
"XmlContent":"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><inv:invoice xmlns:inv=\"http://laphoadon.gdt.gov.vn/2014/09/invoicexml/v1\" xmlns:ds=\"http://www.w3.org/2000/09/xmldsig#\"><inv:invoiceData id=\"data\"><inv:invoiceType>02GTTT</inv:invoiceType><inv:templateCode>02GTTT0/002</inv:templateCode><inv:invoiceSeries>AB/21E</inv:invoiceSeries><inv:invoiceNumber>0000015</inv:invoiceNumber><inv:invoiceIssuedDate>2021-10-30T00:00:00</inv:invoiceIssuedDate><inv:signedDate></inv:signedDate><inv:currencyCode>VND</inv:currencyCode><inv:invoiceNote>Hóa đơn bán lẻ</inv:invoiceNote><inv:adjustmentType>1</inv:adjustmentType><inv:payments><inv:payment><inv:paymentMethodName>Tiền mặt</inv:paymentMethodName></inv:payment></inv:payments><inv:delivery /><inv:sellerLegalName>CÔNG TY TNHH MTV DỊCH VỤ THỦY LỢI BÌNH PHƯỚC</inv:sellerLegalName><inv:sellerTaxCode>2222222222-736</inv:sellerTaxCode><inv:sellerAddressLine>Đường Lê Duẩn - Phường Tân Bình - Thành Phố Đồng Xoài - Bình Phước</inv:sellerAddressLine><inv:sellerPhoneNumber>012345678912345</inv:sellerPhoneNumber><inv:sellerFaxNumber>25251325</inv:sellerFaxNumber><inv:sellerEmail>ngominhdai92@gmail.com</inv:sellerEmail><inv:sellerWebsite>abc.com.vn</inv:sellerWebsite><inv:sellerBankAccount>11047007</inv:sellerBankAccount><inv:sellerBankName>ACB</inv:sellerBankName><inv:buyerLegalName>Công ty cổ phần MISA (Test)</inv:buyerLegalName><inv:buyerDisplayName>Nguyễn Xuân A</inv:buyerDisplayName><inv:buyerTaxCode>0101243150-888</inv:buyerTaxCode><inv:buyerAddressLine>Tầng 9, Tòa nhà Technosoft, Duy Tân, Dịch Vọng Hậu, Cầu Giấy, Hà Nội</inv:buyerAddressLine><inv:buyerEmail>support@misa.com.vn</inv:buyerEmail><inv:buyerBankName>Hội sở Ngân hàng TMCP Á Châu</inv:buyerBankName><inv:buyerBankAccount>21137519</inv:buyerBankAccount><inv:exchangeRate>1 </inv:exchangeRate><inv:items><inv:item><inv:lineNumber>1</inv:lineNumber><inv:itemCode>SME2019.Pro</inv:itemCode><inv:itemName>Phần mềm kế toán doanh nghiệp vừa và nhỏ - gói Professional</inv:itemName><inv:unitName>Gói</inv:unitName><inv:quantity>1.00 </inv:quantity><inv:itemTotalAmountWithoutVat>1000000 </inv:itemTotalAmountWithoutVat><inv:vatPercentage>0</inv:vatPercentage><inv:vatAmount>0 </inv:vatAmount><inv:unitPrice>1000000.0 </inv:unitPrice><inv:promotion>0</inv:promotion></inv:item></inv:items><inv:invoiceTaxBreakdowns><inv:invoiceTaxBreakdown><inv:vatPercentage>0</inv:vatPercentage></inv:invoiceTaxBreakdown></inv:invoiceTaxBreakdowns><inv:totalAmountWithoutVAT>1000000 </inv:totalAmountWithoutVAT><inv:totalVATAmount>100000 </inv:totalVATAmount><inv:totalAmountWithVAT>1100000 </inv:totalAmountWithVAT><inv:totalAmountWithVATInWords>Chín triệu đồng chẵn</inv:totalAmountWithVATInWords><inv:discountAmount>0 </inv:discountAmount><inv:totalAmountWithVATFrn>1100000 </inv:totalAmountWithVATFrn><inv:userDefines><![CDATA[<TransactionID>8VU0C220B</TransactionID><InvoiceRefID>91ad15ac-9c54-43fd-8425-a97d03a40005</InvoiceRefID><InvoiceTemplateID>1d324c9b-d4a3-4a16-a2f6-4b36100b11d1</InvoiceTemplateID><MainCurrency>VND</MainCurrency><UnitPriceDecimalDigits>1</UnitPriceDecimalDigits><UnitPriceOCDecimalDigits>0</UnitPriceOCDecimalDigits><QuantityDecimalDigits>2</QuantityDecimalDigits><AmountDecimalDigits>0</AmountDecimalDigits><AmountOCDecimalDigits>2</AmountOCDecimalDigits><ExchangRateDecimalDigits>0</ExchangRateDecimalDigits><CoefficientDecimalDigits>2</CoefficientDecimalDigits><ClockDecimalDigits></ClockDecimalDigits><WaterArrearage>0</WaterArrearage><WaterPromotion>0</WaterPromotion><WaterUsed>0</WaterUsed><EnvironmmentFeeRate>0</EnvironmmentFeeRate><EnvironmmentFeeAmount>0 </EnvironmmentFeeAmount><OtherFeeRate>0.00 </OtherFeeRate><OtherFeeAmount>0 </OtherFeeAmount><SortOrderIndex>0</SortOrderIndex><SumOfClockIndex>0</SumOfClockIndex><IsTaxReduction>0</IsTaxReduction><ListCustomDetail><ClockInfos></ClockInfos></ListCustomDetail><UserItems><UserItem><LineNumber>1</LineNumber><AmountOC>0 </AmountOC><VATAmountOC>0 </VATAmountOC><DiscountRate>0.00 </DiscountRate><DiscountAmountOC>0 </DiscountAmountOC><DiscountAmount>0 </DiscountAmount><InventoryItemType>0</InventoryItemType><TaxReductionAmountOC>0 </TaxReductionAmountOC><TaxReductionAmount>0 </TaxReductionAmount></UserItem></UserItems>]]></inv:userDefines></inv:invoiceData><inv:controlData><inv:systemCode>LHD_MISA</inv:systemCode></inv:controlData></inv:invoice>"
}

Response

    {
    "Status": 200,
    "Message": null,
    "Payload": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><inv:invoice xmlns:inv=\"http://laphoadon.gdt.gov.vn/2014/09/invoicexml/v1\" xmlns:ds=\"http://www.w3.org/2000/09/xmldsig#\"><inv:invoiceData id=\"data\"><inv:invoiceType>02GTTT</inv:invoiceType><inv:templateCode>02GTTT0/002</inv:templateCode><inv:invoiceSeries>AB/21E</inv:invoiceSeries><inv:invoiceNumber>0000015</inv:invoiceNumber><inv:invoiceIssuedDate>2021-10-30T00:00:00</inv:invoiceIssuedDate><inv:signedDate>2022-09-22T11:51:48</inv:signedDate><inv:currencyCode>VND</inv:currencyCode><inv:invoiceNote>Hóa đơn bán lẻ</inv:invoiceNote><inv:adjustmentType>1</inv:adjustmentType><inv:payments><inv:payment><inv:paymentMethodName>Tiền mặt</inv:paymentMethodName></inv:payment></inv:payments><inv:delivery /><inv:sellerLegalName>CÔNG TY TNHH MTV DỊCH VỤ THỦY LỢI BÌNH PHƯỚC</inv:sellerLegalName><inv:sellerTaxCode>2222222222-736</inv:sellerTaxCode><inv:sellerAddressLine>Đường Lê Duẩn - Phường Tân Bình - Thành Phố Đồng Xoài - Bình Phước</inv:sellerAddressLine><inv:sellerPhoneNumber>012345678912345</inv:sellerPhoneNumber><inv:sellerFaxNumber>25251325</inv:sellerFaxNumber><inv:sellerEmail>ngominhdai92@gmail.com</inv:sellerEmail><inv:sellerWebsite>abc.com.vn</inv:sellerWebsite><inv:sellerBankAccount>11047007</inv:sellerBankAccount><inv:sellerBankName>ACB</inv:sellerBankName><inv:buyerLegalName>Công ty cổ phần MISA (Test)</inv:buyerLegalName><inv:buyerDisplayName>Nguyễn Xuân A</inv:buyerDisplayName><inv:buyerTaxCode>0101243150-888</inv:buyerTaxCode><inv:buyerAddressLine>Tầng 9, Tòa nhà Technosoft, Duy Tân, Dịch Vọng Hậu, Cầu Giấy, Hà Nội</inv:buyerAddressLine><inv:buyerEmail>support@misa.com.vn</inv:buyerEmail><inv:buyerBankName>Hội sở Ngân hàng TMCP Á Châu</inv:buyerBankName><inv:buyerBankAccount>21137519</inv:buyerBankAccount><inv:exchangeRate>1 </inv:exchangeRate><inv:items><inv:item><inv:lineNumber>1</inv:lineNumber><inv:itemCode>SME2019.Pro</inv:itemCode><inv:itemName>Phần mềm kế toán doanh nghiệp vừa và nhỏ - gói Professional</inv:itemName><inv:unitName>Gói</inv:unitName><inv:quantity>1.00 </inv:quantity><inv:itemTotalAmountWithoutVat>1000000 </inv:itemTotalAmountWithoutVat><inv:vatPercentage>0</inv:vatPercentage><inv:vatAmount>0 </inv:vatAmount><inv:unitPrice>1000000.0 </inv:unitPrice><inv:promotion>0</inv:promotion></inv:item></inv:items><inv:invoiceTaxBreakdowns><inv:invoiceTaxBreakdown><inv:vatPercentage>0</inv:vatPercentage></inv:invoiceTaxBreakdown></inv:invoiceTaxBreakdowns><inv:totalAmountWithoutVAT>1000000 </inv:totalAmountWithoutVAT><inv:totalVATAmount>100000 </inv:totalVATAmount><inv:totalAmountWithVAT>1100000 </inv:totalAmountWithVAT><inv:totalAmountWithVATInWords>Chín triệu đồng chẵn</inv:totalAmountWithVATInWords><inv:discountAmount>0 </inv:discountAmount><inv:totalAmountWithVATFrn>1100000 </inv:totalAmountWithVATFrn><inv:userDefines><![CDATA[<TransactionID>8VU0C220B</TransactionID><InvoiceRefID>91ad15ac-9c54-43fd-8425-a97d03a40005</InvoiceRefID><InvoiceTemplateID>1d324c9b-d4a3-4a16-a2f6-4b36100b11d1</InvoiceTemplateID><MainCurrency>VND</MainCurrency><UnitPriceDecimalDigits>1</UnitPriceDecimalDigits><UnitPriceOCDecimalDigits>0</UnitPriceOCDecimalDigits><QuantityDecimalDigits>2</QuantityDecimalDigits><AmountDecimalDigits>0</AmountDecimalDigits><AmountOCDecimalDigits>2</AmountOCDecimalDigits><ExchangRateDecimalDigits>0</ExchangRateDecimalDigits><CoefficientDecimalDigits>2</CoefficientDecimalDigits><ClockDecimalDigits></ClockDecimalDigits><WaterArrearage>0</WaterArrearage><WaterPromotion>0</WaterPromotion><WaterUsed>0</WaterUsed><EnvironmmentFeeRate>0</EnvironmmentFeeRate><EnvironmmentFeeAmount>0 </EnvironmmentFeeAmount><OtherFeeRate>0.00 </OtherFeeRate><OtherFeeAmount>0 </OtherFeeAmount><SortOrderIndex>0</SortOrderIndex><SumOfClockIndex>0</SumOfClockIndex><IsTaxReduction>0</IsTaxReduction><ListCustomDetail><ClockInfos></ClockInfos></ListCustomDetail><UserItems><UserItem><LineNumber>1</LineNumber><AmountOC>0 </AmountOC><VATAmountOC>0 </VATAmountOC><DiscountRate>0.00 </DiscountRate><DiscountAmountOC>0 </DiscountAmountOC><DiscountAmount>0 </DiscountAmount><InventoryItemType>0</InventoryItemType><TaxReductionAmountOC>0 </TaxReductionAmountOC><TaxReductionAmount>0 </TaxReductionAmount></UserItem></UserItems>]]></inv:userDefines></inv:invoiceData><inv:controlData><inv:systemCode>LHD_MISA</inv:systemCode></inv:controlData><Signature Id=\"seller\" xmlns=\"http://www.w3.org/2000/09/xmldsig#\"><SignedInfo><CanonicalizationMethod Algorithm=\"http://www.w3.org/TR/2001/REC-xml-c14n-20010315\" /><SignatureMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#rsa-sha1\" /><Reference URI=\"#data\"><Transforms><Transform Algorithm=\"http://www.w3.org/2000/09/xmldsig#enveloped-signature\" /></Transforms><DigestMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#sha1\" /><DigestValue>RiLPxS1hg6JGH9/hfzOXzTr+m/M=</DigestValue></Reference></SignedInfo><SignatureValue>Up6ON7qcqYC4BZ6no7/BgOk1i1ytx4jBw+gyP1OTKhwUbCcxdVzDzkmAyix3HUR2BSiuyHBmza+BuDwzWcbeji0ynSKn+9RyGuLE5eqdbwTKLLWbOhna00swLIG5/8BC51OZgZVH+sZUJZ+8YHgi5J5w40sFYgOGFtd36oNoaYe8YZqtiR9BuglCuRrjRVK8oMTAxKHH5yR0Ru278aC42b7NgEsCVS99aRCVD6LQON+W+rxRd0+lGs6wPxQupINVkc7SLyvCwH8VWrzZPDGUCVdamqNod212Fn9hIOH1qjd3pKeD8choRk7Ibm2oe8tkJut8uf7/wUwAd43RwDFXOQ==</SignatureValue><KeyInfo><X509Data><X509SubjectName>Description=MST:2222222222-736, CN=2222222222-736, OU=2222222222-736, O=2222222222-736, L=hn, S=hn, C=vn</X509SubjectName><X509Certificate>MIIDmTCCAoGgAwIBAgIBATANBgkqhkiG9w0BAQUFADCBjzELMAkGA1UEBhMCdm4xCzAJBgNVBAgTAmhuMQswCQYDVQQHEwJobjEXMBUGA1UEChMOMjIyMjIyMjIyMi03MzYxFzAVBgNVBAsTDjIyMjIyMjIyMjItNzM2MRcwFQYDVQQDEw4yMjIyMjIyMjIyLTczNjEbMBkGA1UEDRMSTVNUOjIyMjIyMjIyMjItNzM2MB4XDTIyMDkyMjAxNDIwMFoXDTI3MDkyMjAxNDIwMFowgY8xCzAJBgNVBAYTAnZuMQswCQYDVQQIEwJobjELMAkGA1UEBxMCaG4xFzAVBgNVBAoTDjIyMjIyMjIyMjItNzM2MRcwFQYDVQQLEw4yMjIyMjIyMjIyLTczNjEXMBUGA1UEAxMOMjIyMjIyMjIyMi03MzYxGzAZBgNVBA0TEk1TVDoyMjIyMjIyMjIyLTczNjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMcuRh/fR8bTi2LZJ+IvecT7pFuUVq0DTAm33/Aqdzsh09DbxxZ4XwJAxEEJLmvL49ELA8sJfndxmhRhEqGrR4tXnSUYvx4qlLWS7RCBrptURLh/7P0z8SvBqyCaoa26wSm6g1oiy7skNMKw8TbXnhRtGe4pYdkQ7AzGRwDIfvQ08Nz91pUQsdcIHAozm8OG4dLvbRZeqiV+SfgBnl6AG3qtKTOJUG78KLek5NkhlpmN0FZQjrmQKPhHTqjNYZCfMR7YbF1UDRGRiCIoiZpBNVCBR7d5oqR4++s4JoKzNrsnNwK0fq28+1mkR24WdZ8jppnUVOIMX2epLEophGHqx90CAwEAATANBgkqhkiG9w0BAQUFAAOCAQEAIv8AtVIIW4Uz/P6gsOs4QU6Y38XpLWM8trEVbP4AmrgMClMlNbDQu/HCqucwwCV9CqDl1udajSNcMq3iDnq9cnv5mds7FAh+v2W/LHMd2Rm5dGeWoGXh4/slUWsNB3bxvJa1yAtRjyBv9Epg2uW5If2l7IfnDs0U6btojNNNlN769JNc8VoeQcCOtytO2s1zyaExjNkzbMRw4cWIkAeyVpSok2DFSaEUmjM1YJgcXJr8WHz/LSQkEPEcd5wsd+JjjWAWs1jgRU6yd+D8tgiRA63eqy2RXNpPMCmnxL/tZ4Fc3QQeSvzdM0PisbptSy5gHzQ331wo77bfTKukspL6jA==</X509Certificate></X509Data></KeyInfo></Signature></inv:invoice>",
    "Data": "{\"addTimeStamp\":false,\"tsaUrl\":null,\"tsaUsername\":null,\"tsaPassword\":null,\"tsaTokenSizeEstimate\":4096,\"tsaDigestAlgorithm\":null,\"location\":null,\"reason\":null,\"pageNumber\":1,\"LLX\":60.0,\"LLY\":20.0,\"URX\":0.0,\"URY\":0.0,\"width\":300.0,\"height\":60.0,\"renderingMode\":0,\"deleteSignFileAfterSign\":false,\"signByCaption\":\"Ký bởi: 2222222222-736\",\"signDateCaption\":\"Ký ngày: 22/09/2022\",\"signReasonCaption\":\"Lý do: \",\"signLocationCaption\":\"Vị trí: \",\"append\":false,\"addImageBackGround\":true,\"imageFile\":null,\"usedDefaultImageFile\":true,\"imageScale\":0.8}",
    "AppVersion": "2.0.0.0"
}

3. Phát hành hóa đơn

Phương thức này cho phép các ứng dụng thực hiện phát hành một hoặc nhiều HĐĐT. Các HĐĐT có thể là các hóa đơn gốc, hóa đơn thay thế hoặc hóa đơn điều chỉnh.

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

3.1 Body parameter

[
    {
        "RefID": "d0746fa0-8279-4f90-9281-6debd4123f0d",//refid hóa đơn
        "TransactionID": "NPU2F22VVX",//mã tra cứu hóa đơn tra ra ở bước lập xml
        "InvoiceData": "<thông tin xml đã được ký số >",
        "IsSendEmail":true,// đánh dấu có gửi email sau phát hành hay không
        "ReceiverEmail":"mail@gmail.com",//email nhận hóa đơn, nếu nhiều email thì cách nhau bằng dấu ;
        "ReceiverName":"người nhận",// tên người nhận hóa đơn
        "IsInvoiceSummary": false//dùng cho hóa đơn không mã,nếu gửi bảng tổng hợp lên thuế thì bằng :true
    }
]

3.2 Response

Trường hợp thành công, HttpStatusCode = 200 (OK) và dữ liệu trả về sẽ là một danh sách, mỗi dòng sẽ gồm các thông tin sau

Tên	Kiểu dữ liệu	Mô tả
TransactionID	String	Mã tra cứu hóa đơn
PublishStatus	Int	Kết quả phát hành hóa đơn điện tử
ErrorCode	String	Mã lỗi. Các mã lỗi có thể gồm: - SignatureEmpty: Không có chữ ký số trong hóa đơn điện tử - InvalidSignature: Chữ ký số không hợp lệ - InvalidXMLData: Dữ liệu hóa đơn điện tử không hợp lệ - RequireInfo_{0}: Thiếu thông tin bắt buộc - InvoicePublishNotExist: Không có thông báo phát hành hóa đơn cho mẫu số, ký hiệu tương ứng của hóa đơn - InvoiceNumberNotCotinuous: Số hóa đơn không liên tục - InvalidInvNo: Số hóa đơn không hợp lệ - InvoiceIssuedDate: Ngày hóa đơn không hợp lệ - InvalidVatPercentage: Thuế suất không hợp lệ - InvalidTaxCode: Mã số thuế không hợp lệ - InvoiceDuplicated: Trùng hóa đơn dựa vào refid

Khi không thành công, Response nhận được sẽ như sau:

Lỗi khi tham số quá dài. Mỗi lần chỉ phát hành được tối đa 50 hóa đơn

{
"Success": false,
"ErrorCode": "InvoiceQuantityTooLarge",
"Errors": ""
}

Khi không thành công đối với mã lỗi InvoiceDuplicated, Response nhận được sẽ như sau:

{
"Success" : true,
"Data" : "thông tin hóa đơn đã phát hành , errorode : InvoiceDuplicated",
"NewData" : "",
"Errors" : [],
"ErrorCode" : ""
}

* Chú ý:

• "success": true và tất cả các Errocode bên trong đều là “” thì là phát hành hóa đơn điện tử thành công. • "success": true và Errocode bên trong <> “” : Phát hành có lỗi, phải show Errocode để đối chiếu với bảng mã lỗi xem là lỗi gì. • "success": False : Phát hành hóa đơn không thành công • "success": true chỉ là trạng thái gửi lên MISA Meinvoice thành công, phải duyệt tất cả các Errocode để xác định thật sự thành công hay không

Ví dụ Với 1 Response trả về có lỗi {
"Success": true,
"Data": "[{\"RefID\":\"6fab129c-987f-4099-812d-f90abfeaea42\",\"TransactionID\":null,\"InvoiceNumber\":null,\"InvoiceIssuedDate\":null,\"InvoiceData\":null,\"ErrorCode\":\"InvoiceIssuedDateSmallerThanLastest\",\"CallbackUrl\":null}]",
"NewData": "",
"Errors": [],
"ErrorCode": "",
"ErrorCodeDetail": null
}
Diễn giải:
+ "Success": true : Là trạng thái request gửi hóa đơn lên Meinvoice thành công
+ "Data": "[{\"RefID\":\"6fab129c-987f-4099-812d-f90abfeaea42\",\"TransactionID\":null,\"InvoiceNumber\":null,\"InvoiceIssuedDate\":null,\"InvoiceData\":null,\"ErrorCode\":\"InvoiceIssuedDateSmallerThanLastest\",\"CallbackUrl\":null}]" :
Data trả về, cần check” ErrorCode” bên trong này nữa, ErrorCode này là các lỗi về dữ liệu của hóa đơn
Như kiểu ngày không hợp lệ,số hóa đơn không liên tục, mã số thuế không đúng,…
+ "Errors": [] : tên lỗi
+ "ErrorCode": "": Mã lỗi
Đây là các lỗi chung , kiểu như server có lỗi, Authen, tài nguyên, license..
Tóm lại khi client thi công phải check cả Errcode bên ngoài à Errocode ở trong Data để biết lỗi do đâu, phải đối chiếu với bảng mã lỗi để show thông báo cho người dùng.