Đẩy HD GTGT - BH

1. Link API


Tên Phương thức Url
Môi trường test không mã post https://testapp.meinvoice.vn/api/v2/v3sainvoice
Môi trường test có mã post https://testapp.meinvoice.vn/api/v2/v3sainvoice/Code
Môi trường chính thức không mã post https://app.meinvoice.vn/api/v2/v3sainvoice
Môi trường chính thức có mã post https://app.meinvoice.vn/api/v2/v3sainvoice/Code

2. Header

Authorization: Bearer {access_token lấy ở api lấy token}
TaxCode: {mã số thuế}
Content-Type: application/json

3. body

    [{
          object Einvoice
    }]

4. respone

{
    "SerializeConfig": null,
    "data": "thông tin hóa đơn, và trạng thái đẩy",
    "newdata": "",
    "dataError": null,
    "success": true,
    "recordsTotal": 0,
    "recordsFiltered": 0,
    "content": null,
    "error": null,
    "dataAdditional": null,
    "errorCode": []
}

5. ví dụ

Link api 

https://testapp.meinvoice.vn/api/v2/v3sainvoice

hearder

Content-Type: application/json
TaxCode:2222222222-433    
Authorization: Bearer QrkEJdNNJmrgE-Y0Yc2ePkspDqAYYGLGGv7iWGEkQZY7k-2Vi6Q_kK4ZLzf0MoK1vLb5kBHNzejZWyolFGL9zlUpw-k-e09Re4yb9o3Tssjg5Zzouha30pvx_NSoH_ZHu_P__CjVNB94zjP6Q8Gvt5tJRBEJoI_r1asNuIrjJEUzenRfXKLw8nHPB1Jt8tPyGQzp3EG6FxtlEL31xmJy230sXFZN_UdzVIhnMEODgj5e_Qdfc4JNuPXkWSsUX-2-yP7qNh_4_IpwqPHQPqZVQXYBFxdqc16cif--OD9luQKfXFJ8ETxus5ph9V452UQM-E0u1DbBFIkvVrODqOqPlI6RzPKMz3U_x8fGgfe_WU3odVmfVefyRk6oymm5VkPMYdLK7O9Ba1jtSNK5ZvcJzw5dYWm1ExnYqGidG7Lsmw5Jt2mYn5Q8-VscFuBlJ198Y5t4cK3qH2W3tbm1W7anULLC2RivxdAhYIUWR_LWLSaPOMJ1_XrpB_DPKcg_xtUW5TI0Z9SP2n7mnqfjCrwDCreHr43rmRFxui54fuR3UnpBSH15xlF-hnQqczE_8dXktVjbsm7uSOnSSoZAc2Ac2UC3RH_yMbG_KjnuH0vy7bCrCxsFADE4pynRdV69EB7BCrSbZUIsWQCRa6HBguwxwtUqRkG90fazyholKA-dMgs58vlYTb16RPtKpS5Xz8F40Mvr8Sv3bFBJn_gdK2QyIF0jyZEP1oLWp8MrdvTXjONdITK5Dh0zF3t8YHpVpl_FmXjcH6tjgjtFX3knEgImjwlXl7FippWvi6reiiMcMpFOdPGjOWHm4zSlEP-j2FwSsrU4wRddmfjBIx0poPPXSqYdJ1tVSm8daJy2QjWM7r660CukQl1hDzSsIs2QPLZgWMJMMqi3W8PK31rD59Y4zxIPpdtECPqvOU4XC47LOTottarUciK6-y6duMWXsAtL9wuaQRLGonSFLzOom54LXPp_nObKxZ37gnRZYMc0Iey_YLlBRTR6WlPedqw5OVIBgL2oISOSUvh889oc_KR639WEg4XyIG0hE8EtCu1ZGRwdwDea2WUzcoXTL12dlSJJzgzEaWGDlCl-U3Q-8U4xeKua2gJDLFVp6jxQ7D_vyGH2eCdh668KwRv1S90ibmS34ct_njTu5ZfY1HZs7KiMG4v7u4QDkFnAY9NW_7trohCTsvXTozm87_4iSoB1ZFumIFY3-8FqWjakpjIoewvFi_mGmyMs_pcSgs0imCmRdpH2WicpULpJ-L0jXt4Amn-rMN_sVDcp6yjYsBRNr6UzQ8GB5Y-rgNZumBGzyWXYMlTK-FILeJFhFBFN53UBb5Eqnx20esrNCRCog4Wn_0BU6FYG5iiDNl1lH2VDPZrxZAII2cT_bHekrIuSgEpWYizmb0Y6ypQjedlRWUv_NtKPwMIjjOhG4lGfm7DuBYNdKcYkwdCKxa9DUsLnesTjr_GZXw8UyyvIaYUjcy2OgjQvlSShPbYJQr4TEHxMmUqMqRfSNP7JnhNf4s1k4A09I3NheCr9ipI9rt0f_I1TX9TMMVKoH6PmuSUOggLtslLB9CzGF_ku5eqGmxsmRskAL9YebXo0QDtPvduAtZnqa0TNmXo02XIrN9SAsIwhTPtUe1cD9H1wq0w9K2AViKOesIZb2dnbmbbDI-LMETHVAFSY0f1F9-7Up1NSFb8x7i4GLK1jU1xO_wXx-SWdiiA4r6Xt8-_8kcei1g4wqdX66Y5DcFjeonEO-BDgbAKi8UVJ62URjThjFOYqFmspxEJj-DA17ahnFCLg-47GZ7DpDzv-DwjE7wMtB8iMVBO0Ry7KYLAkdLkJp5z8n47sW421E2f2KFPDQ6-N0i9qxMVZHwo5qDWxoeSJge97mlq2JH64KaGY2pJybpj24fcrmujCTQQ24iWXfzTw2uV23ybqEq2UKo3stZet3J5ETvTu8HQJcKkTSXIUx995V4KkQTqd7JdTBLmTK7pRw6WjH8Jrgew4qzcGC7hLE5XvV7LrpjFF0gth5PL9uGKLujdy7C5NDHEuCGAdUPBDvoxOWNlGnj6J5jkaqEsBAAO6ePoMBo-TgIix9cqnMrJxllM6PFChTy_jB5q5SP7N8BihRgXh9W84HwWioyODMLWQDxa-h5UQPymHnqcfMEgpIFhLPbYe3kinLMZ7Kv1lI2bmpmc-OA4dbRorYzxov1r0tzjJtRQuY8sg2wioE-Nq7i3AZZrjlmy6BwTULs3wlsc_sPV42njSIw6NADO_4AJmXZHkroQv8H5VPM5seoydKraIGCFsLxSKRUb6Rl401hHEAI7cPnQDE6mkkI_Qnq5aDzGldjHaWIqZLsHJd-2rsMqV_NSvo1b1rbEMLubZUg9p-farNpWmhV205Tvxs4c5shqpOoGpPx1-AhP1KiUl7zxglMQzllV3wcMEcWtMo8G7nuEshvPOWlKLifE9sNU5ZISn_CMBMgl0rz5h_M2P_VL21_GiYO75pRZ3EJVWNhkC0zLUfW_qQndWVEOqCHlmhAS5PglUlTcBmToJO5Zzvk0nIktwHdUJvFGlfSk_oerdSrDwSvIOUlsCvV5XBQjXVSABAB-lHSycKOn5-v1I4T2bqnXFlIBXPl9XX_8aTNe8k2xWyJSaLODnYEkuK0HLqp332M3fRD2U8hmyxalZVQTBvBfFtw8egNUIHVssZ4MlKcBHIB08LvtTg0O3isNcogFWIYxFyjA6fIjWzzQdjC1AYahFFw52qdgvhabrgx10xbLcg0V6El3OUQmWxobQwW5tnB-2gm5Zt6q5UY9sE8QLos6Oc1NDildaY6bhXxbrnqhEKNNxmAXkwekVNQZYgCa4cZ_ijzInoV4dZzZsZZtlmCDF0GXSc4BthZzRJ2xr6GHRgNeMa6ENgM3lUeE5PpTL38zJkjOko2LI3qEt7hTOusurJRcBteA8YcrjfNH-hnxaoVb886mPG97iI6DhHqqpwQDAYpfeBGZo123XGxqExPmf_zkFBN7RtGZxBMoBAWxvAn9LMa19RUMkUdGPNAPptNR7CREkkCQFr-cEK7mIfeQLup5-T9GqE0JOEhcZvJO3a3EYQQ

