Connecting GPMS

Step by step

A manager opens Workspace setup from the account menu and chooses GPMS.

1. Get a machine credential

   Your organisation’s authorisation administrator creates a machine credential in Relationship Authorisation Manager (RAM) for your ABN, and downloads it with a password they choose.

2. Credential

   Choose the environment (GPMS live, the test environment, or practice only), enter your ABN and upload the credential. It is stored encrypted and never shown again; the step shows only when it expires.

3. Register HealthOS

   Enter the client id and secret of your own B2G Developer Portal application, then register. This tells the Department that HealthOS acts for your organisation with your credential. You do it once, and again only if you replace the credential.

4. Map your homes

   HealthOS reads your services and outlets from GPMS. Match each service to the home it reports for and enter its operational places. If a service is not listed, add it by its SRV- id.

5. Who submits

   For Periscope, add each person who will lodge, with their GPMS federated id and GPMS email. The Department records that person as the one who submitted. Each person can also enter their own.

6. Test

   Choose Run the test. HealthOS signs in to the Department’s gateway with your credential and reads your organisation back. Nothing is lodged.

If the test does not pass

• Check the ABN matches the one the credential was issued to.
• Check the Developer Portal secret was saved with the client id. Without it the Department refuses every request.
• A credential that has expired or been revoked in RAM needs replacing: choose Replace it on the Credential step, then register again.

Still stuck? Email support@healthos.net.au