Agencies are paid a fee when a candidate they submitted is hired for the position they submitted them to. Jadiroon prepares the paperwork; the payment itself happens in your ERP or bank.
Lifecycle
| Status | What happens |
|---|---|
| Draft | Created automatically when the candidate is hired. Staff with suppliers.act confirm or edit the base, amount and VAT rate. |
| Issued | Staff issue it: the number INV-<year>-<seq> is allocated, the due date is set from the contract's payment terms and the supplier is emailed. The agency can upload its own tax invoice (PDF and number) until approval. |
| Approved | Needs suppliers.invoices.approve and a Verified supplier. The approval goes through your delegation of authority rules. A payment voucher is generated. |
| Paid | suppliers.payments.record (or the API) marks it paid from Approved, with a payment reference and a paid date. The supplier is emailed. |
| Cancelled | A reason is required. Staff with suppliers.act cancel a draft or issued invoice; once approved, cancelling needs suppliers.invoices.approve. A cancelled invoice's voucher is void. |
A university hire creates no invoice. If the automatic draft fails, the hire is not affected: you get a notification and can create the invoice by hand (Create invoice on a Hired submission, or on a possible-claim alert).
How the fee is computed
For a percent fee, the base is the annual salary of the position, taken from its pay grade (step 1 if no step is set), else the position's own base salary, else the job description's minimum, else missing. The invoice snapshots the base and its source. Then amount = base x percent, VAT = amount x VAT rate, total = amount + VAT, rounded half-up to two decimals. A draft with a missing base ("Salary needed") cannot be issued until you enter one. A fixed fee needs no base.
The base and its source are shown only to users with structure.functional.salary. Everyone with suppliers.view sees amount, VAT and total. The supplier portal never shows the base.
Payment voucher
When an invoice is approved Jadiroon generates the voucher PV-<year>-<seq>: a bilingual PDF with your workspace, the beneficiary (legal name, CR, VAT), the full IBAN and bank, the invoice reference, amount, VAT, total, the source hire, the approver, and an empty box for "executed in ERP". The IBAN is a snapshot, so a later edit to the supplier does not change an issued voucher. If rendering fails the invoice is still approved and the voucher shows Regenerate.
Downloading a voucher needs suppliers.payments.record.
While a supplier is not verified
Approval, voucher generation and mark-paid are refused with supplier_not_verified until the supplier is Verified again, for example after an IBAN edit sent it back to Pending.
In the supplier portal
The agency sees its invoices with number, status, amount, VAT, total and due date, and can upload its tax invoice. It does not see the base salary, the voucher or the IBAN snapshot.