v0.3.0

pricing periods

Sostituire modalità e intero calendario prezzi

Ricorrenza annuale nel fuso del prodotto, altrimenti del fornitore. Date MM-DD inclusive, anche a cavallo d'anno; weekdays: 0 domenica–6 sabato; startTimes: HH:mm. Serve almeno una risorsa collegata. Operazione atomica e sostitutiva. UNIT/RESOURCE: una chiave per ogni unitId; BOOKING: sola chiave booking. Importi interi nelle unità minori. I periodi devono coprire la disponibilità ricorrente; nelle sovrapposizioni vince il prezzo massimo per chiave. Le fasce retailPriceTiers sono solo BOOKING: minQuantity ≤ maxQuantity; in sovrapposizione vince il prezzo massimo, senza fascia applicabile la quotazione fallisce. Gli id dei periodi vengono rigenerati.


https://api.takoconnect.com
PUT/api/v1/options/{id}/pricing-periods
Authorization
Path
Body
curl -X PUT "https://api.takoconnect.com/api/v1/options/{id}/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": [
        "10:00"
      ],
      "retailPrices": {
        "unit-id": 2500
      }
    }
  ]
}'
[
  {
    "id": "entity-id",
    "tenantId": "tenant-id",
    "optionId": "option-id",
    "startMonthDay": "startMonthDay",
    "endMonthDay": "endMonthDay",
    "weekdays": [
      0
    ],
    "startTimes": [
      "startTimes"
    ],
    "label": "label",
    "createdAt": "2030-06-15T08:00:00.000Z",
    "updatedAt": "2030-06-15T08:00:00.000Z",
    "color": "color",
    "retailPrices": {
      "unit-id": 0
    },
    "retailPriceTiers": [
      {
        "minQuantity": 0,
        "maxQuantity": 0,
        "retail": 0
      }
    ]
  }
]

Autorizzazione

AuthorizationBearer <token>

Chiave tenant emessa dalla dashboard o da POST /api-keys, usata come Bearer token.

Scope richiesti: resources:write

In: header

Parametri di percorso

idstring

Body

Content-Type: application/json

pricingPerenum

UNITRESOURCEBOOKING

periodsobject[]

Mostra proprietà

startMonthDaystring

endMonthDaystring

weekdaysinteger[]

startTimesstring[]

label?string

color?string

retailPricesobject

retailPriceTiers?object[]

Mostra proprietà

minQuantityinteger

min 0

maxQuantityinteger

min 0

retailinteger

min 0

Risposte

200object[]

Operazione riuscita. Lo schema descrive il JSON restituito.

Mostra schema

idstring

tenantIdstring

optionIdstring

startMonthDaystring

endMonthDaystring

weekdaysinteger[]

startTimesstring[]

labelstring | null

createdAtdatetime

date-time

updatedAtdatetime

date-time

colorstring | null

retailPricesobject

retailPriceTiersobject[] | null

Mostra proprietà

minQuantityinteger

maxQuantityinteger

retailinteger

Importo nelle unità minori della valuta: EUR 1250 = 12,50 EUR.

min 0

400object

Validazione o regola di dominio non soddisfatta; correggere la richiesta.

401object

Credenziale assente, revocata, scaduta o non valida.

403object

Scope, ruolo o tipo di credenziale non consentito.

404object

Risorsa assente o non accessibile nel perimetro risolto.

409object

Conflitto di stato, capacità, versione o riferimenti; rileggere lo stato e correggere.

413object

Corpo JSON oltre il limite di 15 MB.

500object

Errore interno. Prima di ripetere una mutazione verificarne l'esito.

SuccessivoCalcolare la disponibilità operativaGET