Modifica date, postazioni, righe o note (ricalcolo e riallocazione atomici)

PATCH

/api/admin/v1/establishments/{establishmentId}/bookings/{bookingId}

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://example.com/api/admin/v1/establishments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/bookings/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"

  payload := strings.NewReader("{ \"customer_id\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"starts_on\": \"2026-04-15\", \"ends_on\": \"2026-04-15\", \"slots\": \"AM\", \"formula\": \"half_day\", \"lines\": [ { \"pack_id\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"zone_id\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"spot_id\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"quantity\": 1, \"extras\": [ { \"extra_id\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"quantity\": 1 } ] } ], \"extras\": [ { \"extra_id\": \"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0\", \"quantity\": 1 } ], \"notes_customer\": \"example\", \"notes_internal\": \"example\", \"force\": true }")

  req, _ := http.NewRequest("PATCH", url, payload)

  req.Header.Add("cookie", "arenile_session=<arenile_session>")
  req.Header.Add("If-Match", "example")
  req.Header.Add("Content-Type", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

const url = 'https://example.com/api/admin/v1/establishments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/bookings/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';
const options = {
  method: 'PATCH',
  headers: {
    cookie: 'arenile_session=<arenile_session>',
    'If-Match': 'example',
    'Content-Type': 'application/json'
  },
  body: '{"customer_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","starts_on":"2026-04-15","ends_on":"2026-04-15","slots":"AM","formula":"half_day","lines":[{"pack_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","zone_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","spot_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","quantity":1,"extras":[{"extra_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","quantity":1}]}],"extras":[{"extra_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","quantity":1}],"notes_customer":"example","notes_internal":"example","force":true}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request PATCH \
  --url https://example.com/api/admin/v1/establishments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/bookings/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Content-Type: application/json' \
  --header 'If-Match: example' \
  --cookie arenile_session=<arenile_session> \
  --data '{ "customer_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "starts_on": "2026-04-15", "ends_on": "2026-04-15", "slots": "AM", "formula": "half_day", "lines": [ { "pack_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "zone_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "spot_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "quantity": 1, "extras": [ { "extra_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "quantity": 1 } ] } ], "extras": [ { "extra_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "quantity": 1 } ], "notes_customer": "example", "notes_internal": "example", "force": true }'

Spec 10.3: nuova allocazione e rilascio della vecchia nella stessa transazione, nuovo prezzo, differenza da incassare (positiva) o rimborsare (negativa). Gli snapshot originali restano (INV-21).

Authorizations

cookieAuth
bearerAuth

Parameters

Path Parameters

establishmentId

required

string format: uuid

bookingId

required

string format: uuid

Query Parameters

dry_run

boolean

True = calcola differenza e conflitti senza salvare.

Header Parameters

If-Match

required

string

<= 64 characters

ETag (versione) della mappa letta in precedenza; obbligatorio (428 precondition_required se assente). * salva sulla versione corrente; la forma debole W/"3" è accettata (ADR 0008).

X-CSRF-Token

string

Obbligatorio per le richieste autenticate via cookie che modificano dati: deve coincidere con il valore del cookie arenile_csrf.

Request Body^required

application/json

Campi da modificare; i campi assenti restano invariati. lines sostituisce tutte le righe.

object

customer_id

string format: uuid

starts_on

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slots

Fasce prenotate: mattina, pomeriggio o giorno intero.

string

Allowed values: AM PM FULL

formula

Formula di durata.

string

Allowed values: half_day day multi_day week fortnight month season

lines

Array<object>

>= 1 items <= 50 items

object

pack_id

required

string format: uuid

zone_id

Obbligatoria per zone in modalità zone o quantity; dedotta dalla postazione in modalità seat.

string format: uuid

spot_id

Obbligatoria per le zone seat; facoltativa per le zone zone (assegnazione immediata).

string format: uuid

quantity

Default 1; >1 solo per zone quantity.

integer

>= 1 <= 100

extras

Array<object>

object

extra_id

required

string format: uuid

quantity

required

integer

>= 1

extras

Array<object>

object

extra_id

required

string format: uuid

quantity

required

integer

>= 1

notes_customer

string

<= 2000 characters

notes_internal

string

<= 2000 characters

force

Ignora i limiti di modifica della policy (registrato nell’audit).

boolean

Responses

200

Esito della modifica

application/json

object

applied

required

False con dry_run=true (nessuna scrittura).

boolean

booking

required

object

required

string format: uuid

code

required

string

status

required

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

channel

required

Canale di vendita.

string

Allowed values: desk online api

customer

required

object

required

string format: uuid

first_name

required

string

last_name

required

string

display_name

required

Cognome e nome per elenchi e mappa.

string

email

string

phone

string

locale

required

string

notes

required

string

tags

required

Array<string>

agreement_id

string format: uuid

marketing_consent

Consenso marketing separato e facoltativo (spec 23).

object

given_at

required

string format: date-time

source

required

string

<= 40 characters

text_version

required

string

<= 40 characters

anonymized_at

string format: date-time

version

required

Versione per la concorrenza ottimistica; coincide con l’ETag.

integer format: int64

>= 1

created_at

required

string format: date-time

updated_at

required

string format: date-time

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slots

required

Fasce prenotate: mattina, pomeriggio o giorno intero.

string

Allowed values: AM PM FULL

formula

required

Formula di durata.

string

Allowed values: half_day day multi_day week fortnight month season

is_season_pass

required

boolean

test

Creata in modalità prova (spec 15.4): esclusa da report, KPI, corrispettivi ed esportazioni.

boolean

season_id

string format: uuid

total_amount

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

paid_amount

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

balance_due

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

deposit_due

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

hold_expires_at

string format: date-time

lines

required

Array<object>

object

required

string format: uuid

pack_id

required

string format: uuid

pack_code

string

zone_id

required

string format: uuid

spot_id

string format: uuid

spot_label

string

assignment_status

required

string

Allowed values: assigned pending not_applicable

quantity

required

Unità per le zone a quantità; 1 altrimenti.

integer

line_total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

extras

required

Array<object>

object

required

string format: uuid

extra_id

required

string format: uuid

extra_code

string

booking_line_id

Assente per gli extra legati alla prenotazione.

string format: uuid

quantity

required

integer

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

extras

required

Extra legati alla prenotazione (attach_to = booking).

Array<object>

object

required

string format: uuid

extra_id

required

string format: uuid

extra_code

string

booking_line_id

Assente per gli extra legati alla prenotazione.

string format: uuid

quantity

required

integer

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

allocations

required

Array<object>

Una riga di spot_allocations o pool_allocations della prenotazione.

object

booking_line_id

string format: uuid

spot_id

string format: uuid

pool_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

kind

required

string

Allowed values: booking hold block season

quantity

integer

expires_at

string format: date-time

payments

required

Array<object>

object

required

string format: uuid

booking_id

string format: uuid

booking_code

string

provider

required

Manual, stripe, …

string

method

required

Metodo di pagamento (spec 6.7); credit = uso del saldo crediti del cliente (spec 13.4).

string

Allowed values: cash card bank_transfer wallet credit other

direction

required

string

Allowed values: in refund

amount

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

status

required

string

Allowed values: pending succeeded failed cancelled

provider_ref

string

cash_session_id

string format: uuid

refund_of_payment_id

string format: uuid

received_by_user_id

string format: uuid

description

string

note

string

created_at

required

string format: date-time

test

Incassato in modalità prova (spec 15.4): escluso da report, KPI, corrispettivi ed esportazioni.

boolean

history

required

Array<object>

Voce dello storico, letta dal registro attività (audit_log).

object

required

string format: date-time

action

required

Es. booking.created, booking.confirmed, booking.note_added, payment.succeeded.

string

actor_type

required

string

Allowed values: user customer system api_key

actor_id

string

actor_name

string

details

object

key

additional properties

any

price_snapshot

required

Dettaglio completo del calcolo (spec 8.6), con le regole applicate passo per passo.

object

engine_version

required

integer

currency

required

string

lines

required

Array<object>

object

pack

required

string

zone

required

string

spot

string

fixed

object

formula

required

Formula a durata fissa.

string

Allowed values: week fortnight month season

rate_period

string

amount

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

days

required

Array<object>

object

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slots

required

Fasce prenotate: mattina, pomeriggio o giorno intero.

string

Allowed values: AM PM FULL

base

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

applied

required

Array<object>

object

rule

required

string

stage

required

string

Allowed values: base modifier discount

effect

required

string

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

extras

required

Array<object>

object

code

required

string

qty

required

integer

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

extras

Array<object>

object

code

required

string

qty

required

integer

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

discounts

required

Array<object>

object

source

required

string

amount

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

rounding

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

vat

required

Array<object>

object

rate

required

Numero decimale esatto come stringa (es. “1.2”, “0.5”, “10”). Mai float nel calcolo.

string

/^-?[0-9]{1,9}(\.[0-9]{1,6})?$/

taxable

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

tax

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

price_current

Scomposizione corrente del prezzo dopo una modifica successiva alla conferma (ADR 0011): total_amount coincide con il suo totale. Assente finché la prenotazione non è stata modificata dopo la conferma (vale price_snapshot, immutabile, INV-21).

object

engine_version

required

integer

currency

required

string

lines

required

Array<object>

object

pack

required

string

zone

required

string

spot

string

fixed

object

formula

required

Formula a durata fissa.

string

Allowed values: week fortnight month season

rate_period

string

amount

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

days

required

Array<object>

object

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slots

required

Fasce prenotate: mattina, pomeriggio o giorno intero.

string

Allowed values: AM PM FULL

base

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

applied

required

Array<object>

object

rule

required

string

stage

required

string

Allowed values: base modifier discount

effect

required

string

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

extras

required

Array<object>

object

code

required

string

qty

required

integer

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

extras

Array<object>

object

code

required

string

qty

required

integer

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

discounts

required

Array<object>

object

source

required

string

amount

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

rounding

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

vat

required

Array<object>

object

rate

required

Numero decimale esatto come stringa (es. “1.2”, “0.5”, “10”). Mai float nel calcolo.

string

/^-?[0-9]{1,9}(\.[0-9]{1,6})?$/

taxable

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

tax

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

policy_snapshot

required

Policy applicata al momento della creazione (spec 9), base di rimborsi e modifiche.

object

policy_id

string format: uuid

rules

required

Vincoli di prenotazione (spec 9); i campi assenti ereditano dalla policy di default.

object

min_lead_time

object

days

integer

cutoff_time

string

/^([01][0-9]|2[0-3]):[0-5][0-9]$/

max_lead_time_days

integer

same_day_booking

object

enabled

boolean

until

string

/^([01][0-9]|2[0-3]):[0-5][0-9]$/

only_slot

string

Allowed values: AM PM PM_after

duration

object

allowed_formulas

Array<string>

Allowed values: half_day day multi_day week fortnight month season

min_days

integer

>= 1

max_days

integer

>= 1

fixed_start_weekday

ISO 1..7; 0 = qualsiasi.

integer

<= 7

payment

object

mode

string

Allowed values: full deposit none

deposit

object

type

string

Allowed values: percent amount

value

Percentuale intera o importo in centesimi.

integer format: int64

balance_due

string

/^(on_arrival|days_before:[0-9]{1,3})$/

cancellation

Array<object>

object

until_days_before

required

integer

refund_percent

required

integer

<= 100

string

Allowed values: refund credit

modification

object

allowed_until_days_before

integer

fee

Importo in centesimi di euro (IVA inclusa).

integer format: int64

weather_policy

object

enabled

boolean

string

Allowed values: refund credit

approval_required

boolean

max_spots_per_booking

integer

>= 1

allow_spot_change_during_stay

boolean

customer_can_release_season_days

boolean

season_release_credit

object

enabled

boolean

percent

integer

<= 100

credit_validity_days

Validità in giorni dei crediti emessi da questa policy (cancellazione, meteo, rilascio): expires_on = giorno di emissione + giorni. Assente o 0 = nessuna scadenza (spec 9, 13.4).

integer

<= 3650

promo_code

string

agreement_id

string format: uuid

notes_customer

required

string

notes_internal

required

string

cancelled_at

string format: date-time

cancel_reason

string

created_by_user_id

string format: uuid

refunds

Rimborsi garantiti verso il provider (stato visibile, mai persi né doppi).

Array<object>

object

required

string format: uuid

booking_id

required

string format: uuid

booking_code

string

amount

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

provider

required

string

payment_intent_id

Intent di pagamento rimborsato.

string format: uuid

refund_intent_id

Intent di rimborso presso il provider (dopo il primo invio).

string format: uuid

payment_id

Riga refund del registro pagamenti (dopo la conferma).

string format: uuid

status

required

Pending: riservato, in attesa di invio (o di nuovo tentativo); processing: inviato al provider, in attesa di conferma; succeeded: confermato dal provider (riga refund nel registro pagamenti); failed: tentativi esauriti, serve un intervento (notifica al gestore); cancelled: annullato dal gestore (rimborso fatto altrove).

string

Allowed values: pending processing succeeded failed cancelled

attempts

required

integer

next_attempt_at

string format: date-time

last_error

string

reason

required

string

Allowed values: customer_cancellation panel_cancellation expired_hold

test

boolean

created_at

required

string format: date-time

updated_at

required

string format: date-time

completed_at

string format: date-time

next_statuses

required

Stati raggiungibili da quello corrente (macchina a stati, spec 10.2).

Array<string>

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

version

required

Versione per la concorrenza ottimistica; coincide con l’ETag.

integer format: int64

>= 1

created_at

required

string format: date-time

updated_at

required

string format: date-time

previous_total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

new_total

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

price_difference

required

Importo in centesimi di euro (IVA inclusa).

integer format: int64

conflicts

required

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

Example

{
  "booking": {
    "status": "draft",
    "channel": "desk",
    "slots": "AM",
    "formula": "half_day",
    "lines": [
      {
        "assignment_status": "assigned"
      }
    ],
    "allocations": [
      {
        "slot": "AM",
        "kind": "booking"
      }
    ],
    "payments": [
      {
        "method": "cash",
        "direction": "in",
        "status": "pending"
      }
    ],
    "history": [
      {
        "actor_type": "user"
      }
    ],
    "price_snapshot": {
      "lines": [
        {
          "fixed": {
            "formula": "week"
          },
          "days": [
            {
              "slots": "AM",
              "applied": [
                {
                  "stage": "base"
                }
              ]
            }
          ]
        }
      ]
    },
    "price_current": {
      "lines": [
        {
          "fixed": {
            "formula": "week"
          },
          "days": [
            {
              "slots": "AM",
              "applied": [
                {
                  "stage": "base"
                }
              ]
            }
          ]
        }
      ]
    },
    "policy_snapshot": {
      "rules": {
        "same_day_booking": {
          "only_slot": "AM"
        },
        "duration": {
          "allowed_formulas": [
            "half_day"
          ]
        },
        "payment": {
          "mode": "full",
          "deposit": {
            "type": "percent"
          }
        },
        "cancellation": [
          {
            "as": "refund"
          }
        ],
        "weather_policy": {
          "as": "refund"
        }
      }
    },
    "refunds": [
      {
        "status": "pending",
        "reason": "customer_cancellation"
      }
    ],
    "next_statuses": [
      "draft"
    ]
  },
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ]
}

Headers

ETag

string

Versione della risorsa ("<version>"), da reinviare in If-Match.

400

Richiesta non valida

application/problem+json

Errore RFC 9457 (application/problem+json).

object

type

required

Slug stabile del tipo di errore. I client devono basarsi su questo valore, mai sul testo di title o detail.

string

Allowed values: bad_request validation_failed unauthorized invalid_credentials totp_required invalid_totp totp_enrolment_required totp_already_enabled forbidden csrf_failed not_found conflict method_not_allowed unsupported_media_type rate_limited idempotency_key_reused idempotency_in_progress internal_error spot_unavailable no_price policy_violation hold_expired version_conflict precondition_required spot_has_future_allocations not_implemented pool_exhausted quota_exceeded invalid_transition cash_session_closed cash_session_already_open booking_outside_period checkout_not_found payment_provider_unavailable webhook_signature_invalid pairing_code_invalid lan_mode_required loopback_required setup_token_invalid setup_completed renewal_expired waitlist_offer_expired waitlist_disabled credit_insufficient season_rollover_conflict test_mode_preview_required import_invalid import_already_applied refund_in_progress zone_full assignment_conflict ticket_number_conflict ticket_voided ticket_already_entered price_changed ticket_owned printing_unavailable printer_address_not_allowed print_route_missing payment_provider_test_mode email_template_invalid

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after

Secondi da attendere (solo per rate_limited).

integer

errors

Array<object>

object

field

required

string

message

required

string

current_version

Versione corrente della risorsa (solo per version_conflict).

integer format: int64

spot_ids

Postazioni con allocazioni future (solo per spot_has_future_allocations).

Array<string>

violations

Vincoli violati (solo per policy_violation).

Array<object>

object

code

required

Codice stabile (es. lead_time_too_short).

string

params

object

key

additional properties

string

conflicts

Mezze giornate non disponibili (solo per spot_unavailable, pool_exhausted, quota_exceeded).

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

current_status

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

existing_customer_id

Cliente già presente con la stessa email o telefono (solo per conflict su createCustomer).

string format: uuid

period

Periodo del soggiorno e data odierna dello stabilimento (solo per booking_outside_period).

object

today

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

Example

{
  "type": "bad_request",
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ],
  "current_status": "draft"
}

