Availability and Rates

Un seul endpoint porte les trois natures d'ARI. Un message contient une liste d'items indépendants ; chaque item porte une nature (availability, prices ou restrictions) sur une plage de nuits. Regroupez autant d'items que possible par message (plafond 5 Mo).

Update ARI

Request

Authorization: Bearer {clientToken}
X-Bridg-Signature: sha256={hmac}
Content-Type: application/json
Idempotency-Key: {optionnel}

{
  "messageId": "ari-2026-09-11T10:15:00Z-000412",
  "items": [
    {
      "unitTypeCode": "DLX",
      "from": "2026-10-10",
      "to": "2026-10-13",
      "availability": 12,
      "overbookingAllowance": 2
    },
    {
      "unitTypeCode": "DLX",
      "ratePlanCode": "BAR1",
      "from": "2026-10-10",
      "to": "2026-10-13",
      "prices": {
        "currency": "DZD",
        "byOccupancy": [
          { "guests": 1, "gross": 10000, "net": 10000 },
          { "guests": 2, "gross": 12000, "net": 12000 },
          { "guests": 3, "gross": 14000, "net": 14000 }
        ]
      }
    },
    {
      "ratePlanCode": "BAR1",
      "from": "2026-12-24",
      "to": "2027-01-01",
      "restrictions": { "minLos": 3, "closedToArrival": false }
    },
    {
      "unitTypeCode": "SUP",
      "ratePlanCode": "BAR1",
      "from": "2026-12-31",
      "to": "2027-01-01",
      "restrictions": { "closed": true }
    }
  ]
}

Success Response

200 OK — accusé par item, dans l'ordre du message :

{
  "accepted": true,
  "messageId": "ari-2026-09-11T10:15:00Z-000412",
  "results": [
    { "index": 0, "ok": true },
    { "index": 1, "ok": true },
    { "index": 2, "ok": true },
    { "index": 3, "ok": false, "error": { "code": "UNMAPPED_UNIT_TYPE", "message": "Type d'unité \"SUP\" non mappé sur cette connexion" } }
  ]
}

202 Accepted — même messageId reçu pendant son traitement :

{ "accepted": true, "messageId": "ari-2026-09-11T10:15:00Z-000412", "pending": true }

Error Response

400 Bad Request

{ "error": "messageId et items[] requis", "code": "VALIDATION_ERROR" }

401 Unauthorized

{ "error": "Signature invalide", "code": "UNAUTHORIZED" }

403 Forbidden — { "error": "Connexion paused", "code": "CONNECTION_INACTIVE" }

429 Too Many Requests — { "error": "Too many requests", "code": "RATE_LIMIT_EXCEEDED" }

500 Internal Server Error — échec transitoire, message conservé, réémettre :

{ "error": "Message reçu mais non appliqué — reprise programmée", "code": "INGEST_FAILED" }

Returns

Fields

Message

Item

Prices

Restrictions — seuls les champs fournis sont écrits.

Note

• Les items sont traités séquentiellement dans l'ordre du message ; en cas de doublon sur une même (clé, date), le dernier gagne.
• Avec unitTypeCode, une restriction est stockée par tarif × type ; la vue par tarif (celle que lit le moteur de réservation) est recalculée comme l'agrégat des types : fermée seulement si tous les types le sont, LOS la moins restrictive.
• Bridg_ retient le prix à l'occupation 2 comme référence de distribution ; à défaut, il se replie sur l'occupation la plus basse fournie. Envoyez néanmoins toutes les occupations connues.
• La disponibilité est absolue (nombre de chambres vendables), jamais un delta.
• Horizon : Bridg_ n'écrit rien au-delà de l'horizon de la connexion (365 jours à partir d'aujourd'hui par défaut, réglable dans l'écran Interface PMS). Un item qui le dépasse est ramené à l'horizon et l'accusé le signale par note ; inutile d'envoyer plus loin.
• Un closed: true ferme la vente du tarif sur tous les canaux de l'établissement, pour chaque nuit de la plage : sur une longue plage, ne l'envoyez que si c'est l'état voulu.