Tài liệu Open API tích hợp Hóa đơn điện tử MISA meInvoice (Đầu vào)

-BaseURL: https://testapp.meinvoice.vn/

-BaseURL2: https://testapi.meinvoice.vn/api2

Trên môi trường chính thức:

– BaseURL: https://app.meinvoice.vn/

– BaseURL2: https://api.meinvoice.vn/api2

Xem tại đây

CompanyTaxCode: Mã số thuế đăng ký dịch vụ HĐĐT MeInvoice.vn

UserName: Tên đăng nhập tài khoản dịch vụ HĐĐT

    “Success“: true,

    “ErrorCode“: “”,<mã lỗi nếu có>

    “Errors“: “[<Danh sách danh mục trả về>]”,

    “Data“: “CompanyID; securetoken“,

    “CustomData“: “{Thông tin User trả về}”,

}

Lưu ý:

Lấy đúng dữ liệu là securetoken

–header ‘AppID: xxxxxbe96-ab02-4d9c-b995-45d86a0b54e1’ \

–header ‘CompanyTaxCode: 0101243xxx’ \

–header ‘UserName: [email protected]’ \

–header ‘Content-Type: application/json’ \

–data ‘{“PassWord”:”12345xxx”}’

CompanyTaxCode: Mã số thuế đăng ký dịch vụ HĐĐT MeInvoice.vn

UserName: Tên đăng nhập tài khoản dịch vụ HĐĐT

securetoken: Lấy từ kết quả ở API “2.1 Lấy chuỗi Securetoken”

    “Success“: true,

    “ErrorCode“: “”,<mã lỗi nếu có>

    “Message“: “[<Danh sách danh mục trả về>]”,

    “Data“: “Đối tượng JWTToken“,

}

JWTToken = Data.AccessToken

–header ‘AppID: xxxxxbe96-ab02-4d9c-b995-45d86a0b54e1’ \

–header ‘CompanyTaxCode: 0101243xxx’ \

–header ‘UserName: [email protected]’ \

–header ‘securetoken: ExxxxxA7u8aPJw+qIWNnzf1YnS/3lk2fsVdACibvv8TajbBG2mGIZbcNcOfqXC3wU3ZmKrvgy4+Q2bWi6xHld/mte+eOPi2GrvVaju+5ps=’ \

CompanyTaxCode: Mã số thuế đăng ký dịch vụ HĐĐT MeInvoice.vn

UserName: Tên đăng nhập tài khoản dịch vụ HĐĐT

securetoken: Lấy từ kết quả ở API “2.1 Lấy chuỗi Securetoken”

    “Success“: true,

    “Message“: “Tin nhắn trả về nếu có lỗi”,

    “Data“: “Đối tượng Subscribers“,

}

SubscribersID = Data.Id

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

subscribersID lấy ở bước 3

Authorization: {TokenType} {AccessToken} (thông tin lấy từ  JWTToken)

    “Success“: true,

    “Message“: “Tin nhắn trả về nếu có lỗi”,

    “Data“: “Đối tượng Subscribers“,

}

SubscribersID = Data.Id

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

–header ‘Authorization: Bearer xxxxxbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySWQiOiI1NzY2NGEwNy0zYmFjLTRjNmYtYWIxOS0wNzQzNDU1YzA0MzciLCJNaXNhSWQiOiJhOTFmMDc4MS0zMTc3LTQ2YWYtYjliYi1mMWI5ZWY3NjcyMjgiLCJQaG9uZU51bWJlciI6IjA5NzE1MDA3MzEiLCJFbWFpbCI6InRlc3RtaXNhQHlhaG9vLmNvbSIsIkZpcnN0TmFtZSI6Im1pc2EiLCJMYXN0TmFtZSI6InRlc3QiLCJqdGkiOiIxYTc0YjMwNS0wZmZhLTRkOGUtYTg0Mi1mY2Q0YmJkNjFhOTciLCJleHAiOjE4MDgxMjI1NTEsImlzcyI6Imh0dHBzOi8vbWVpbnZvaWNlLnZuIiwiYXVkIjoiaHR0cHM6Ly9tZWludm9pY2Uudm4ifQ.2XPHx35TmpBoH9FAA2W-4TopYQ441wG7BOTBuPefrDU’ \

