Debt Position Actions API

The Organization publish a debt Position.

Changed on

The Organization publish a debt Position.

post/organizations/{organizationfiscalcode}/debtpositions/{iupd}/publish

Request

  • Base URL: https://api.uat.platform.pagopa.it/gpd/debt-positions-service/v3
  • URL: https://api.uat.platform.pagopa.it/gpd/debt-positions-service/v3/organizations/{organizationfiscalcode}/debtpositions/{iupd}/publish
  • Auth: one of:
    • API key in header Ocp-Apim-Subscription-Key
    • API key in query parameter subscription-key

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.

Headers

X-Request-Idstring

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

Response

Request published.

iupdstring required
payStandInboolean

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

companyNamestring required
officeNamestring
paymentDatestring date-time
status'DRAFT' | 'PUBLISHED' | 'VALID' | 'UNPAYABLE' | 'PARTIALLY_PAID' | 'PAID'

Example response

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

Changes

  • v36f3db9e68367Revision changes
    • info

      the endpoint scheme security ApiKey was removed from the API

    • info

      added the new optional header request parameter X-Request-Id

  • v393e168e2fe0eRevision changes
    • warning

      deleted the header request parameter X-Request-Id

    • info

      the endpoint scheme security ApiKey was added to the API

    • info

      added the new optional header request parameter X-Request-Id to all path's operations

    • info

      the response's property default value changed from true to true for the status

    • info

      the response's property default value changed from false to false for the status