Operazioni disponibili

Tutte le operazioni indicate sono segregate per codice fiscale dell'ente creditore (organizationfiscalcode).

In caso di intermediazione, è possibile associare alla subscription key dell'intermediario da 1 ad n codici fiscali di enti intermediati, ciò consente agli intermediari di utilizzare una sola subscription key per l'invocazione delle API per conto di tutti gli enti intermediati. Tali abilitazioni devono essere richieste a PagoPA contestualmente alla creazione della subscription key o in momenti successivi.

Le subscription key e le relative abilitazioni sono segregate per ambiente UAT/PROD.

Gestione posizioni debitorie

Nei seguenti sequence diagram si identifica con l'acronimo GPD il servizio di Gestione Posizioni Debitorie e con APD l'Archivio delle Posizioni Debitorie (base dati).

Per i dettagli https://github.com/pagopa/pagopa-api/tree/SANP3.6.1/openapi

Creazione di una posizione debitoria

The Organization creates a debt Position.

post

Authorizations

ApiKeyAuthorization

Path parameters

organizationfiscalcodestringRequired

Organization fiscal code, the fiscal code of the Organization.

Query parameters

toPublishbooleanOptionalDefault: false

Body

iupdstringRequired

typestring · enumRequiredPossible values:

fiscalCodestringRequired

fullNamestringRequired

streetNamestringOptional

civicNumberstringOptional

postalCodestringOptional

citystringOptional

provincestringOptional

regionstringOptional

countrystringOptionalPattern: [A-Z]{2}

emailstringOptional

phonestringOptional

switchToExpiredbooleanOptional

feature flag to enable the debt position to expire after the due date

Default: falseExample: false

companyNamestringRequired

officeNamestringOptional

validityDatestring · date-timeOptional

paymentDatestring · date-timeRead-onlyOptional

statusstring · enumRead-onlyOptionalPossible values:

Responses

201

Request created.

application/json

400

Malformed request.

application/json

401

Wrong or missing function key.

409

Conflict: duplicate debt position found.

application/json

500

Service unavailable.

application/json

post

HTTPcURLJavaScriptPython

POST /organizations/{organizationfiscalcode}/debtpositions HTTP/1.1
Host: api.uat.platform.pagopa.it
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 793

{
  "iupd": "text",
  "type": "F",
  "fiscalCode": "text",
  "fullName": "text",
  "streetName": "text",
  "civicNumber": "text",
  "postalCode": "text",
  "city": "text",
  "province": "text",
  "region": "text",
  "country": "text",
  "email": "text",
  "phone": "text",
  "switchToExpired": false,
  "companyName": "text",
  "officeName": "text",
  "validityDate": "2025-05-09T05:35:59.451Z",
  "paymentOption": [
    {
      "iuv": "text",
      "amount": 1,
      "description": "text",
      "isPartialPayment": true,
      "dueDate": "2025-05-09T05:35:59.451Z",
      "retentionDate": "2025-05-09T05:35:59.451Z",
      "fee": 1,
      "transfer": [
        {
          "idTransfer": "1",
          "amount": 1,
          "organizationFiscalCode": "00000000000",
          "remittanceInformation": "text",
          "category": "text",
          "iban": "IT0000000000000000000000000",
          "postalIban": "IT0000000000000000000000000",
          "stamp": {
            "hashDocument": "text",
            "stampType": "text",
            "provincialResidence": "RM"
          }
        }
      ]
    }
  ]
}

