Ký số bằng HSM
(SignType=2)
Mô tả
Đối với phương thức ký HSM này Client chỉ cần gọi API truyền thông tin hóa đơn dưới dạng json lên MISA, các việc tạo XML, ký số, phát hành, gửi qua CQT sẽ được tự động thực hiện trên server MISA và kết quả sẽ được trả lại ngay trong response của API.
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": 2, (loại ký số HSM)
"InvoiceData": <list đối tượng InvoiceData>
}
Mô tả đối tượng: InvoiceData
2 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": null,
"publishInvoiceResult": <List thông tin publishInvoiceResult>
}
Mô tả đối tượng: publishInvoiceResult
3 Ví dụ
3.1 Request
URL: https://testapi.meinvoice.vn/api/api/integration/invoice
HEADERS:
Content-Type: application-json
Authorization: Bearer <token lấy ở api Lấy token Authorization>
BODY:
{
"SignType": 2,
"InvoiceData": [
{
"RefID": "a91f0781-3177-46af-b9bb-f1b9ef767228",
"InvSeries": "1C24TQQ",
"InvDate": "2024-09-18",
"CurrencyCode": "VND",
"ExchangeRate": 1.0,
"PaymentMethodName": "TM/CK",
"BuyerLegalName": "Công ty cổ phần MISA",
"BuyerTaxCode": "0101243150",
"BuyerAddress": "Tầng 9 tòa nhà Technosoft, Duy Tân, Dịch Vọng Hậu, Cầu Giấy, Hà Nội",
"BuyerCode": "MS001",
"BuyerPhoneNumber": "0241 522 526",
"BuyerEmail": "contact@misa.com.vn",
"BuyerFullName": "Nguyễn Xuân Hoàng",
"BuyerBankAccount": "010124315087210",
"BuyerBankName": "Ngân hàng Việt Nam Thịnh Vượng",
"TotalSaleAmountOC":500000,
"TotalSaleAmount":500000,
"TotalDiscountAmountOC": 0,
"TotalDiscountAmount": 0,
"TotalAmountWithoutVATOC": 500000.0,
"TotalAmountWithoutVAT": 500000.0,
"TotalVATAmountOC": 50000.0,
"TotalVATAmount": 50000.0,
"TotalAmountOC": 550000.0,
"TotalAmountOC": 550000.0,
"TotalAmountInWords": "Năm trăm năm mươi nghìn đồng.",
"OriginalInvoiceDetail": [
{
"ItemType": 1,
"LineNumber": 1,
"SortOrder":1,
"ItemCode": "AOSM01",
"ItemName": "Áo sơ mi Nam 40",
"UnitName": "Chiếc",
"Quantity": 10.0,
"UnitPrice": 50000.0,
"DiscountRate": 0,
"DiscountAmountOC": 0,
"DiscountAmount": 0,
"AmountOC": 500000.0,
"Amount": 500000.0,
"AmountWithoutVATOC": 500000.0,
"AmountWithoutVAT": 500000.0,
"VATRateName": "10%",
"VATAmountOC":50000,
"VATAmount":50000
}
],
"TaxRateInfo": [
{
"VATRateName": "10%",
"AmountWithoutVATOC": 500000.0,
"VATAmountOC": 50000.0
}
],
"OptionUserDefined": {
"MainCurrency": "VND",
"AmountDecimalDigits": "0",
"AmountOCDecimalDigits": "0",
"UnitPriceOCDecimalDigits": "0",
"UnitPriceDecimalDigits": "0"
}
}
]
}
3.2 Response
{
"success": true,
"errorCode": null,
"descriptionErrorCode": null,
"createInvoiceResult": null,
"publishInvoiceResult": "[{\"RefID\":\"a91f0781-3177-46af-b9bb-f1b9ef767228\",\"TransactionID\":\"11CRTPWJG5\",\"InvTemplateNo\":null,\"InvSeries\":null,\"InvNo\":\"00000033\",\"InvCode\":null,\"InvDate\":\"2024-09-25T00:00:00+07:00\",\"ErrorCode\":\"\",\"CustomData\":null}]"
}
4. Tài liệu tham khảo (Curl Postman)
curl --location 'https://testapi.meinvoice.vn/api/integration/invoice' \
--header 'Authorization: Bearer <token lấy ở api Lấy token Authorization>' \
--header 'Content-Type: application/json' \
--header 'Cookie: TS01df89db=010fb9740483c6e090a0168ad18f153b6543df0dc2ef8db082c5fdd03356731f4ab3170cb5f315fa0afca8615e2ead2e9f8602d6e8' \
--data-raw '{
"SignType": 2,
"InvoiceData": [
{
"RefID": "1f269f4c-08af-4665-b7b6-eb62581f583c",
"InvSeries": "1C24TAA",
"InvDate": "2024-09-25",
"CurrencyCode": "VND",
"ExchangeRate": 1.0,
"PaymentMethodName": "TM/CK",
"BuyerLegalName": "Công ty cổ phần MISA",
"BuyerTaxCode": "0101243150",
"BuyerAddress": "Tầng 9 tòa nhà Technosoft, Duy Tân, Dịch Vọng Hậu, Cầu Giấy, Hà Nội",
"BuyerCode": "MS001",
"BuyerPhoneNumber": "0241 522 526",
"BuyerEmail": "contact@misa.com.vn",
"BuyerFullName": "Nguyễn Xuân Hoàng",
"BuyerBankAccount": "010124315087210",
"BuyerBankName": "Ngân hàng Việt Nam Thịnh Vượng",
"TotalAmountWithoutVATOC": 5000000.0,
"TotalVATAmountOC": 500000.0,
"TotalDiscountAmountOC": 0,
"TotalAmountOC": 5500000.0,
"TotalAmountInWords": "Năm triệu năm trăm nghìn đồng.",
"OriginalInvoiceDetail": [
{
"ItemType": 1,
"LineNumber": 1,
"ItemCode": "AOSM01",
"ItemName": "Áo sơ mi Nam 40",
"UnitName": "Chiếc",
"Quantity": 10.0,
"UnitPrice": 500000.0,
"DiscountRate": 0,
"DiscountAmountOC": 0,
"AmountOC": 5000000.0,
"AmountWithoutVATOC": 5000000.0,
"VATRateName": "10%",
"VATAmountOC":500000.0,
"VATAmount":500000.0
}
],
"TaxRateInfo": [
{
"VATRateName": "10%",
"AmountWithoutVATOC": 5000000.0,
"VATAmountOC": 500000.0
}
],
"OptionUserDefined": {
"MainCurrency": "VND",
"AmountDecimalDigits": "0",
"AmountOCDecimalDigits": "0",
"UnitPriceOCDecimalDigits": "0",
"UnitPriceDecimalDigits": "0"
}
}
],
"PublishInvoiceData": null
}'