Body

[
{
    "RefID": "a9842fc2-d2f3-417e-91cd-75c2e0b84276",
    "CompanyID": 110627,
    "OrganizationUnitID": "d6a6deb9-46d8-11ec-940a-005056a6f699",
    "SourceType": 0,
    "InvTemplateNo": "1",
    "InvoiceType": 1,
    "InvSeries": "1K23TCB",
    "InvDate": "2023-03-14T09:00:13+07:00",
    "InvNo": "<Chưa cấp số>",
    "PublishStatus": 0,
    "AccountObjectID": "",
    "AccountObjectTaxCode": "0101243150",
    "AccountObjectName": "Công ty Misa Test",
    "AccountObjectCode": "",
    "AccountObjectAddress": "Hà Nội",
    "ContactName": "Người mua hàng",
    "ReceiverName": "",
    "SendInvoiceStatus": 0,
    "SendNumber": 0,
    "IsInvoiceReceipted": false,
    "PaymentMethod": "TM/CK",
    "CurrencyCode": "VND",
    "CurrencyID": "VND",
    "ExchangeRate": 1.0,
    "DiscountRate": 0.0,
    "IsMoreVATRate": false,
    "VATRate": 10.0,
    "TotalSaleAmountOC": 100000.0,
    "TotalSaleAmount": 100000.0,
    "TotalAmountWithoutVAT": 100000.0,
    "TotalAmountWithoutVATOC": 100000.0,
    "TotalVATAmountOC": 10000.0,
    "TotalVATAmount": 10000.0,
    "TotalAmountOC": 110000.0,
    "TotalAmount": 110000.0,
    "TotalDiscountAmount": 0.0,
    "TotalDiscountAmountOC": 0.0,      
    "EInvoiceStatus": 1,
    "IsInvoiceDiscount": false,
    "TypeDiscount": 0,
    "SortOrder": 0,
    "IsInvoiceDeleted": false,
    "InvoiceTemplateID": "cb8f8f2a-109b-4aba-b6c2-f3b0273ea503",
    "UserID": "c3319801-2d9f-43eb-80d9-b31999e75ab2",
    "EditVersion": 0,
    "InvoiceDetails": [
        {
            "RefDetailID": "9e075350-2eb6-4c2c-be82-74783308881b",
            "RefID": "a9842fc2-d2f3-417e-91cd-75c2e0b84274",
            "Description": "Tên hàng hóa",
            "UnitName":"DVT",
            "Quantity": 1.0,
            "UnitPrice": 100000.0,
            "AmountOC": 100000.0,
            "Amount": 100000.0,
            "DiscountRate": 0.0,
            "DiscountAmountOC": 0.0,
            "DiscountAmount": 0.0,
            "VATRate": 10.0,
            "VATAmountOC": 10000.0,
            "VATAmount": 10000.0,
            "SortOrder": 1,
            "IsPromotion": false,
            "InventoryItemType": 0,
            "SortOrderView": 1
        }
    ]
}
]