401

Autenticazione assente o non valida

application/problem+json

Errore RFC 9457 (application/problem+json).

object

type

required

Slug stabile del tipo di errore. I client devono basarsi su questo valore, mai sul testo di title o detail.

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after

Secondi da attendere (solo per rate_limited).

integer

errors

Array<object>

object

field

required

string

message

required

string

current_version

Versione corrente della risorsa (solo per version_conflict).

integer format: int64

spot_ids

Postazioni con allocazioni future (solo per spot_has_future_allocations).

Array<string>

violations

Vincoli violati (solo per policy_violation).

Array<object>

object

code

required

Codice stabile (es. lead_time_too_short).

string

params

object

key

additional properties

string

conflicts

Mezze giornate non disponibili (solo per spot_unavailable, pool_exhausted, quota_exceeded).

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

current_status

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

existing_customer_id

Cliente già presente con la stessa email o telefono (solo per conflict su createCustomer).

string format: uuid

period

Periodo del soggiorno e data odierna dello stabilimento (solo per booking_outside_period).

object

today

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

Example

{
  "type": "bad_request",
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ],
  "current_status": "draft"
}

403

Permesso negato

application/problem+json

Errore RFC 9457 (application/problem+json).

object

type

required

Slug stabile del tipo di errore. I client devono basarsi su questo valore, mai sul testo di title o detail.

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after

Secondi da attendere (solo per rate_limited).

integer

errors

Array<object>

object

field

required

string

message

required

string

current_version

Versione corrente della risorsa (solo per version_conflict).

integer format: int64

spot_ids

Postazioni con allocazioni future (solo per spot_has_future_allocations).

Array<string>

violations

Vincoli violati (solo per policy_violation).

Array<object>

object

code

required

Codice stabile (es. lead_time_too_short).

string

params

object

key

additional properties

string

conflicts

Mezze giornate non disponibili (solo per spot_unavailable, pool_exhausted, quota_exceeded).

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

current_status

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

existing_customer_id

Cliente già presente con la stessa email o telefono (solo per conflict su createCustomer).

string format: uuid

period

Periodo del soggiorno e data odierna dello stabilimento (solo per booking_outside_period).

object

today

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

Example

{
  "type": "bad_request",
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ],
  "current_status": "draft"
}

404

Risorsa inesistente

application/problem+json

Errore RFC 9457 (application/problem+json).

object

type

required

Slug stabile del tipo di errore. I client devono basarsi su questo valore, mai sul testo di title o detail.

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after

Secondi da attendere (solo per rate_limited).

integer

errors

Array<object>

object

field

required

string

message

required

string

current_version

Versione corrente della risorsa (solo per version_conflict).

