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.
/api/v1/options/{id}/pricing-periodsAuthorization
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.