Difference between revisions of "Service Provider Integration"

Revision as of 01:43, 6 June 2012

This article provides an overview of the process to integrate third party service providers such as transportation and translation services with client copies of SmartSimple that track Independent Medical Assessments(IME) and Rehabilitation services.

For full details, refer to the Service Provider Integration protocol document.

Overview

The objectives of this integration are twofold:

Provide the ability for a SmartSimple client to electronically request services from a third party provider.
Provide the ability for a third party provider to post invoice details related to the services requested back to the SmartSimple client.

Two service types are currently fully defined and supported: Interpretation/Translation and Transportation. Additional service types will be supported in the future.

The general transfer process is illustrated below:

From SmartSimple, information related to the service request is transferred to the service provider's website using a HTTPS post method
Information from the service provider's system is posted back to SmartSimple using a HTTPS post method

Transferring Information from SmartSimple to Service Provider

The information to be transferred from SmartSimple is gathered from a number of linked objects associated to the service.

As illustrated below, information is gathered from the Payor, Client's contact record, Case (Level 1), and the specific assessment or treatment service (Level 2).

The configuration work required to post information to the service provider is performed by SmartSimple or its business partners.

For a complete list of fields transferred from SmartSimple, please refer to Service Provider Integration Fields page.

Transferring Information from Service Provider to SmartSimple

When invoice information is received from the Service Provider, a new record is created under each service called a service billing record (Level 3).

This service billing record contains the details and costs of the services provided.

The configuration work required to post information to SmartSimple is performed by the service provider.

For a complete list of fields transferred by the Service Provider, please refer to Service Provider Integration Fields page.

Transfer Process

For security and auditing purposes, information is not directly passed from the Service Provider system to SmartSimple's client interface. Instead the returned service billing information is managed by SmartSimple's Integration Gateway.

The gateway performs the following:

Manages all incoming service billing information
Each SmartSimple client polls the Integration Gateway and extracts Service Billing records using proprietary protocols
All fields are submitted by http POST parameters
Service URL is https://integration.smartsimple.biz/billingpost/

Sample POST from SmartSimple

The following code is a sample of what SmartSimple will be using within a Web Page View on each client copy to post the details to the service provider.

Note that the naming of the HTML control IDs are the field names specified in the Service Provider Integration Fields page.

<html>
<head>
<title>Transportation Request</title>
</head>