integer format: int64

spot_ids

Postazioni con allocazioni future (solo per spot_has_future_allocations).

Array<string>

violations

Vincoli violati (solo per policy_violation).

Array<object>

object

code

required

Codice stabile (es. lead_time_too_short).

string

params

object

key

additional properties

string

conflicts

Mezze giornate non disponibili (solo per spot_unavailable, pool_exhausted, quota_exceeded).

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

current_status

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

existing_customer_id

Cliente già presente con la stessa email o telefono (solo per conflict su createCustomer).

string format: uuid

period

Periodo del soggiorno e data odierna dello stabilimento (solo per booking_outside_period).

object

today

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

Example

{
  "type": "bad_request",
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ],
  "current_status": "draft"
}

409

Conflitto con lo stato corrente

application/problem+json

Errore RFC 9457 (application/problem+json).

object

type

required

Slug stabile del tipo di errore. I client devono basarsi su questo valore, mai sul testo di title o detail.

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after

Secondi da attendere (solo per rate_limited).

integer

errors

Array<object>

object

field

required

string

message

required

string

current_version

Versione corrente della risorsa (solo per version_conflict).

integer format: int64

spot_ids

Postazioni con allocazioni future (solo per spot_has_future_allocations).

Array<string>

violations

Vincoli violati (solo per policy_violation).

