---
title: Pendenza
description: Posizione debitoria archivio di GovPay (APA)
type: object
required:
  - idA2A
  - idPendenza
  - idDominio
  - soggettoPagatore
  - importo
  - causale        
properties:
  idA2A:
    type: string
    description: Identificativo del gestionale responsabile della pendenza
    example: A2A_12345
  idPendenza:
    type: string
    description: Identificativo della pendenza nel gestionale responsabile
    example: abcdef12345
  idDominio:
    type: string
    description: Identificativo del dominio creditore
    example: 1234567890
  idUnitaOperativa:
    type: string
    description: Identificativo dell'unita' operativa
    example: UO33132
  idTipoPendenza:
    type: string
    description: Identificativo della tipologia pendenza
    example: IMU
    pattern: '(^[a-zA-Z0-9\-_\.]{1,35}$)'
  nome:
    type: string
    description: Nome della pendenza da visualizzare sui portali di pagamento e console di gestione.
    example: 'Immatricolazione AA 2017/2018'
  causale:
    type: string
    description: Descrizione da inserire nell'avviso di pagamento
    example: 'Sanzione CdS n. abc00000'
  soggettoPagatore:
    $ref: '#/definitions/soggetto'
  importo:
    type: number
    description: Importo della pendenza. Deve corrispondere alla somma delle singole voci.
    example: 10.01
  numeroAvviso:
    type: string
    description: Numero avviso, assegnato se pagabile da psp
    example: 001000000000012345
  dataCaricamento:
    type: string
    format: date
    description: Data di emissione della pendenza
    example: '2010-12-31'
  dataValidita:
    type: string
    format: date
    description: Data di validita dei dati della pendenza, decorsa la quale la pendenza può subire variazioni.
    example: '2019-12-31'
  dataScadenza:
    type: string
    format: date
    description: Data di scadenza della pendenza, decorsa la quale non è più pagabile.
    example: '2020-12-31'
  annoRiferimento:
    type: number
    description: Anno di riferimento della pendenza
    example: 2020
  cartellaPagamento:
    type: string
    description: Identificativo della cartella di pagamento a cui afferisce la pendenza
    example: ABC00000001
  datiAllegati:
    type: object
    description: Dati applicativi allegati dal gestionale secondo un formato proprietario.
  tassonomia:
    type: string
    description: Macro categoria della pendenza secondo la classificazione del creditore
    example: Sanzioni
  tassonomiaAvviso:
    description: Macro categoria della pendenza Agid
    type: string
    enum:
      - Cartelle esattoriali
      - Diritti e concessioni
      - Imposte e tasse
      - IMU, TASI e altre tasse comunali
      - Ingressi a mostre e musei
      - Multe e sanzioni amministrative
      - Previdenza e infortuni
      - Servizi erogati dal comune
      - Servizi erogati da altri enti
      - Servizi scolastici
      - Tassa automobilistica
      - Ticket e prestazioni sanitarie
      - Trasporti, mobilità e parcheggi
    example:
      Ticket e prestazioni sanitarie
  direzione:
    type: string
    description: Identificativo della direzione interna all'ente creditore
    example: Direzione ABC
  divisione:
    type: string
    description: Identificativo della divisione interna all'ente creditore
    example: Divisione001
  documento:
    $ref: '#/definitions/documento'
  dataNotificaAvviso:
    type: string
    format: date
    description: Data in cui inviare il promemoria di pagamento.
    example: '2020-12-31'
  dataPromemoriaScadenza:
    type: string
    format: date
    description: Data in cui inviare il promemoria di scadenza della pendenza.
    example: '2020-12-31'
  proprieta:
    type: object
    description: Dati supporto per la gestione del ciclo di vita della pendenza.
    properties:
      linguaSecondaria:
        descrizione: Lingua secondaria nella stampa dell'avviso di pagamento
        example: 'false'
        type: string
        enum:
          - 'false'
          - 'de'
          - 'en'
          - 'fr'
          - 'sl'
      descrizioneImporto:
        type: array
        items: 
          type: object
          properties:
            voce: 
              type: string
              description: voce importo
              example: canone annuo
            importo: 
              type: number
              description: importo
              example: 10.01
      lineaTestoRicevuta1:
        type: string
        description: stringa personalizzata da inserire nella ricevuta
      lineaTestoRicevuta2:
        type: string
        description: stringa personalizzata da inserire nella ricevuta
  voci:
    type: array
    minItems: 1
    maxItems: 5
    items:
      $ref: '#/definitions/vocePendenza'