{
  "iupd": "text",
  "type": "F",
  "fiscalCode": "text",
  "fullName": "text",
  "streetName": "text",
  "civicNumber": "text",
  "postalCode": "text",
  "city": "text",
  "province": "text",
  "region": "text",
  "country": "text",
  "email": "text",
  "phone": "text",
  "switchToExpired": false,
  "companyName": "text",
  "officeName": "text",
  "validityDate": "2025-05-09T05:35:59.451Z",
  "paymentDate": "2025-05-09T05:35:59.451Z",
  "status": "DRAFT",
  "paymentOption": [
    {
      "nav": "text",
      "iuv": "text",
      "amount": 1,
      "description": "text",
      "isPartialPayment": true,
      "dueDate": "2025-05-09T05:35:59.451Z",
      "retentionDate": "2025-05-09T05:35:59.451Z",
      "fee": 1,
      "notificationFee": 1,
      "transfer": [
        {
          "idTransfer": "1",
          "amount": 1,
          "organizationFiscalCode": "00000000000",
          "remittanceInformation": "text",
          "category": "text",
          "iban": "IT0000000000000000000000000",
          "postalIban": "IT0000000000000000000000000",
          "stamp": {
            "hashDocument": "text",
            "stampType": "text",
            "provincialResidence": "RM"
          }
        }
      ]
    }
  ]
}

In fase di creazione della posizione debitoria il servizio effettuerà controlli sui dati in input e controlli di eventuali duplicati.

Tra i controlli dei dati in input si rilevano:

• obbligatorietà dei dati

• coerenza date (ad esempio due_date ≥ validity_date)

