Skip to main content
Hajj & Umrah Management — A build-to-order ERPNext application for Hajj and Umrah operators to manage pilgrim registration, v — 1/1Illustrative preview

A build-to-order ERPNext application for Hajj and Umrah operators to manage pilgrim registration,

visas, packages, group logistics, and installment payments.

ECOSIRE scopes, builds, installs, and supports it on your bench.

What is Hajj & Umrah Management?

A build-to-order ERPNext application for Hajj and Umrah operators to manage pilgrim registration, visas, packages, group logistics, and installment payments. ECOSIRE scopes, builds, installs, and supports it on your bench. Built to order by ECOSIRE for ERPNext v15, v16 — indicative price from $999.00 USD; request a quote for a scoped proposal.

Key Features

`Pilgrim` DocType with passport, national ID, Mahram link, photo attachment, and a full workflow (Draft → Documents Pending → Visa Issued → Confirmed → Travelled) driven by ERPNext workflow states
`Visa Application` tracking with Nusuk/Tasreeh reference fields, submission and issue dates, and `validate` hooks that block travel assignment until visa status is Issued
Passport-expiry versus travel-date validation in a `hooks.py` doc event, plus a scheduler job that flags passports expiring inside a configurable window
`Package` configurator DocType with tiered pricing, inclusions, Makkah/Madinah nights, and a child table that generates the pilgrim's `Installment Plan` on selection
`Pilgrim Group` DocType with capacity limits, group-leader assignment, and Link-field roll-up of every member's document, payment, and allocation status
Hotel and room `Accommodation Allocation` with block/room-type tracking and an `on_submit` guard preventing double-booking of the same room across overlapping dates
`Transport Allocation` with bus and seat-map assignment; a client script blocks assigning an already-occupied seat and recomputes free seats live
Flight allocation and PNR fields that feed a whitelisted manifest-generation method (`frappe.whitelist()`) producing per-group departure and airline manifests
`Installment Plan` schedule linked to standard ERPNext `Payment Entry`, with a nightly scheduler event sending due and overdue reminders and updating paid-to-date
Frappe REST API exposure of pilgrim, group, and payment endpoints so an external booking portal or visa-agent system can create and update records
Role profiles and permission rules (Visa Officer, Group Coordinator, Accountant, Agent) so each role sees only its documents and fields
Print Formats for pilgrim cards, group manifests, visa cover letters, and installment receipts, rendered via Jinja against the custom DocTypes
Dashboard and Report Views (group fill rate, outstanding installments, visa pipeline, passports expiring soon) built on Query/Script Reports
Optional bilingual (Arabic/English) field labels and RTL-aware Print Formats for GCC operations, on Frappe/ERPNext v15 and v16

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

  1. 1

    You order

    Start with a one-time build price. We scope it with you at kickoff.

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your ERPNext.

  3. 3

    Go live + support

    You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.

Technical Specifications

ERPNext Compatibility
—
License
Licence confirmation required
Python Requirement
Python 3.10+
Database
MariaDB 10.6+

About this Product

Hajj and Umrah operators run a seasonal, document-heavy, high-liability business that stock ERPNext was never shaped for. A single pilgrim record has to carry passport data, visa status, Mahram linkage, a Nusuk/Tasreeh reference, room and seat assignments, and a payment plan spread over months — and hundreds of these have to move through visa cut-offs, hotel allocation windows, and flight manifests as coordinated groups. In native ERPNext you can bend a Customer, a Sales Order, and a Payment Entry to approximate some of this, but there is no pilgrim lifecycle, no group/package structure, no visa-deadline tracking, and no bus-seat or room allocation. Operators end up managing the real work in spreadsheets alongside ERPNext, which breaks the moment a group changes size or a hotel block is reassigned.

ECOSIRE builds a proper Frappe application (ecosire_hajj_umrah) that installs on your own ERPNext bench and adds the domain natively. We model the business as first-class DocTypes — Pilgrim, Pilgrim Group, Package, Visa Application, Accommodation Allocation, Transport Allocation, and Installment Plan — each with proper naming series, links back to standard ERPNext Customer, Sales Order, and Payment Entry documents, and workflow states (Draft, Documents Pending, Visa Issued, Confirmed, Travelled). The pilgrim lifecycle and the package configurator are the core; everything else — hotels, buses, flights, money — hangs off them by Link and Table fields so a change in one place propagates correctly.

Technically, the app is wired the way a maintainable Frappe app should be. Document events in hooks.py (validate, on_submit, on_update) enforce rules such as passport-expiry-versus-travel-date, group-capacity limits, and no-double-booking of a seat or room. Server scripts and whitelisted methods (frappe.whitelist()) expose operations like bulk visa-status updates and manifest generation, callable from the Frappe REST API so your existing portal or a GDS/visa-agent integration can push and pull data. Client scripts drive the in-form UX — auto-filling Mahram details, warning on visa cut-offs, recalculating an installment schedule when a package price changes. Scheduler events run the time-based work: nightly reminders for expiring passports and unpaid installments, and daily recomputation of group fill rates. Access is governed by ERPNext role profiles and permission rules so a visa officer, an accountant, and a group leader each see only what they should.

Because every deployment is scoped to how your agency actually operates — your packages, your hotels in Makkah and Madinah, your bus operators, your visa channel, your installment terms — this is a build-to-order engagement, not a marketplace download. We start with a scoping call, agree the DocTypes and workflows in writing, then build against a staging bench on Frappe/ERPNext v15 (with v16 supported). Typical delivery is one working week from confirmed scope. You receive the installable app source, run UAT on staging, and go live with a support window and the git repository in your hands.