definitions:
  soggetto:
    description: dati anagrafici di un versante o pagatore.
    type: object
    required:
      - tipo
      - identificativo
    properties:
      tipo:
        description: >-
          tipologia di soggetto, se persona fisica (F) o giuridica
          (G)
        type: string
        enum:
          - G
          - F
        example: F
      identificativo:
        description: codice fiscale o partita iva del soggetto
        type: string
        example: RSSMRA30A01H501I
      anagrafica:
          description: nome e cognome o altra ragione sociale del soggetto
          type: string
          example: Mario Rossi
      indirizzo:
        type: string
        example: Piazza della Vittoria
      civico:
        type: string
        example: 10/A
      cap:
        type: string
        example: 0
      localita:
        type: string
        example: Roma
      provincia:
        type: string
        example: Roma
      nazione:
        type: string
        example: IT
      email:
        type: string
        example: mario.rossi@host.eu
      cellulare:
        type: string
        example: 0039000123456789      
  documento:
    type: object
    required:
      - identificativo
      - descrizione
    properties:
      identificativo:
        type: string
        description: Identificativo del documento
        example: abcdef12345_1
        minLength: 1
        maxLength: 35             
      descrizione:
        type: string
        description: descrizione del documento
        example: Sanzione CdS n. abc00000
      rata:
        type: number
        description: Rata del documento
        example: 1
        minimum: 1
      soglia:
        type: object
        required:
          - tipo
          - giorni
        properties:
          giorni:
            type: number
            description: numero di giorni vincolo per il pagamento
            example: 5
            minimum: 1
          tipo:
             description: Indica se il pagamento deve avvenire entro o oltre la soglia di giorni indicata
             type: string
             enum:
               - ENTRO
               - OLTRE 
    vocePendenza:
      type: object    
      allOf:
        - type: object 
          required:
            - idVocePendenza
            - importo
            - descrizione
            - stato
          properties:
            indice:
              type: number
              description: indice di voce all'interno della pendenza
              example: 1
            idVocePendenza:
              type: string
              description: Identificativo della voce di pedenza nel gestionale proprietario
              example: abcdef12345_1
            importo:
              type: number
              description: Importo della voce
              example: 10.01
            descrizione:
              type: string
              description: descrizione della voce di pagamento
              example: Sanzione CdS n. abc00000
            stato:
              $ref: '#/components/schemas/statoVocePendenza'
            descrizioneCausaleRPT:
              type: string
              description: Testo libero per la causale versamento
              example: Sanzione CdS n. abc00000
              maxLength: 140
            datiAllegati:
              type: object
              description: Dati applicativi allegati dal gestionale secondo un formato proprietario.
        - type: object 
          oneOf:
            - description: Definisce i dettagli di incasso tramite riferimento in anagrafica GovPay.
              type: object
              required:
                - codEntrata
              properties:
                codEntrata:
                  type: string
                  pattern: '(^[a-zA-Z0-9\-_\.]{1,35}$)'
            - description: Definisce i dettagli di incasso.
              type: object
              required:
                - ibanAccredito
                - tipoContabilita
                - codiceContabilita
              properties:
                ibanAccredito:
                  type: string
                  example: IT60X0542811101000000123456
                ibanAppoggio:
                  type: string
                  example: IT60X0542811101000000123456
                tipoContabilita:
                  $ref: '#/components/schemas/tipoContabilita'
                codiceContabilita:
                  description: Codifica del capitolo di bilancio
                  type: string
                  example: 3321
            - description: Definisce i dati di un bollo telematico
              type: object
              required:
                - tipoBollo
                - hashDocumento
                - provinciaResidenza
              properties:
                tipoBollo:
                  description: Tipologia di Bollo digitale
                  type: string
                  enum:
                    - Imposta di bollo
                hashDocumento:
                  description: Digest in base64 del documento informatico associato alla marca da bollo
                  type: string
                provinciaResidenza:
                  description: Sigla automobilistica della provincia di residenza del soggetto pagatore
                  type: string                    
          