Method GetLoanStatus
SOAP Component: | https://catweb.sba.gov/elips/ws/elipsstat.wsdl |
SOAP Method: | GetLoanStatus |
Keys of the Input Structure: | |
Mandatory. CLS login’s username with update permissions in Origination. | |
Mandatory. CLS login’s password with update permissions in Origination. | |
Mandatory. EMail addrss to send upload results to. | |
Mandatory. XML in SBA_ELIPS_Status.xsd format. | |
Keys of the Output Structure: | |
Should be nullstring. If not, a generally-worded error message. | |
Should be nullstring. If not, a more helpful error message, but scarier to some users. | |
“Yes”, “No”, number of days till expiration or “TBD” (prior to validating login). | |
XML in SBA_ETran_ELIPS_Status_Response.xsd format. |
In case of errors, both the error number and text message will be returned for each error. Generally, the return of errors indicates that the loan number was not found in the SBA’s database. The exception is warning/error messages related to the user’s account and password are described below.
Except for message 00, the following are the login status messages that would be returned.
SLEVEL(Severity Level) | MSG(Message) | Criteria |
---|---|---|
00 | Login Successful | Login Successful |
11 | UserName is invalid. | If user name does not exist or the user has been suspended. |
12 | Password Expired | If the password has expired. |
13 | Invalid Password | If the password entered is not correct. |
21 | First Time Login. Please change the Password before continuing. | If the login is for the first time or password reset by Security. |
22 | Your password expires in "+iDays+" days. Please change the Password before continuing. | If number of days left till the password expiration is less than or equal to 15 days. |
31 | Your password expires in "+iDays+". | If number of days left for password expiration is equal to or less than 30 days. |
You have x number of days to provide pin for authentication | If the login information is correct and the two-factor PIN is not provided. | |
Invalid PIN | If the login information is correct and the two-factor PIN is incorrect. | |
Note: |
- Here "iDays" is the number of days left for user password expiration.
- For the error codes starting with "1", that is 11, 12 and 13; the user is not allowed to log in.
- For error codes starting with "2", like 21 or 22, the user is not allowed to log in and must be redirected to change their password.
- For error codes starting with "3", like 31 or 32, the user is logged into the system, with a warning message.
- If the error code starts with "0", the login is successful.