Transactions

Create a Transaction

A new Transaction must have one Tier associated to it and that Tier must have at least one AgentCommission associated to it; you will receive a validation error if you send a Transaction object without that data.

Transaction.Number should be set to NULL unless the primary office for the transaction allows manual entry of a transaction number.

The response will contain the newly created transaction object populated with all of the data to which you have read access. You can use the OData $expand parameter to limit the data that is returned.

Please see the Creating and Updating Data section of the introduction for more information on how to set property values.

OData Support: $expand

$expandstring

Instructs the API to include a child object or collection in the response. If omitted, ALL child objects and collections are returned. Pass $expand= (empty) to return only the root object. See the OData Support section of the introduction.

Request body

Idstring

The Lone Wolf Id of the transaction. Required for updates only. It will be ignored when creating a new transaction.

Numberstring

The transaction number. In most cases, the transaction number will be automatically generated. This is only required if the primary office for the trade allows manual transaction number entry and it has not setup a sequence for transaction numbers.

MLSNumberstring

The MLS number for the listing associated to the transaction.

PropertyTypeIdstring required

The Lone Wolf Id of the property type. This is an Id that is retrieved from the property types resource.

ClassificationIdstring required

The Lone Wolf Id of the classification. This is an Id that is retrieved from the classifications resource.

StatusCodestring

The code for the status. N: Open, A: Closed, P: Partially closed (not all but at least one tier has been finalized), B: Fallen through because of a condition, C: Fallen through

Statusstring

The name of the status. This field is read only.

EntryDatestring date

The date the transaction was entered. This is not the date that the transaction record was created (though in most cases, it will be the same value). This is a client specified date. If not specified, then the current date is used.

CloseDatestring date required

The date the transaction closed.

OfferDatestring date required

The date an offer was made on the transaction.

SellPricenumber required

The final sale price.

LegalDescriptionstring

Any legal notices for the transaction.

CreatedTimestampstring date-time

The date and time the transaction was created.

ModifiedTimestampstring date-time

The date and time the transaction was last modified.

TransactionChangedTimestampstring date-time

The date and time the transaction or any of its associated objects were last changed. For instance, if a commission was added to a tier, the TransactionChangedTimestamp would hold the time that the commission was added. Any change to any object associated to the transaction will update this field. It is very useful when querying for transactions that have been modified since a particular date and time.

RowVersioninteger

The version of the record in the database.

Response

The newly created Transaction object.