Pruvan - PPW - XactPRM    Support Center

Follow

Integrating with Pruvan (Read First)

Welcome and thank you for your interest!   Pruvan allows large and small work providers (Clients) to send work to a growing network of field contractors and inspectors (Vendors) who use Pruvan every day. 

As a Client, once integrated to Pruvan, you are in control of the orders that you send to "external" Pruvan accounts, or to your own "internal" Pruvan account.  You have visibility to the chain of custody for all your orders, including orders that are sub-contracted.  The Pruvan network consists of thousands of existing companies with Pruvan accounts looking for work. If you have your own vendors, Pruvan Customer Care will help with first line support and setup of your existing vendor network.

As a Vendor, you will receive orders from your various Clients (customers) setup into your own Pruvan account.  You then dispatch your orders to your employees or sub-contractors you setup in your own Pruvan account..  

Using Pruvan as the work order management system

If you are a Client, or a Vendor and want to use Pruvan Online as your order dispatching solution, you are already integrated to the thousands of other Pruvan accounts. 

Pruvan accounts can easily link to other Pruvan accounts using Pruvan Share.  Learn more about how to use Pruvan Share, or contact us and we will get you integrated to other Pruvan accounts. 

Need more than Pruvan Share?  All Pruvan accounts also have a built-in API Pruvan that allows you to fully integrate Pruvan into your business systems and vendor processes. 

Using popular work order management systems

If you are a Client or a Vendor using a popular work order management system, Pruvan may have an existing Add-On that provides basic functionality without custom integration.  Often these Add-On's can work as-is, or be customized to meet your requirements.

Exporting orders received in your Pruvan account

If you are receiving orders into your own Pruvan account and want a copy of these orders for your own business systems, you can export your orders to a CSV file.  CSV files can be opened in Excel or other compatible tools.  

If you would like to get a more robust order export you can use the built-in API in your Pruvan account to export your orders.   Open a ticket with Pruvan for assistance and study the "for developers" examples found here.. 

I want my own proprietary system integrated to Pruvan.

If you are a Client and are looking to use Pruvan as your mobile data collection solution and vendor management tool, integrated to your system(s) please contact us.  We would love to work with you to get integrated.  Please reference the steps below if you would like to get started.  Contact Pruvan at helpdesk@pruvan.com or by open a support ticket if you have any questions.

Step One:  

Become familiar with the Pruvan API and related examples test cases.  Pruvan provides a test harness for the Pruvan API.  This test harness will allow you to configure the “Basic” Pruvan standard driver and test round trips of web messages to and from endpoints. Test your Pruvan endpoints here.
Now test the best case path and all the potential error paths using the test harness to see the “error messages.” Pruvan reports these error messages to the end-user and whatever your API’s return.  The more verbose and user friendly, the better. For example: “The Work Portal reports that this work order is closed and is no longer accepting photos. Please contact your administrator.  Error Code 123XX.”
Want to Push Orders to Pruvan in real time, can do!  Or, do you want tell Pruvan to come get orders from your system(s)?  This too is possible!  Want to control, track and share your order across a multi-tier vendor netwok?  We got you covered. 
We highly recommend you engage Pruvan professional services to help you get integrated.  Please contact Pruvan to find out more about training and implementation services offered.  

 Second:

Once the test harness works, use your Pruvan account and select Client Import->NEW. Test everything on Pruvan Mobile to see error messages on corner cases (like work order canceled, closed, etc). Once tested and ready for production use,  Pruvan users will be able to use the Standard Pruvan interface to connect with your business system(s) using the URL and log-in information you provide to them.

Third (Optional):

A named integration allows any Pruvan end user to select your company’s portal name from a list of our integrated partners, login with your portal’s login credentials (URL not required), and start receiving work orders from you ASAP. Please contact Pruvan to find out additional requirements for a named integration that can be specifically tailored to your company’s business systems.

Ready to get integrated with Pruvan’s Open API? Take a look at our documentation including out Integration Best Practices Guidebook and reach out if you have any questions.

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments