ForHosting KIT · Strumenti per sviluppatori

Crei un calendario delle scadenze ricorrenti

Trasformi un elenco di giorni di scadenza mensili in prossime date concrete. Inserisca la data corrente, il nome di ogni bolletta e il relativo giorno: il risultato restituisce la prossima occorrenza di ciascuna voce nello stesso ordine.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Una bolletta in scadenza oggi rimane associata alla data odierna. Se un giorno valido, come 29, 30 o 31, non esiste nel mese interessato, la scadenza viene fissata all’ultimo giorno di quel mese.

Inserisca la data corrente e le bollette ricorrenti

Inizi con una data corrente nel formato non ambiguo AAAA-MM-GG. Aggiunga quindi una riga per ogni bolletta mensile, indicando un nome riconoscibile e un giorno di scadenza intero da 1 a 31. Il nome viene conservato esattamente nel risultato e può identificare un fornitore, un alias del conto o una categoria di spesa. Il giorno descrive una ricorrenza mensile, non una data completa. I valori inferiori a 1 o superiori a 31 vengono rifiutati. Anche l’ordine dell’elenco rimane invariato, così può confrontare facilmente il risultato con il Suo budget, foglio di calcolo o elenco dei pagamenti. Utilizzi una riga per ogni obbligo, anche quando più bollette condividono lo stesso giorno. La data inserita deve esistere nel calendario gregoriano; valori impossibili come il 30 febbraio non vengono interpretati in modo approssimativo.

Comprenda come viene scelta la prossima scadenza

Per ogni bolletta, il calcolo considera prima la scadenza nel mese corrente. Se tale data è oggi o è successiva, viene restituita come prossima occorrenza. Questa regola inclusiva evita di spostare al mese seguente una bolletta che scade oggi. Se la scadenza del mese corrente è già trascorsa, il calcolo avanza esattamente di un mese. Poiché i mesi hanno durate diverse, un giorno valido può non esistere in tutti i mesi. In quel caso viene utilizzato l’ultimo giorno reale del mese selezionato. Una scadenza al 31 cade quindi il 30 aprile e il 28 o 29 febbraio. La stessa regola vale per i giorni 29 e 30 a febbraio. Gli anni bisestili seguono le regole gregoriane, inclusa l’eccezione dei secoli. Il risultato è deterministico e non dipende dal fuso orario, dall’orologio locale o dalle interpretazioni dell’ambiente di esecuzione.

Utilizzi il calendario nel processo di pagamento

Il risultato contiene la data corrente indicata e una riga per ogni bolletta, con nome, giorno ricorrente e prossima data nel formato AAAA-MM-GG. Se desidera una vista cronologica del flusso di cassa, può ordinare o raggruppare le date nel Suo foglio di calcolo; il calcolo mantiene intenzionalmente l’ordine di inserimento. Lo esegua di nuovo con una data successiva per aggiornare il calendario. Input identici producono sempre output identici, favorendo verifiche e test ripetibili. Controlli i risultati di fine mese se il contratto del creditore prevede una regola diversa, come lo spostamento al giorno lavorativo seguente, perché vengono utilizzati soltanto giorni di calendario. Festività, fine settimana, periodi di tolleranza, ritardi bancari e pagamenti già effettuati non sono considerati, e nessun dato del conto viene memorizzato. Il prezzo base dell’esecuzione è $0.002; eventuali dettagli di addebito possono essere mostrati separatamente.

Casi d'uso

Bilancio familiare mensile

Converta affitto, utenze, abbonamenti, assicurazioni e carte in prossime date utili alla pianificazione del flusso di cassa.

Elenco delle fatture da pagare

Assegni una prossima data concreta a ogni fornitore ricorrente senza modificare l’ordine dell’elenco interno.

Controllo di fine mese

Verifichi come vengono adattate le scadenze del 29, 30 e 31 a febbraio e negli altri mesi più brevi.

Domande frequenti

Una bolletta che scade oggi compare oggi o il mese prossimo?

Compare oggi. La data corrente è inclusa nella selezione della prossima occorrenza.

Che cosa accade al giorno 31 in un mese più breve?

La scadenza viene collocata nell’ultimo giorno del mese, come il 30 aprile o il 28 febbraio in un anno non bisestile.

Vengono considerati i fine settimana e le festività?

No. Il calcolo usa giorni di calendario e non sposta le date in base a festività o calendari bancari.

Quali valori sono accettati come giorno di scadenza?

È richiesto un intero da 1 a 31. Zero, numeri negativi, frazioni e valori superiori a 31 vengono rifiutati.

Le bollette o i dati di pagamento vengono memorizzati?

No. Le date sono calcolate in modo deterministico dall’input, senza rete né archiviazione persistente.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/final3/recurring-bill-due-date-list

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/final3/recurring-bill-due-date-list \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"current_date":"2026-01-30","bills":[{"name":"Rent","due_day":1},{"name":"Internet","due_day":31}]}'

const res = await fetch("https://api.kit.forhosting.com/final3/recurring-bill-due-date-list", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "current_date": "2026-01-30",
    "bills": [
      {
        "name": "Rent",
        "due_day": 1
      },
      {
        "name": "Internet",
        "due_day": 31
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/final3/recurring-bill-due-date-list",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "current_date": "2026-01-30",
    "bills": [
        {
            "name": "Rent",
            "due_day": 1
        },
        {
            "name": "Internet",
            "due_day": 31
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/final3/recurring-bill-due-date-list", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"current_date":"2026-01-30","bills":[{"name":"Rent","due_day":1},{"name":"Internet","due_day":31}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"current_date":"2026-01-30","bills":[{"name":"Rent","due_day":1},{"name":"Internet","due_day":31}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/final3/recurring-bill-due-date-list", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "current_date": "2026-01-30",
  "bills": [
    {
      "name": "Rent",
      "due_day": 1
    },
    {
      "name": "Internet",
      "due_day": 31
    }
  ]
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "final3.recurring_bill_due_date_list",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →