Common
Controller quản lý một số
| API | Description |
|---|---|
| GET iptemplate/thumbnail?ipTemplateID={ipTemplateID}&templateType={templateType}&modifiedDate={modifiedDate} |
Lấy mẫu hóa đơn view dạng ảnh |
| GET einvoice/preview?refId={refId} |
Xem hóa đơn |
| GET einvoice/previewsync?refId={refId} |
Xem hóa đơn |
| GET company/get |
Method tra ve thong tin Compnay |
| GET company/info |
Method tra ve thong tin Compnay của web |
| GET user/getcurent |
Method trả về thông tin người dùng hiện tại |
| GET locationtax/get |
Method tra ve danh sach co quan thue |
| GET resource/getcurent |
Method trả về thông tin tài nguyên |
| GET resource/GetTotalUsedInvoiceQuantityByInvTemplate?invTemplateNo={invTemplateNo}&invSeries={invSeries} |
Method trả về thông tin số lượng hóa đơn còn lại |
| GET bank/get |
Lấy toàn bộ danh sách ngân hàng |
| POST Common/SaveMisaESignSetting |
Lưu thiết lập ký số nếu pass validate |
| POST Common/GetSatisfaction |
Lấy dữ liệu Khảo sát độ hài lòng của khách hàng |
| POST Common/GetSatisfactionActive |
Show form khảo sát khi KH chủ động nhấn |
| POST Common/UpdateServey |
Lưu dữ liệu Khảo sát độ hài lòng của khách hàng |
| POST Common/GetTokenForUpdate |
Lấy token cho việc submit độ hài lòng của KH |
| POST Common/SubmitSurvey |
No documentation available. |
| GET Common/GetSurveySubmit?idUser={idUser} |
lấy dữ liệu từ mysql bên mình để xem nó đã được người dùng hủy bỏ hay chưa |
V3Invoice
Xử lý các nghiệp vụ chung hóa đơn/PXK
Customer
Controller quản lý danh mục khách hàng
| API | Description |
|---|---|
| GET customer/tt86/lastest?taxCode={taxCode} |
lấy thông tin khách hàng từ org TT86 |
| GET customer/tt86?taxCode={taxCode} |
lấy thông tin khách hàng từ org TT86 |
V3Template
Controller quản lý các nghiệp vụ liên quan mẫu hóa đơn
V3ApproveInvoice
quản troller quản lý quy trình phê duyệt hoa đơn
PetrolInvoice
| API | Description |
|---|---|
| POST petrolinvoice |
Thêm một hóa đơn mới từ hệ thống HĐ xăng dầu |
Ticket
Controller quản lý API cho vé
Invoice
API Invoice
V3InvoiceRegistration
Controller quản lý các nghiệp vụ liên quan mẫu hóa đơn
| API | Description |
|---|---|
| GET v3invoiceregistration/checkexists?deviceDate={deviceDate} |
Kiểm tra có mẫu tờ khai nào được lập, gửi CQT và được chấp nhận chưa |
| GET v3invoiceregistration/lastest |
Lấy tờ khai mới nhất, đã được CQT chấp thuận |
V3Receipt
Controller quản lý biên lai
Receipt
Controller quản lý biên lai
V3Common
Controller tiện ích dành cho api web v3
| API | Description |
|---|---|
| POST v3common/template |
Lấy danh sách mẫu hóa đơn phục vụ tạo hóa đơn |
| POST code/v3common/template |
Lấy danh sách mẫu hóa đơn phục vụ tạo hóa đơn |
| POST v3common/code/template |
Lấy danh sách mẫu hóa đơn phục vụ tạo hóa đơn |
V3SAInvoice
Controller quản lý các nghiệp vụ hóa đơn v3 trước khi phát hành
Template
controller mẫu hóa đơn ND51
| API | Description |
|---|---|
| GET template/permission/inv-templateno-series?isTicket={isTicket} |
lấy danh sách mẫu số ký hiệu vé user quyền sử dụng tại ND51 |
AccountObject
Controller quản lý khách hàng
| API | Description |
|---|---|
| GET accountobject?skip={skip}&take={take}&accountObjectType={accountObjectType} | |
| GET AccountObject/Get?start={start}&length={length}&sort={sort}&accountObjectType={accountObjectType}&filter={filter}&whereClause={whereClause}&inactive={inactive} |
Method lấy danh sách khách hàng theo các điều kiện (phân trang, lọc) |
| GET AccountObject/Get/{id} |
Method lấy KH theo ID |
| GET AccountObject/GetByListId?listId={listId} |
Lấy thông tin KH theo danh sách ID |
| POST AccountObject/Insert |
Method thêm KH |
| POST AccountObject/SyschronizeAccountObject |
Method đồng bộ dữ liệu thông tin khách hàng |
| POST AccountObject/Update |
Method cập nhật KH |
| DELETE AccountObject/Delete/{id} |
Method xóa một KH |
| DELETE AccountObject/Delete |
Method xóa danh sách khách hàng. Trả về danh sách các id lỗi kèm thông báo lỗi |
| GET AccountObject/GetNewCode |
Lấy mã tự tăng khách hàng |
Dictionary
Controller quản lý các danh mục
| API | Description |
|---|---|
| GET Dictionary/GetRouteByCompany?companyID={companyID} |
Lấy danh sách tuyến đường theo company id |
| GET Dictionary/RouteDetailByID?id={id} |
Lấy ra bản ghi tuyến đường |
| POST Dictionary/Delete |
Api cho phép xóa các danh mục |
| GET Dictionary/GetListTemplate?invoiceType={invoiceType} |
Lấy danh sách mẫu hóa đơn được phân quyền |
| GET Dictionary/GetTemplateByInvNo?invTemplateNo={invTemplateNo} |
Lấy mẫu qua Mẫu số |
| GET Dictionary/GetListFeeByCompanyID?mode={mode}&feeCode={feeCode} |
Lấy dữ liệu cho combo tree biên lai |
System
Controller quản lý các thông tin, cấu hình chung của hệ thống
| API | Description |
|---|---|
| PUT system/typeinvoice/{typeInvoice} |
cập nhập loại hóa đơn sử dụng |
| GET system/permistion/issue-ticket/usernames |
Lấy danh sách user name có quyền sử dụng vé |
| GET system/permistion/issue-receipt/usernames |
Lấy danh sách user name có quyền sử dụng vé |
| GET System/GetCompany |
Method tra ve thong tin Compnay |
| GET System/GetUserOptionByID?optionID={optionID} |
Lấy cấu hình userConfig |
| GET System/GetListPermission |
Lấy danh sách quyền theo user |
| GET System/GetListPermissionV2 |
Lấy danh sách quyền theo user app xanh - biên lai |
| POST System/GetListCustomField?typeExtend={typeExtend} |
lấy danh sách trường mở rộng theo công ty |
| POST System/GetNumberFormatOption?isDecree={isDecree} |
Lấy dữ liệu thiết lập định dạng số |
| GET System/GetAllApproveProcess |
get danh sách quy trình phê duyệt |
GraphApi
| API | Description |
|---|---|
| POST api/graph/push_data_to_meinvoice |
No documentation available. |
ApproveInvoice
Phê duyệt hóa đơn
| API | Description |
|---|---|
| GET approveinvoice/list?fromDate={fromDate}&toDate={toDate}&start={start}&length={length}&lstOrganizationUnit={lstOrganizationUnit}&invTemplate={invTemplate}&searchKey={searchKey}&invoiceStatus={invoiceStatus}&paymentStatus={paymentStatus} |
Lấy phân trang danh sách hóa đơn phê duyệt |
| POST approveinvoice/update?isApprove={isApprove} |
Update trạng thái phê duyệt |
| GET approveinvoice/haseinvoice |
kiểm tra có hóa đơn nào chưa phát hành trong quy trình phê duyệt đang dk sử dụng ko hthuyen(17.06.20121) |
| GET approveinvoice/history?id={id} |
Lấy lịch sử phê duyệt |
| GET approveinvoice/organizationunits |
Lấy danh sách đơn vị lập hóa đơn mà user đang đăng nhập có quyền phê duyệt |
| GET approveinvoice/templatenoandseries |
Lấy danh sách MS-KH mà user được thiết lập ở các quy trình |
| POST approveinvoice/permissionbyuserid?id={id} |
Lấy danh sách permission được thiết lập cho User có UserID = id |
| GET approveinvoice/count |
Lấy số lượng hóa đơn đang chờ duyệt của User đang đăng nhập |
Fee
Controller quản lý phí
| API | Description |
|---|---|
| GET fee |
Lấy danh sách phí |
UnAuthorize
Lớp thò ra để unauthor
| API | Description |
|---|---|
| POST authen/savetoken |
api để lưu tại token vào cache phục vụ cho pass login |
Account
| API | Description |
|---|---|
| POST account/login/1 |
Login step 1 - Submit |
| POST account/active/1 |
No documentation available. |
| POST account/ConfirmActiveAccount?userName={userName}&code={code} |
Kích hoạt tài khoản MisaId |
| POST account/ActiveMisaIDByEmail?email={email}&userName={userName} |
Kích hoạt tài khoản MisaId bằng email |
| POST account/login/authenotp2?value={value} |
API gửi lại mã xác nhận khi chọn lại cách nhận OTP |
V3System
Controller quản lý các thông tin, cấu hình chung của hệ thống
| API | Description |
|---|---|
| GET v3system/appconfig |
lấy cấu hình app (circullarFollow, isWithCode) |
| GET v3system/serverdate |
lấy ngày server |
| GET v3system/getresourceticketdata |
Lấy về tài nguyên vé createdBy nmquang2 31/08/2022 |
| GET v3system/getresourceinvoicedata |
Lấy về tài nguyên hóa đơn createdBy nmquang2 31/08/2022 |
| GET v3system/getallresource |
Lấy về tài nguyên hóa đơn createdBy nmquang2 31/08/2022 |
| GET v3system/sign-config |
Lấy danh sách thiết lập ký số |
| POST v3system/loyalty/generateLink |
Sinh link tính thưởng từ MISA ID |
| GET v3system/misaid/accessToken |
Lấy MISA ID Access Token |
| GET v3system/misaid/refreshAccessToken |
Refresh lại và lấy MISA ID Access Token |
| GET v3system/config?optionID={optionID} |
Lấy system config by optionID |
| POST viettel/login?userID={userID} |
Lấy token ký ViettelMysign |
| POST viettel/csc/credentials?userID={userID} |
lấy list credential id của Viettel Mysign hanghiep 17/09/2025 |
| POST system/viettel-mysign-setting?isStart={isStart} |
Thực hiện lưu thiết lập Viettel mysign hanghiep 17/09/2025 |
V3Report
Controller quản lý hóa đơn v3
| API | Description |
|---|---|
| POST v3report/ipusedamount/paging |
Lay bảng kê hóa đơn đã phát hành báo cáo>bảng kê hóa đơn đã sử dụng. |
| POST v3report/ticketusedamount/paging |
lấy dữ liệu bảng kê vé đã phát hành |
| POST v3report/ipsuminventoryitemamount |
báo cáo hóa đơn xd theo mặt hàng |
| GET v3report/inventoryitem/publish |
Lấy danh sách vật tư đã phát sinh hóa đơn |
V3Email
Xử lý gửi mail
| API | Description |
|---|---|
| POST v3email/invoice/data |
Lấy dữ liệu bind lên danh sách gửi mail |
| POST v3email/invoice/send?sendMultiType={sendMultiType} |
gửi email hóa đơn đã phát hành |
| POST v3email/ticket/send?sendMultiType={sendMultiType} |
Gửi vé đã xuất |
| POST v3email/ticket/cancelvoucher/send |
Gửi thông báo hủy vé |
CashRegisterInvoice
V3Ticket
Controller quản lý vé
V3Outward
Controller quản lý phiếu xuất v3 trước khi phát hành
| API | Description |
|---|---|
| GET v3outward/paging?start={start}&length={length}&sort={sort}&fromDate={fromDate}&toDate={toDate}&publishStatus={publishStatus}&sendToTaxStatus={sendToTaxStatus}&sendInvoiceStatus={sendInvoiceStatus}&invoiceStatus={invoiceStatus}&paymentStatus={paymentStatus}&approveStatus={approveStatus}&searchKey={searchKey} |
Get danh sách hóa đơn |
| GET v3outward/code/paging?start={start}&length={length}&sort={sort}&fromDate={fromDate}&toDate={toDate}&publishStatus={publishStatus}&sendInvoiceStatus={sendInvoiceStatus}&invoiceStatus={invoiceStatus}&paymentStatus={paymentStatus}&approveStatus={approveStatus}&searchKey={searchKey} |
Get danh sách hóa đơn có mã |
| GET v3outward/code/{refID} |
Lấy hóa đơn có mã |
| GET v3outward/{refID} |
Lấy hóa đơn |
| POST v3outward/code |
Insert hóa đơn có mã |
| PUT v3outward/code |
update hóa đơn có mã |
| DELETE v3outward/{refID} |
Xóa hóa đơn |
| DELETE v3outward/code/{refID} |
Xóa hóa đơn có mã |
| POST v3outward |
Insert hóa đơn |
| PUT v3outward |
update hóa đơn |
CashRegisterTicket
| API | Description |
|---|---|
| POST cashregisterticket/paging?start={start}&length={length}&sort={sort}&fromDate={fromDate}&toDate={toDate}&publishStatus={publishStatus}&sendToTaxStatus={sendToTaxStatus}&sendInvoiceStatus={sendInvoiceStatus}&invoiceStatus={invoiceStatus}&paymentStatus={paymentStatus}&approveStatus={approveStatus}&searchKey={searchKey} |
lấy danh sách hóa đơn từ mtt |
| POST cashregisterticket/publish/multi |
Phát hành hóa đơn máy tính tiền |
| POST cashregisterticket/publish |
Phát hành hóa đơn máy tính tiền |
V3Dashboard
Controller quản lý hóa đơn v3
| API | Description |
|---|---|
| GET v3dashboard/getusingstate |
Lấy giá trị hđ phát hành, số hđ đã ph, tổng số hóa đơn đã sử dụng, tông số hóa đơn còn lại |
| GET v3dashboard/getusingstateV2?fromDate={fromDate}&toDate={toDate} |
Lấy giá trị hđ phát hành, số hđ đã ph |
| GET v3dashboard/getchartdata/{category} |
Lấy giá trị hđ phát hành, số hđ đã ph, tổng số hóa đơn đã sử dụng, tông số hóa đơn còn lại |
| GET v3dashboard/getinvoicequantitybystatus |
Lấy thông kê số lượng hóa đơn theo từng loại trạng thái |
Report
Api gọi báo cáo hóa đơn
| API | Description |
|---|---|
| POST Report/GetIPUsedAmount |
Lay bảng kê hóa đơn đã phát hành báo cáo>bảng kê hóa đơn đã sử dụng. |
| POST Report/GetIPUsedAmountDetail |
Lay danh sach chi tiết hoá đơn đã phát hành Báo cáo>bảng kê chi tiếp hóa đơn đã sử dụng. |
| GET Report/test |
Lấy danh sách mẫu |
| GET Report/GetListInvTemplateNoAndInvSeries |
Lay danh sach hoá đơn đã phát hành |
| GET Report/ShowInvoiceByTranstionID?transtionID={transtionID} |
Hàm sinh link tra cứu hóa đơn |
SAInvoice
Controller quản lý danh sách hóa đơn
LicenseAndPrivacy
| API | Description |
|---|---|
| GET LicenseAndPrivacy/GetAgreementMisaIdAsyncAccept?misaIDKey={misaIDKey}&phoneNumber={phoneNumber}&email={email}&privacyID={privacyID}&termsOfServiceID={termsOfServiceID}&deviceName={deviceName}&osName={osName} |
Cập nhật trạng thái đã chấp nhận chính sách quyền riêng tư / Thỏa thuận sử dụng PM |
| GET LicenseAndPrivacy/GetAgreementMisaIdAsyncHistory?misaIDKey={misaIDKey}&phoneNumber={phoneNumber}&email={email}&agreementType={agreementType} |
Lấy thông tin thỏa thuận dịch vụ / chính sách người dùng đã xác nhận gần nhất |
| GET LicenseAndPrivacy/GetAgreementMisaIdAsyncByUser?misaIDKey={misaIDKey}&phoneNumber={phoneNumber}&email={email} |
Lấy nội dung thỏa thuận dịch vụ và chính sách theo người dùng đăng nhập |
| GET LicenseAndPrivacy/GetAgreementMisaIdAsync?agreementType={agreementType} |
Lấy nội dung thỏa thuận dịch vụ và chính sách mới nhất |
User
Controller quản lý người dùng
| API | Description |
|---|---|
| GET User/Get?filter={filter} |
Method lấy danh sách người dùng |
| GET User/Get/{id} |
Method lấy người dùng theo ID |
| POST User/Insert |
Method thêm người dùng |
| POST User/Update |
Method cập nhật người dùng |
| DELETE User/Delete/{id} |
Method xóa người dùng theo ID |
| DELETE User/Delete |
Method xóa danh sách người dùng. Trả về danh sách người dùng xóa bị lỗi kèm thông báo |
| GET User/AnOtherWay?userName={userName} |
lấy danh sách cách khác có thể nhận OTP |
| GET User/AuthenticationOTPV2?value={value} |
API gửi lại mã xác nhận khi chọn lại cách nhận OTP |
Other
controller other
| API | Description |
|---|---|
| GET Other/GetCompanyInfoByTaxCodeV3?taxCode={taxCode} |
Lấy giá trị hđ phát hành, số hđ đã ph, tổng số hóa đơn đã sử dụng, tông số hóa đơn còn lại |
| POST Other/WriteLogElkToServer |
Lưu log elk |
Notification
Controller quản lý thông báo
| API | Description |
|---|---|
| GET Notification/GetNotification?start={start}&limit={limit} |
Method trả về danh sách thông báo |
| GET Notification/GetNewNotificationNumber |
Method trả về số lượng thông báo mới |
| POST Notification/UpdateNotificationReadStatus?notifyId={notifyId} | |
| POST Notification/InsertMobileDeviceInfo |
Thêm thông tin thiết bị mobile |
| DELETE Notification/DeleteDeviceInfo?deviceTokenID={deviceTokenID} |
Xóa thiết bị mobile |
| DELETE Notification/DeleteDevice?deviceTokenId={deviceTokenId} |
Xóa thiết bị mobile |
| GET Notification/GetUnreadCount |
Lấy số lượng thông báo chưa đọc |
| POST Notification/SetReadAllNotification |
Update đã đọc cho toàn bộ thông báo |
V3ReceiptRegistration
| API | Description |
|---|---|
| GET V3ReceiptRegistration/GetLastestGrantedRegistration |
Lấy tờ khai mới nhất, đã được CQT chấp thuận |
InventoryItem
Controller quản lý hàng hóa/dịch vụ
| API | Description |
|---|---|
| GET InventoryItem/Get?start={start}&length={length}&sort={sort}&filter={filter}&whereClause={whereClause}&inactive={inactive} |
Method lấy danh sách HH/DV |
| GET InventoryItem/Get/{id} |
Method lấy HH/DV theo id |
| POST InventoryItem/Insert |
Method thêm HH/DV |
| POST InventoryItem/SyschronizeInventoryItem |
Method đồng bộ dữ liệu thông tin khách hàng |
| POST InventoryItem/Update |
Method cập nhật HH/DV |
| DELETE InventoryItem/Delete/{id} |
Method xóa HH/DV |
| DELETE InventoryItem/Delete |
Method xóa danh sách HH/DV. Trả về danh sách các HH/DV xóa bị lỗi kèm thông báo |
| GET InventoryItem/GetNewCode |
Lấy mã tự tăng khách hàng |
| POST InventoryItem/GetUnitPriceChangesHistory |
Lấy danh sách lịch sử thay đổi đơn giá |
Dashboard
Controller quản lý các màn hình báo cáo, dashboard
| API | Description |
|---|---|
| GET Dashboard/GetStatusInvoice |
Lấy danh sách trạng thái hóa đơn |
| GET Dashboard/GetInvoiceDataForChart?categoryValue={categoryValue} |
Method lấy tình hình sử dụng hóa đơn theo thời gian |
| GET Dashboard/GetInvoicePublishSendingStatus |
Lấy thông kế số lượng hóa đơn theo từng loại |
IPPublish
Controller thông báo phát hành hóa đơn
| API | Description |
|---|---|
| GET IPPublish/Get |
Method lấy danh sách mẫu hóa đơn đã đăng ký phát hành |
V3AVA
Xử lý các request liên quan kết nối AVA Platform
| API | Description |
|---|---|
| POST V3AVA/V3AVAConnect?force={force} |
Kết nối đến AVA Platform để lấy thông tin token và cấu hình |