CiirusXMLAdditionalFunctions15025


Click here for a complete list of operations.

PropertyChangeLog

Returns the last Property Change for the specified Property.

Use this function to check when the Property Static Content (Property features, Description, Terms, Rates) last changed for each PropertyID passed in the Array of ID class Objects held in the PropertyIDs Class Object.
Note: This function caches responses for 30 seconds.
Note: This function returns dates in Calibrated to the EST (-5:00) Timezone



Pass the following parameters:

  • APIUsername (String)
  • APIPassword (String)
  • MCUserID (Integer)
  • PropertyIDs (Class Object)
    Note: Pass any number of PropertyIDs of the same MC user in a single call or pass one at a time.
    • Property (Array of ID Class Objects)
      • ID (Class Object)
        Note: Contains "<PropertyID>" Node as Integer
        • PropertyID (Integer)



Error Responses:

  • PropertyChangeLog: Validation Error 1
  • PropertyChangeLog: The request must contain at least 1 PropertyID
  • PropertyChangeLog: You do not have access rights to this MC.
  • PropertyChangeLog: MCUserID must be greater than 0.
  • PropertyChangeLog: Error - CS Relation could not be resolved.
  • PropertyChangeLog: You do not have access rights to this MC (2724368).
  • PropertyChangeLog: You do not have access rights to this MC.
  • PropertyChangeLog: MCUserID must be greater than 0.
  • PropertyChangeLog: You do not have access rights to this Property.
  • PropertyChangeLog: The Property Change Log Request could not be processed.
  • PropertyChangeLog: No Date Could be determined.
  • PropertyChangeLog: Unknown Error.
  • PropertyChangeLog: The Property Change Log Request must contain one or more PropertyIDs for which your user has access.

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /XMLadditionalfunctions15.025.asmx HTTP/1.1
Host: api.ciirus.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://xml.ciirus.com/PropertyChangeLog"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PropertyChangeLog xmlns="http://xml.ciirus.com/">
      <APIUserName>string</APIUserName>
      <APIPassword>string</APIPassword>
      <MCUserID>int</MCUserID>
      <PropertyIDs>
        <Property>
          <ID>
            <PropertyID>int</PropertyID>
          </ID>
          <ID>
            <PropertyID>int</PropertyID>
          </ID>
        </Property>
      </PropertyIDs>
    </PropertyChangeLog>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <PropertyChangeLogResponse xmlns="http://xml.ciirus.com/">
      <PropertyChangeLogResult>
        <PropertyUpdated>
          <MCUserID>int</MCUserID>
          <PropertyID>int</PropertyID>
          <LastChange>dateTime</LastChange>
          <ErrorMsg>string</ErrorMsg>
        </PropertyUpdated>
        <PropertyUpdated>
          <MCUserID>int</MCUserID>
          <PropertyID>int</PropertyID>
          <LastChange>dateTime</LastChange>
          <ErrorMsg>string</ErrorMsg>
        </PropertyUpdated>
      </PropertyChangeLogResult>
    </PropertyChangeLogResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /XMLadditionalfunctions15.025.asmx HTTP/1.1
Host: api.ciirus.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <PropertyChangeLog xmlns="http://xml.ciirus.com/">
      <APIUserName>string</APIUserName>
      <APIPassword>string</APIPassword>
      <MCUserID>int</MCUserID>
      <PropertyIDs>
        <Property>
          <ID>
            <PropertyID>int</PropertyID>
          </ID>
          <ID>
            <PropertyID>int</PropertyID>
          </ID>
        </Property>
      </PropertyIDs>
    </PropertyChangeLog>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <PropertyChangeLogResponse xmlns="http://xml.ciirus.com/">
      <PropertyChangeLogResult>
        <PropertyUpdated>
          <MCUserID>int</MCUserID>
          <PropertyID>int</PropertyID>
          <LastChange>dateTime</LastChange>
          <ErrorMsg>string</ErrorMsg>
        </PropertyUpdated>
        <PropertyUpdated>
          <MCUserID>int</MCUserID>
          <PropertyID>int</PropertyID>
          <LastChange>dateTime</LastChange>
          <ErrorMsg>string</ErrorMsg>
        </PropertyUpdated>
      </PropertyChangeLogResult>
    </PropertyChangeLogResponse>
  </soap12:Body>
</soap12:Envelope>