Kết nối Misa Meinvoice lấy Token

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.

Token của MISA 1 lần get về có thời hạn sử dụng 15 ngày.

Để lấy về thông tin Token, MeInvoice cung cấp API với thông tin như sau:

1. Request

Method	URL
POST	<BaseURL>/auth/token

1.1 Body parameter

{
    "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)"
}

1.2 Response

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

2. Ví dụ:

2.1 Request

https:/testapi.meinvoice.vn/api/v3/auth/token

{
    "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.2 Response

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

3. 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
}

3. Ghi chú:

Khi token hết hạn thì các đầu API sẽ trả về mã lỗi "TokenExpiredCode" ở ErrorCode. khi báo về mã lỗi này mình sẽ gọi API "refreshtoken"

Request

Method	URL
POST	<BaseURL>/auth/refreshtoken

Body parameter

Token cũ đã hết hạn

Response

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