Authorization: {TokenType} {AccessToken} (thông tin lấy từ  JWTToken)

to: thời gian kết thúc

take: số lượng lấy (tối đa 100, mặc định 20)

skip: số lượng bỏ qua (mặc định 0)

IsFilterInvDate: 

True: lọc theo ngày hóa đơn, lấy tất cả hóa đơn trong khoảng thời gian

False: Lọc theo trạng thái hóa đơn bị thay đổi trong khoảng thời gian

Mặc định: false

    “Success“: true,

    “Message“: “Tin nhắn trả về nếu có lỗi”,

    “Data“: [“Total, Data “],

    “Other“: “Thông tin khác về tài nguyên”,

}

(Xem mô tả đối tượng tại đây)

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

–header ‘Authorization: Bearer xxxxxbGciOiJIUzI1NiIsInmJkNjFhOTciLCJleHAiOjE4MDgxMjI1NTEsImlzcyI6Imh0dHBzOi8vbWVpbnZvaWNlLnZuIiwiYXVkIjoiaHR0cHM6Ly9tZWludm9pY2Uudm4ifQ.2XPHx35TmpBoH9FAA2W-4TopYQ441wG7BOTBuPefrDU’ \

Authorization: {TokenType} {AccessToken} (thông tin lấy từ  JWTToken)

    “Success“: true,

    “Message“: “Tin nhắn trả về nếu có lỗi”,

    “Data“: [“Total, Data “],

}

(Xem mô tả đối tượng tại đây)

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

–header ‘Authorization: Bearer xxxxxbGciOiJIUzI1NiIsInR5cCIVpbnZvaWNlLnZuIn0.BocNRpV7PIh7zMuvVUUa03fON-pt80SKFah-tUWgNF0’ \

Authorization: {TokenType} {AccessToken} (thông tin lấy từ  JWTToken)

    “FileType“: 1,

    “LstInvID“: [“IdInvoice”]

}

FileType – Loại dữ liệu muốn tải

1: xml + pdf

2: pdf

3: xml

    “Success“: true,

    “Message“: “Tin nhắn trả về nếu có lỗi”,

    “Data“: [“Key”]

}

Sử dụng Key để thực hiện việc tải ở bước 2

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

–header ‘Authorization: Bearer xxxxxbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySWQiOiJlYTFhYTViOS0xMDdZXhwIjoxODA3NjkyOTM5LCJpc3MiOiJodHRwczovL21laW52b2ljZS52biIsImF1ZCI6Imh0dHBzOi8vbWVpbnZvaWNlLnZuIn0.BocNRpV7PIh7zMuvVUUa03fON-pt80SKFah-tUWgNF0’ \

–header ‘Content-Type: application/json’ \

–data ‘{

    “FileType”: 3,

    “LstInvID”: [

        “xxx1b5cb267b3fa0ea20409d”, “xxx1b5a8b30f65fb9a6976b6”, “xxx1b5a4267b3fa0ea204072”

    ]

}’

Key lấy từ bước 1

Authorization: {TokenType} {AccessToken} 

(thông tin lấy từ  JWTToken)

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

–header ‘Authorization: Bearer xxxxxbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySWQiOiJlYTFhYTViOS0xMDdiLTQFuIiwianRpIjoiMDIzNzgwMWMtZWJjYi00MTAwLTkwZWUtNjJlNzhkOTFjZDFlIiwiZXhwIjoxODA3NjkyOTM5LCJpc3MiOiJodHRwczovL21laW52b2ljZS52biIsImF1ZCI6Imh0dHBzOi8vbWVpbnZvaWNlLnZuIn0.BocNRpV7PIh7zMuvVUUa03fON-pt80SKFah-tUWgNF0’ \

