Hire of Halls

Service documentation · Republic of Zambia · GSB e-Services

Owner	Department of Local Government
Service key	LGD/hire-of-halls
Version	service v1, platform 39fb88e4
Date	2026-10-21

Generated automatically by the service's end-to-end test run. Every screenshot shows synthetic test data on a local test installation, never real personal data.

This document describes the Hire of Halls service of Department of Local Government as the platform runs it today. It is generated by the service's end-to-end test: every step below was performed by the test, and every screenshot was taken during that run with synthetic data. Regenerate it with npm run docs:services in the e2e suite; do not edit it by hand.

1. Service summary

Item	Detail
Service	Hire of Halls
Owner (MDA)	Department of Local Government (LGD)
Purpose	Hire of Council’s facilities, including halls and designated photo-booth spaces, by members of the public for various activities such as meetings, weddings, conferences, exhibitions, and other events.
Who can apply	Individual; Organization
How to apply	Online on the national e-Services portal, signed in with ZamPass; pay with ZamPay.
Fees	Not set in the service configuration.
Turnaround	One (1) working day
Validity of the output	Subject to Cancellation by the Council
Required documents	Applicant/Representative Identity Document (required) Applicant/Representative Certificate of Registration (required)
Output documents	GS-1 Application for a Government Service GS-2 Notice of Government Action

2. Application process, step by step

The process as configured in the back office:

Step	Role	Task	Type
1	Applicant	Apply	form
2	Applicant	Payment	payment
3	System	Generate Document	generate-document
4	System	Notify Client	notify

Who takes part in this journey: Citizen, Anyone (public).

Step 1. Find the service at the council

Citizen · National e-Services portal

The service is delivered by the local authorities: on the national e-Services portal the citizen opens Councils, chooses their council (Lusaka City Council in this run) and searches its services ("Hire of Halls"). The application is then registered with that council and priced with its own fees.

Step 2. Read the service page

Citizen · National e-Services portal

The service page sets out what the service is for, the fee, how long it takes and the documents to have ready, and names the council the application goes to. "Start application" begins an application at Lusaka City Council (the citizen is signed in with ZamPass).

Step 3. Confirm the applicant details

Citizen · National e-Services portal

The applicant details are filled in from the citizen's ZamPass account. The citizen says whom they are applying for (themself) and continues with "Proceed to Application".

Step 4. Fill in the application form

Citizen · National e-Services portal

The citizen answers the service's own application form, converted from the legacy system (4 answers in this run, all synthetic), for the type of application "New". Questions marked * must be answered; some appear only after an earlier answer. Answers are saved as the citizen types, so an unfinished application can be reopened from My Workplace.

Step 5. Upload the supporting documents

Citizen · National e-Services portal

Each document the service asks for has its own upload (2 in this run: Applicant/Representative Identity Document, Applicant/Representative Certificate of Registration). The files are checked and stored with the application; the page confirms each upload.

Step 6. Check the answers and confirm the declaration

Citizen · National e-Services portal

Before sending, the citizen sees every answer and document on one page and can go back to change them. The declaration that the information is true and complete must be ticked.

Step 7. Application sent

Citizen · National e-Services portal

The portal confirms the application with the ministry's reference number (LGD-HH/00001/10-21-26 in this run). The fee is due now: it is taken with the application, so the invoice was raised when the application was sent.

Step 8. See that the fee is due

Citizen · National e-Services portal

The application shows "Waiting for your payment" in My Workplace with a Pay button (K1,000.00). The fee is taken with the application; the invoice was raised on ZamPay.

Step 9. Pay with ZamPay

Citizen · National e-Services portal

Pay opens the invoice (K1,000.00, the amount set by the platform, never by the page) with its PDF preview; the citizen pays at ZamPay by mobile money or bank card.

Step 10. Payment received

Citizen · National e-Services portal

ZamPay reports the payment; the dialog says "Paid. Thank you" and the application moves on to the ministry's officers.

Step 11. The document in My permits

Citizen · National e-Services portal

The issued document (LGD-HH-2026-00001 in this run: "Hire of Halls") is listed in "My permits and licences" with its validity and a download of the sealed PDF.

Step 12. Verify the document

Anyone (public) · Public verification page

The QR code on the document opens the public verification page: genuine and current, to whom it was issued, and whether the electronic seal is valid. No sign-in is needed.

3. Payment

Item	In the test run
Fee (as published)	none
Invoice 1	9371365613074086
Amount 1	ZMW 1000.00
Paid at 1	with the application

On screen: step 8 (See that the fee is due), step 9 (Pay with ZamPay), step 10 (Payment received) in section 2.

4. Output documents

Hire of Halls (sealed PDF)

Issued when the case was approved, from the service's output configuration (permitDocument/issued@1), filled from the application and the decision, sealed with the platform's electronic seal and stored as the issued version. The holder downloads it from My permits; the verification page checks it.

The issued PDF has 1 page; the image shows the first.

Fields

Field	Value in the test run
Document title	Hire of Halls
Permit / licence number	LGD-HH-2026-00001
Holder	Chanda Mwila
Valid from	2026-10-21
Valid until
Status	active
Verification code (printed with a QR code)	BZ4D-BLK8-GY

Seal

Item	Detail
Seal status	sealed
Signature level	PAdES-B-T
Sealed by	the platform seal (development key in the test run)
Signed at	2026-10-21T11:32:31.508Z
Trusted time-stamp	2026-10-21T11:32:31.995Z (time-stamping authority)
Document fingerprint (SHA-256)	a228dca16b5178ae...

