DevPortalPagoPA



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

Dicci cosa ne pensi

Per segnalare problemi o dare feedback, puoi aprire una segnalazione su Github