The CertData information collected on a carrier is available in the CarrierLookup web service under the <CertData> section. The CertData status attribute will be one of the following:
=======================
ACCOUNTEXPIRED: Customer has not activated this module in SaferWatch.
UNQUALIFIEDCARRIER: Carrier does not qualify for CertData.
OK: CertData insurance certificates are available for this carrier.
NOTONFILE: CertData insurance certificates have not been aquired on this carrier. Customer may want to click link to make request.
NONCOOP: Agent is not cooperating with CertData to provide insurance certificates. Customer may want to click link to make request for additional attempt.
By design, a REQUESTED status attribute will not be available in the CarrierLookup web service.
=======================
If CertData is not available based on the above status, you should make available the option to request insurance (see below). After the user has requested the CertData insurance, they will be notifed by email when ready. At this time they can pull up the carrier in your system and invoke the CarrierLookup service providing the new CertData insurance.
After the CertData status is OK (aka ONFILE), the user has the option of obtaining the Certificate Image through the RequestImage process.
If the CertData status is NOTONFILE or NONCOOP, we need to provide an avenue for the user to request CertData insurance on the carrier. There are two methods available for this process:
=======================
Option 1) Link the user to the SaferWatch carrier details page with the request insurance window open:
https://www.saferwatch.com/swCarrierDetailsLink.php?&number=51442&showCertDataWin=TRUE Click to see link results
number=MC, MX, FF or DOT Number (Numbers with no prefix are interpreted as DOT numbers)
NOTE: This link is identical to the link to the Carrier Details window with the addition of parameter showCertDataWin=TRUE
=======================
Option 2) Collect the producer (aka insurance agent) information from the user and call the RequestInsurance web service:
https://www.saferwatch.com/webservices/CarrierService32.php
?Action=RequestInsurance
&ServiceKey=YourServiceKey
&CustomerKey=YourCustomerKey
&number=MC, MX, FF or DOT Number (Numbers with no prefix are interpretted as DOT numbers)
&prodName=Testproducer
&prodPhone=555-555-5555
&[email protected]
&prodFax=333-333-3333
&sourceType=LoadWaiting or PreQualify
NOTE: LoadWaiting tells CertData that the Insurance information should be aquired quickly as the customer is waiting for this information prior to assigning the carrier to the load.
The certificate image is a scanned image provided by the producer and shows the insurance coverages. The certificate ID is provided under the CertData section of the CarrierLookup service. It can be a bit confusing as there is no standard as to how certificates are provided by the producer: In some cases, there may be mulitple coverages on a certificate. Other times, there are multiple certificates each showing different coverages. There are two methods available to aquire the certificate:
=======================
Option 1) Link the user to SaferWatch using the CarrierDetails link:
https://www.saferwatch.com/swCarrierDetailsLink.php?&number=51442 Click to see link results
=======================
Option 2) Use the web service to aquire link to a specific Certificate Image for the user to download. This service validates and bills the user for the Certificate Image if necessary and responds with a URL to download the Certificate Image. The URL is a one-use link that is invalidated after 24 hours.
https://www.saferwatch.com/webservices/CarrierService32.php
?Action=RequestImage
&ServiceKey=YourServiceKey
&CustomerKey=YourCustomerKey
&CertificateId=certificateID Number. (Found under CertData section of CarrierLookup)
https://www.saferwatch.com/webservices/CarrierService32.php?Action=RequestImage&ServiceKey=DemoServiceKey&CustomerKey=DemoCustomerKey&CertificateId=1234
Click to see RequestImage results
<CarrierService.RequestImage>
<ResponseDO> NOTE: See Standard Response
<status>APPROVED</status>
<action>OK</action>
<code>SFW00389</code>
<displayMsg>https://www.saferwatch.com/swSigleUseURL.php?uuid=51e96bc2438e7</displayMsg>
<techMsg></techMsg>
</ResponseDO>
</CarrierService.RequestImage>
<status>APPROVED</status>
<action>OK</action>
Means every thing worked.
<status>DENIED</status>
<action>FAILED</action>
Means ether could not find the carrier being requested or carrier does not qualify for CertData monitoring. It could also mean your account does not have CertData or your subscription to Certdata has expired. Check displayMsg for more details.
<status>ERROR</status>
<action>FAILED</action>
This is an unexpected system error. Check the display and technical message for details.
Copyright ©- Grizella LLC. All Rights Reserved.