Agentivity API

<back to all web services

BookingEventsSummaryRequest

The following routes are available for this service:
All Verbs/BookingEventsSummary
import Foundation
import ServiceStack

// @DataContract(Namespace="schemas.agentivity.com/types")
public class BookingEventsSummaryRequest : CompanyLevelRequestBase
{
    /**
    * Date in format YYYYMMDD
    */
    // @DataMember
    public var eventDateStart:String

    /**
    * Date in format YYYYMMDD
    */
    // @DataMember
    public var eventDateEnd:String

    /**
    * Comma Delimited List of PCCs
    */
    // @DataMember
    public var owningAgencyLocationID:[String]

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case eventDateStart
        case eventDateEnd
        case owningAgencyLocationID
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        eventDateStart = try container.decodeIfPresent(String.self, forKey: .eventDateStart)
        eventDateEnd = try container.decodeIfPresent(String.self, forKey: .eventDateEnd)
        owningAgencyLocationID = try container.decodeIfPresent([String].self, forKey: .owningAgencyLocationID) ?? []
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if eventDateStart != nil { try container.encode(eventDateStart, forKey: .eventDateStart) }
        if eventDateEnd != nil { try container.encode(eventDateEnd, forKey: .eventDateEnd) }
        if owningAgencyLocationID != nil { try container.encode(owningAgencyLocationID, forKey: .owningAgencyLocationID) }
    }
}

// @DataContract(Namespace="schemas.agentivity.com/types")
public class CompanyLevelRequestBase : PagingMetadata, IMemberUsername, IMemberOwningCompanyCode
{
    /**
    * Comma Delimited List of Owning Company Codes
    */
    // @DataMember
    public var owningCompanyCode:[String]

    /**
    * UserName in form of an email address
    */
    // @DataMember
    public var userName:String

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case owningCompanyCode
        case userName
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        owningCompanyCode = try container.decodeIfPresent([String].self, forKey: .owningCompanyCode) ?? []
        userName = try container.decodeIfPresent(String.self, forKey: .userName)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if owningCompanyCode != nil { try container.encode(owningCompanyCode, forKey: .owningCompanyCode) }
        if userName != nil { try container.encode(userName, forKey: .userName) }
    }
}

// @DataContract(Name="Metadata", Namespace="schemas.agentivity.com/types")
public class PagingMetadata : Codable
{
    /**
    * Starting Record
    */
    // @DataMember
    // @ApiMember(DataType="string", Description="Starting Record", Name="Offset", ParameterType="query")
    public var offset:String

    /**
    * Number of records to return (PageSize)
    */
    // @DataMember
    // @ApiMember(DataType="string", Description="Number of records to return (PageSize)", Name="Limit", ParameterType="query")
    public var limit:String

    /**
    * Total Number of Records in a Full Reponse (if no paging)
    */
    // @DataMember
    // @ApiMember(DataType="string", Description="Total Number of Records in a Full Reponse (if no paging)", Name="TotalRecords", ParameterType="query")
    public var totalRecords:Int

    /**
    * Total Number of Records in this Reponse (on this page)
    */
    // @DataMember
    // @ApiMember(DataType="string", Description="Total Number of Records in this Reponse (on this page)", Name="ResponseRecords", ParameterType="query")
    public var responseRecords:Int

    required public init(){}
}

// @DataContract(Name="AgentivityResponse", Namespace="schemas.agentivity.com/types")
public class BookingEventsSummaryRequestItemResponse : ItemResponse<BookingEventsSummary, BookingEventsSummaryRequestResponseReport>
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

// @DataContract(Name="AgentivityResponse", Namespace="schemas.agentivity.com/types")
public class ItemResponse<TItem : Codable, TReport : Codable> : Codable
{
    // @DataMember(Order=1)
    public var responseMetadata:ResponseMetadata

    // @DataMember(Order=2, EmitDefaultValue=false)
    public var responseReport:TReport

    // @DataMember(Order=3, EmitDefaultValue=false)
    public var responseError:AgentivityError

    required public init(){}
}

// @DataContract(Name="ResponseMetadata", Namespace="schemas.agentivity.com/types")
public class ResponseMetadata : Codable
{
    // @DataMember(Order=0)
    public var success:Bool

    // @DataMember(Order=1)
    public var hasCache:Bool

    // @DataMember(Order=2)
    public var hasPaging:Bool

    // @DataMember(Order=3, EmitDefaultValue=false)
    public var cacheMetadata:CacheMetadata

    // @DataMember(Order=4, EmitDefaultValue=false)
    public var pagingMetadata:PagingMetadata

    required public init(){}
}

// @DataContract(Name="CacheMetadata", Namespace="schemas.agentivity.com/types")
public class CacheMetadata : Codable
{
    // @DataMember(Order=1)
    public var cachedAt:Date

    // @DataMember(Order=2)
    public var cacheExpiresAt:Date

    // @DataMember(Order=0)
    public var isFromCache:Bool

    required public init(){}
}

// @DataContract(Name="ResponseMetadata", Namespace="schemas.agentivity.com/types")
public class AgentivityError : Codable
{
    // @DataMember
    public var errorCode:String

    // @DataMember
    public var message:String

    // @DataMember
    public var statusCode:String

    // @DataMember
    public var verboseMessage:String

    required public init(){}
}

// @DataContract(Name="BookingEventsSummary", Namespace="schemas.agentivity.com/types")
public class BookingEventsSummary : Codable
{
    // @DataMember(Order=10)
    public var dateStart:Date?