<body bgcolor="#FFFFFF" link=blue vlink=purple class="Normal" lang=EN-US topmargin="25" bottommargin="25" leftmargin="30" rightmargin="30">
<form method="POST" action="/ex/ex_post.jsp">
  <input type=hidden name="post_url" value="@system.providerurl@">
  <input type=hidden name="update_fieldid" value="2704332">
  <input type=hidden name="ss_CaseID" value="@parent.opportunityid@">
  <input type=hidden name="ss_ServiceID" value="@eventid@">
  <input type=hidden name="ss_CustomerID" value="ID goes here">
  <input type=hidden name="ss_Source" value="10">
  <input type=hidden name="newlevelthree" value="1">
  <input type=hidden name="subject" value="providername">
  <input type=hidden name="description" value="">
  <input type=hidden name="statusid" value="31064">
  <input type=hidden name="eventtype" value="46852">
  <input type=hidden name="appid" value="103115">
  <input type=hidden name="referencefield" value="2704345">
  <BR>
  <div style="border:1px solid #1b409b; max-width:700px; min-width:550px;">
    <table>
      <th colspan="6" align="left" class="titleText001">Insurance company claim referred By:</th>
      </tr>
      <tr>
        <th align="left">Insurer First Name </th>
        <td><textarea name=ss_ReferralFirstName readonly>@parent.Referral Contact First Name@</textarea></td>
        <th align="left">Insurer Last Name </th>
        <td><textarea name=ss_ReferralLastName readonly>@parent.Referral Contact Last Name@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Address </th>
        <td><textarea name=ss_ReferralAddress readonly>@parent.client.address@</textarea></td>
        <th align="left"> City </th>
        <td><textarea name=ss_ReferralCity readonly>@parent.client.city@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Province </th>
        <td><textarea name=ss_ReferralProvince/State readonly>@parent.client.province@</textarea></td>
        <th align="left"> Postal Code </th>
        <td><textarea name=ss_ReferralPostalCode readonly>@parent.client.postalcode@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Country </th>
        <td><textarea name=ss_ReferralCountry readonly>Canada</textarea></td>
      </tr>
      <tr>
        <th align="left"> Phone </th>
        <td><textarea name=ss_ReferralPhoneNumber readonly>@parent.Referral Contact Phone@</textarea></td>
        <th align="left"> Fax </th>
        <td><textarea name=ss_ReferralFaxNumber readonly>@parent.client.fax@</textarea></td>
      </tr>
      <tr>
        <th align="left">Email </th>
        <td><textarea name=ss_ReferralEmail readonly><!--hideifnotfound-->@parent.Referral Contact Email@</textarea></td>
        <th align="left"> Company </th>
        <td><textarea name=ss_ReferralCompany readonly>@parent.client.name@</textarea></td>
      </tr>
      <tr>
        <th colspan="6"> </th>
      </tr>
      <th colspan="6" align="left" class="titleText001">Claim / Assessment Information </th>
      </tr>
      <tr>
        <th align="left">File Number (Referral)</th>
        <td><textarea name=ss_ReferralFileNumber readonly>@parent.Claim #@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Arrange Appointment with Claimant/Patient</th>
        <td><input type='hidden' name='ss_ArrangeAppointmentwithClaimant' value='@arrapp.combovalue@'>
          <textarea readonly>@arrapp@</textarea></td>
        <th align="left"> Confirm Appointment with Claimant/Patient</th>
        <td><input type='hidden' name='ss_ConfirmAppointmentwithClaimant' value='@conapp.combovalue@'>
          <textarea readonly>@conapp@</textarea></td>
      </tr>
      <tr>
        <th align="left">Location</th>
        <td><textarea name=ss_AppointmentLocation readonly>@Location@</textarea></td>
        <th align="left"> Date & Time </th>
        <td><textarea name=ss_DateandTime readonly>@fullstartdate@</textarea></td>
      </tr>
      <th align="left"> Duration (hr) </th>
        <td><textarea name=ss_Duration readonly>@appduration@</textarea></td>
        <th align="left"> Assessment Type</th>
        <th><textarea name=ss_TypeofAssessment readonly>@type@</textarea></th>
      </tr>
      <tr>
        <th colspan="6"> </th>
      </tr>
      <th colspan="6" align="left" class="titleText001">Pickup Details </th>
      </tr>
      <tr>
        <th align="left"> Pickup Time</th>
        <td><textarea name=ss_PickupTime readonly>@apppictime@</textarea></td>
        <th align="left"> Pickup Address</th>
        <!--@sslogic('@picsamehome@'='No')-->
        <td><textarea name=ss_PickupAddress readonly>@picaddress@</textarea></td>
        <!--@end--> 
      </tr>
      <tr>
        <th align="left"> Pickup City</th>
        <!--@sslogic('@picsamehome@'='No')-->
        <td><textarea name=ss_PickupCity readonly>@piccity@</textarea></td>
        <!--@end-->
        <th align="left"> Pickup Postal Code</th>
        <!--@sslogic('@picsamehome@'='No')-->
        <td><textarea name=ss_PickupPostalCode readonly>@piczip@</textarea></td>
        <!--@end--> 
      </tr>
      <tr>
        <th align="left"> Pickup Apt. /Suite</th>
        <td><textarea name=ss_PickupApt/Suite readonly><!--hideifnotfound-->@Pickup-Apt@</textarea></td>
        <th align="left"> Pickup Buzzer Code</th>
        <td><textarea name=ss_PickupBuzzer readonly><!--hideifnotfound-->@Pickup-Buzzer@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Pickup Province/State</th>
        <!--@sslogic('@picsamehome@'='No')-->
        <td><textarea name=ss_PickupProvince/state readonly>@picprovince@</textarea></td>
        <!--@end-->
        <th align="left"> Pickup Phone</th>
        <!--@sslogic('@picsamehome@'='No')-->
        <td><textarea name=ss_PickupPhone readonly><!--hideifnotfound-->@Pickup-Phone@</textarea></td>
        <!--@end--> 
      </tr>
      <tr>
        <th align="left"> Does Claimant Require a Wheelchair Accessible Vehicle?</th>
        <td><input type='hidden' name='ss_WheelchairVehicle' value='@intwheel.combovalue@'>
          <textarea readonly>@intwheel@</textarea></td>
        <th align="left"> Does Claimant Require Special Needs (e.g. Assistance)?</th>
        <td><input type='hidden' name='ss_SpecialNeeds' value='@intassistance.combovalue@'>
          <textarea readonly>@intassistance@</textarea></td>
      </tr>
      <tr>
        <th colspan="6"> </th>
      </tr>
      <th colspan="6" align="left" class="titleText001">Claimant Information </th>
      </tr>
      <tr>
        <th align="left"> Claimant First Name </th>
        <td><textarea name=ss_ClaimantFirstName readonly>@parent.Claimant First Name@</textarea></td>
        <th align="left"> Claimant Last Name </th>
        <td><textarea name=ss_ClaimantLastName readonly>@parent.Claimant Last Name@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Address </th>
        <td><textarea name=ss_ClaimantAddress readonly><!--hideifnotfound-->@parent.Claimant Address@</textarea></td>
        <th align="left"> City </th>
        <td><textarea name=ss_ClaimantCity readonly><!--hideifnotfound-->@parent.Claimant City@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Apt. /Suite </th>
        <td><textarea name=ss_ClaimantApt/Suite readonly><!--hideifnotfound-->@parent.Claimant Apt@</textarea></td>
        <th align="left"> Buzzer Code</th>
        <td><textarea name=ss_ClaimantBuzzer readonly><!--hideifnotfound-->@parent.Claimant Buzzer@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Province </th>
        <td><textarea name=ss_ClaimantProvince readonly><!--hideifnotfound-->@parent.Claimant Province@</textarea></td>
        <th align="left"> Postal Code </th>
        <td><textarea name=ss_ClaimantPostalCode readonly><!--hideifnotfound-->@parent.Claimant Postal Code@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Country </th>
        <td><textarea name=ss_ClaimantCountry readonly><!--hideifnotfound-->Canada</textarea></td>
        <th align="left"> P.O Box </th>
        <td><textarea name=ss_ClaimantP.O.Box readonly><!--hideifnotfound-->@parent.Claimant P.O Box@</textarea></td>
      </tr>
      <tr>
        <th align="left">Phone </th>
        <td><textarea name=ss_ClaimantPhone readonly><!--hideifnotfound-->@parent.Claimant Phone #@</textarea></td>
        <th align="left">Fax Number </th>
        <td><textarea name=ss_ClaimantFax readonly><!--hideifnotfound-->@parent.Claimant Fax #@</textarea></td>
      </tr>
      <tr>
        <th align="left">Policy #</th>
        <td><textarea name=ss_ClaimantPolicyNumber readonly>@parent.Policy #@</textarea></td>
        <th align="left"> Claim #</th>
        <td><textarea name=ss_ClaimFile readonly>@parent.Claim #@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Date of Loss </th>
        <td><textarea name=ss_DateofLoss readonly>@parent.Date of Loss@</textarea></td>
      </tr>
      <tr>
        <th colspan="6" align="left" class="titleText001">Billing Details</th>
      </tr>
      <tr>
        <th align="left"> Billing Same as Insurer / Referral company</th>
        <td><input type='hidden' name='ss_Billingsameasreferral' value='@billsamereferral.combovalue@'>
          <textarea readonly>@billsamereferral@</textarea></td>
      </tr>
      <!--@sslogic('@billsamereferral@'='No')-->
      <tr>
        <th align="left"> First Name (Billing)</th>
        <td><textarea name=ss_BillingFirstName readonly>@bilfirstname@</textarea></td>
        <th align="left"> Last Name (Billing)</th>
        <td><textarea name=ss_BillingLastName readonly>@bilastname@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Company (Billing)</th>
        <td><textarea name=ss_BillingCompany readonly>@bilcompany@</textarea></td>
        <th align="left"> Address (Billing)</th>
        <td><textarea name=ss_BillingAddress readonly>@biladdress@</textarea></td>
      </tr>
      <tr>
        <th align="left"> City (Billing)</th>
        <td><textarea name=ss_BillingCity readonly>@bilcity@</textarea></td>
        <th align="left"> Province Code/Zip (Billing)</th>
        <td><textarea name=ss_BillingProvince/state readonly>@bilprovince@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Postal Code/Zip (Billing)</th>
        <td><textarea name=ss_BillingPostalCode readonly>@bilzip@</textarea></td>
        <th align="left"> P.O.Box(Billing) </th>
        <td><textarea name=ss_BillingP.O.Box readonly>@bilpobox@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Phone (Billing)</th>
        <td><textarea name=ss_BillingPhone readonly>@bilphone@</textarea></td>
        <th align="left"> Fax(Billing)</th>
        <td><textarea name=ss_BillingFax readonly>@bilfax@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Email</th>
        <td><textarea name=ss_BillingEmail readonly>@bilemail@</textarea></td>
      </tr>
      <!--@end--> 
      <br>
      <tr>
        <th colspan="6"> </th>
      </tr>
      <tr>
        <th colspan="6" align="left" class="titleText001">Appointment Confirmation</th>
      </tr>
      <tr>
        <th align="left"> Fax confirmation of appointment</th>
        <td><input type='hidden' name='ss_Faxconfirmationofappointment' value='@faxconf.combovalue@'>
          <textarea readonly>@faxconf@</textarea></td>
        <th align="left"> Phone Confirmation</th>
        <td><input type='hidden' name='ss_Phoneconfirmationofappointment' value='@phoneconf.combovalue@'>
          <textarea readonly>@phoneconf@</textarea></td>
      </tr>
      <tr>
        <th align="left"> Email confirmation of appointment</th>
        <td><input type='hidden' name='ss_Emailconfirmationofappointment' value='@emailconf.combovalue@'>
          <textarea readonly>@emailconf@</textarea></td>
        <th align="left"> Notes</th>
        <th><textarea name=ss_Notes readonly><!--hideifnotfound-->@Service Notes@</textarea>
        </th>
      </tr>
    </table>
  </div>
</form>
</body>
</html>

Difference between revisions of "Service Provider Integration"

Revision as of 01:43, 6 June 2012

Contents

Overview

Transferring Information from SmartSimple to Service Provider

Transferring Information from Service Provider to SmartSimple

Transfer Process

Sample POST from SmartSimple

See Also

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigation

Tools