Reservation

curl -X POST https://sandbox.duve.com/api/v1/hooks/reservation/connect \
     -H "Content-Type: application/json" \
     -d '{
  "accountId": "{{accountId}}",
  "event": "create",
  "entity": "reservation",
  "resource": {
    "id": "yourSystemReservationId",
    "status": "NEW",
    "createdAt": "2019-03-17T13:49:36Z",
    "primaryGuest": {
      "firstName": "string",
      "lastName": "Alex",
      "email": "alex@airbnb.com",
      "phone": "+33 3434343434",
      "language": "fr",
      "country": "FR"
    },
    "unitReservations": [
      {
        "id": "1154464678",
        "adults": 2,
        "checkin": "2019-05-10",
        "checkout": "2019-05-11",
        "unitId": "1212324232",
        "unitName": "Beautiful large - Two bed rooms - Kind",
        "children": 2,
        "babies": 0,
        "estimatedCheckInTime": "12:00",
        "estimatedCheckOutTime": "17:00",
        "unitRoomTypeId": "12345",
        "unitRoomTypeCode": "stg",
        "unitRoomTypeName": "Standard room",
        "price": 150,
        "paidAmount": 0,
        "status": "MODIFIED",
        "currency": "EUR",
        "doorCode": "",
        "buildingCode": "",
        "codeReleased": false,
        "comments": "This is a comment",
        "guestComments": "This is a guest comment",
        "checkInOutComments": "This is a check in check out comment",
        "additionalFields": [
          {
            "fieldName": "NEW FIELD",
            "content": "Today is Sunday, September 03"
          }
        ],
        "guests": [
          {
            "firstName": "Alex",
            "lastName": null,
            "country": "FR",
            "language": null,
            "email": "alex@airbnb.com",
            "phone": "+33 2323232323"
          },
          {
            "firstName": "Richard",
            "lastName": "Bom",
            "country": "US",
            "language": "en",
            "email": "richard@airbnb.com",
            "phone": {}
          }
        ]
      },
      {
        "id": "115555565",
        "adults": 2,
        "checkin": "2018-05-09",
        "checkout": "2018-05-11",
        "unitId": "123456",
        "unitName": "One double bed room - with sofa",
        "children": 1,
        "babies": 0,
        "unitRoomTypeId": "123456",
        "unitRoomTypeCode": "stg2",
        "unitRoomTypeName": "Standard room2",
        "price": 120,
        "paidAmount": 100,
        "status": "OPEN",
        "currency": "EUR",
        "guests": [
          {
            "firstName": "Jenny",
            "lastName": null,
            "country": "PT",
            "language": null,
            "email": "luara@duve.co",
            "phone": {}
          }
        ],
        "additionalCharges": [
          {
            "title": "Tax",
            "amount": 25,
            "amountPerDay": true
          },
          {
            "title": "Drinks",
            "amount": 40
          }
        ]
      },
      {
        "id": "1153333678",
        "adults": 0,
        "checkin": "2018-05-09",
        "checkout": "2018-05-11",
        "unitId": "123333",
        "unitName": "One double bed room - with sofa",
        "children": 0,
        "babies": 0,
        "price": 120,
        "status": "CANCELED",
        "currency": "EUR",
        "guests": []
      }
    ],
    "channelReservationId": "HTK9085122",
    "channelName": "bookingcom",
    "channelId": 7,
    "channelId2": 8,
    "marketSegment": "INT",
    "agent": "AgentName",
    "membership": "membershipName",
    "ratePlan": "ratePlanName",
    "id2": "yourSecondSystemReservationId",
    "bookedAt": "2019-03-17T13:49:36Z",
    "updatedAt": "2018-04-17T13:50:29Z"
  }
}'

{
  "newReservations": 1,
  "updatedReservations": 0,
  "skippedReservations": 0,
  "summary": "WishboxConnect reservations sync completed, synced 0 skipped 0",
  "reservationIds": [
    "yourSystemReservationId-1154464678",
    "yourSystemReservationId-115555565",
    "yourSystemReservationId-1153333678"
  ]
}

Create or update an reservation in Duve

Request

This endpoint expects an object.

accountIdstringRequired

The source id that you recieved in Your Duve account.

eventenumRequired

Allowed values:

entityenumRequired

Allowed values:

resourceobjectRequired

The entity payload body

Response

Webhook received and processed successfully.

newReservationsinteger

Number of new reservations synced.

updatedReservationsinteger

Number of updated reservations synced.

skippedReservationsinteger

Number of reservations skipped during the sync.

summarystring

Summary of the sync process.

reservationIdslist of strings

List of reservation IDs processed in the sync.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error