/entitlements - Entitlement (P) - Edu-V Compliance Testlab

Veldspecificaties

29 items

Veld	Beschrijving	Type	Verplicht	Beperkingen
`response.`	response	Object	Nee	-
`response..entitlementReferenceId`	entitlementReferenceId Unique entitlementReferenceId for this request. This referenceId is used by the Event Mediator of the `Aanspraakmanager` to match the EntitlementConfirmation confirmation message(s) send by the `Licentieregistratie` and/or the `Leermiddelenportaal`. If a party receives another request with the same entitlementReferenceId value, the receiving party should not process the request again. It should send the confirmation again.	Tekenreeks	Ja	-
`response..entitlement`	entitlement	Object	Ja	Entitlement
`response..entitlement.entitlementId`	entitlementId	Tekenreeks	Ja	-
`response..entitlement.deliveryOrderId`	deliveryOrderId The deliveryOrderId which was part of the DeliveryOrder request send by the `Bestelomgeving leermiddelen` to the `Aanspraakmanager`.	Tekenreeks	Nee	-
`response..entitlement.contractId`	contractId An optional unique identifier for a contract between the supplier that is responsible for the `Bestelomgeving leermiddelen` and the supplier of the learning materials. The DeliveryOrder should be handled according to the business rules of the contract.'	Tekenreeks	Nee	-
`response..entitlement.productId`	productId Unique identifier of a Product. The productId can be retrieved from the Catalogue API of supplier of the learning materials.	Tekenreeks	Ja	-
`response..entitlement.startDate`	startDate Date from which the product can be activated by the Entitlee(s). The startDate marks the start of the activation period. Format: YYYY-MM-DD (according to RFC3339).	Datum	Ja	-
`response..entitlement.activationUntilDate`	activationUntilDate Date on which the product can no longer be activated by the Entitlee(s). The activationUntilDate marks the end of the activation period. This does not imply the product can not be used by Licensees who have activated the product during the activation period. Format: YYYY-MM-DD (according to RFC3339).	Datum	Ja	-
`response..entitlement.expirationDate`	expirationDate ExpirationDate a `Leermiddelenportaal` can use to maintain access links to the Product in the Learning Material Lists of Students or Employees. An initially set minExpirationDate is calculated by the `Aanspraakmanager` based on info from the Product retrieved from the Catalogue API. If the `Aanspraakmanager` receives an InitialActivation message regarding this Entitlement from the `Licentieregistratie` via the Usage API, the expirationDate could be updated. The InitialActivation message could include an updated expirationDate. In that case this new expirationDate overwrites the initially set minExpirationDate. This triggers the process within the `Aanspraakmanager` to exchange the updated entitlement with the `Leermiddelenportaal`. The urlStatus is updated to `initialized` and is newly exchanged with the `Leermiddelenportaal`. Format: YYYY-MM-DD (according to RFC3339).	Datum	Nee	-
`response..entitlement.endDate`	endDate Date this Entitlement was blocked or cancelled. Mandatory field when the status changes to Cancelled or Blocked. Format: YYYY-MM-DD (according to RFC3339).	Datum	Nee	-
`response..entitlement.entitlementType`	entitlementType The entitlement type specifies if a student, employee or a user with an activation code can activate and license the product.	Keuzelijst	Ja	toegestaan ["school-student","school-employee","school-activationcode","customer-student","customer-activationcode"]
`response..entitlement.entitlementSpecification`	entitlementSpecification	Object	Nee	EntitlementSpecification
`response..entitlement.entitlementStatus`	entitlementStatus The status of the entitlement.	Keuzelijst	Ja	toegestaan ["school-student","school-employee","school-activationcode","customer-student","customer-activationcode"]
`response..entitlement.urlStatuses`	urlStatuses	Lijst[]	Nee	-
`response..entitlement.urlStatuses[*]`	urlStatuses	Object	Nee	-
`response..entitlement.urlStatuses[*].portal`	portal Identifier of the `Leermiddelenportaal` application.	Tekenreeks	Nee	-
`response..entitlement.urlStatuses[*].urlStatus`	urlStatus The status of the accessUrl at the `Leermiddelenportaal` application.	Keuzelijst	Nee	toegestaan ["uninitialized","initialized","processed","cancelled","blocked"]
`response..entitlement.dateCreated`	dateCreated Indicates the date and time the object was first created. Format: Conform openapi in ZULU time zoals gespecificeerd in RFC 3339, section 5.6.	Datum/tijd	Ja	-
`response..entitlement.dateLastModified`	dateLastModified Indicates the date and time the object was last modified. Format: Conform openapi in ZULU time zoals gespecificeerd in RFC 3339, section 5.6.	Datum/tijd	Ja	-
`response.400`	response 400 Functional status code and status message.	Object	Nee	-
`response.400.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.400.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-
`response.401`	response 401 Functional status code and status message.	Object	Nee	-
`response.401.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.401.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-
`response.403`	response 403 Functional status code and status message.	Object	Nee	-
`response.403.status`	status See functional status codes within the Documentation.	Geheel getal	Ja	-
`response.403.statusMessage`	statusMessage See functional status messages within the Documentation.	Tekenreeks	Nee	-

Verwachte statuscodes

5 items

Code	Betekenis	Uitkomst
`202`	Accepted	Succes
`400`	Bad Request	Fout
`401`	Unauthorized	Fout
`403`	Forbidden	Fout
`405`	Method Not Allowed - Licentieregistratie and Leermiddelenportaal are providers of this endpoint	Fout

Bronspecificatie (YAML)

Ruwe definitie uit het afsprakenstelsel.

  /entitlements:
    put:
      summary: Accept Entitlement from Aanspraakmanager
      operationId: accept-entitlement
      tags:
        - Licentieregistratie
        - Leermiddelenportaal
      x-tags:
        - Entitlement
      description: |
        As a `Aanspraakmanager`, send a new Entitlement to a `Licentieregistratie` or `Leermiddelenportaal`.
        
        The `Licentieregistratie` and 'Leermiddelenportaal' are the providers of this endpoint.
        The `Aanspraakmanager` should give a 405 HTTP status as result when called.
        Consent is required for exchange of entitlement information from the 'Aanspraakmanager' to the `Leermiddelenportaal`.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EntitlementRequest'
      responses:
        '202':
          description: Accepted
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
        '405':
          description: Method Not Allowed - Licentieregistratie and Leermiddelenportaal are providers of this endpoint
      security:
        - OAuth2:
            - eduv.entitlement.licensor
            - eduv.entitlement.portal