Array<object>

object

code

required

Codice stabile (es. lead_time_too_short).

string

params

object

key

additional properties

string

conflicts

Mezze giornate non disponibili (solo per spot_unavailable, pool_exhausted, quota_exceeded).

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

current_status

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

existing_customer_id

Cliente già presente con la stessa email o telefono (solo per conflict su createCustomer).

string format: uuid

period

Periodo del soggiorno e data odierna dello stabilimento (solo per booking_outside_period).

object

today

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

Example

{
  "type": "bad_request",
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ],
  "current_status": "draft"
}

412

Versione non aggiornata (version_conflict, con current_version)

application/problem+json

Errore RFC 9457 (application/problem+json).

object

type

required

Slug stabile del tipo di errore. I client devono basarsi su questo valore, mai sul testo di title o detail.

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after

Secondi da attendere (solo per rate_limited).

integer

errors

Array<object>

object

field

required

string

message

required

string

current_version

Versione corrente della risorsa (solo per version_conflict).

integer format: int64

spot_ids

Postazioni con allocazioni future (solo per spot_has_future_allocations).

Array<string>

violations

Vincoli violati (solo per policy_violation).

Array<object>

object

code

required

Codice stabile (es. lead_time_too_short).

string

params

object

key

additional properties

string

conflicts