Authorization: {TokenType} {AccessToken} 

(thông tin lấy từ  JWTToken)

    “Accountant“: “người hạch toán”,

    “AccountingDate“: “ngày hạch toán”,

    “InvoiceId“: “id của hóa đơn”,

    “RefNo“: “số chứng từ hạch toán”

}

    “Success“: true,

    “Message“: “Tin nhắn trả về nếu có lỗi”,

    “Data“: “true/false”

}

Nếu muốn bỏ hạch toán chỉ cần truyền InvoiceID

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

–header ‘Authorization: Bearer xxxxxbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySWQiOiJlYTFhYTViOS0xMDdanRpIjoiMDIzNzgwMWMtZWJjYi00MTAwLTkwZWUtNjJlNzhkOTFjZDFlIiwiZXhwIjoxODA3NjkyOTM5LCJpc3MiOiJodHRwczovL21laW52b2ljZS52biIsImF1ZCI6Imh0dHBzOi8vbWVpbnZvaWNlLnZuIn0.BocNRpV7PIh7zMuvVUUa03fON-pt80SKFah-tUWgNF0’ \

–header ‘Content-Type: application/json’ \

–data ‘{

    “Accountant”: “”,

    “AccountingDate”: “”,

    “InvoiceId”: “xxx6b6140f522c2e36c634c2”, 

    “RefNo”: “”

}’

Authorization: {TokenType} {AccessToken} (thông tin lấy từ  JWTToken)

    “Success“: true,

    “Message“: “Tin nhắn trả về nếu có lỗi”,

    “Data“: “true/false”

}

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

–header ‘Authorization: Bearer xxxxxbGciOiJIiwiZXhwIjoxODA3NjkyOTM5LCJpc3MiOiJodHRwczovL21laW52b2ljZS52biIsImF1ZCI6Imh0dHBzOi8vbWVpbnZvaWNlLnZuIn0.BocNRpV7PIh7zMuvVUUa03fON-pt80SKFah-tUWgNF0’ \

–header ‘Content-Type: application/json’ \

–data ‘{

    “InvoiceId”: “xxx6b6140f522c2e36c634c2”, 

    “PaymentDate”: “2024/07/18”, 

    “PaymentPair”: “nxson”, 

    “TotalAmountPayment”: 100000, 

    “TotalAmountNotPayment”: 100001, 

    “NumberPaymentNext”: “”, 

    “AmountPayment”: 1 

}’

Xem tại đây (PaymentStatus)

Authorization: {TokenType} {AccessToken} (thông tin lấy từ  JWTToken)

to: thời gian kết thúc

take: số lượng lấy (tối đa 100, mặc định 20)

skip: số lượng bỏ qua (mặc định 0)

IsFilterInvDate: 

True: lọc theo ngày hóa đơn, lấy tất cả hóa đơn trong khoảng thời gian

False: Lọc theo trạng thái hóa đơn bị thay đổi trong khoảng thời gian

Mặc định: false

    “Success“: true,

    “Message“: “Tin nhắn trả về nếu có lỗi”,

    “Data“: [“Total, Data “],

    “Other“: “Thông tin khác về tài nguyên”,

}

(Xem mô tả đối tượng tại đây)

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

–header ‘Authorization: Bearer xxxxxbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySWQiOiI1NzY2NGEwNy0zYmFjLTRjNmYtYWIxOS0wNzQzNDU1YzA0MzciLCJNaXNhSWQiOiJhOTFmMDc4MS0zMTc3LTQ2YWYtYjliYi1mMWI5ZWY3NjcyMjgiLCJQaG9uZU51bWJlciI6IjA5NzE1MDA3MzEiLCJFbWFpbCI6InRlc3RtaXNhQHlhaG9vLmNvbSIsIkZpcnN0TmFtZSI6Im1pc2EiLCJMYXN0TmFtZSI6InRlc3QiLCJqdGkiOiIxYTc0YjMwNS0wZmZhLTRkOGUtYTg0Mi1mY2Q0YmJkNjFhOTciLCJleHAiOjE4MDgxMjI1NTEsImlzcyI6Imh0dHBzOi8vbWVpbnZvaWNlLnZuIiwiYXVkIjoiaHR0cHM6Ly9tZWludm9pY2Uudm4ifQ.2XPHx35TmpBoH9FAA2W-4TopYQ441wG7BOTBuPefrDU’ \