respone

{
"SerializeConfig": null,
"data": "{\"a9842fc2-d2f3-417e-91cd-75c2e0b84276\":{\"Data\":\"{\\\"RefID\\\":\\\"a9842fc2-d2f3-417e-91cd-75c2e0b84276\\\",\\\"CompanyID\\\":110627,\\\"OrganizationUnitID\\\":\\\"d6a6deb9-46d8-11ec-940a-005056a6f699\\\",\\\"SourceType\\\":0,\\\"InvTemplateNo\\\":\\\"1\\\",\\\"InvoiceType\\\":1,\\\"InvSeries\\\":\\\"1K23TCB\\\",\\\"InvDate\\\":\\\"2023-03-14T09:00:13+07:00\\\",\\\"InvNo\\\":\\\"<Chưa cấp số>\\\",\\\"PublishStatus\\\":0,\\\"AccountObjectID\\\":\\\"\\\",\\\"AccountObjectTaxCode\\\":\\\"0101243150\\\",\\\"AccountObjectName\\\":\\\"Công ty Misa Test\\\",\\\"AccountObjectCode\\\":\\\"\\\",\\\"AccountObjectAddress\\\":\\\"Hà Nội\\\",\\\"ContactName\\\":\\\"\\\",\\\"ReceiverName\\\":\\\"\\\",\\\"SendInvoiceStatus\\\":0,\\\"SendNumber\\\":0,\\\"IsInvoiceReceipted\\\":false,\\\"PaymentMethod\\\":\\\"TM/CK\\\",\\\"CurrencyCode\\\":\\\"VND\\\",\\\"CurrencyID\\\":\\\"VND\\\",\\\"ExchangeRate\\\":1.0,\\\"IsMoreVATRate\\\":false,\\\"VATRate\\\":10.0,\\\"TotalSaleAmountOC\\\":100000.0,\\\"TotalDiscountAmountOC\\\":0.0,\\\"TotalVATAmountOC\\\":10000.0,\\\"TotalAmountOC\\\":110000.0,\\\"TotalSaleAmount\\\":100000.0,\\\"TotalDiscountAmount\\\":0.0,\\\"TotalAmountWithoutVAT\\\":100000.0,\\\"TotalVATAmount\\\":10000.0,\\\"TotalAmount\\\":110000.0,\\\"TotalSaleAmountOther\\\":0.0,\\\"TotalVATAmountOther\\\":0.0,\\\"TotalAmountWithVAT\\\":0.0,\\\"TotalAmountWithVATOC\\\":0.0,\\\"EInvoiceStatus\\\":1,\\\"PaymentStatus\\\":0,\\\"IsInvoiceDiscount\\\":false,\\\"TypeDiscount\\\":0,\\\"BusinessArea\\\":0,\\\"ApproveStep\\\":-3,\\\"IsImport\\\":false,\\\"SortOrder\\\":0,\\\"EditVersion\\\":0,\\\"OrgInvoiceType\\\":0,\\\"InvoiceDetails\\\":[{\\\"RefDetailID\\\":\\\"9e075350-2eb6-4c2c-be82-74783308881b\\\",\\\"RefID\\\":\\\"a9842fc2-d2f3-417e-91cd-75c2e0b84274\\\",\\\"Description\\\":\\\"Tên hàng hóa\\\",\\\"UnitName\\\":\\\"DVT\\\",\\\"Quantity\\\":1.0,\\\"InWards\\\":0.0,\\\"UnitPrice\\\":100000.0,\\\"AmountOC\\\":100000.0,\\\"Amount\\\":100000.0,\\\"DiscountRate\\\":0.0,\\\"DiscountAmountOC\\\":0.0,\\\"DiscountAmount\\\":0.0,\\\"VATRate\\\":10.0,\\\"VATAmountOC\\\":10000.0,\\\"VATAmount\\\":10000.0,\\\"WageAmountOC\\\":0.0,\\\"WageAmount\\\":0.0,\\\"WagePriceAmount\\\":0.0,\\\"WagePriceDiscountAmount\\\":0.0,\\\"WageDiscountAmountOC\\\":0.0,\\\"SortOrder\\\":1,\\\"IsPromotion\\\":false,\\\"IsTemp\\\":false,\\\"CompanyID\\\":0,\\\"InventoryItemType\\\":0,\\\"UnitAfterTax\\\":0.0,\\\"AmountAfterTax\\\":0.0,\\\"OutWards\\\":0.0,\\\"SortOrderView\\\":1,\\\"TaxReductionAmount\\\":0.0,\\\"TaxReductionAmountOC\\\":0.0,\\\"SourceType\\\":208}],\\\"IsInvoiceDeleted\\\":false,\\\"InvoiceTemplateID\\\":\\\"cb8f8f2a-109b-4aba-b6c2-f3b0273ea503\\\",\\\"SendToTaxStatus\\\":0,\\\"UserID\\\":\\\"c3319801-2d9f-43eb-80d9-b31999e75ab2\\\",\\\"ErrorInvoiceStatus\\\":0,\\\"IsTaxReduction\\\":false,\\\"IsInheritFromOldTemplate\\\":true,\\\"IsInvoiceSummary\\\":false,\\\"IsAutoCalculate\\\":false,\\\"InvoiceSummaryStatus\\\":-1,\\\"IsTaxReduction43\\\":false}\",\"ErrorMessage\":null,\"ErrorCode\":[],\"Success\":true,\"DBExecuteResult\":null,\"EntityState\":0}}",
"newdata": "",
"dataError": null,
"success": true,
"recordsTotal": 0,
"recordsFiltered": 0,
"content": null,
"error": null,
"dataAdditional": null,
"errorCode": []
}