Mezze giornate non disponibili (solo per spot_unavailable, pool_exhausted, quota_exceeded).

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

current_status

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

existing_customer_id

Cliente già presente con la stessa email o telefono (solo per conflict su createCustomer).

string format: uuid

period

Periodo del soggiorno e data odierna dello stabilimento (solo per booking_outside_period).

object

today

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

Example

{
  "type": "bad_request",
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ],
  "current_status": "draft"
}

422

Richiesta valida ma non elaborabile (no_price, policy_violation, email_template_invalid)

application/problem+json

Errore RFC 9457 (application/problem+json).

object

type

required

Slug stabile del tipo di errore. I client devono basarsi su questo valore, mai sul testo di title o detail.

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after

Secondi da attendere (solo per rate_limited).

integer

errors

Array<object>

object

field

required

string

message

required

string

current_version

Versione corrente della risorsa (solo per version_conflict).

integer format: int64

spot_ids

Postazioni con allocazioni future (solo per spot_has_future_allocations).

Array<string>

violations

Vincoli violati (solo per policy_violation).

Array<object>

object

code

required

Codice stabile (es. lead_time_too_short).

string

params

object

key

additional properties

string

conflicts

Mezze giornate non disponibili (solo per spot_unavailable, pool_exhausted, quota_exceeded).

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