What you get

  • Installable Frappe app source (`ecosire_hajj_umrah`) built for your ERPNext v15/v16 bench, scoped to your packages and workflows
  • Installation and configuration on your bench (or a staging site we provide), including role profiles, naming series, and scheduler setup
  • Technical documentation: DocType schemas, `hooks.py` events, whitelisted methods, and REST endpoint reference
  • End-user guide plus one live training session for your visa, coordination, and accounts teams
  • UAT on a staging bench with a documented rollback plan before any production go-live
  • Post-go-live support window (bug fixes and adjustments) as agreed in the scope
  • Git repository handover with full commit history so you own and can extend the code
  • Data-migration helper scripts to import existing pilgrim and group records from spreadsheets, where applicable

Who this is for

Hajj & Umrah Travel Operator (GCC / South Asia / Africa)

Runs seasonal group tours and needs one system for pilgrim documents, visas, hotel and transport allocation, and staged payments — instead of ERPNext plus a stack of spreadsheets that fall apart when a group changes.

Visa & Documentation Officer

Owns the passport, visa, and Mahram compliance workload and needs deadline-driven tracking, expiry alerts, and a clean pilgrim workflow that won't let an incomplete file be assigned to travel.

Group Coordinator / Logistics Lead

Assembles groups, allocates buses, seats, and hotel rooms, and generates manifests; needs capacity limits, no-double-booking guards, and per-group roll-ups of who is paid, documented, and ready.

Finance / Accounts Manager

Manages installment plans against ERPNext Payment Entries and needs automatic due/overdue reminders, paid-to-date tracking, and package-price changes that recompute schedules without manual re-entry.

How Hajj & Umrah Management Compares

CriterionECOSIRECustom BuildCompetitorERPNext Native
Pilgrim & visa lifecycleNative `Pilgrim`/`Visa Application` DocTypes with workflow states and expiry guardsPossible, but you design the model from zeroRarely offered; generic travel apps miss visa/Mahram logicNo pilgrim or visa concept — bend Customer + custom fields
Group & package management`Pilgrim Group` + `Package` with capacity limits and roll-upsBuildable if your devs know the domainOften a flat booking list, no true group structureNo group/package entity out of the box
Hotel / transport / seat allocationAllocation DocTypes with no-double-booking `on_submit` guardsDepends entirely on spec qualityUsually spreadsheet-level, if presentNot modelled at all
Installment payments`Installment Plan` linked to native Payment Entries + remindersRe-implement scheduling and dunning yourselfBasic or manual; weak ERPNext accounting linkManual payment entries only, no schedule
Fit to your operationScoped to your packages, hotels, visa channel, termsFully bespoke — and fully your maintenance burdenFixed feature set, take it or leave itGeneric ERP, not vertical
ERPNext v15/v16 supportBuilt and tested on both; standard bench installYours to keep version-compatibleVaries; may lag ERPNext releasesCore, but without the vertical features
Delivery & cost modelBuild-to-order, one working week from confirmed scope, fixed quoteOpen-ended timeline and costInstant install, but gaps you'll fill laterFree, but heavy internal configuration effort
Ownership & supportFull git repo handover + post-go-live support windowYou own it and support it aloneVendor-locked; limited source accessCommunity support only

Frequently Asked Questions about Hajj & Umrah Management

Is this a ready-made app I can download and install today?

No. This is a build-to-order engagement. ECOSIRE scopes the app to how your agency actually operates — your packages, hotels, visa channel, and installment terms — then builds, installs, and supports it. There is no instant download.

How long does delivery take?

Typical delivery is one working week from confirmed scope. After the scoping call we agree the DocTypes and workflows in writing; that signed-off scope starts the clock. Larger or heavily integrated builds may run longer, and we'll say so upfront rather than after.

Which ERPNext versions are supported?

We build for Frappe/ERPNext v15 (LTS) and v16. The app installs on your own bench as a standard Frappe app and links to native ERPNext Customer, Sales Order, and Payment Entry documents rather than replacing them.

How are updates and support handled after go-live?

Every project includes a post-go-live support window for bug fixes and adjustments, agreed in the scope. Because you receive the full git repository, your own team can also maintain and extend the code; we offer ongoing support or a maintenance retainer beyond the initial window on request.

Can it connect to our booking portal or a visa agent's system?

Yes. Core operations are exposed through the Frappe REST API and whitelisted server methods (`frappe.whitelist()`), so an external portal, GDS, or visa-agent system can create and update pilgrim, group, and payment records. Specific integrations are scoped and quoted as part of the build.

Will it interfere with our existing ERPNext accounting?

No. Installments link to standard ERPNext Payment Entries and packages to Sales Orders, so revenue and receivables flow through native accounting. The app adds Hajj/Umrah-specific DocTypes alongside ERPNext core — it doesn't fork or override your finance modules.

Do we own the code?

Yes. You receive installable source and the full git repository with commit history at handover. Your version is yours to run, audit, and extend.

Request a quote

Hajj & Umrah Management

A build-to-order ERPNext application for Hajj and Umrah operators to manage pilgrim registration, visas, packages, group logistics, and installment payments. ECOSIRE scopes, builds, installs, and supports it on your bench.

  • `Pilgrim` DocType with passport, national ID, Mahram link, photo attachment, and a full workflow (Draft → Documents Pending → Visa Issued → Confirmed → Travelled) driven by ERPNext workflow states
  • `Visa Application` tracking with Nusuk/Tasreeh reference fields, submission and issue dates, and `validate` hooks that block travel assignment until visa status is Issued
  • Passport-expiry versus travel-date validation in a `hooks.py` doc event, plus a scheduler job that flags passports expiring inside a configurable window
  • `Package` configurator DocType with tiered pricing, inclusions, Makkah/Madinah nights, and a child table that generates the pilgrim's `Installment Plan` on selection

Request a Quotation

Tell us about your Hajj & Umrah Management requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.