6.1 Mô tả đối tượng Einvoice - Master


Object Description DataType Mandatory
RefID Khóa chính của hóa đơn Guid Yes
CompanyID ID của công ty (lấy từ kết quả trả về của api get token) int Yes
OrganizationUnitID id định danh đơn vị (lấy từ kết quả trả về của api get token) string Yes
UserID ID của user lập HĐ (lấy từ kết quả trả về của api get token) string Yes
InvoiceType Loại hóa đơn (lấy theo kết quả trả về của api get template) string Yes
InvTemplateNo mẫu số HĐ (lấy theo kết quả trả về của api get template) string Yes
InvoiceTemplateID ID mẫu hóa đơn (lấy theo kết quả trả về của api get template) string Yes
IsInheritFromOldTemplate kiểu mẫu HĐ (lấy theo kết quả trả về của api get template) string Yes
InvDate Ngày hóa đơn Datetime Yes
InvNo Số hóa đơn (mặc định truyền "Chưa cấp số") string Yes
SourceType giá trị mặc định: 0 int Yes
SendInvoiceStatus giá trị mặc định: 0 int Yes
SendNumber giá trị mặc định: 0 int Yes
CurrencyCode Mã loại tiền tệ. ví dụ: VND,USD... string Yes
CurrencyID Mã loại tiền tệ. ví dụ: VND,USD... string Yes
ExchangeRate tỷ giá (nếu là VND thì ExchangeRate:1) decimal Yes
TypeDiscount Loại chiết khấu: 0: Không có chiết khấu 1: Chiết khấu theo dòng hàng 2: Chiết khấu theo tổng giá trị hóa đơn int Yes
DiscountRate Phần trăm chiết khấu decimal Yes
IsMoreVATRate Đánh dấu HĐ nhiều thuế suất hay 1 thuế suất: 1 thuế suất: false nhiều thuế suất: true bool Yes
VATRate Loại thuế suất(0%,5%,8%,10%,KCT,KKKNT,...) decimal Yes
ExchangeRateOperation giá trị mặc định: 0 decimal yes
EInvoiceStatus giá trị mặc định: 0 int yes
PaymentStatus giá trị mặc định: 0 int yes
PaymentRule kiểu thanh toán,giá trị mặc định: 0 int yes
ApproveStep giá trị mặc định: -3 int yes
CreatedDate giá trị mặc định: DateTime.Now() DateTime Yes
ModifiedDate giá trị mặc định: DateTime.Now() DateTime Yes
EditVersion giá trị mặc định: 0 int yes
OrgInvoiceType giá trị mặc định: 1 int yes
TotalSaleAmountOC = Sum(AmountOC, InventoryItemType = 0) - Sum(AmountOC, InventoryItemType = 4)
TotalSaleAmount = TotalSaleAmountOC * ExchangeRate decimal yes
TotalVATAmountOC = Sum(VATAmountOC, InventoryItemType = 0) - Sum(VATAmountOC, InventoryItemType = 4) decimal yes
TotalVATAmount = TotalVATAmountOC * ExchangeRate decimal yes
TotalDiscountAmountOC = Sum(DiscountAmountOC) decimal yes
TotalDiscountAmount = TotalDiscountAmountOC * ExchangeRate decimal yes
TotalAmountOC = TotalSaleAmountOC – TotalDiscountAmountOC + TotalVATAmountOC decimal yes
TotalAmount = TotalAmountOC * ExchangeRate decimal yes
AccountObjectTaxCode Mã số thuế của KH string No
AccountObjectName Tên đơn vị string No
AccountObjectCode Mã KH string No
ContactName Người mua hàng string No
ReceiverEmail email người mua hàng string No
ReceiverName Invoice recipient’s name string No
ReceiverMobile Số điện thoại người mua hàng string No
PaymentMethod Hình thức thanh toán (TM,Ck,TM/CK,...) string yes
IsTaxReduction43 Đánh dấu nếu hđ có thuế suất 8% (true,false) bool yes

