v0.3.0

Prezzi

Valuta del tenant, modalità di prezzo e periodi tariffari.


Valuta

Leggi tenant.defaultCurrency da GET /me. Per cambiarla usa PATCH /me con {"defaultCurrency":"EUR"} prima di inserire tariffe: se esistono periodi di prezzo ricevi 409. Non sono inclusi cambio valuta, prezzi netti o maggiorazioni automatiche per canale.

Modalità pricingPer

pricingPerPrezzo e consumo
UNITretailPrices: una chiave per ogni unitId. Consumo di posti secondo paxCount e requisiti della risorsa.
RESOURCEretailPrices: una chiave per ogni unitId. L’unità vende una risorsa intera identificata da metadata.resourceId.
BOOKINGretailPrices: sola chiave booking. Prezzo per prenotazione; consumo in risorse intere. resourceItems può specificare quante usarne.

Periodi tariffari

curl -X PUT "$TAKO_API_URL/api/v1/options/{optionId}/pricing-periods" \
  -H "Authorization: Bearer $TAKO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "pricingPer": "UNIT",
  "periods": [
    {
      "startMonthDay": "01-01",
      "endMonthDay": "12-31",
      "weekdays": [
        0,
        1,
        2,
        3,
        4,
        5,
        6
      ],
      "startTimes": [
        "09:00",
        "15:00"
      ],
      "retailPrices": {
        "adult-unit-id": 2500,
        "child-unit-id": 1500
      }
    }
  ]
}'

Il PUT sostituisce tutti i periodi e la modalità dell’opzione atomicamente; gli id vengono rigenerati. Le chiavi prezzo devono corrispondere alle unità attuali, oppure alla sola booking. Serve copertura di ogni partenza ricorrente.

I periodi possono sovrapporsi: per ogni chiave vince il prezzo massimo applicabile. In BOOKING retailPriceTiers definisce fasce con minQuantity, maxQuantity e retail; se nessuna copre la quantità, la quotazione fallisce.

Il totale autorevole è booking.pricingSnapshot.retail. Un cambio di listino non cambia le prenotazioni salvate; una modifica materiale ricalcola lo snapshot. Aggiungere un’unità inserisce una voce a prezzo zero: correggila prima di vendere. Completare i prezzi non attiva il prodotto.