API thực hiện lấy token của MISA Meinvoice

Chức năng này cung cấp cách thức lấy mã thông báo (token) để xác thực và ủy quyền truy cập vào các API của MISA. Nhà phát triển cần cung cấp thông tin đăng nhập hợp lệ để nhận token, token này sẽ được dùng cho các yêu cầu API khác trong hệ thống.

MeInvoice sử dụng cơ chế Token Authentication để cho phép các ứng dụng gọi các API để thao tác với các tài nguyên của MeInvoice. Tất cả các Request gọi lên hệ thống MeInvoice đều phải chứa thông tin Authorization trong Header.

1. Request

1.1 Url API

Method	URL API
POST	TEST: https://testapi.meinvoice.vn/api/integration/auth/token LIVE: https://api.meinvoice.vn/api/integration/auth/token

1.2 Body

{
    "appid": "chuỗi ký tự được MISA cung cấp",
    "taxcode": "Mã số thuế",
    "username": "tài khoản(đăng nhập hệ thống MISA)",
    "password": "Mật khẩu(đăng nhập hệ thống MISA)"
}

2 Response

{
    "Success": <false/true>,
    "Data": "<Dữ liệu token trả về>",
    "ErrorCode": "<Trống hoặc Mã lỗi>",
    "Errors": "",
    "CustomData":""
}

3. Ví dụ:

3.1 Request

URL: https://testapi.meinvoice.vn/api/integration/auth/token
BODY:
{
    "appid": "chuỗi ký tự được MISA cung cấp",
    "taxcode": "Mã số thuế",
    "username": "tài khoản(đăng nhập hệ thống MISA)",
    "password": "Mật khẩu(đăng nhập hệ thống MISA)"
}

3.2 Response

{
    "Success": true,
    "ErrorCode": null,
    "Errors": [],
    "Data":     "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJBcHBJZCI6IkY3RThEN0U1LUJCNUEtNDIxQi04QjM5LUQzQTM1RDY2MUYwOCIsIkNvbXBhbnlJZCI6IjIwNjc1IiwiUm9sZVR5cGUiOiIxIiwiVXNlcklkIjoiYzQ1NDE2MjItNDY2Yy00ZWZjLWI3OTMtM2I2YzUxN2RkNjkyIiwiVXNlck5hbWUiOiJhZG1pbiIsIk1pc2FJZCI6IiIsIlBob25lTnVtYmVyIjoiMDk2NzEyNTE4MiIsIkVtYWlsIjoidHFoYWlAc29mdHdhcmUubWlzYS5jb20udm4iLCJUYXhDb2RlIjoiMDEwMTI0MzE1MC0wMzgiLCJTZWN1cmVUb2tlbiI6IkVNeHZPaFBFVVpRNzNSdjhiQkR5eEVNYjdZNWkybmZJRkNzMkI1NE9STm1RbFQ1OVcwRGRBYzdPbmZXTUhseHkiLCJuYmYiOjE2MzY2MTg4MTksImV4cCI6MTYzNjcwNTIxOSwiaWF0IjoxNjM2NjE4ODE5LCJpc3MiOiJodHRwczovL21laW52b2ljZS52biIsImF1ZCI6Imh0dHBzOi8vbWVpbnZvaWNlLnZuIn0.RbJoXqjxfWk38dpoAkcM8bKooD4ut9ewxxxxxxx",
    "CustomData": null
}

4. Các mã lỗi thường gặp:

• Sai thông tin AppID:

{
    "Success": false,
    "ErrorCode": "InvalidAppID",
    "Errors": [],
    "Data": null,
    "CustomData": null
}

• Ứng dụng bị ngừng theo dõi:

{
    "Success": false,
    "ErrorCode": "InactiveAppID",
    "Errors": [],
    "Data": null,
    "CustomData": null
}

• Sai thôn tin đăng nhập:

{
    "Success": false,
    "ErrorCode": "UnAuthorize",
    "Errors": [],
    "Data": null,
    "CustomData": null
}

5. Tài liệu tham khảo (Curl postman):

curl --location 'https://testapi.meinvoice.vn/api/integration/invoice/token' \
     --header 'Content-Type: application/json' \
     --data-raw 
    '{
     "appid": "điền appid được MISA cung cấp",
     "taxcode": "điền mã số thuế test",
     "username": "điền email/sdt môi trường test",
     "password": "điền mật khẩu môi trường test"
     }'