6.2 Mô tả đối tượng Einvoice - Detail


Object Mô tả Kiểu dữ liệu Bắt buộc
RefDetailID ID của dòng hàng hóa Guild Yes
RefID ID của hóa đơn ở master Guild Yes
InventoryItemType Loại hàng hóa

  • Product = 1
  • Promotion = 2
  • Description = 3

  • Discount = 4

int Yes
InventoryItemCode Mã hàng hóa string Yes
Description Tên hàng hóa string Yes
UnitName đơn vị tính string Yes
Quantity số lượng decimal Yes
UnitPrice đơn giá decimal Yes
AmountOC thành tiền nguyên tệ = Quantity UnitPrice decimal Yes
Amount thành tiền quy đổi = AmountOC ExchangeRate decimal Yes
DiscountRate phần trăm chiết khấu decimal Yes
DiscountAmountOC số tiền chiết khấu nguyên tệ decimal Yes
DiscountAmount số tiền chiết khấu quy đổi = DiscountAmountOC ExchangeRate decimal Yes
VATRate thuế suất decimal Yes
VATAmountOC tiền thuế VAT nguyên tệ = AmountOC VATRate/100 decimal Yes
VATAmount tiền thuế VAT quy đổi = VATAmountOC * ExchangeRate decimal Yes
SortOrder số thứ tự int Yes
SortOrderView số thứ tự hiển thị(lưu ý: đối với hàng hóa InventoryItemType:3,4 thì SortOrderView:null int Yes

7. Lưu ý khi truyền đối tượng Einvoice

  • trường OrganizationUnitID lấy value ở respone được trả về trong api lấy token

  • trường CompanyID lấy value ở respone được trả về trong api lấy token
  • trường UserID lấy value ở respone được trả về trong api lấy token
  • trường InvoiceTemplateID lấy value ở respone được trả về trong api lấy mẫu hóa đơn