In order to establish an API connection with iEdison, an organization must:
The user intending to access use the iEdison API is responsible for contacting a certificate provider and procuring a certificate or reusing an existing certificate they may already have.
An ISA document is required when creating a system account. When creating an account, the applicant must download a copy of the ISA document, sign it, and then upload the signed copy during the registration process.
The ISA document can be found here or on the Manage System Account page in the iEdison application.
An agency or organization is required to have a System Account User role to access the iEdison API. Before creating a system account, ensure you have the following prepared to upload and add during the account creation: a valid certificate, an executed ISA document, and a contact person.
Complete the following steps to create your iEdison System Account:
An iEdison Approver user will review your registration and Approve or Deny your System Account registration.
Once a System Account registration has been approved by an iEdison Approver, agencies or contractor organizations will be able to Create or Update an iEdison report using the iEdison API. Institution administrators will be responsible for maintaining a valid certificate.
To update an expired certificate of a System Account, follow the steps below:
The following table describes common error messages you may receive when setting up your System Account as well as the possible causes and solutions:
|Type of Issue||Error Message||Possible Cause/Solution|
|Connectivity||UnknownHostException||The full URL for the Web Service is incorrect. (Verify the URL that is being called.)|
|Certificate||SSLPeerUnverifiedException||The certificate has not been obtained or configured properly in the calling program.|
SOAP response containing aHTTP 500: “Mapping doesn’t exist for certificate”
|Verify that the serial number and authority match the certificate on the caller’s server.|
SOAP response containing aHTTP 500: “User <XYZ> is not authorized to access this operation”
SOAP response containing aHTTP 500: “Certificate has expired.”
|For help resolving this issue, please contact the administrator of the agency or organization.|
|Inactive Agency/Organization Account||
SOAP response containing aHTTP 500: “Agency/Organization has been disabled.”
|The agency or organization has been disabled. (Contact the iEdison Helpdesk if you believe the account needs to be re-activated)|
|Other Exception||SOAP response containing a system exception||For help resolving this issue, contact the iEdison Helpdesk with the date/time of the call, serial number, certificate authority, and the name of the Web Service.|