Forfaits et extras

Prestations supplémentaires vendables avec une réservation : forfaits chambre (liés à un type de chambre) et forfaits généraux (transfert, dîner, spa). Les forfaits vendus sont envoyés lors de la transmission de la réservation, dans extras[].

GET/external/stock/packagesLister les forfaits

Lister les forfaits#

GET/external/stock/packages

Authentification: Authorization: Bearer

Renvoie les forfaits que l’hôtel vend en ligne. priceType indique si le prix s’applique par nuit ou une seule fois, pricePlan s’il est calculé par personne ou par chambre.

Paramètres de requête

hotelIDintegerobligatoire

Identifiant de l’hôtel.

packageTypeinteger

1 forfaits chambre, 2 forfaits généraux. Vide pour tous.

12

languageIDintegerpar défaut: 1

Identifiant de la langue des noms de forfaits (Langues).

limitintegerpar défaut: 20

Nombre d’enregistrements par page.

pageintegerpar défaut: 1

Numéro de page.

orderstring

Tri par id, baslik ou fiyat ; préfixez par - pour un ordre décroissant.

Réponse

200 Succès.

Requête

curl "https://test.hms.gen.tr/external/stock/packages?hotelID=1000&packageType=2&limit=20&page=1" \
  -H "Authorization: Bearer $HMS_TOKEN"

const res = await fetch("https://test.hms.gen.tr/external/stock/packages?hotelID=1000&packageType=2&limit=20&page=1", {
  headers: {
    "Authorization": `Bearer ${process.env.HMS_TOKEN}`
  }
});
const data = await res.json();

$ch = curl_init('https://test.hms.gen.tr/external/stock/packages?hotelID=1000&packageType=2&limit=20&page=1');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . getenv('HMS_TOKEN'),
    ],
]);
$data = json_decode(curl_exec($ch), true);

Réponse · 200

{
    "success": true,
    "count": 2,
    "items": [
        {
            "id": 12,
            "name": "Dîner",
            "image": "/images/1000/stock/t-aksam-yemegi.jpg",
            "quantity": 0,
            "stockTracking": false,
            "salePrice": "400.00",
            "saleCurrency": "TRY",
            "saleCurrencyId": 1,
            "priceType": "nightly_price",
            "pricePlan": "price_per_person",
            "roomTypeId": null,
            "roomTypeName": null,
            "stockCategory": {
                "id": 4,
                "name": "Restauration"
            }
        },
        {
            "id": 15,
            "name": "Transfert aéroport",
            "image": null,
            "quantity": 0,
            "stockTracking": false,
            "salePrice": "1500.00",
            "saleCurrency": "TRY",
            "saleCurrencyId": 1,
            "priceType": "one_time_price",
            "pricePlan": "price_per_room",
            "roomTypeId": null,
            "roomTypeName": null,
            "stockCategory": {
                "id": 7,
                "name": "Transfert"
            }
        }
    ]
}

Dernière mise à jour: 21 septembre 2026Vous avez repéré une erreur ? Signalez-la-nous