    // @DataMember(Order=20)
    public var dateEnd:Date?

    // @DataMember(Order=30)
    public var events:EventsSummary

    // @DataMember(Order=40)
    public var branches:[OwningAgencyLocationIdEventsSummary]

    required public init(){}
}

// @DataContract(Name="Events", Namespace="schemas.agentivity.com/types")
public class EventsSummary : Codable
{
    // @DataMember(Order=10)
    public var create:String

    // @DataMember(Order=20)
    public var cancel:String

    // @DataMember(Order=30)
    public var change:String

    // @DataMember(Order=50)
    public var ticketing:String

    // @DataMember(Order=60)
    public var service:String

    // @DataMember(Order=70)
    public var ticketsIssued:Int

    required public init(){}
}

// @DataContract(Name="Branch", Namespace="schemas.agentivity.com/types")
public class OwningAgencyLocationIdEventsSummary : Codable
{
    // @DataMember(Order=10)
    public var branchId:String

    // @DataMember(Order=20)
    public var events:EventsSummary

    // @DataMember(Order=30)
    public var accounts:[AccountEventsSummary]

    required public init(){}
}

// @DataContract(Name="Account", Namespace="schemas.agentivity.com/types")
public class AccountEventsSummary : Codable
{
    // @DataMember(Order=10)
    public var accountId:String

    // @DataMember(Order=20)
    public var events:EventsSummary

    // @DataMember(Order=30)
    public var consultants:[ConsultantEventsSummary]

    required public init(){}
}

// @DataContract(Name="Consultant", Namespace="schemas.agentivity.com/types")
public class ConsultantEventsSummary : Codable
{
    // @DataMember(Order=10)
    public var consultantId:String

    // @DataMember(Order=20)
    public var events:EventsSummary

    required public init(){}
}

// @DataContract(Name="BookingEventsSummary", Namespace="schemas.agentivity.com/types")
public class BookingEventsSummaryRequestResponseReport : Report<BookingEventsSummaryRequestItemResponse, BookingEventsSummary>
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

// @DataContract(Namespace="schemas.agentivity.com/types")
public class Report<TItemResponse : Codable, TItem : Codable> : Codable
{
    // @DataMember(Order=1, EmitDefaultValue=false)
    public var item:TItem

    required public init(){}
}

Swift BookingEventsSummaryRequest DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /BookingEventsSummary HTTP/1.1 
Host: api.agentivity.com 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<BookingEventsSummaryRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="schemas.agentivity.com/types">
  <Limit>String</Limit>
  <Offset>String</Offset>
  <ResponseRecords>0</ResponseRecords>
  <TotalRecords>0</TotalRecords>
  <OwningCompanyCode xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>String</d2p1:string>
  </OwningCompanyCode>
  <UserName>String</UserName>
  <EventDateEnd>String</EventDateEnd>
  <EventDateStart>String</EventDateStart>
  <OwningAgencyLocationID xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>String</d2p1:string>
  </OwningAgencyLocationID>
</BookingEventsSummaryRequest>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<AgentivityResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="schemas.agentivity.com/types">
  <ResponseMetadata>
    <Success>false</Success>
    <HasCache>false</HasCache>
    <HasPaging>false</HasPaging>
    <CacheMetadata>
      <IsFromCache>false</IsFromCache>
      <CachedAt>0001-01-01T00:00:00</CachedAt>
      <CacheExpiresAt>0001-01-01T00:00:00</CacheExpiresAt>
    </CacheMetadata>
    <PagingMetadata>
      <Limit>String</Limit>
      <Offset>String</Offset>
      <ResponseRecords>0</ResponseRecords>
      <TotalRecords>0</TotalRecords>
    </PagingMetadata>
  </ResponseMetadata>
  <ResponseReport>
    <Item>
      <DateStart>0001-01-01T00:00:00</DateStart>
      <DateEnd>0001-01-01T00:00:00</DateEnd>
      <Events>
        <Create>String</Create>
        <Cancel>String</Cancel>
        <Change>String</Change>
        <Ticketing>String</Ticketing>
        <Service>String</Service>
        <TicketsIssued>0</TicketsIssued>
      </Events>
      <Branches>
        <Branch>
          <BranchId>String</BranchId>
          <Events>
            <Create>String</Create>
            <Cancel>String</Cancel>
            <Change>String</Change>
            <Ticketing>String</Ticketing>
            <Service>String</Service>
            <TicketsIssued>0</TicketsIssued>
          </Events>
          <Accounts>
            <Account>
              <AccountId>String</AccountId>
              <Events>
                <Create>String</Create>
                <Cancel>String</Cancel>
                <Change>String</Change>
                <Ticketing>String</Ticketing>
                <Service>String</Service>
                <TicketsIssued>0</TicketsIssued>
              </Events>
              <Consultants>
                <Consultant>
                  <ConsultantId>String</ConsultantId>
                  <Events>
                    <Create>String</Create>
                    <Cancel>String</Cancel>
                    <Change>String</Change>
                    <Ticketing>String</Ticketing>
                    <Service>String</Service>
                    <TicketsIssued>0</TicketsIssued>
                  </Events>
                </Consultant>
              </Consultants>
            </Account>
          </Accounts>
        </Branch>
      </Branches>
    </Item>
  </ResponseReport>
  <ResponseError>
    <ErrorCode>String</ErrorCode>
    <Message>String</Message>
    <StatusCode>String</StatusCode>
    <VerboseMessage>String</VerboseMessage>
  </ResponseError>
</AgentivityResponse>