Table of Contents

Teamamerica Delta API Documentation

Overview

This API provides access to a list of hotels and rooms that have been created, updated, or deleted within a specific time frame. The response is formatted in XML and contains detailed information about each record, including date ranges for changes.

## Request Structure

To retrieve updated data, send an XML request formatted as follows:

### Request XML Example

```xml <RetrieveUpdatedData> 

   <UserName>username</UserName>
   <Password>********</Password>
   <OrderCode></OrderCode> <!-- Optional -->
   <ListID></ListID> <!-- Optional -->
   <LastSynced>2023-10-02T12:00:00Z</LastSynced>
   <IncludeDeleted>0</IncludeDeleted>

</RetrieveUpdatedData> ```

### Request Parameters

Parameter Type Required Description
————– ——- ——– ——————————————————–
UserName String Yes API username for authentication
Password String Yes API password for authentication
OrderCode String No Filter records by order code
ListID String No Filter records by list ID
LastSynced String Yes Timestamp of the last synchronization in ISO 8601 format
IncludeDeleted Integer No Whether to include deleted records (0 = No, 1 = Yes)

## Response Structure

The response XML contains a timestamp and a list of updated records.

### Response XML Example

```xml <TimeStamp>2023-10-02T12:00:00Z</TimeStamp> <Lists> 

  <List id="1">
      <ListItem code="ASDFG">
          <Created>
              <DateRange>
                  <From>2025-09-11</From>
                  <To>2025-09-30</To>
              </DateRange>
              <DateRange>
                  <From>2025-10-15</From>
                  <To>2025-10-31</To>
              </DateRange>
          </Created>
          <Updated>
              <Rate>
                  <DateRange>
                      <From>2025-07-11</From>
                      <To>2025-07-15</To>
                  </DateRange>
                  <DateRange>
                      <From>2025-07-19</From>
                      <To>2025-07-25</To>
                  </DateRange>
              </Rate>
              <Inventory>
                  <Status Type="AS">
                      <DateRange>
                          <From>2025-07-11</From>
                          <To>2025-07-15</To>
                      </DateRange>
                  </Status>
                  <Status Type="SE">
                      <DateRange>
                          <From>2025-07-11</From>
                          <To>2025-07-15</To>
                      </DateRange>
                  </Status>
              </Inventory>
          </Updated>
          <Deleted>
              <DateRange>
                  <From>2025-07-11</From>
                  <To>2025-07-15</To>
              </DateRange>
          </Deleted>
      </ListItem>
  </List>

</Lists> ```

### Response Elements

Element Description
——— ———————————————————-
TimeStamp The timestamp of the response in ISO 8601 format
Lists Container for all record lists
List A collection of items, each identified by an ID
ListItem A specific item within a list, identified by a unique code
Created Contains date ranges indicating when the item was created
Updated Contains details about rate and inventory changes
Deleted Contains date ranges indicating when the item was deleted

### Updated Data

- Rate: Changes in pricing, with associated date ranges. - Inventory: Status updates with specified types (e.g., “AS”, “SE”).

Error Handling

If an error occurs, the API will return an error message in below formats:

XML format: 

<ErrorResponse>
  <Code>DCA101</Code>
  <Message>Unauthorized Access: Invalid login credentials</Message>
  <Timestamp>2025-02-19T12:34:56Z</Timestamp>
</ErrorResponse>

JSON format: 

{
  "ErrorResponse": {
    "Code": "DCA101",
    "Message": "Unauthorized Access: Invalid login credentials",
    "Timestamp": "2025-02-19T12:34:56Z"
  }
}

Common Error Codes

Code Description
DCA101 Unauthorized Access: Invalid login credentials.
DCA111 Validation Error: One or more fields failed validation checks.
DCA106 Bad Request: The request is malformed or missing required parameters.
DCA104 Data Type Mismatch: Invalid data type detected in the request.

## Notes

- The API requires authentication using a valid username and password. - Date fields follow the format `YYYY-MM-DD`. - Ensure `LastSynced` is provided to fetch only the necessary changes.

For further assistance, contact API support.