Authorization: {TokenType} {AccessToken} (thông tin lấy từ  JWTToken)

    “Success“: true,

    “Message“: “Tin nhắn trả về nếu có lỗi”,

    “Data“: [“Total, Data “],

}

(Xem mô tả đối tượng tại đây)

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

–header ‘Authorization: Bearer xxxxxbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySWQiOiJlYTFhYTViOS0xMDdiLTQxY2YtOTkzNS1mOGU3MGNlMWYyNWUiLCJNaXNhSWQiOiJmNWU4ZTY2Mi1iMjVhLTRiNDctOTZkYS01MmU5MTZmYTExYjQiLCJQaG9uZU51bWJlciI6IjA5MTUzMTQ3NDQiLCJFbWFpbCI6ImdpYW5na2UxNDk0QGdtYWlsLmNvbSIsIkZpcnN0TmFtZSI6IkdpYW5nIiwiTGFzdE5hbWUiOiJQaGFuIiwianRpIjoiMDIzNzgwMWMtZWJjYi00MTAwLTkwZWUtNjJlNzhkOTFjZDFlIiwiZXhwIjoxODA3NjkyOTM5LCJpc3MiOiJodHRwczovL21laW52b2ljZS52biIsImF1ZCI6Imh0dHBzOi8vbWVpbnZvaWNlLnZuIn0.BocNRpV7PIh7zMuvVUUa03fON-pt80SKFah-tUWgNF0’ \

Authorization: {TokenType} {AccessToken} (thông tin lấy từ  JWTToken)

take: Số lượng chứng từ bỏ qua (Mặc định: 0)

    “Success“: true,

    “Message“: “Tin nhắn trả về nếu có lỗi”,

    “Data“: [“Dữ liệu trả về”]

}

Data

Danh sách nhà cung cấp

(Xem mô tả đối tượng tại đây)

Total: tổng số nhà cung cấp lấy được

Data: Danh sách chi tiết nhà cung cấp

–header ‘ClientId: xxxxx2b7110e8a16cffa2222’ \

–header ‘Authorization: Bearer xxxxxbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVc2VySWQiOiJlYTFhYTViOS0xMDdiLTQxY2YtOTkzNS1mOGU3MGNlMWYyNWUiLCJNaXNhSWQiOiJmNWU4ZTY2Mi1iMjVhLTRiNDctOTZkYS01MmU5MTZmYTExYjQiLCJQaG9uZU51bWJlciI6IjA5MTUzMTQ3NDQiLCJFbWFpbCI6ImdpYW5na2UxNDk0QGdtYWlsLmNvbSIsIkZpcnN0TmFtZSI6IkdpYW5nIiwiTGFzdE5hbWUiOiJQaGFuIiwianRpIjoiMDIzNzgwMWMtZWJjYi00MTAwLTkwZWUtNjJlNzhkOTFjZDFlIiwiZXhwIjoxODA3NjkyOTM5LCJpc3MiOiJodHRwczovL21laW52b2ljZS52biIsImF1ZCI6Imh0dHBzOi8vbWVpbnZvaWNlLnZuIn0.BocNRpV7PIh7zMuvVUUa03fON-pt80SKFah-tUWgNF0’ \

Xem tại đây (ActiveStatus)

Xem tại đây (TypeInvoiceReceive)

2: Có mã

3: Không mã

Xem tại đây (InvoiceStatus)

Xem tại đây (RickStatus)

Xem tại đây (InvoiceInfoFlags)

Xem tại đây (CreatorEnum)

