Sign in

v17

latestOpenAPI 3.1.0raw.githubusercontent.com2026-02-1291962.1 KB
Debt Positions API

The Organization updates a debt position

put/organizations/{organizationfiscalcode}/debtpositions/{iupd}

Path parameters

organizationfiscalcodestring required

Organization fiscal code, the fiscal code of the Organization.

iupdstring required

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

toPublishboolean

Request body

iupdstring required
type'F' | 'G' required
payStandInboolean

feature flag to enable a debt position in stand-in mode

fiscalCodestring required
fullNamestring required
streetNamestring
civicNumberstring
postalCodestring
citystring
provincestring
regionstring
countrystring
emailstring
phonestring
switchToExpiredboolean required

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

companyNamestring required
officeNamestring
validityDatestring date-time
paymentDatestring date-time
status'DRAFT' | 'PUBLISHED' | 'VALID' | 'INVALID' | 'EXPIRED' | 'PARTIALLY_PAID' | 'PAID' | 'REPORTED'

Example request

{
  "payStandIn": true,
  "country": "IT",
  "email": "email@domain.com",
  "paymentOption": [
    {
      "transfer": [
        {
          "organizationFiscalCode": "00000000000",
          "iban": "IT0000000000000000000000000",
          "postalIban": "IT0000000000000000000000000",
          "stamp": {
            "provincialResidence": "RM"
          }
        }
      ]
    }
  ]
}

Response

Debt Position updated.

iupdstring required
type'F' | 'G' required
payStandInboolean

feature flag to enable a debt position in stand-in mode

fiscalCodestring required
fullNamestring required
streetNamestring
civicNumberstring
postalCodestring
citystring
provincestring
regionstring
countrystring
emailstring
phonestring
switchToExpiredboolean required

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

companyNamestring required
officeNamestring
validityDatestring date-time
paymentDatestring date-time
status'DRAFT' | 'PUBLISHED' | 'VALID' | 'INVALID' | 'EXPIRED' | 'PARTIALLY_PAID' | 'PAID' | 'REPORTED'

Example response

{
  "payStandIn": true,
  "country": "IT",
  "email": "email@domain.com",
  "paymentOption": [
    {
      "transfer": [
        {
          "organizationFiscalCode": "00000000000",
          "iban": "IT0000000000000000000000000",
          "postalIban": "IT0000000000000000000000000",
          "stamp": {
            "provincialResidence": "RM"
          }
        }
      ]
    }
  ]
}