Đẩy VÉ ĐIỆN TỬ

1. Link API


tdhttps://testapp.meinvoice.vn/api/v2/v3ticket/temp</td
Tên Phương thức Url
Môi trường test không mã post
Môi trường test có mã post https://testapp.meinvoice.vn/api/v2/v3ticket/temp/code
Môi trường chính thức không mã post https://app.meinvoice.vn/api/v2/v3ticket/temp
Môi trường chính thức có mã post https://app.meinvoice.vn/api/v2/v3ticket/temp/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/v3ticket/temp

Header

TaxCode: 2222222222-486
Content-Type: application/json
Authorization: Bearer Z6nsSKIyYeHnzpjnUanfGXzX5K0OsXGTp-viuQfhoOcq832PnbsJjyk3iiYOtgFwBJQmI0GA7bRXjpdB6Vb9QGyz09IPZqEjj_mWUDmNslFYwLq7z741wdqcwFCELSk-eKPFqItZsve4Qr3bZkgKh2F7nJ68gn7zJ2hcwx8CzUzJVknEBQBRWtLwQ8HErmPXnBp719GSv6pfwmHVkde0SYQbDNQzCWIvTHGF8sUC2X9AFUbvCw4nRT8mp2ZYWAQpL20-TqOvIX52DPuux1T_xIRFE7NC-zESEqQVDkTOA9doMRWiiFZkYHZ2odVsC3jWuaaDTDRAczlzK8jRNEGCu0CtlblCj2ggAR6ViLfbENwkNCL_kyGtPYMLjjtk_hBLGc6yI7HhFn_LqZVXl1p9I1E-QcEnc-JKNygLfplBDbAJZTXlOHcvws9jajRzLcDzvAY0hNLIdJAvEbXKGGaqaFnQHhHV1eE4MmgdmjKKGtEihv7RLkLNTag2WKLit5_oNE9_npQwEo6KBHCO3OIdFh9h9ukEOxAEvjTP8_EK1pFYqZBzNFiur8Qz0G4fb8h8TZykmzwrSsBoKHDRuqCDVRZE0TzUpGW5oub1UHEae0ynyu2-c2NY5WvJ5k1Rw3mSxgC84Os1OiqAfwGjox4SMOg7OXw7Ncx_RFN4ABAlD0iWPAtcWTGmTZFGU8sGPQZw6KlR-0Y2-H_dHWh6ZNQ3Yce1IHAqE7ZQBrp-Xe_6IoC2zqVxSrJiXGdqNBJ9fBJHjz-vMIA-D9nv73Xwm0uJmxp1v-3glf_r6gvuazeqrdPWwvnZuIok1e55I3X75ymodwwkqizKWYeA6mzUI94zeypj_QQ0tKENR_Q3TJwJZu8slqX3NvzMRf-fgpaL44xtAT0ofNDNAXe53AFIutNOaV2yuBcYCkTZmC0RgpzSVm3hxvNPHbWTEPUQT7eDCuXCuT-AmffGqVWekDsGHfRBQhtj0S2aZQxjjcw9-23gx8zNwDLdh__p1fh2LJup13uEUDMfP1d7WgXTkefQ7bbe3F4xEHOhV9mUsmcCiCfol2HK-NrIdhurFoMDrRzACBAqLUPHmRZ_-gN9Vt0br2gw1RCZOi9NGD9cIPNDBRUbdcig_6BcQHh4Ae-5Y1JdJz0j7HMpYz0Ol1gaS_X8FSuK0qg9YDTTUOodJpEIzs-uOfx55_vO6Yi8nN1kuuPhjakqHnTUiyPwi5SdQk3pNzolxXjCN1kVZLNvETPEebGDpQh7rVD1XdE1E8QMIMp4rHOf0A5CQV4b-cnNcifvNviP6gj5wuxo5K3PpsTEqyYGYsrgnW5VVOZEvPfSKpxshjz44gOgIinMOoVT2ft4-matIx6LvVsAc9ib2_KnCxfHEJzj-7Ly0X0Fc_jfn5rZyWEzZmQJzqzzOP4S2YKm74t3Y8wyEbpfOSCwudme9xUn5Tn6Ga2lJc4XAJE27CiEpxNwqYngrgqQdR9KwFfT2DsjRKA5ugEa0lycjL_HCq1EXCYnenoE2CXSLTT4thS9hNn-g6lILV0RhZxu2P5IxXJTR1AhW0-IHr5rmfKaSKouGptGCDYGOPJa-HguTz61sHcVQjF9k8vtsgdJw_0K6T5hhju6Q1TUyvl7J-GXiQ6yj0rS8OYwIDwPcLNjfOBj1oiRH1g-ACjGVMPk3auDSzISfpIXpnIHHajqrzguSReGqGfc5rEoHB3oF6k7TbflrXuy3zh_cOS8RJw0gynFO1dJ_PLbEBofIEqRL3P61k10Ys39IN1zw1Z44NyCpdyIqfBTchZwCUoKRKQHWDwB12v2CWoqW1ClkrS-RLWvCbx8k-Y4z99STLNISTLFr8fPCV-KP_ZofjKOQf4PlNjaBELWKMu-dFniHQm08P--oTBoKJvMi0IvQhWzrSoeQDXgSDcJtsmKaPTMaz3X0thctY4pi9A5t_crM2kY0w3tEzWKdXgHkyZggxJWJ3s6N7NGuVdYCBCE673iJDGHKNmGF0G83stLQ8_Pz2ZKbBvjcX9Ov9puNzC9mNWdF2vsuEiTVgCf42ZjmaVi1u1GEKujfNajm-BiyTRRQB_XOozhs2S2PRPsgaJ6NJ1blnFRSQ3TaRi_iZWvBqN1KkQJNFKUIf4A6-mfXBbGgE9Vo6ClzJpNBG0F6EsprRaAeNTbW7fkTM86Xo8fgnYjw5n0hZQ8L2cYSuf2FLbuAPKpUhf0qIJ0ChZB2EFh5Fzp-_3_AjaVHdY1WKDhHwRIR3LTAOXl1YeqLBcTVoJAZMGeX20yeGKqlP1hZJ18Gn2SYl0XLPb_y5wAmZ4hKkIcrHwqQmZ-enYg6Xg8yJLqEf4vuZgLEdO7q6Q6vIaEwFk8OFwtYr4ACmzQRjdx5ZJUQHm9JcjXF0kvAlFuuyTzyc9Ztp2ZzAAPuFsSS8frDHk4sAMez5DSV4xnBNXwVYxdo6v5nfhDCzeJmv1z978mSRemBbeFgNEDAbljPuqQTDMRSI4-oIvuSk9QbNtEzuuESe4ctIQwEL60Hm0M_5FwVyCpETTGVEPbLUEyaq-lZMqfAaozXZAmJiT7WUN__1zZbcD08kb5_e3XPWQCnrU-r23BYnr2Gn7G-qyVtHXVapRD30cyajZDxLylRezu2HguYcyfnzvKnQdWSiLkWFwRXry7IjLA7488eR1i73da3huGfTRlZYelfEfJAHKm5NMbluTD59x9SjTxSm-zDDSq08nI7qpxeBpaAmzmKzmCa_24dSVEFywktLlengncskbGPPBgwR9rrTZVNvp652KBik5Fj5qvealpzHn-g8mkS8OklCuCVs1HckBzpqQ4mc2KDGb6N4KzD6eqQ7BvxJIBgulezYCHR2PaMaOSUM5Ef9Zfuywy4fbU_BYK4xqVM-6nReHCCjAPRJaIOTkhj1t3gEqN0Qi4qHWeBrXBU2-UDvBSKeWJKRGL0kFfH-1UZ1QpzakC90naqrnfCgMMJ_-fk3zf3zkb9aq4l9YOqvVehAs11hFDLs5phigEDGqSLznAj71B_yEplAkEL-D9p1bvRek1TrtE41JMIBatWtrRzdg0F87qVF4snd2CzPQL6oSxFXOi8UKzRTg7d7ltNPdU-U5naodPaqjnU2E