0,1: chính thức

2: dùng thử

• ActiveStatus

Xem tại đây (ActiveStatus)

• TaxRiskStatus

• Name

• Address

• ModifiedDate

• Status

Xem tại đây (CheckingStatus)

• TaxCode

• Name

• Address

• Status

Xem tại đây (CheckingStatus)

• HasInvoicePublished

• InvoiceNo

• InvoiceDate

• GdtIndexing

• Status

Xem tại đây (CheckingStatus)

• InvoicePublishedId

• HasSigned

• Certificate

• CertificateOwner

• SignedDate

• SignedDateEqInvoiceDate

• Status

Xem tại đây (CheckingStatus)

• CertificateId

Xem tại đây (ActiveStatus)

1: Tổng công ty/Công ty

2: Chi nhánh/Công ty con

3: Phòng ban

Xem tại đây (StatusExistTCT)

Xem tại đây (ProcessingStatus)

Xem tại đây (InvoiceType)

Xem tại đây (InvoiceStatus)

Xem tại đây (CheckedStatus)

InvoiceInfoFlags

2 – Hóa đơn hợp lệ

8 – Hóa đơn nháp

16 – Hóa đơn không hợp lệ

24 – Hóa đơn chưa thực hiện kiểm tra xong hết các chỉ tiêu

29 – Hóa đơn rủi ro

30 – Hóa đơn rủi ro

31 – Không kiểm tra

997 – Cờ dùng lọc hóa đơn có file xml

998 – Cờ dùng lọc hóa đơn không có file xml

999 – Cờ chỉ dùng để lọc hóa đơn không có bản thể hiện pdf

InvoiceStatus

2 – Hóa đơn thay thế

3 – Hóa đơn điều chỉnh

4 – Hóa đơn đã bị thay thế

5 – Hóa đơn đã bị điều chỉnh

6 – Hóa đơn đã bị xóa bỏ/hủy bỏ

7 – Hóa đơn chưa xác định

InvoiceType

2 – Hóa đơn thay thế

3 – Hóa đơn điều chỉnh

ProcessingStatus

2 – CQT từ chối hóa đơn theo từng lần phát sinh

3 – Hóa đơn đủ điều kiện cấp mã

4 – Hóa đơn không đủ điều kiện cấp mã

5 – Đã cấp mã hóa đơn

6 – Tổng cục thuế đã nhận không mã

7 – Đã kiểm tra định kỳ HĐĐT không có mã

8 – Đã tiếp nhận hóa đơn máy tính tiền

CheckingStatus

1 – Hợp lệ

8 – Không rõ trạng thái

16 – Không hợp lệ

999 – Đang kiểm tra

CreatorEnum

0 – Không phải hóa đơn

1 – Hóa đơn được đọc tự động bởi hệ thống

2 – Hóa đơn nhập tay

3 – Hóa đơn lưu nháp

4 – Hóa đơn không đủ thông tin để kiểm tra nhưng vẫn hợp lệ

5 – Hóa đơn được đọc từ tool

PaymentStatus

1: Chưa thanh toán

2: Thanh toán toàn phần

3: Quá hạn thanh toán

4: Đến hạn thanh toán

5: Thanh toán 1 phần

RickStatus

2 – Rủi ro theo công văn thuế thông báo các NCC danh sách đen

3 – Chưa đủ thông tin kết luận

4 – Rủi ro theo trạng thái hoạt động

ActiveStatus

2: Ngừng hoạt động

TypeInvoiceReceive

2: Hóa đơn email

3: Tự động

4: Nhập thủ công

5: Tự động từ tool

Kind

2: Khuyến mại

3: Chiết khấu thương mại

4: Diễn giải

5: Hàng hóa đặc trưng (kinh doanh vận tải)

StatusExistTCT

-1: Gặp lỗi trong quá trình kiểm tra

0: Chưa kiểm tra

1: Hợp lệ

8: Không rõ trạng thái

16: Không hợp lệ

999: Đang kiểm tra