Gestione Posizioni Debitorie (GPD)

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.

TABELLA DELLE SEZIONI
Inserimento/Modifica/Cancellazione/Lettura
Flussi di rendicontazione - DEPRECATED
Inserimento/Modifica/Cancellazione/Lettura - Gestione Massiva v1
Inserimento/Modifica/Cancellazione/Lettura - Gestione Massiva v2
Recupero ricevute
Inserimento/Modifica/Cancellazione/Lettura + Opzioni di Pagamento

Inserimento/Modifica/Cancellazione/Lettura

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

• ​The Organization creates a debt Position

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.

• The Organization updates the IBANs of every updatable payment​​option's transfers​

• ​Return the details of a specific debt position​

• ​The Organization updates a debt position​

• ​The Organization delete a debt Position​

• ​The Organization invalidate a debt Position​

• ​The Organization publish a debt Position

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.

Flussi di rendicontazione - DEPRECATED

Queste API saranno dismesse a partire dal 31/12/2026

• getFlowList

• getFlow

Inserimento/Modifica/Cancellazione/Lettura - Gestione Massiva v1

• ​Returns the debt positions upload status​

• ​Returns the debt positions upload report​

• ​Returns the list of fileIds for a broker/organization in the given date range (max 7 days)​

• ​The Organization creates the debt positions listed in the file​

• ​The Organization updates the debt positions listed in the file​

• ​The Organization deletes the debt positions based on IUPD listed in the file

Inserimento/Modifica/Cancellazione/Lettura - Gestione Massiva v2

• ​Returns the debt positions upload report​

• ​Returns the debt positions upload status​

• ​Returns the list of fileIds for a broker/organization in the given date range (max 7 days).

• ​The Organization creates the debt positions listed in the file​

• ​The Organization updates the debt positions listed in the file​

• ​The Organization deletes the debt positions based on IUPD listed in the file

Recupero ricevute

• ​Return the list of the organization receipts​

• ​Return the details of a specific receipt

Inserimento/Modifica/Cancellazione/Lettura + Opzioni di Pagamento

• ​Return the details of a specific debt position​

• ​The Organization updates a debt position​

• ​The Organization deletes a debt position​

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

• ​The Organization creates a debt Position​

• ​The Organization publish a debt Position