Values

Code Label Standard code Definition
pending Pending The entitlement has been created but has not yet been confirmed through validation or approval.
approved Approved The entitlement has been confirmed and is awaiting fulfillment.
suspended Suspended The entitlement is temporarily withheld, for example due to a failed conditionality check or pending verification.
rejected Rejected The entitlement was evaluated and denied. Unlike cancellation, rejection means the entitlement was never valid.
cancelled Cancelled The entitlement has been withdrawn and will not be fulfilled.
expired Expired The entitlement's validity period has passed without fulfillment. Unlike cancellation, no one actively withdrew the entitlement; it lapsed.
partially_fulfilled Partially fulfilled Some but not all of the entitled amount has been delivered, for example one tranche of a multi-tranche payment or a voucher issued but not yet redeemed.
fulfilled Fulfilled The full entitled amount has been delivered to the beneficiary.

System mappings

OpenSPP

System vocabulary: EntitlementState

System code System label entitlement-status value
draft Draft pending
pending_validation Pending Validation pending
approved Approved approved
trans2FSP Transferred to FSP approved
rdpd2ben Redeemed/Paid to Beneficiary fulfilled
reject Rejected rejected
cancelled Cancelled cancelled
expired Expired expired

Not covered by OpenSPP: suspended, partially_fulfilled