CUP Mock — Guida Tecnica

Regole generali

• Tutti gli endpoint REST sono POST e restituiscono JSON.
• Le risposte di errore seguono il formato: {"ok": false, "error": "codice_errore"}.
• request_id è consigliato per tracciamento e idempotenza lato cliente.
• ids_slot è un array di interi (ID slot presenti in vista_agende_slot_disponibili).
• Se il gestionale non gestisce id_slot, potete usare slots con codice_agenda + datetime_start_slot.
• Ricette elettroniche: non esiste alcuna vista DB. Il cliente interroga un servizio esterno (SSN) e restituisce i dati via REST.

Workflow consigliato

1. Leggere disponibilità da vista_agende_slot_disponibili.
2. Bloccare slot selezionati con /v1/bookings/blocca.
3. Inserire prenotazione con /v1/bookings/insert.
4. Se l’utente annulla prima del commit, liberare con /v1/bookings/libera.

Errori standard

Ricette elettroniche

Recupera i dati utente e la prestazione associata ad una NRE (ricetta elettronica).

Nota: questa informazione non proviene da viste DB. Il cliente interroga il servizio SSN e risponde via REST. Nel mock i dati arrivano dalla tabella ricette_elettroniche (pagina Admin).

{
  "codice_fiscale": "RSSMRA80A01H501Z",
  "codice_ricetta": "1900A1234567890"
}

{
  "ok": true,
  "codice_ricetta_15_cifre": "1900A1234567890",
  "codice_fiscale": "RSSMRA80A01H501Z",
  "nome": "Mario",
  "cognome": "Rossi",
  "tel1": "3357378145",
  "tel2": "",
  "tel3": "",
  "prestazioni": [
    {
      "codice_prestazione": "88.93.B",
      "data_emissione": "2026-03-05 00:00:00",
      "gg_validita": 30
    }
  ]
}

curl -X POST https://cupmock.ccup.it/api/v1/ricette_elettroniche \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <key>" \
  -d '{"codice_fiscale":"RSSMRA80A01H501Z","codice_ricetta":"1900A1234567890"}'

Blocca slot

Riserva uno o più slot (es. pre‑prenotazione). Gli slot diventano temporaneamente non disponibili.

{
  "request_id": "uuid",
  "ids_slot": [1001, 1002]
}

{
  "request_id": "uuid",
  "slots": [
    {"codice_agenda": "AGENDA_01", "datetime_start_slot": "2026-03-07 09:00:00"}
  ]
}

curl -X POST https://cupmock.ccup.it/api/v1/bookings/blocca \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <key>" \
  -d '{"request_id":"uuid","ids_slot":[1001,1002]}'

Libera slot

Rilascia slot precedentemente bloccati.

{
  "request_id": "uuid",
  "ids_slot": [1001, 1002]
}

{
  "request_id": "uuid",
  "slots": [
    {"codice_agenda": "AGENDA_01", "datetime_start_slot": "2026-03-07 09:00:00"}
  ]
}

curl -X POST https://cupmock.ccup.it/api/v1/bookings/libera \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <key>" \
  -d '{"request_id":"uuid","ids_slot":[1001,1002]}'

Insert prenotazione

Crea una prenotazione, legandola ad agenda, prestazione e slot selezionati.

{
  "request_id": "uuid",
  "booking_code": "ABC123456",
  "codice_agenda": "AGENDA_01",
  "codice_prestazione": "PREST_001",
  "NRE": "1900A4833547605",
  "codice_fiscale": "RSSMRA80A01H501Z",
  "channel": "voice",
  "ids_slot": [1001]
}

{
  "request_id": "uuid",
  "booking_code": "ABC123456",
  "codice_agenda": "AGENDA_01",
  "codice_prestazione": "PREST_001",
  "NRE": "1900A4833547605",
  "codice_fiscale": "RSSMRA80A01H501Z",
  "channel": "voice",
  "slots": [
    {"codice_agenda": "AGENDA_01", "datetime_start_slot": "2026-03-07 09:00:00"}
  ]
}

curl -X POST https://cupmock.ccup.it/api/v1/bookings/insert \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <key>" \
  -d '{"request_id":"uuid","booking_code":"ABC123456","codice_agenda":"AGENDA_01","codice_prestazione":"PREST_001","NRE":"1900A4833547605","codice_fiscale":"RSSMRA80A01H501Z","channel":"voice","ids_slot":[1001]}'

Disdetta prenotazione

Annulla una prenotazione esistente.

{
  "request_id": "uuid",
  "requested_at": "2026-03-07 11:00:00"
}

curl -X POST https://cupmock.ccup.it/api/v1/bookings/ABC123456/cancel \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <key>" \
  -d '{"request_id":"uuid","requested_at":"2026-03-07 11:00:00"}'

Panoramica

vista_prestazioni

vista_agende

vista_agende_prestazioni_map

vista_agende_slot_disponibili

vista_prenotazioni