• coerenza importi (ad esempio la somma degli importi dei versamenti deve essere uguale all'importo totale)

• validità della tassonomia

• validità degli IBAN (devono essere censiti sulla piattaforma pagoPA)

Tra i controlli dei duplicati ci si basa sugli identificativi di pagamento (IUPD, IUV e fiscalCode)

Il query parameter toPublish consente di pubblicare automaticamente una posizione debitoria in fase di creazione, impostando questo parametro a true e valorizzando contestualmente a null il campo validityDate, la posizione debitoria andrà direttamente nello stato VALID pronta per essere pagata.

Lettura di una lista di posizioni debitorie e di una singola posizione debitoria

Return the list of the organization debt positions. The due dates interval is mutually exclusive with the payment dates interval.

get

Authorizations

ApiKeyAuthorization

Path parameters

organizationfiscalcodestringRequired

Organization fiscal code, the fiscal code of the Organization.

Query parameters

limitinteger · int32 · max: 100Optional

Number of elements on one page. Default = 50

Default: 50

pageinteger · int32Required

Page number. Page value starts from 0

due_date_fromstring · dateOptional

Filter from due_date (if provided use the format yyyy-MM-dd). If not provided will be set to 30 days before the due_date_to.

due_date_tostring · dateOptional

Filter to due_date (if provided use the format yyyy-MM-dd). If not provided will be set to 30 days after the due_date_from.

payment_date_fromstring · dateOptional

Filter from payment_date (if provided use the format yyyy-MM-dd). If not provided will be set to 30 days before the payment_date_to.

payment_date_tostring · dateOptional

Filter to payment_date (if provided use the format yyyy-MM-dd). If not provided will be set to 30 days after the payment_date_from

statusstring · enumOptional

Filter by debt position status

Possible values:

orderbystring · enumOptional

Order by INSERTED_DATE, COMPANY_NAME, IUPD or STATUS

Default: COMPANY_NAMEPossible values:

orderingstring · enumOptional

Direction of ordering

Default: DESCPossible values:

Responses

200

Obtained all organization payment positions.

application/json

400

Malformed request.

application/json

401

Wrong or missing function key.

429

Too many requests.

500

Service unavailable.

application/json

get

HTTPcURLJavaScriptPython

GET /organizations/{organizationfiscalcode}/debtpositions HTTP/1.1
Host: api.uat.platform.pagopa.it
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*

{
  "payment_position_list": [
    {
      "iupd": "text",
      "organizationFiscalCode": "text",
      "type": "F",
      "companyName": "text",
      "officeName": "text",
      "insertedDate": "2025-05-09T05:35:59.451Z",
      "publishDate": "2025-05-09T05:35:59.451Z",
      "validityDate": "2025-05-09T05:35:59.451Z",
      "paymentDate": "2025-05-09T05:35:59.451Z",
      "status": "DRAFT",
      "lastUpdatedDate": "2025-05-09T05:35:59.451Z",
      "paymentOption": [
        {
          "nav": "text",
          "iuv": "text",
          "organizationFiscalCode": "text",
          "amount": 1,
          "description": "text",
          "isPartialPayment": true,
          "dueDate": "2025-05-09T05:35:59.451Z",
          "retentionDate": "2025-05-09T05:35:59.451Z",
          "paymentDate": "2025-05-09T05:35:59.451Z",
          "reportingDate": "2025-05-09T05:35:59.451Z",
          "insertedDate": "2025-05-09T05:35:59.451Z",
          "paymentMethod": "text",
          "fee": 1,
          "notificationFee": 1,
          "pspCompany": "text",
          "idReceipt": "text",
          "idFlowReporting": "text",
          "status": "PO_UNPAID",
          "lastUpdatedDate": "2025-05-09T05:35:59.451Z",
          "transfer": [
            {
              "organizationFiscalCode": "text",
              "idTransfer": "text",
              "amount": 1,
              "remittanceInformation": "text",
              "category": "text",
              "iban": "text",
              "postalIban": "text",
              "stamp": {
                "hashDocument": "text",
                "stampType": "text",
                "provincialResidence": "RM"
              },
              "insertedDate": "2025-05-09T05:35:59.451Z",
              "status": "T_UNREPORTED",
              "lastUpdatedDate": "2025-05-09T05:35:59.451Z"
            }
          ]
        }
      ]
    }
  ],
  "page_info": {
    "page": 1,
    "limit": 1,
    "items_found": 1,
    "total_pages": 1
  }
}

La lettura di una lista di posizioni debitorie prevede sempre una paginazione. E' inoltre possibile filtrare per due_date in modo da limitare i risultati.

Return the details of a specific debt position.

get

Authorizations

ApiKeyAuthorization

Path parameters

organizationfiscalcodestringRequired

Organization fiscal code, the fiscal code of the Organization.

iupdstringRequired

IUPD (Unique identifier of the debt position). Format could be <Organization fiscal code + UUID> this would make it unique within the new PD management system. It's the responsibility of the EC to guarantee uniqueness. The pagoPa system shall verify that this is true and if not, notify the EC.

Responses

200

Obtained debt position details.

application/json

401

Wrong or missing function key.

404

No debt position found.

application/json

500

Service unavailable.

application/json

get

HTTPcURLJavaScriptPython

GET /organizations/{organizationfiscalcode}/debtpositions/{iupd} HTTP/1.1
Host: api.uat.platform.pagopa.it
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*

{
  "iupd": "text",
  "organizationFiscalCode": "text",
  "type": "F",
  "companyName": "text",
  "officeName": "text",
  "insertedDate": "2025-05-09T05:35:59.451Z",
  "publishDate": "2025-05-09T05:35:59.451Z",
  "validityDate": "2025-05-09T05:35:59.451Z",
  "paymentDate": "2025-05-09T05:35:59.451Z",
  "status": "DRAFT",
  "lastUpdatedDate": "2025-05-09T05:35:59.451Z",
  "paymentOption": [
    {
      "nav": "text",
      "iuv": "text",
      "organizationFiscalCode": "text",
      "amount": 1,
      "description": "text",
      "isPartialPayment": true,
      "dueDate": "2025-05-09T05:35:59.451Z",
      "retentionDate": "2025-05-09T05:35:59.451Z",
      "paymentDate": "2025-05-09T05:35:59.451Z",
      "reportingDate": "2025-05-09T05:35:59.451Z",
      "insertedDate": "2025-05-09T05:35:59.451Z",
      "paymentMethod": "text",
      "fee": 1,
      "notificationFee": 1,
      "pspCompany": "text",
      "idReceipt": "text",
      "idFlowReporting": "text",
      "status": "PO_UNPAID",
      "lastUpdatedDate": "2025-05-09T05:35:59.451Z",
      "transfer": [
        {
          "organizationFiscalCode": "text",
          "idTransfer": "text",
          "amount": 1,
          "remittanceInformation": "text",
          "category": "text",
          "iban": "text",
          "postalIban": "text",
          "stamp": {
            "hashDocument": "text",
            "stampType": "text",
            "provincialResidence": "RM"
          },
          "insertedDate": "2025-05-09T05:35:59.451Z",
          "status": "T_UNREPORTED",
          "lastUpdatedDate": "2025-05-09T05:35:59.451Z"
        }
      ]
    }
  ]
}

La lettura di una posizione debitoria si basa sull'identificativo in input (IUPD). In caso lo IUPD non sia esistente verrà emesso un errore.

Aggiornamento di una posizione debitoria

The Organization updates a debt position

put

Authorizations

ApiKeyAuthorization

Path parameters

organizationfiscalcodestringRequired

Organization fiscal code, the fiscal code of the Organization.

iupdstringRequired

IUPD (Unique identifier of the debt position). Format could be <Organization fiscal code + UUID> this would make it unique within the new PD management system. It's the responsibility of the EC to guarantee uniqueness. The pagoPa system shall verify that this is true and if not, notify the EC.

Query parameters

toPublishbooleanOptionalDefault: false

Body

iupdstringRequired

typestring · enumRequiredPossible values:

fiscalCodestringRequired

fullNamestringRequired

streetNamestringOptional

civicNumberstringOptional

postalCodestringOptional

citystringOptional

provincestringOptional

regionstringOptional

countrystringOptionalPattern: [A-Z]{2}

emailstringOptional

phonestringOptional

switchToExpiredbooleanOptional

feature flag to enable the debt position to expire after the due date

Default: falseExample: false

companyNamestringRequired

officeNamestringOptional

validityDatestring · date-timeOptional

paymentDatestring · date-timeRead-onlyOptional

statusstring · enumRead-onlyOptionalPossible values:

Responses

200

Request updated.

application/json

400

Malformed request.

application/json

401

Wrong or missing function key.

404

No debt position found.

application/json

409

Conflict: existing related payment found.

application/json

500

Service unavailable.

application/json

put

HTTPcURLJavaScriptPython

PUT /organizations/{organizationfiscalcode}/debtpositions/{iupd} HTTP/1.1
Host: api.uat.platform.pagopa.it
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 793

{
  "iupd": "text",
  "type": "F",
  "fiscalCode": "text",
  "fullName": "text",
  "streetName": "text",
  "civicNumber": "text",
  "postalCode": "text",
  "city": "text",
  "province": "text",
  "region": "text",
  "country": "text",
  "email": "text",
  "phone": "text",
  "switchToExpired": false,
  "companyName": "text",
  "officeName": "text",
  "validityDate": "2025-05-09T05:35:59.451Z",
  "paymentOption": [
    {
      "iuv": "text",
      "amount": 1,
      "description": "text",
      "isPartialPayment": true,
      "dueDate": "2025-05-09T05:35:59.451Z",
      "retentionDate": "2025-05-09T05:35:59.451Z",
      "fee": 1,
      "transfer": [
        {
          "idTransfer": "1",
          "amount": 1,
          "organizationFiscalCode": "00000000000",
          "remittanceInformation": "text",
          "category": "text",
          "iban": "IT0000000000000000000000000",
          "postalIban": "IT0000000000000000000000000",
          "stamp": {
            "hashDocument": "text",
            "stampType": "text",
            "provincialResidence": "RM"
          }
        }
      ]
    }
  ]
}

{
  "iupd": "text",
  "type": "F",
  "fiscalCode": "text",
  "fullName": "text",
  "streetName": "text",
  "civicNumber": "text",
  "postalCode": "text",
  "city": "text",
  "province": "text",
  "region": "text",
  "country": "text",
  "email": "text",
  "phone": "text",
  "switchToExpired": false,
  "companyName": "text",
  "officeName": "text",
  "validityDate": "2025-05-09T05:35:59.451Z",
  "paymentDate": "2025-05-09T05:35:59.451Z",
  "status": "DRAFT",
  "paymentOption": [
    {
      "nav": "text",
      "iuv": "text",
      "amount": 1,
      "description": "text",
      "isPartialPayment": true,
      "dueDate": "2025-05-09T05:35:59.451Z",
      "retentionDate": "2025-05-09T05:35:59.451Z",
      "fee": 1,
      "notificationFee": 1,
      "transfer": [
        {
          "idTransfer": "1",
          "amount": 1,
          "organizationFiscalCode": "00000000000",
          "remittanceInformation": "text",
          "category": "text",
          "iban": "IT0000000000000000000000000",
          "postalIban": "IT0000000000000000000000000",
          "stamp": {
            "hashDocument": "text",
            "stampType": "text",
            "provincialResidence": "RM"
          }
        }
      ]
    }
  ]
}

In fase di aggiornamento, oltre ai già citati controlli in fase di creazione , si verifica che la posizione sia esistente ed aggiornabile.

In particolare l'aggiornabilità della posizione debitoria dipende dallo stato della posizione stessa (ad esempio se una posizione è già stata pagata non sarà possibile aggiornarla)

E' importante porre particolare attenzione al campo notificationFee che contiene le spese di notifica della posizione debitoria. Questo campo viene gestito in modo esclusivo da Piattaforma Notifiche e l'eventuale importo viene aggiunto automaticamente dal sistema GPD all'importo delle posizioni debitorie. L'EC pertanto in fase di aggiornamento dell'importo amount di uno dei transfer presenti all'interno di una paymentOption, non dovrà tenere conto del valore presente all'interno del campo notificationFee.

Cancellazione di una Posizione Debitoria

The Organization deletes a debt position

delete

Authorizations

ApiKeyAuthorization

Path parameters

organizationfiscalcodestringRequired

Organization fiscal code, the fiscal code of the Organization.

iupdstringRequired

IUPD (Unique identifier of the debt position). Format could be <Organization fiscal code + UUID> this would make it unique within the new PD management system. It's the responsibility of the EC to guarantee uniqueness. The pagoPa system shall verify that this is true and if not, notify the EC.

Header parameters

X-Request-IdstringOptional

This header identifies the call, if not passed it is self-generated. This ID is returned in the response.

Responses

200

Operation completed successfully.

application/json

Responsestring

401

Wrong or missing function key.

404

No debt position position found.

application/json

409

Conflict: existing related payment found.

application/json

500

Service unavailable.

application/json

delete

HTTPcURLJavaScriptPython

DELETE /gpd/api/v1/organizations/{organizationfiscalcode}/debtpositions/{iupd} HTTP/1.1
Host: api.uat.platform.pagopa.it
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*

text

La cancellazione di una posizione debitoria prevede controlli sia sull'esistenza (IUPD) che sullo stato (ad esempio, una posizione debitoria non sarà cancellabile se è già stata pagata)

Pubblicazione di una posizione debitoria

The Organization publish a debt Position.

post

Authorizations

ApiKeyAuthorization

Path parameters

organizationfiscalcodestringRequired

Organization fiscal code, the fiscal code of the Organization.

iupdstringRequired

IUPD (Unique identifier of the debt position). Format could be <Organization fiscal code + UUID> this would make it unique within the new PD management system. It's the responsibility of the EC to guarantee uniqueness. The pagoPa system shall verify that this is true and if not, notify the EC.

Responses

200

Request published.

application/json

401

Wrong or missing function key.

404

No debt position found.

application/json

409

Conflict: debt position is not in publishable state.

application/json

500

Service unavailable.

application/json

post

HTTPcURLJavaScriptPython

POST /organizations/{organizationfiscalcode}/debtpositions/{iupd}/publish HTTP/1.1
Host: api.uat.platform.pagopa.it
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*

{
  "iupd": "text",
  "type": "F",
  "fiscalCode": "text",
  "fullName": "text",
  "streetName": "text",
  "civicNumber": "text",
  "postalCode": "text",
  "city": "text",
  "province": "text",
  "region": "text",
  "country": "text",
  "email": "text",
  "phone": "text",
  "switchToExpired": false,
  "companyName": "text",
  "officeName": "text",
  "validityDate": "2025-05-09T05:35:59.451Z",
  "paymentDate": "2025-05-09T05:35:59.451Z",
  "status": "DRAFT",
  "paymentOption": [
    {
      "nav": "text",
      "iuv": "text",
      "amount": 1,
      "description": "text",
      "isPartialPayment": true,
      "dueDate": "2025-05-09T05:35:59.451Z",
      "retentionDate": "2025-05-09T05:35:59.451Z",
      "fee": 1,
      "notificationFee": 1,
      "transfer": [
        {
          "idTransfer": "1",
          "amount": 1,
          "organizationFiscalCode": "00000000000",
          "remittanceInformation": "text",
          "category": "text",
          "iban": "IT0000000000000000000000000",
          "postalIban": "IT0000000000000000000000000",
          "stamp": {
            "hashDocument": "text",
            "stampType": "text",
            "provincialResidence": "RM"
          }
        }
      ]
    }
  ]
}

La pubblicazione della posizione debitoria permette il passaggio dallo stato DRAFT allo stato PUBLISHED.

Una posizione in stato DRAFT (bozza) infatti non permette la normale operatività con la piattaforma pagoPA. Solo quando l'Ente Creditore pubblica la posizione, in coerenza con le date di validità e di scadenza, questa risulta pagabile sulla piattaforma.

Invalidazione di una posizione debitoria

The Organization invalidate a debt Position.

post

Authorizations

ApiKeyAuthorization

Path parameters

organizationfiscalcodestringRequired

Organization fiscal code, the fiscal code of the Organization.

iupdstringRequired

IUPD (Unique identifier of the debt position). Format could be <Organization fiscal code + UUID> this would make it unique within the new PD management system. It's the responsibility of the EC to guarantee uniqueness. The pagoPa system shall verify that this is true and if not, notify the EC.

Responses

200

Request published.

application/json

401

Wrong or missing function key.

404

No debt position found.

application/json

409

Conflict: debt position is not in invalidable state.

application/json

500

Service unavailable.

application/json

post

HTTPcURLJavaScriptPython

POST /organizations/{organizationfiscalcode}/debtpositions/{iupd}/invalidate HTTP/1.1
Host: api.uat.platform.pagopa.it
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*

{
  "iupd": "text",
  "type": "F",
  "fiscalCode": "text",
  "fullName": "text",
  "streetName": "text",
  "civicNumber": "text",
  "postalCode": "text",
  "city": "text",
  "province": "text",
  "region": "text",
  "country": "text",
  "email": "text",
  "phone": "text",
  "switchToExpired": false,
  "companyName": "text",
  "officeName": "text",
  "validityDate": "2025-05-09T05:35:59.451Z",
  "paymentDate": "2025-05-09T05:35:59.451Z",
  "status": "DRAFT",
  "paymentOption": [
    {
      "nav": "text",
      "iuv": "text",
      "amount": 1,
      "description": "text",
      "isPartialPayment": true,
      "dueDate": "2025-05-09T05:35:59.451Z",
      "retentionDate": "2025-05-09T05:35:59.451Z",
      "fee": 1,
      "notificationFee": 1,
      "transfer": [
        {
          "idTransfer": "1",
          "amount": 1,
          "organizationFiscalCode": "00000000000",
          "remittanceInformation": "text",
          "category": "text",
          "iban": "IT0000000000000000000000000",
          "postalIban": "IT0000000000000000000000000",
          "stamp": {
            "hashDocument": "text",
            "stampType": "text",
            "provincialResidence": "RM"
          }
        }
      ]
    }
  ]
}

L'invalidazione di una posizione debitore consiste di fatto in una cancellazione logica. E' possibile solo partendo dagli stati PUBLISHED e VALID.

La funzionalità è utile quando si vuole dare evidenza all'utente, in fase di pagamento, della invalidazione della posizione debitoria.

Ricevute di pagamento

Sono messe a disposizione due API per il recupero delle ricevute di pagamento:

• lista ricevute di pagamento

• dettaglio singola ricevuta

Return the list of the organization receipts.

get

Authorizations

ApiKeyAuthorization

Path parameters

organizationfiscalcodestringRequired

Organization fiscal code, the fiscal code of the Organization.

Query parameters

limitinteger · int32 · max: 999Optional

Number of elements on one page

pageinteger · int32Optional

Page number. Page value starts from 0

Default: 0

debtorstringOptional

Filter by debtor

servicestringOptional

Filter by service

Header parameters

X-Request-IdstringOptional

This header identifies the call, if not passed it is self-generated. This ID is returned in the response.

Responses

200

Obtained all organization payment positions.

application/json

401

Wrong or missing function key.

404

No receipts found.

application/json

500

Service unavailable.

application/json

get

HTTPcURLJavaScriptPython

GET /payments/{organizationfiscalcode}/receipts HTTP/1.1
Host: localhost:8080
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*

{
  "receipts_list": [
    {
      "organizationFiscalCode": "text",
      "iuv": "text",
      "debtorFiscalCode": "text"
    }
  ],
  "page_info": {
    "page": 1,
    "limit": 1,
    "items_found": 1,
    "more_pages": true
  }
}

Return the details of a specific receipt.

get

Authorizations

ApiKeyAuthorization

Path parameters

organizationfiscalcodestringRequired

Organization fiscal code, the fiscal code of the Organization.

iuvstringRequired

IUV (Unique Payment Identification). Alphanumeric code that uniquely associates and identifies three key elements of a payment: reason, payer, amount

Header parameters

X-Request-IdstringOptional

This header identifies the call, if not passed it is self-generated. This ID is returned in the response.

Responses

200

Obtained receipt details.

application/xml

Responsestring

401

Wrong or missing function key.

404

No receipt found.

application/xmlapplication/json

422

Unable to process the request.

application/xmlapplication/json

500

Service unavailable.

application/json

get

HTTPcURLJavaScriptPython

GET /payments/{organizationfiscalcode}/receipts/{iuv} HTTP/1.1
Host: localhost:8080
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*

<?xml version="1.0"?>
<object>text</object>

Flussi di rendicontazione

Sono messe a disposizione delle funzionalità di lettura dei flussi di rendicontazione:

• Lista di flussi di rendicontazione per un Ente Creditore

• Dettaglio del flusso di rendicontazione

L'abilitazione al servizio per la gestione dei flussi di rendicontazione su GPD non è automatico e va richiesto esplicitamente al momento dell'on-boarding dell'EC

getFlowList

get

getFlowList

Authorizations

apiKeyHeaderapiKeyQuery

Path parameters

organizationIdstringRequiredExample: {"value":null}

Responses

200

Successful response

application/json

400

Error response

application/json

get

HTTPcURLJavaScriptPython

GET /gpd-reporting/api/v1/organizations/{organizationId}/reportings HTTP/1.1
Host: api.uat.platform.pagopa.it
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*

[
  {
    "flowId": "2022-07-15PSPXXXXXXXX-0000000001",
    "flowDate": "2022-07-15T00:31:05.0000000+00:00"
  }
]

getFlow

get

getFlow

Authorizations

apiKeyHeaderapiKeyQuery

Path parameters

organizationIdstringRequiredExample: {"value":null}

flowIdstringRequiredExample: {"value":null}

datestringRequiredExample: {"value":null}

Responses

200

Successful response

application/xml

Responsestring · binary

Flow XML

404

Not Found

application/json

get

HTTPcURLJavaScriptPython

GET /gpd-reporting/api/v1/organizations/{organizationId}/reportings/{flowId}/date/{date} HTTP/1.1
Host: api.uat.platform.pagopa.it
Ocp-Apim-Subscription-Key: YOUR_API_KEY
Accept: */*

<Organizations-organizationId-Reportings-flowId-Date-date-Get200ApplicationXmlResponse>string</Organizations-organizationId-Reportings-flowId-Date-date-Get200ApplicationXmlResponse>