Tabella dei contenuti
How to submit a service request
Submitting a service request (Agreement) involves creating a draft, followed by a submission.
Step 1 - Create the Agreement in DRAFT
The Agreement must be created by specifying both the e-service and the specific e-service version (EServiceDescriptor) it refers to.
Request
1POST /agreements
2
3{
4 "eserviceId": "fd7d6c6b-c042-4d9c-926a-d5e26c815220",
5 "descriptorId": "419adb1c-8e0e-4225-97d9-24510a9a4aac"
6}
7
If the creation request is successful, it produces an Agreement in DRAFT state.
Response
1{
2 "id": "17bfba0b-85f2-44e1-9bfc-497605a0d8c7",
3 "eserviceId": "fd7d6c6b-c042-4d9c-926a-d5e26c815220",
4 "descriptorId": "419adb1c-8e0e-4225-97d9-24510a9a4aac",
5 "producerId": "90f45b0c-f63b-4a16-9352-80497ee88890",
6 "consumerId": "efea2507-08df-4a5d-b4bf-263763ae03ad",
7 "state": "DRAFT",
8 "createdAt": "2025-06-01T00🕛️34Z"
9}
10
Step 2 - Submit the Agreement for activation
The draft can be submitted to request its activation.
Request
1POST /agreements/17bfba0b-85f2-44e1-9bfc-497605a0d8c7/submit
2
3{}
4
Response — Requirements met
If the requesting consumer meets the necessary requirements, the Agreement is activated.
Response
1{
2 "id": "17bfba0b-85f2-44e1-9bfc-497605a0d8c7",
3 "eserviceId": "fd7d6c6b-c042-4d9c-926a-d5e26c815220",
4 "descriptorId": "419adb1c-8e0e-4225-97d9-24510a9a4aac",
5 "producerId": "90f45b0c-f63b-4a16-9352-80497ee88890",
6 "consumerId": "efea2507-08df-4a5d-b4bf-263763ae03ad",
7 "state": "ACTIVE",
8 "createdAt": "2025-06-01T00🕛️34Z",
9 "updatedAt": "2025-06-02T00🕛️34Z"
10}
11
Response — Requirements not met
If the requesting consumer does not meet the necessary requirements, the Agreement moves to the waiting for approval (PENDING) state.
Response
1{
2 "id": "17bfba0b-85f2-44e1-9bfc-497605a0d8c7",
3 "eserviceId": "fd7d6c6b-c042-4d9c-926a-d5e26c815220",
4 "descriptorId": "419adb1c-8e0e-4225-97d9-24510a9a4aac",
5 "producerId": "90f45b0c-f63b-4a16-9352-80497ee88890",
6 "consumerId": "efea2507-08df-4a5d-b4bf-263763ae03ad",
7 "state": "PENDING",
8 "createdAt": "2025-06-01T00🕛️34Z",
9 "updatedAt": "2025-06-02T00🕛️34Z"
10}
11
Hai bisogno di aiuto?
Apri un ticket utilizzando l’apposita funzione all’interno della tua Area Riservata