Which Measurement Reports Work With JobNimbus?
Learn which measurement providers fill your Measurement Tokens, how each report gets into JobNimbus, and which token each value fills.
On This Page
- How Each Provider Gets Into JobNimbus
- Matching Report Values to Tokens
- EagleView
- GAF QuickMeasure
- Hover
- Roofr
- RoofSnap
Measurement values fill your Measurement Tokens, which your estimates use to calculate quantities. How a report gets into JobNimbus depends on the provider.
How Each Provider Gets Into JobNimbus
|
Provider |
How it gets into JobNimbus |
Details |
|---|---|---|
|
EagleView |
Integration only |
Order or apply the report from the Measurements tab. EagleView files can't be uploaded. |
|
GAF QuickMeasure |
File upload |
Upload the .xml file. The PDF won't upload. |
|
Hover |
Integration or file upload |
Import from the Measurements tab (Hover Pro plan), or upload the .json file. Hover .xml files won't upload. The integration fills more tokens than the .json file. |
|
Roofr |
File upload |
Upload the .csv file. |
|
RoofSnap |
File upload |
Upload the .csv file. |
|
Any other provider |
Manual entry |
Type the values into your Measurement Tokens. |
RoofScope reports can be sent to a Job or Contact as a PDF, but they don't fill Measurement Tokens. Enter RoofScope measurements manually.
If a third party, such as your supplier, orders a measurement report for you, check which file types you can download before they order it. The report fills your Measurement Tokens only when it's a .xml file from GAF QuickMeasure, a .json file from Hover, or a .csv file from Roofr or RoofSnap. PDFs won't upload.
Check out How Do I Upload Reports to Measurements? to upload a file, or How Do I Order and View Measurements Reports in Financials? to use the EagleView or Hover integration.
Matching Report Values to Tokens
Each report value goes to the Measurement Token with the matching name. Names must match exactly, including spaces between words, spelling, and plurals. Capitalization and extra spaces at the start or end don't matter. If two tokens share a name, both fill in. For example, Total Ridges fills in, but Ridge Length doesn't. This applies to every provider, whether you upload a file or use an integration.
- File uploads (GAF QuickMeasure, Hover .json, Roofr, and RoofSnap): Uploading never adds a missing token. Add the tokens to your account before you upload, or those values won't fill in. The one exception is an account with no Measurement Tokens at all, which gets the full default set on its first upload.
- EagleView integration: Loading your EagleView report list and downloading a report both add missing default tokens, but only the ones the report supplies. If you delete a default token, the next import adds it back if the report supplies it, along with its category if you deleted that too. EagleView never adds back Roof Waste Percentage, Total Flashing, or Total Step Flashing. It also adds the 7/12 through 12/12 pitch tokens if they're missing, but only when EagleView sends the XML file with the report. It fills the 1/12 through 6/12 pitch tokens only if you've added them.
- Hover integration: Only downloading a Hover report adds missing default tokens that the report supplies, along with their categories. It also adds the 7/12 through 12/12 pitch tokens if they're missing.
- A value with no matching token won't fill in, unless it's on the default list or it's a 7/12 through 12/12 pitch token that an integration adds.
Check out How Do I Create Measurement Tokens and Calculations in JobNimbus Financials? to add a token.
EagleView
EagleView measurements come in through the EagleView integration only, which pulls reports from your own connected EagleView account. Premium Residential and Premium Commercial reports are supported. EagleView reports ordered on someone else's account, such as through your supplier, won't appear in the integration and can't be uploaded. Enter those measurements manually, or order the report through your own EagleView account.
Each value fills the Measurement Token with the matching name. Capitalization doesn't matter. The integration adds a missing default token only when the report supplies it.
|
EagleView Measurement |
JobNimbus Token Name |
Unit |
|---|---|---|
|
Total Roof Area |
Total Roof Area |
SF |
|
Eaves |
Total Eaves |
LF |
|
Rakes |
Total Rakes |
LF |
|
Valleys |
Total Valleys |
LF |
|
Hips |
Total Hips |
LF |
|
Ridges |
Total Ridges |
LF |
|
Waste % |
Suggested Waste Percentage |
% |
|
Total Siding |
Total Siding |
SF |
|
Total Windows and Doors Area |
Total Windows and Doors Area |
SF |
|
Total Windows and Doors Perimeter |
Total Windows and Doors Perimeter |
LF |
|
Total Wall Area |
Total Wall Area |
SF |
|
Total Siding Area* |
Siding |
SF |
|
Total Masonry Area* |
Masonry |
SF |
|
Total Wall Facets |
Wall Facets |
Each |
|
Windows & Doors |
Windows & Doors |
Each |
|
Window and Door Area |
Window and Door Area |
SF |
|
Window & Door Perimeter |
Window & Door Perimeter |
LF |
|
Fascia (Eaves + Rakes) (XML file only) |
Fascia (Eaves + Rakes) |
LF |
|
Fascia (XML file only) |
Fascia |
LF |
|
Top of Siding Walls |
Top of Siding Walls |
LF |
|
Bottom of Siding Walls |
Bottom of Siding Walls |
LF |
|
Ridges and hips combined (standard data or XML file) |
Total Ridges/Hips |
LF |
|
Ridges and hips combined (standard data or XML file) |
Total Hips and Ridges Length |
LF |
|
Valleys (XML file only) |
Total Valleys Length |
LF |
|
Eaves and rakes combined (standard data or XML file) |
Total Eaves and Rakes Length |
LF |
|
Roof area by pitch (XML file only) |
One token per pitch: 7/12 through 12/12 (1/12 through 6/12 only if the token exists) |
SF |
*Includes penetrations, so the value will be higher than the matching total on the EagleView report.
EagleView has no single steep pitch token. For steep roof areas, use the pitch tokens from 7/12 through 12/12.
Pitch tokens fill only when EagleView sends the XML file with the report. Without the XML file, no pitch tokens fill.
If your pitch tokens stay empty after an EagleView report, check with EagleView that the XML file is included in your order, or contact JobNimbus Support.
Pitch values come in as square feet, with no conversion to squares. If a pitch isn't on the roof, its token keeps its current value. The integration adds any missing 7/12 through 12/12 token, even when that pitch isn't on the roof, but fills 1/12 through 6/12 only if you've added the token. EagleView drops 0/12 and any pitch steeper than 12/12.
EagleView fills Total Ridges/Hips and Total Hips and Ridges Length with the combined hips and ridges length, so your account may show both. It fills Total Eaves and Rakes Length with the combined eaves and rakes length. Total Valleys Length, Fascia, and Fascia (Eaves + Rakes) fill only when EagleView sends the XML file with the report.
Use one token for each measurement in your calculations:
- Hips and ridges: Total Ridges/Hips, Total Hips and Ridges Length, or Total Hips plus Total Ridges
- Valleys: Total Valleys
- Eaves and rakes: Total Eaves and Rakes Length, or Total Eaves plus Total Rakes
If your account has two Measurement Tokens for the same measurement, or the same token listed twice, hide the one you don't use instead of deleting it. A deleted default token can come back on the next import. Check that your calculations use the token you keep.
GAF QuickMeasure
GAF QuickMeasure measurements fill in when you upload the GAF QuickMeasure XML file (.xml) to the Job's Measurements tab. The PDF report won't upload. Check out How Do I Upload Reports to Measurements? to learn how to upload the file.
Each value goes to the Measurement Token with the matching name, so the tokens need to exist in your account before you upload. Your account starts with Total Roof Area, Total Eaves, Total Rakes, Total Valleys, Total Hips, and Total Ridges. Add Step Flashing, Wall Flashing, and a token for each pitch you use (for example, 5/12). Check out How Do I Create Measurement Tokens and Calculations in JobNimbus Financials? to learn how to add a token.
|
GAF QuickMeasure Measurement |
SQ Token Name |
Unit |
|---|---|---|
|
Total Roof Area |
Total Roof Area |
SF |
|
Eaves |
Total Eaves |
LF |
|
Rakes |
Total Rakes |
LF |
|
Valleys |
Total Valleys |
LF |
|
Hips |
Total Hips |
LF |
|
Ridges |
Total Ridges |
LF |
|
Step Flashing |
Step Flashing |
LF |
|
Wall Flashing |
Wall Flashing |
LF |
|
Roof area by pitch (0/12 through 24/12) |
One token per pitch: 0/12, 1/12, 2/12, and so on through 24/12 |
SF |
Each pitch token holds the GAF QuickMeasure roof area at that pitch. For example, the 5/12 token receives the total area of all roof sections with a 5/12 pitch. GAF QuickMeasure values come in as square feet and linear feet, so when you add a pitch token, choose square feet as its unit. For a flashing token, choose linear feet.
Uploading a GAF QuickMeasure file doesn't create missing tokens. Token names must match exactly, including spaces and plurals, but capitalization doesn't matter. For example, Total Ridges fills in, but Ridge Length doesn't.
Hover
Hover measurements come in two ways, and they don't fill the same tokens.
- Hover integration: Import the report from the Measurements tab. This requires a Hover Pro plan. The integration fills the tokens in the Hover Integration Tokens table. When you download a report, it also adds missing default tokens that the report supplies, along with their categories, such as Siding Measurement Tokens and Accessories Tokens.
- Hover .json file upload: Upload the .json file from Hover. It fills only Total Roof Area, Total Eaves, Total Rakes, Total Valleys, and Total Ridges/Hips. It doesn't fill flashing, pitch, or waste tokens, and it doesn't add missing tokens. Hover .xml files won't upload. If you try, you may see the message "This XML file contains data that could not be parsed."
Either way, each value fills the Measurement Token with the matching name, and capitalization doesn't matter. Check out How Do I Connect and Disconnect Hover? to set up the integration.
Hover Integration Tokens
Some Hover measurements fill two token names, a newer one and an older one. Your token fills in if it uses either name, so you don't need both.
|
Hover Measurement |
JobNimbus Token Name |
Unit |
|---|---|---|
|
Roof area |
Total Roof Area |
SF |
|
Eaves |
Total Eaves |
LF |
|
Rakes |
Total Rakes |
LF |
|
Valleys |
Total Valleys |
LF |
|
Ridges |
Total Ridges |
LF |
|
Hips |
Total Hips |
LF |
|
Ridges and hips combined |
Total Ridges & Hips or Total Ridges/Hips |
LF |
|
Roof perimeter |
Total Roof Perimeter |
LF |
|
Flashing |
Total Flashing |
LF |
|
Step flashing |
Total Step Flashing |
LF |
|
Wall area, including windows and doors |
Total Wall Area |
SF |
|
Wall area, not including windows and doors |
Siding or Total Wall Without Openings |
SF |
|
Window and door area |
Window and Door Area or Window & Door Area |
SF |
|
Windows and doors |
Windows & Doors or Windows and Doors |
Each |
|
Window and door perimeter |
Window & Door Perimeter or Window/Door Trims |
LF |
|
Tops of windows and doors (Hover integration only) |
Openings Tops Length |
LF |
|
Sills of windows and doors (Hover integration only) |
Openings Sills Length |
LF |
|
Sides of windows and doors (Hover integration only) |
Openings Sides Length |
LF |
|
Footprint perimeter |
Total Footprint Perimeter |
LF |
|
Inside corners |
Inside Corners or Corners - Inside |
LF |
|
Outside corners |
Outside Corners or Corners - Outside |
LF |
|
Inside corners count |
Inside Corners Quantity |
Each |
|
Outside corners count |
Outside Corners Quantity |
Each |
|
Level starter |
Level Starter or Bottom of Siding Walls |
LF |
|
Sloped trim |
Sloped Trim |
LF |
|
Vertical trim |
Vertical Trim |
LF |
|
Eaves fascia |
Eaves Fascia |
LF |
|
Rakes fascia |
Rakes Fascia |
LF |
|
Eaves and rakes fascia |
Fascia (Eaves + Rakes) |
LF |
|
Level frieze board |
Level Frieze Board |
LF |
|
Sloped frieze board |
Sloped Frieze Board |
LF |
|
Eaves soffit area |
Eaves Soffit Area |
SF |
|
Rakes soffit area |
Rakes Soffit Area |
SF |
|
Total soffit area |
Total Soffit Area |
SF |
|
Shutters |
Shutters |
Each |
|
Shutter area |
Shutter Area |
SF |
|
Vents |
Vents |
Each |
|
Vent area |
Vent Area |
SF |
|
Roof area by pitch |
One token per pitch: 7/12 through 12/12 (other pitches only if the token exists) |
SF |
Hover fills pitch tokens in square feet and doesn't convert them to squares. It fills the 7/12 through 12/12 tokens and adds any that are missing. It fills the other pitches only if you've added the token.
A Hover report applied from the Measurements tab doesn't fill Roof Waste Percentage, Walls Waste Percentage, Masonry, Wall Facets, or separate Windows, Doors, Window Area, and Door Area tokens. Use Windows & Doors and Window and Door Area instead. The Hover integration fills Openings Tops Length, Openings Sills Length, and Openings Sides Length, but a .json upload doesn't. The Hover integration also doesn't fill Total Wall Flashing or Downspouts. Enter those manually.
Hover fills both Total Ridges/Hips and Total Ridges & Hips with the same value. If your account has both tokens, use one in your calculations and hide the other.
Hover .json Upload Tokens
|
Hover Measurement |
JobNimbus Token Name |
Unit |
|---|---|---|
|
Total Roof Area |
Total Roof Area |
SF |
|
Eaves |
Total Eaves |
LF |
|
Rakes |
Total Rakes |
LF |
|
Valleys |
Total Valleys |
LF |
|
Hips/Ridges |
Total Ridges/Hips |
LF |
The .json upload fills ridges and hips into Total Ridges/Hips. The Hover integration fills that token too, so one Total Ridges/Hips token works for both.
RoofR
Roofr measurements fill in when you upload the original Roofr .csv export to the Measurements tab. Check out How Do I Upload Reports to Measurements? to learn how to upload the file.
Uploading a Roofr file doesn't create missing tokens. Token names must match exactly, including spaces and plurals, but capitalization doesn't matter.
|
Roofr Measurement |
JobNimbus Token Name |
Unit |
|---|---|---|
|
Total Roof Area |
Total Roof Area |
SF |
|
Eaves |
Total Eaves |
LF |
|
Rakes |
Total Rakes |
LF |
|
Valleys |
Total Valleys |
LF |
|
Hips |
Total Hips |
LF |
|
Ridges |
Total Ridges |
LF |
|
Wall Flashing |
Wall Flashing |
LF |
|
Step Flashing |
Step Flashing |
LF |
|
Roof area by pitch (0/12 through 24/12) |
One token per pitch: 0/12, 1/12, and so on through 24/12 |
SF |
Each Roofr pitch token holds the roof area at that pitch in square feet.
RoofSnap
RoofSnap measurements fill in when you upload the RoofSnap .csv file to the Measurements tab. Check out How Do I Upload Reports to Measurements? to learn how to upload the file.
Uploading a RoofSnap file doesn't create missing tokens. Token names must match exactly, including spaces and plurals, but capitalization doesn't matter.
RoofSnap measures roof area in squares. JobNimbus fills Total Roof Area with Actual Squares times 100, in square feet. It also fills Quick Squares with Total Squares, which includes waste. Total Roof Area doesn't include waste, so the two values won't match.
|
RoofSnap Measurement |
JobNimbus Token Name |
Unit |
|---|---|---|
|
Actual Squares (multiplied by 100) |
Total Roof Area |
SF |
|
Total Squares (includes waste) |
Quick Squares |
SQ |
|
Eaves |
Total Eaves |
LF |
|
Rakes |
Total Rakes |
LF |
|
Valleys |
Total Valleys |
LF |
|
Hips |
Total Hips |
LF |
|
Ridges |
Total Ridges |
LF |
|
Waste % |
Suggested Waste Percentage |
% |
|
Roof squares by pitch (0/12 through 24/12) |
One token per pitch: 0/12, 1/12, and so on through 24/12 |
SQ |
|
Gutters |
Gutters |
LF |
|
Downspouts (combined length) |
Downspouts |
LF |
RoofSnap fills pitch tokens in squares, but EagleView, GAF QuickMeasure, Hover, and Roofr fill them in square feet. If you use more than one, check each pitch token's unit.