Prerequisites

Before you can use the new WorkSafeBC Web Service functionality, you must:

  • Confirm your PeopleTools release.

  • Identify a static Internet protocol (IP) address from which your system calls WorkSafeBC's web services. This is required to connect to WCB's Accident Registration System

  • Register with WorkSafeBC Web Services.

  • Set Up Integration Broker.

  • Enter a phone number for your location.

  • Change the ISSv3 web service URL.

Confirming your PeopleTools Release

You must be running PeopleTools 8.48 or later to use the WorkSafeBC Web Service functionality.

Identifying a Static Internet Protocol (IP) Address

To protect the integrity of the ISSv3 Web Service, WorkSafeBC uses several firewalls, each of which requires authentication before permitting messages to pass. Therefore, before an employer requests access to the ISSv3 Web Service, it must register with WorkSafeBC one or more static IP addresses from which its system calls the Web Services.

Registering with WorkSafeBC Web Services

Before you begin implementing and testing your web service functionality, you must register with WorkSafeBC. Registration enables you to:

  • Use WorkSafeBC's business-to-business services.

  • Use the web service feature in PeopleSoft HR to electronically submit the Employer's Report of Injury (Form 7).

  • Complete WorkSafeBC's web service testing requirements before being permitted access to the production environment (optional). Optional testing may include a connectivity test and/or a data test.

To obtain instructions on web service registration, visit the WorkSafe BC website.

Setting Up Integration Broker

The WorkSafeBC Web Service enhancement uses PeopleSoft Integration Broker to transmit information between your PeopleSoft system and the WCB system. To use Integration Broker for this purpose, you need to configure the default local node, PSFT_HR, and make sure that it is active.

The WorkSafeBC Web Service enhancement uses the following four service operations:

  • RETRIEVEEMPLOYERCODES

  • RETRIEVEINCIDENTSTATUS

  • RETRIEVESYSTEMCODES

  • SUBMITINCIDENT

Entering a Phone Number for your Location

Telephone Area Code and Telephone Number are mandatory fields for WCB for

  • Reporting employers

  • Submitting employers

  • Payroll contacts

  • Workers

Telephone number, however, is not a mandatory field in PeopleSoft HR, so it is imperative that you enter an area code and telephone number on the Company page. The system uses this telephone number if no telephone number exists for one of the entities listed above.

Changing the ISSv3 Web Service URL

Although completing WorkSafeBC's web service testing requirements is an optional step, we deliver a client validation ISSv3 web service URL so that you can perform this testing if you wish. In test mode, you can send web service messages to request system codes, request employer-related codes, and submit injury reports. Only the ability to request submission status is disabled for client validation testing. You need to contact WorkSafeBC prior to connecting to the production database. In addition, you need to change the client validation URL to the production URL. To change the ISSv3 web service URL:

  1. Access the Service page (PeopleTools, Integration Broker, Integration Setup, Services) for the ISSV3 service.

  2. In the Existing Operations group box, click the RETRIEVEEMPLOYERCODES.V1 link to access the Service Operations component for the RETRIEVEEMPLOYERCODES service operation.

  3. Access the Routings page of the Service Operations component.

  4. In the Routing Definitions group box, click the ~IMPORTED~22075 link to access the Routings component for the ~IMPORTED~22075 routing.

  5. Access the Connector Properties page.

  6. Change the value of the PRIMARYURL property ID from https://cv.b2b.online.worksafebc.com/ISSV3/ISSV3.asmx to https://b2b.online.worksafebc.com/ISSV3/ISSV3.asmx.

  7. Click Save.

  8. Repeat these steps for the routings associated with the RETRIEVEINCIDENTSTATUS, RETRIEVESYSTEMCODES, and SUBMITINCIDENT service operations.

See Also PeopleTools: Integration Broker

Related Topics