Body

[
{
    "RefID": "3fde88b2-3943-50e4-7802-cc98a93d1b44",
    "Quantity": 1,
    "InvDate": "2022-07-12T10:28:34.401Z",
    "TicketName": "Vé dịch vụ vận tải không in sẵn mệnh giá",
    "InvTemplateNo": "5",
    "InvSeries": "5K22GYY",
    "IsDefault": false,
    "TicketTemplateID": "6deaa0d1-575b-4563-9d96-c13ae98e5d8b",
    "TemplateType": 1,
    "TicketType": 2,
    "CreatedBy": "c8e459a1-33ef-4247-8a83-48bb552eef1f",
    "IssueBy": "misa test",
    "CreatedDate": "2022-07-12T10:28:34.401Z",
    "DeclarationType": 0,
    "TicketStatus": 1,
    "ServiceName": "Vé Tàu",
    "TicketSummaryStatus": -1,
    "SendToTaxStatus": 0,
    "VATRate": 10,
    "VATAmount": 9091,
    "Amount": 100000,
    "AmountWithoutVAT": 90909,
    "IsTaxReduction43": false,
    "AmountWithoutReduceVAT": 0,
    "IsMultiRoadPath": true,
    "Route": "SA KỲ - LÝ SƠN",
    "Destination": "LÝ SƠN",
    "From": "SA KỲ",
    "IsConfirmIncrease": false,
    "CustomData": "{}",
    "DepatureDate": "2022-07-12T00:00:00.000Z",
    "DepatureTime": "10:00",
    "VehicleNo": "SUPER BIEN DONG 1",
    "Seat": "A1"
}
]

respone

{
"SerializeConfig": null,
"data": "[{\"RefID\":\"3fde88b2-3943-50e4-7802-cc98a93d1b44\",\"Success\":true,\"ErrorMessage\":null}]",
"newdata": "",
"dataError": null,
"success": true,
"recordsTotal": 0,
"recordsFiltered": 0,
"content": null,
"error": null,
"dataAdditional": null,
"errorCode": []
}

6. Mô tả đối tượng Einvoice

Mô tả đối tượng được liệt kê trong link này:

https://testapp.meinvoice.vn/api/v2/Description/Entity/EInvoice.html

6. 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
  • đối với đẩy lần đầu (insert) thì EditVersion = 0 đối với lần 2(update) EditVersion += 1
  • đối với vé điện tử thêm các trường sau: "TicketType": 2(tùy kiểu vé),"TicketStatus": 1