Skip to main content

Preferenze

Il path parameter companyId è l'identificativo TS Digital di un'azienda correttamente registrata

Le preferenze non vincono mai sui valori impostati in una singola richiesta di pagamento. Questo permette di sovrascrivere le preferenze per delle richieste di pagamento specifiche.

Se daysDueDate non viene impostato, o viene impostato a 0, verranno aggiunti 180gg come valore di default alla data di scadenza della richiesta di pagamento (a meno di non aver impostato una due date specifica)

Creazione di una preferenza

Permette di creare una preferenza per una specifica azienda

[POST] /preferences/{companyId}

Nella request abbiamo:

  • daysDueDate: giorni di scadenza che verranno aggiunti alla data di scadenza di una richiesta di pagamento
  • emailSettings: parametri di customizzazione per email
    • bodyText: testo della mail
    • name: nome inserito nell'intestazione della mail
    • surname: cognome inserito nell'intestazione della mail
  • paymentMethodSettings: identificativi delle rate del piano di pagamento da pagare
    • name: metodo di pagamento
    • constraints: minimali e massimali del singolo metodo di pagamento
      • minimumAmount: importo minimo per il metodo di pagamento
      • maximumAmount: importo massimo per il metodo di pagamento

Nella response l'API ritorna:

  • companyId: id azienda TS Digital
  • daysDueDate: giorni di scadenza che verranno aggiunti alla data di scadenza di una richiesta di pagamento
  • emailSettings: parametri di customizzazione per email
    • bodyText: testo della mail
    • name: nome inserito nell'intestazione della mail
    • surname: cognome inserito nell'intestazione della mail
  • paymentMethodSettings: identificativi delle rate del piano di pagamento da pagare
    • name: metodo di pagamento
    • constraints: minimali e massimali del singolo metodo di pagamento
      • minimumAmount: importo minimo per il metodo di pagamento
      • maximumAmount: importo massimo per il metodo di pagamento

 

Modifica di una preferenza

Permette di modificare una preferenza precedentemente creata per una specifica azienda

[PATCH] /preferences/{companyId}

Nella request abbiamo:

  • daysDueDate: giorni di scadenza che verranno aggiunti alla data di scadenza di una richiesta di pagamento
  • emailSettings: parametri di customizzazione per email
    • bodyText: testo della mail
    • name: nome inserito nell'intestazione della mail
    • surname: cognome inserito nell'intestazione della mail
  • paymentMethodSettings: identificativi delle rate del piano di pagamento da pagare
    • name: metodo di pagamento
    • constraints: minimali e massimali del singolo metodo di pagamento
      • minimumAmount: importo minimo per il metodo di pagamento
      • maximumAmount: importo massimo per il metodo di pagamento

Nella response l'API ritorna:

  • companyId: id azienda TS Digital
  • daysDueDate: giorni di scadenza che verranno aggiunti alla data di scadenza di una richiesta di pagamento
  • emailSettings: parametri di customizzazione per email
    • bodyText: testo della mail
    • name: nome inserito nell'intestazione della mail
    • surname: cognome inserito nell'intestazione della mail
  • paymentMethodSettings: identificativi delle rate del piano di pagamento da pagare
    • name: metodo di pagamento
    • constraints: minimali e massimali del singolo metodo di pagamento
      • minimumAmount: importo minimo per il metodo di pagamento
      • maximumAmount: importo massimo per il metodo di pagamento

 

Visualizzazione di una preferenza

Permette di modificare una preferenza precedentemente creata per una specifica azienda

[GET] /preferences/{companyId}

Nella response l'API ritorna:

  • companyId: id azienda TS Digital
  • daysDueDate: giorni di scadenza che verranno aggiunti alla data di scadenza di una richiesta di pagamento
  • emailSettings: parametri di customizzazione per email
    • bodyText: testo della mail
    • name: nome inserito nell'intestazione della mail
    • surname: cognome inserito nell'intestazione della mail
  • paymentMethodSettings: identificativi delle rate del piano di pagamento da pagare
    • name: metodo di pagamento
    • constraints: minimali e massimali del singolo metodo di pagamento
      • minimumAmount: importo minimo per il metodo di pagamento
      • maximumAmount: importo massimo per il metodo di pagamento