LogoLogo
WebsiteGitHubSlack
Integrated Beneficiary Registry v1.0.0
Integrated Beneficiary Registry v1.0.0
  • Integrated Beneficiary Registry and SP-MIS Interface
    • Introduction
    • Assumptions
    • Exception Handling
    • IBR with SP-MIS Standards
      • Process
        • PRS.IBR.01: SP-MIS queries the IBR to verify if a beneficiary is enrolled in a specific scheme
          • Example 1: Disability Cash Transfer Scheme
          • Example 2: Education Cash Transfer Scheme
        • PRS.IBR.02: SP-MIS publishes data on beneficiaries and the benefits that they have received
          • Example 1: Disability Cash Transfer Scheme
        • PRS.IBR.03: SP-MIS updates the IBR when the enrolment status of a beneficiary or household changes
          • Example 1: Disability Cash Transfer Scheme
        • PRS.IBR.04: IBR queries the social registry to request information needed for analysis
          • Example 1: Analysis of Disability Coverage of Social Protection Schemes
      • Data
        • Data Objects
          • DO.IBR.01 Beneficiary
          • DO.IBR.02 Programme
          • DO.IBR.03 Benefit
          • DO.IBR.O4 Benefit Frequency
          • DO.COM.02 Group
          • DO.COM.09 Member
        • Code Directory
          • CD.IBR.01 assistance_unit
          • CD.IBR.02 enrolment_status
          • CD.IBR.03 benefit_type
          • CD.IBR.04 institution_type
          • CD.IBR.05 legal_status
          • CD.IBR.06 social_protection_functions
          • CD.IBR.07 contribution_type
          • CD.IBR.08 programme_type
        • Data Types and Formats
          • DF.COM.STRING.01 date_time (Optional)
          • DF.COM.STRING.02 phone_number (Optional)
          • DT.COM.02 string
          • DT.COM.03 integer
          • DF.COM.STRING.08 currency
          • DT.COM.04 decimal
          • DT.COM.05 array
      • API
        • Design Principles
        • Versioning
        • Methods
          • API.COM.01 ASY Search (Async approach)
          • API.COM.01 SYN Search (Sync approach)
          • API.COM.02 Event Subscription
          • API.COM.03 Event Notification
          • API.COM.04 ASY Status (Async approach)
          • API.COM.04 SYN Status (Sync approach)
          • API.IBR.01 SYN Enrolment/updates
          • API.IBR.02 SYN Enrolled
    • Previous Versions
  • RESOURCES
    • Interoperability in Action #7
    • Standards Committee & Acknowledgments
Powered by GitBook
On this page

Was this helpful?

  1. Integrated Beneficiary Registry and SP-MIS Interface
  2. IBR with SP-MIS Standards
  3. Data
  4. Data Objects

DO.IBR.O4 Benefit Frequency

Last updated 1 month ago

Was this helpful?

DO.IBR.04: BenefitFrequency

This data object outlines the frequency at which a beneficiary receives benefits from a programme. It refers to the RRULE. For details and examples, see the reference link below.

Reference:

Attribute​
Type​
Cardinality
Description​

freq

0...1​

Frequency with which a programme delivers a benefit to beneficiaries​

dtstart​

0...1​

Recurrence start – as well as being the base for the recurrence, missing parameters in the final recurrence instances are also extracted from this date. If not given, the current time will be used instead.

interval​

​

0...1​

Interval between each frequency iteration - for example, when using YEARLY, an interval of 2 means once every two years, but with HOURLY, it means once every two hours. The default interval is 1.​

wkst​

0...1​

Week start day - must be one of MO, TU, WE constants, or an integer, specifying the first day of the week. This will affect recurrences based on weekly periods. ​

count​

​

0...1​

If given, this determines how many occurrences will be generated.​

until​

​

0...1​

If given, this date specifies the upper-bound limit of the recurrence. The last recurrence in the rule is the greatest date/time that is less than or equal to the value specified in the until parameter.​

​

​

​

​

RRULE
DT.COM.02 string
DF.COM.STRING.01 date_time
DT.COM.04 decimal
DT.COM.02 string
DT.COM.03 integer
DF.COM.STRING.01 date_time
…........
Additional attributes
https://github.com/spdci/schemas/blob/main/extensions/ibr/v1/BenefitFrequency.jsonld
{
  "@context": {
    "spdci": "https://schema.spdci.org/extensions/ibr/v1/",
    "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
    "xsd": "http://www.w3.org/2001/XMLSchema#",
    "owl": "http://www.w3.org/2002/07/owl#",
    "common": "https://schema.spdci.org/common/v1/"
  },
  "@id": "spdci:BenefitFrequency",
  "@type": "rdfs:Class",
  "rdfs:comment": "This data object outlines the frequency at which a beneficiary receives benefits from a program. It refers to the RRULE.",
  "rdfs:label": "BenefitFrequency",
  "rdfs:subClassOf": [
    {
      "@type": "rdfs:Class",
      "rdfs:label": "Structured Entity"
    }
  ],
  "rdfs:property": [
    {
      "@id": "spdci:freq",
      "@type": "rdfs:Datatype",
      "rdfs:domain": "spdci:BenefitFrequency",
      "rdfs:range": "xsd:string",
      "rdfs:comment": "The frequency with which a programs delivers a benefit to beneficiaries​"
    },
    {
      "@id": "spdci:dtstart",
      "@type": "rdfs:Datatype",
      "rdfs:domain": "spdci:BenefitFrequency",
      "rdfs:range": "common:DateTime",
      "rdfs:comment": "The recurrence start. Besides being the base for the recurrence, missing parameters in the final recurrence instances will also be extracted from this date. If not given, the current time will be used instead.​"
    },
    {
      "@id": "spdci:interval",
      "@type": "rdfs:Datatype",
      "rdfs:domain": "spdci:BenefitFrequency",
      "rdfs:range": "xsd:decimal",
      "rdfs:comment": "The interval between each frequency iteration. For example, when using YEARLY, an interval of 2 means once every two years, but with HOURLY, it means once every two hours. The default interval is 1.​"
    },
    {
      "@id": "spdci:wkst",
      "@type": "rdfs:Datatype",
      "rdfs:domain": "spdci:BenefitFrequency",
      "rdfs:range": "xsd:string",
      "rdfs:comment": "The week start day. Must be one of the MO, TU, WE constants, or an integer, specifying the first day of the week. This will affect recurrences based on weekly periods. "
    },
    {
      "@id": "spdci:count",
      "@type": "rdfs:Datatype",
      "rdfs:domain": "spdci:BenefitFrequency",
      "rdfs:range": "xsd:integer",
      "rdfs:comment": "If given, this determines how many occurrences will be generated.​"
    },
    {
      "@id": "spdci:until",
      "@type": "rdfs:Datatype",
      "rdfs:domain": "spdci:BenefitFrequency",
      "rdfs:range": "common:DateTime",
      "rdfs:comment": "If given, this must be a date specifying the upper-bound limit of the recurrence. The last recurrence in the rule is the greatest datetime that is less than or equal to the value specified in the until parameter.​​"
    }
  ],
  "required": ["@context","@type", "spdci:benefit_type", "spdci:benefit_date"]
}