current_status

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

existing_customer_id

Cliente già presente con la stessa email o telefono (solo per conflict su createCustomer).

string format: uuid

period

Periodo del soggiorno e data odierna dello stabilimento (solo per booking_outside_period).

object

today

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

Example

{
  "type": "bad_request",
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ],
  "current_status": "draft"
}

428

Header If-Match mancante (precondition_required)

application/problem+json

Errore RFC 9457 (application/problem+json).

object

type

required

Slug stabile del tipo di errore. I client devono basarsi su questo valore, mai sul testo di title o detail.

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after

Secondi da attendere (solo per rate_limited).

integer

errors

Array<object>

object

field

required

string

message

required

string

current_version

Versione corrente della risorsa (solo per version_conflict).

integer format: int64

spot_ids

Postazioni con allocazioni future (solo per spot_has_future_allocations).

Array<string>

violations

Vincoli violati (solo per policy_violation).

Array<object>

object

code

required

Codice stabile (es. lead_time_too_short).

string

params

object

key

additional properties

string

conflicts

Mezze giornate non disponibili (solo per spot_unavailable, pool_exhausted, quota_exceeded).

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

current_status

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

existing_customer_id

Cliente già presente con la stessa email o telefono (solo per conflict su createCustomer).

string format: uuid

period

Periodo del soggiorno e data odierna dello stabilimento (solo per booking_outside_period).

object

today

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

Example

{
  "type": "bad_request",
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ],
  "current_status": "draft"
}

501

Operazione non ancora disponibile (not_implemented)

application/problem+json

Errore RFC 9457 (application/problem+json).

object

type

required

Slug stabile del tipo di errore. I client devono basarsi su questo valore, mai sul testo di title o detail.

string

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after

Secondi da attendere (solo per rate_limited).

integer

errors

Array<object>

object

field

required

string

message

required

string

current_version

Versione corrente della risorsa (solo per version_conflict).

integer format: int64

spot_ids

Postazioni con allocazioni future (solo per spot_has_future_allocations).

Array<string>

violations

Vincoli violati (solo per policy_violation).

Array<object>

object

code

required

Codice stabile (es. lead_time_too_short).

string

params

object

key

additional properties

string

conflicts

Mezze giornate non disponibili (solo per spot_unavailable, pool_exhausted, quota_exceeded).

Array<object>

Mezza giornata non disponibile per una risorsa (spec 7.2), restituita in Problem.conflicts e nelle anteprime.

object

spot_id

string format: uuid

pool_id

string format: uuid

zone_id

string format: uuid

date

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

slot

required

Fascia: mattina o pomeriggio.

string

Allowed values: AM PM

reason

required

string

Allowed values: spot_unavailable pool_exhausted quota_exceeded closed inactive

current_status

Stato della prenotazione (spec 10.2).

string

Allowed values: draft held pending_payment awaiting_approval confirmed checked_in completed cancelled no_show expired rejected

existing_customer_id

Cliente già presente con la stessa email o telefono (solo per conflict su createCustomer).

string format: uuid

period

Periodo del soggiorno e data odierna dello stabilimento (solo per booking_outside_period).

object

today

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

starts_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

ends_on

required

Data di calendario YYYY-MM-DD nel fuso dello stabilimento.

string format: date

Example

{
  "type": "bad_request",
  "conflicts": [
    {
      "slot": "AM",
      "reason": "spot_unavailable"
    }
  ],
  "current_status": "draft"
}

Modifica date, postazioni, righe o note (ricalcolo e riallocazione atomici)

Authorizations

Parameters

Path Parameters

Query Parameters

Header Parameters

Request Bodyrequired

Responses

200

Example

Headers

400

Example

401

Example

403

Example

404

Example

409

Example

412

Example

422

Example

428

Example

501

Example

Request Body^required