About the service - Business rules

Version 2.00 (Released 01/03/2023 - Updated 07/06/2024)

Index

© Crown copyright 2023, except where otherwise stated.

---

1.1. General rules and validation

(Previously section 1 in Business rules v1.x)

1.1.1. Numbers

All numbers within Street Manager system are non-negative.

1.1.2. Dates and times

Note: Street Manager receives bank holiday data from gov.uk up to the end of the following year, any works that extend beyond that will not be factoring in bank holidays.

1.1.2.1. Date and time format

All dates and times must match the ISO 8601 standard date format.

See GOV.UK guidance for date-times https://www.gov.uk/government/publications/open-standards-for-government/date-times-and-time-stamps-standard

1.1.2.2. Calendar days

Street Manager calculates calendar days based on a 24 hour clock.

For example, the Street Manager system would consider the time period Monday 01:00 to Tuesday 23:00 as 2 calendar days.

1.1.2.3. Calendar month

Street Manager calculates a calendar month as 28 calendar days for the purpose of deeming and early start.

1.1.3. Coordinates

Coordinates must be a GeoJSON geometry (easting and northing pairs, using British National Grid / EPSG:27700 spatial reference).

Please observe the following, when obtaining and displaying coordinates using maps other than the one in Street Manager:

• Map applications outside Street Manager may use a different projection (mathematical formula to map earth’s curvature onto a flat plane).
  • For example OSBG36, WGS84 and ED50 are all widely used in Britain and yet these different systems of latitude and longitude can disagree on the coordinates of a point by up to 200m
• Maps show the general position of coordinates but cannot be used to accurately determine boundaries

1.1.4. Unique Street Reference Number (USRN)

• USRN must be a value between 100001 and 99999999.
• Currently supported USRNs:
  • Street state codes: 1 and 2 (See NSG spec v2.10 table 5.1.2)
  • Reinstatement type codes: 1-10 (See NSG spec v2.10 table 7.2)
  • Street Maintenance responsibility (STREET_STATUS): 1, 2 & 3 (See NSG spec v2.10 table 6.1)
• See the API documentation for details on backwards compatibility.
• If there are multiple reinstatement type codes, one must be selected when raising a forward plan or PAA/PA.

1.1.5. File uploads

• Maximum file size is 10MB.
• All files on a single work record must total less than 100mb.
• Street Manager has a file upload limit of 50 files for each individual:
  • Work Record
  • Permit
  • FPN
  • Section 81
  • Section 74
  • Inspection
  • Reinstatements
  • Historic Works
• Street Manager has a list of allowed file types when uploading a file to the system:
  • doc
  • docx
  • pdf
  • png
  • jpeg
  • jpg
  • tiff
  • bmp
• File name must be 100 characters or less.
• Some character, for example an apostrophe (‘), are not allowed as part of the file name.

1.1.6. Text character limits

1.1.6.1. Username field

The max length for username fields is 50 characters.

1.1.6.2. Single-line text fields

Max length is 100 characters.

These include:

• Promoter contact details
• Approved contractor
• Contractor details
• Secondary contact email
• Project reference number
• Early start pre-approval authoriser
• Promoter org
• Promoter contact details
• Approved contractor
• Contractor contact details
• Street name
• Area name
• Project reference number
• Inspection call log field
• Inspection call log reference
• Inspector name
• FPN authorised officer
• FPN officer contact details
• Activity name
• Activity type details
• Contact name
• Contact details
• Street special designation code
• Emergency contact
• Emergency contact number

1.1.6.3. Multi-line text areas

Text areas for large comment fields are limited to the max length of 1500 characters.

All other text areas are limited to 500 characters. These include:

• Description of work
• Works location description
• Collaboration details
• Description of collaborative works
• Early start pre approval details
• Early start pre approval reason
• Additional info (apply for works) / comments (revoke) / details (lane rental assessment / collaborative working)
• Revoke reason
• Permit discount reason
• Reinstatement location description
• Inspection outcome details
• Inspection call log summary
• FPN offence details
• FPN status reason
• Activity location description
• Cancellation reason

---

1.2. Workstreams

(Previously section 2 in Business rules v1.x)

The Street Manager system will, by default, create a workstream with the prefix of ‘000’ for every organisation. Before users start raising works in Street Manager (production), their organisation must set up their workstreams as PAA/PAs cannot be raised using the ‘000’ workstream.

When organisations set up their workstreams, they can choose to allocate numerical prefixes between 1 - 999. See works reference number (WRN) section for details on how the workstream prefix will be used when raising works.