Verification

Item	Detail
Where	The public verification page of the national portal, <portal>/verify/<verification code>, opened by scanning the QR code on the document.
What it shows	Whether the document is genuine and current, its holder and validity, and whether the electronic seal is valid and who sealed it.
Checking a copy	Anyone can upload a PDF they were given; the page says whether it is exactly the document that was issued. A changed copy is reported as not matching.

On screen: step 11 (The document in My permits), step 12 (Verify the document) in section 2.

5. Notifications

When	Channel	To	Message	Delivery
Payment due (invoice raised)	in-app (portal bell)	the applicant	Payment due for application LGD-HH/00001/10-21-26 - The fee of ZMW 1000.00 for Hire of Halls (LGD-HH/00001/10-21-26) is now due. Invoice 9371365613074086.	shown
Application received	in-app (portal bell)	the applicant	Application LGD-HH/00001/10-21-26 received - Your application LGD-HH/00001/10-21-26 for Hire of Halls has been received by Department of Local Government.	shown
Licence / permit issued	in-app (portal bell)	the applicant	Your Hire of Halls document has been issued - LGD-HH-2026-00001 has been issued for Hire of Halls.	shown
Invitation to rate the service	in-app (portal bell)	the applicant	How was Hire of Halls? - How was Hire of Halls? Tell us in about a minute.	shown
Payment received	in-app (portal bell)	the applicant	Payment received for LGD-HH/00001/10-21-26 - Your payment of ZMW 1000.00 for LGD-HH/00001/10-21-26 (Hire of Halls) has been received. Receipt: <ZamPay>/pdf?documentType=receipt&invoiceNumber=9371365613074086	shown
Decision: approved	in-app (portal bell)	the applicant	Application LGD-HH/00001/10-21-26 completed - LGD-HH/00001/10-21-26 (Hire of Halls) is complete. Your documents are ready.	shown
Payment due (invoice raised)	email	e2e.c***@example.test	Payment due for application LGD-HH/00001/10-21-26	skipped
Payment due (invoice raised)	sms	+260 97* *** 567	Fee of ZMW 1000.00 due for LGD-HH/00001/10-21-26. Invoice 9371365613074086. Pay: <ZamPay>/pay-for-service/get-invoice/9371365613074086	delivered
Application received	sms	+260 97* *** 567	Application LGD-HH/00001/10-21-26 for Hire of Halls has been received. Track it: <portal>/my-workplace	delivered
Application received	email	e2e.c***@example.test	Application LGD-HH/00001/10-21-26 received	skipped
Invitation to rate the service	sms	+260 97* *** 567		skipped
Invitation to rate the service	email	e2e.c***@example.test	How was Hire of Halls?	skipped
Licence / permit issued	sms	+260 97* *** 567		sent
Licence / permit issued	email	e2e.c***@example.test	Your Hire of Halls document has been issued	skipped
Payment received	sms	+260 97* *** 567		delivered
Decision: approved	email	e2e.c***@example.test	Application LGD-HH/00001/10-21-26 completed	skipped
Decision: approved	sms	+260 97* *** 567		delivered

Delivery: shown = in the portal's notification bell; delivered = the SMS gateway (a test double in this run) reported the text delivered; skipped = not sent on that channel (e-mail is not configured on the test installation, and some notices go out on one channel only); sent by the national portal = a ministry node handed the notice to the national portal, which texts and e-mails the citizen under its own name and the citizen's preferences. Addresses written <portal>, <ZamPay> stand for the national portal and ZamPay.

6. Legacy mapping

Item	Detail
Replaces	Hire of Halls in the legacy ZIGS e-Services directory (ZIGS_Services)
Legacy service id	650
Legacy provider	Department of Local Government (LGD) under Ministry of Local Government and Rural Development
Legacy process	not recorded
Fee in the legacy system	none
Fee taken before submission	yes (as in ZIGS)
Time to issue (legacy)	not recorded
Legacy output templates	GS-1 Application for a Government Service: ZIGS_Forms_ZDA / GS1 GS-2 Notice of Government Action: ZIGS_Forms_Notices / GS-2.NoticeOfAction
Legacy address	https://ecouncils.gsb.gov.zm
How it was brought over	Imported by the platform's legacy catalogue importer (zcm-backend scripts/zigs/importLegacy.js) from the ZIGS snapshot: form, case types, fees, documents, process and output templates, then served by the new platform.

7. Version and date

Item	Detail
Document version	service v1, platform 39fb88e4
Generated	2026-10-21T11:32:39Z (by the end-to-end run, not edited by hand)
Service version	not versioned (configured directly)
Platform snapshot	backend 39fb88e4 portal 72805f0 back office 58e5946
Test suite	e2e 2f82c10; one installation (combined); seed profile mihud
Journeys	30-catalogue-service.spec.js: citizen finds the service, answers its form, uploads its documents and sends the application - passed 30-catalogue-service.spec.js: the case goes through every step of its process: payments by the citizen, each officer step by its role - passed 30-catalogue-service.spec.js: the grant document is issued, sealed, filled in and verifiable; the citizen has it in My permits - passed
Result	3 of 3 journey tests passed
Data	Synthetic test data on a local test installation; provider test doubles for ZamPass, ZamPay, SMS and signing.