[{"data":1,"prerenderedAt":1003},["ShallowReactive",2],{"guide:en:work-fulfillment/reports":3},{"id":4,"title":5,"body":6,"description":995,"extension":996,"meta":997,"navigation":998,"path":999,"seo":1000,"stem":1001,"__hash__":1002},"guide_en/en/user/work-fulfillment/reports.md","Reports — Documenting Completed Field Work",{"type":7,"value":8,"toc":979},"minimark",[9,14,18,23,34,40,80,85,99,104,118,122,125,176,182,186,192,197,211,215,226,229,233,236,277,282,303,307,313,318,332,336,339,344,363,368,382,387,401,405,415,419,469,475,486,492,506,510,513,518,529,534,547,553,564,568,573,599,604,624,628,631,636,642,647,653,658,664,667,671,678,698,709,718,722,727,747,753,791,796,810,814,819,830,835,846,851,865,870,881,886,897,902,916,920,926,943,949,963,968],[10,11,13],"h1",{"id":12},"reports","Reports",[15,16,17],"p",{},"Reports are the field worker's record of completed work. When a worker finishes an installation, repair, or inspection, they submit a report capturing what was done, which materials were used, where the work took place, and any photos or notes. Submitting a report automatically creates inventory consumption transactions and feeds into payment calculations — no separate paperwork required.",[19,20,22],"h2",{"id":21},"report-structure","Report Structure",[15,24,25,30],{},[26,27],"img",{"alt":28,"src":29},"Reports List","/guide/work-fulfillment/reports-list.png",[31,32,33],"em",{},"Reports page showing field execution records with consumption and status",[15,35,36],{},[37,38,39],"strong",{},"Core Fields:",[41,42,43,50,56,62,68,74],"ul",{},[44,45,46,49],"li",{},[37,47,48],{},"Name"," - Report title or summary",[44,51,52,55],{},[37,53,54],{},"Description"," - Detailed notes, observations, issues encountered",[44,57,58,61],{},[37,59,60],{},"Reported By"," - User who submitted report",[44,63,64,67],{},[37,65,66],{},"Report Date"," - When work was performed",[44,69,70,73],{},[37,71,72],{},"Work order"," - Optional link to parent assignment",[44,75,76,79],{},[37,77,78],{},"Geometry"," - Location where work performed (point, line, or polygon)",[15,81,82],{},[37,83,84],{},"Work Documentation:",[41,86,87,93],{},[44,88,89,92],{},[37,90,91],{},"Work Completed"," - Array of resources consumed and tasks finished",[44,94,95,98],{},[37,96,97],{},"Consumed From"," - Which stock items were depleted (triggers transactions)",[15,100,101],{},[37,102,103],{},"Media:",[41,105,106,112],{},[44,107,108,111],{},[37,109,110],{},"Photos"," - Before/after images, issues encountered",[44,113,114,117],{},[37,115,116],{},"Attachments"," - Documents, diagrams, certifications",[19,119,121],{"id":120},"work-completed-structure","Work Completed Structure",[15,123,124],{},"Each entry in the Work Completed list documents one type of work performed:",[126,127,128,140],"table",{},[129,130,131],"thead",{},[132,133,134,138],"tr",{},[135,136,137],"th",{},"Field",[135,139,54],{},[141,142,143,152,160,168],"tbody",{},[132,144,145,149],{},[146,147,148],"td",{},"Resource",[146,150,151],{},"What was done (e.g., Cat6 Cable, Junction Boxes, Electrician)",[132,153,154,157],{},[146,155,156],{},"Volume",[146,158,159],{},"How much was completed (e.g., 45, 8, 3.5)",[132,161,162,165],{},[146,163,164],{},"Unit of Measure",[146,166,167],{},"The unit for the volume (e.g., meters, units, hours)",[132,169,170,173],{},[146,171,172],{},"Task",[146,174,175],{},"Optional — which task this work contributes to",[15,177,178,181],{},[37,179,180],{},"Example:"," A worker reports installing 45 m of Cat6 Cable, 8 Junction Boxes, and 3.5 hours of electrician labour, all against the same task.",[19,183,185],{"id":184},"ad-hoc-reports-no-formal-task","Ad-Hoc Reports (No Formal Task)",[15,187,188,189,191],{},"The ",[37,190,172],{}," field on each work completed entry is optional — this supports unplanned work:",[15,193,194],{},[37,195,196],{},"Use Cases:",[41,198,199,202,205,208],{},[44,200,201],{},"Emergency repairs (broken equipment, accidents)",[44,203,204],{},"Customer service calls (unplanned site visits)",[44,206,207],{},"Maintenance discovered during other work",[44,209,210],{},"Exploratory work (surveys, assessments)",[15,212,213],{},[37,214,180],{},[216,217,222],"pre",{"className":218,"code":220,"language":221},[219],"language-text","Report: \"Emergency fiber repair - storm damage\"\nWork Completed: [\n  { resource: \"Fiber Cable\", volume: 20, uom: \"meters\" }\n  // No task linked - this was unplanned emergency work\n]\nConsumed From: [\n  { stockItemId: truck_fiber_id, resource: \"Fiber Cable\", volume: 20, uom: \"meters\" }\n]\n","text",[223,224,220],"code",{"__ignoreMap":225},"",[15,227,228],{},"System still creates consumption transactions, tracks material costs, calculates payment - even without formal task assignment.",[19,230,232],{"id":231},"consumed-from-automatic-transactions","Consumed From (Automatic Transactions)",[15,234,235],{},"The Consumed From list triggers automatic inventory deduction when the report is submitted:",[126,237,238,246],{},[129,239,240],{},[132,241,242,244],{},[135,243,137],{},[135,245,54],{},[141,247,248,256,263,270],{},[132,249,250,253],{},[146,251,252],{},"Stock Item",[146,254,255],{},"Which stock item to deduct from (e.g., your truck's cable stock)",[132,257,258,260],{},[146,259,148],{},[146,261,262],{},"What resource was consumed",[132,264,265,267],{},[146,266,156],{},[146,268,269],{},"How much was used",[132,271,272,274],{},[146,273,164],{},[146,275,276],{},"The unit for the volume",[15,278,279],{},[37,280,281],{},"Workflow:",[283,284,285,288,291,294,297,300],"ol",{},[44,286,287],{},"Worker submits report with Consumed From entries",[44,289,290],{},"System validates stock availability at each stock item",[44,292,293],{},"Consumption transactions created automatically",[44,295,296],{},"Transactions linked to this report",[44,298,299],{},"Stock item balances reduced",[44,301,302],{},"If insufficient stock → report rejected or worker prompted for partial",[15,304,305],{},[37,306,180],{},[216,308,311],{"className":309,"code":310,"language":221},[219],"Consumed From: [\n  { stockItemId: johns_truck_cable, resource: \"Cat6 Cable\", volume: 45, uom: \"meters\" },\n  { stockItemId: johns_truck_boxes, resource: \"Junction Boxes\", volume: 8, uom: \"units\" }\n]\n\nResult:\n  - 2 consumption transactions created\n  - John's truck inventory reduced by 45m cable, 8 boxes\n  - Transactions linked to this report\n  - Payment calculation has reliable consumption data\n",[223,312,310],{"__ignoreMap":225},[15,314,315],{},[37,316,317],{},"Benefits:",[41,319,320,323,326,329],{},[44,321,322],{},"Stock always accurate (can't report work without recording consumption)",[44,324,325],{},"Transaction audit trail automatic",[44,327,328],{},"Prevents \"ghost consumption\" (report without stock change)",[44,330,331],{},"Payment based on actual materials used",[19,333,335],{"id":334},"report-validation","Report Validation",[15,337,338],{},"When report submitted, system validates:",[15,340,341],{},[37,342,343],{},"Stock Availability:",[41,345,346,349],{},[44,347,348],{},"Each consumed-from entry is checked",[44,350,351,352],{},"If a stock item has insufficient volume → options:\n",[283,353,354,357,360],{},[44,355,356],{},"Reject entire report (error message)",[44,358,359],{},"Prompt for partial consumption (reduce reported volume)",[44,361,362],{},"Allow negative balance (with warning - requires adjustment transaction later)",[15,364,365],{},[37,366,367],{},"Work-Consumption Match:",[41,369,370,373,376,379],{},[44,371,372],{},"Warning if consumption totals don't align with work completed volumes",[44,374,375],{},"Example: Reported 50 m cable work, but only 30 m consumed from stock",[44,377,378],{},"Doesn't block submission (worker might have used personal materials)",[44,380,381],{},"Flags for validation review",[15,383,384],{},[37,385,386],{},"Geometry Validation:",[41,388,389,392,395,398],{},[44,390,391],{},"Points must have valid coordinates",[44,393,394],{},"Lines must have at least 2 points",[44,396,397],{},"Polygons must close (first point = last point)",[44,399,400],{},"Work location must be within reasonable distance of task geometry (configurable)",[19,402,404],{"id":403},"creating-reports","Creating Reports",[15,406,407,410,411,414],{},[37,408,409],{},"Access Required:"," ",[223,412,413],{},"reportsCreate"," admin right (or self-reporting permission)",[15,416,417],{},[37,418,281],{},[283,420,421,424,427,430,433,447,460,463,466],{},[44,422,423],{},"Navigate to Fulfillment → Reports",[44,425,426],{},"Click \"Add Report\"",[44,428,429],{},"Fill basic info (name, description, date)",[44,431,432],{},"Link to assignment (optional - needed for progress tracking)",[44,434,435,436],{},"Add work completed entries:\n",[41,437,438,441,444],{},[44,439,440],{},"Select resource",[44,442,443],{},"Enter volume completed",[44,445,446],{},"Link to task (optional)",[44,448,449,450],{},"Add consumed from entries:\n",[41,451,452,455,457],{},[44,453,454],{},"Select stock item (usually worker's personal site)",[44,456,440],{},[44,458,459],{},"Enter volume consumed",[44,461,462],{},"Set geometry (where work performed)",[44,464,465],{},"Upload photos/attachments",[44,467,468],{},"Submit → transactions created automatically",[15,470,471,474],{},[37,472,473],{},"Quick Report from Work order:","\nPre-filled form from assignment detail view:",[41,476,477,480,483],{},[44,478,479],{},"Work order, assigned to, available tasks auto-populated",[44,481,482],{},"Suggested consumption based on resource targets",[44,484,485],{},"Worker adjusts actuals and submits",[15,487,488,491],{},[37,489,490],{},"Mobile Report Creation:","\nSimplified mobile interface:",[41,493,494,497,500,503],{},[44,495,496],{},"Camera integration for photos",[44,498,499],{},"GPS auto-capture for geometry",[44,501,502],{},"Voice-to-text for descriptions",[44,504,505],{},"Minimal required fields",[19,507,509],{"id":508},"report-progress-contribution","Report Progress Contribution",[15,511,512],{},"Reports update task and assignment progress:",[15,514,515],{},[37,516,517],{},"Task Progress:",[41,519,520,523,526],{},[44,521,522],{},"Sum all work completed for this task (from all reports)",[44,524,525],{},"Divide by task resource requirements",[44,527,528],{},"Cap at 100% per resource",[15,530,531],{},[37,532,533],{},"Work Order Progress:",[41,535,536,539,542,544],{},[44,537,538],{},"Sum all work completed for this assignment (from all reports)",[44,540,541],{},"Divide by assignment resource targets",[44,543,528],{},[44,545,546],{},"Calculate average across all targets",[15,548,549,552],{},[37,550,551],{},"Over-Delivery:","\nWorker can report more than assigned:",[41,554,555,558,561],{},[44,556,557],{},"Contributes to task progress (helps complete task faster)",[44,559,560],{},"Work order progress capped at 100% (worker exceeded targets)",[44,562,563],{},"Validation reviews over-delivery (verify accuracy)",[19,565,567],{"id":566},"report-detail-view","Report Detail View",[15,569,570],{},[37,571,572],{},"Information Shown:",[41,574,575,578,581,584,587,590,593,596],{},[44,576,577],{},"Basic details (name, description, date, reported by)",[44,579,580],{},"Work order link (if applicable)",[44,582,583],{},"Work completed list with task references",[44,585,586],{},"Consumed from list with stock item links",[44,588,589],{},"Consumption transactions (auto-created)",[44,591,592],{},"Photos and attachments",[44,594,595],{},"Geometry on map",[44,597,598],{},"Validation results (if QC performed)",[15,600,601],{},[37,602,603],{},"Actions Available:",[41,605,606,609,612,615,618,621],{},[44,607,608],{},"Edit report (before validation)",[44,610,611],{},"Upload additional photos",[44,613,614],{},"Add comments/notes",[44,616,617],{},"Request validation",[44,619,620],{},"View consumption transactions",[44,622,623],{},"Print report (PDF export)",[19,625,627],{"id":626},"payment-calculation","Payment Calculation",[15,629,630],{},"Reports drive payment workflows:",[15,632,633],{},[37,634,635],{},"Labor Payment:",[216,637,640],{"className":638,"code":639,"language":221},[219],"Work Completed:\n  - Electrician: 3.5 hours\n  \nPayment = 3.5 hours × hourly rate\n",[223,641,639],{"__ignoreMap":225},[15,643,644],{},[37,645,646],{},"Material Costs:",[216,648,651],{"className":649,"code":650,"language":221},[219],"Consumed From:\n  - Cat6 Cable: 45m × $2/m = $90\n  - Junction Boxes: 8 units × $15/unit = $120\n  \nTotal Material Cost = $210\n",[223,652,650],{"__ignoreMap":225},[15,654,655],{},[37,656,657],{},"Total Job Cost:",[216,659,662],{"className":660,"code":661,"language":221},[219],"Labor + Materials = Payment to worker + Material cost = Total\n",[223,663,661],{"__ignoreMap":225},[15,665,666],{},"Transaction audit trail provides reliable material costs (can't inflate consumption - tied to actual stock depletion).",[19,668,670],{"id":669},"validation-badges-on-the-reports-list","Validation Badges on the Reports List",[15,672,673,674,677],{},"Validations are now surfaced directly on the reports page as traffic-light badges — you no longer navigate to a separate ",[223,675,676],{},"/fulfillment/validations"," page to view or create them. Each report row has:",[41,679,680,691],{},[44,681,682,683,686,687,690],{},"An ",[37,684,685],{},"aggregate validation badge"," in its own column, showing the most-severe status with a count (e.g. ",[223,688,689],{},"FAILED · 3","). Hover for a per-status breakdown.",[44,692,693,694,697],{},"A ",[37,695,696],{},"status-grouped badge row"," inside the expanded report, with one badge per validation.",[15,699,700,701,704,705,708],{},"Clicking any badge opens the ",[223,702,703],{},"ValidationEditModal"," — a full overlay for viewing, editing, or creating a validation without leaving the report. The ",[37,706,707],{},"Submit"," button in the modal commits report and validation edits together atomically.",[15,710,711,712,717],{},"See ",[713,714,716],"a",{"href":715},"/guide/work-fulfillment/validations","Validations"," for the full walkthrough.",[19,719,721],{"id":720},"filtering-reports","Filtering Reports",[15,723,724],{},[37,725,726],{},"Pre-Built Filters:",[41,728,729,735,741],{},[44,730,731,734],{},[37,732,733],{},"Reported by me"," - Your submitted reports",[44,736,737,740],{},[37,738,739],{},"Needs validation"," - Reports without any validation (grey badge)",[44,742,743,746],{},[37,744,745],{},"Recent"," - Last 7 days",[15,748,749,752],{},[37,750,751],{},"Validation Status Filter:","\nThe reports list accepts a validation status filter with these options:",[41,754,755,761,767,773,779,785],{},[44,756,757,760],{},[223,758,759],{},"all"," - every report (default)",[44,762,763,766],{},[223,764,765],{},"none"," - reports without any validation",[44,768,769,772],{},[223,770,771],{},"any"," - reports with at least one validation",[44,774,775,778],{},[223,776,777],{},"failed"," - reports with at least one failed validation",[44,780,781,784],{},[223,782,783],{},"revision"," - reports with at least one needs-revision validation",[44,786,787,790],{},[223,788,789],{},"passed"," - reports where all validations pass",[15,792,793],{},[37,794,795],{},"Custom Filters:",[41,797,798,801,804,807],{},[44,799,800],{},"Date range",[44,802,803],{},"Reported by specific user",[44,805,806],{},"Assignment",[44,808,809],{},"Task reference",[19,811,813],{"id":812},"best-practices","Best Practices",[15,815,816],{},[37,817,818],{},"Accurate Consumption Reporting:",[41,820,821,824,827],{},[44,822,823],{},"Report actual materials used (not estimated)",[44,825,826],{},"Use stock items from your personal site (proves you had materials)",[44,828,829],{},"Document over-consumption (explain why more materials needed)",[15,831,832],{},[37,833,834],{},"Timely Submission:",[41,836,837,840,843],{},[44,838,839],{},"Submit reports same day as work performed",[44,841,842],{},"GPS and timestamps provide accountability",[44,844,845],{},"Fresh memory = more accurate details",[15,847,848],{},[37,849,850],{},"Photo Documentation:",[41,852,853,856,859,862],{},[44,854,855],{},"Before photos (site condition)",[44,857,858],{},"During photos (work in progress)",[44,860,861],{},"After photos (completed installation)",[44,863,864],{},"Issues photos (damage, obstacles, non-standard conditions)",[15,866,867],{},[37,868,869],{},"Detailed Descriptions:",[41,871,872,875,878],{},[44,873,874],{},"Note any deviations from task requirements",[44,876,877],{},"Document reasons for over/under-consumption",[44,879,880],{},"Record issues for future reference (locked gates, missing permits, weather)",[15,882,883],{},[37,884,885],{},"Link to Tasks When Possible:",[41,887,888,891,894],{},[44,889,890],{},"Helps track task progress",[44,892,893],{},"Enables spatial analysis (where work concentrated)",[44,895,896],{},"Improves future task estimation",[15,898,899],{},[37,900,901],{},"Respond to Validation Findings:",[41,903,904,907,910,913],{},[44,905,906],{},"Review validation results promptly",[44,908,909],{},"Provide clarification if questioned",[44,911,912],{},"Correct errors in future reports",[44,914,915],{},"Learn from quality feedback",[19,917,919],{"id":918},"report-immutability","Report Immutability",[15,921,922,925],{},[37,923,924],{},"Soft Deletes:","\nReports can be marked deleted but stay in database:",[41,927,928,931,934,937],{},[44,929,930],{},"Preserves transaction history (consumption transactions remain)",[44,932,933],{},"Maintains payment audit trail",[44,935,936],{},"Configurable retention period (app settings)",[44,938,939,942],{},[223,940,941],{},"viewDeleted"," admin right to see deleted reports",[15,944,945,948],{},[37,946,947],{},"Edit Restrictions:","\nAfter validation performed:",[41,950,951,954,957,960],{},[44,952,953],{},"Reports become read-only",[44,955,956],{},"Corrections require new report with notes",[44,958,959],{},"Preserves QC integrity",[44,961,962],{},"Version history tracks all changes before validation",[15,964,965],{},[37,966,967],{},"Audit Trail:",[41,969,970,973,976],{},[44,971,972],{},"Every report edit logged (who, when, what changed)",[44,974,975],{},"Consumption transactions never edited (immutable)",[44,977,978],{},"Payment calculations traceable to original report data",{"title":225,"searchDepth":980,"depth":980,"links":981},2,[982,983,984,985,986,987,988,989,990,991,992,993,994],{"id":21,"depth":980,"text":22},{"id":120,"depth":980,"text":121},{"id":184,"depth":980,"text":185},{"id":231,"depth":980,"text":232},{"id":334,"depth":980,"text":335},{"id":403,"depth":980,"text":404},{"id":508,"depth":980,"text":509},{"id":566,"depth":980,"text":567},{"id":626,"depth":980,"text":627},{"id":669,"depth":980,"text":670},{"id":720,"depth":980,"text":721},{"id":812,"depth":980,"text":813},{"id":918,"depth":980,"text":919},"Field workers submit reports to record what was done, materials consumed, GPS location, and photos. Submitting a report automatically deducts inventory and feeds into payment calculations.","md",{},true,"/en/user/work-fulfillment/reports",{"title":5,"description":995},"en/user/work-fulfillment/reports","KfJx1N4Nu7AnEnFrhmKZSP_4wU4v2dta7bdX3dGaBDE",1776295549441]