Matching statuses (activity) between applications

[Filip5991]

We were asked by mutual clients to try and match the statuses (activity) between our application (Acaboom) and the app we have built in the Foundations system. As we weren't exactly sure what belongs under statuses in Reapit, a client suggested opening a ticket may help identify those (and if the API caters for marrying these). Exploring the API docs, I saw that each property has a "status" field (one example value for this is 'underOffer'). In the RPS - Developer app, I also saw a few properties called statuses: Are those statuses 'standard' and if so what are the possible options, or can they be amended by the client?

One client asking for this seems to be focused on an offer (i.e. an amount to buy or rent the property) being made rather than pre-marketing.

Can you please shed some light on what we are after, or maybe something we can ask the client to help clarify this?

[AshDeeming]

Hi @Filip5991 The statues referred to above i.e. under offer, are against the property however the screen shot is from the offers information & can be found under the offers endpoint;

Does that help clarify?

[Filip5991]

Hi @AshDeeming , It was mentioned to us that Foundations has a completely different range of status names and most seem to be relating to whether a property is available or under-offer etc. rather than pre-marketing.

So I think the question is what status names does Foundations have relating to an appointment booked, pending, lost, won, etc. and where can these be found?

[AshDeeming]

Hi @Filip5991 Property statues do have two differing options wtihin the CRM, which mean the same thing within the Industry - Under Offer aka SSTC

All other statues should be universal & can be found via the swagger model under each relevant endpoint

Properties: (Lettings) (sales)

Offers:

Appointments can relate to a multitude of reasons, if you wish to segment these based on their type, please note that the configuration endpoint to call the below will be required re appointment typeID

[Filip5991]

Hi Ash, I don't think appointment types, nor offers statuses are what we are after. The 'offers' values don't sound right, as by that time the property has been marketed and thus 'won' in our world. Are there any other statuses that relate to a market appraisal point in time only - e.g. won, lost, pending, withdrawn etc.? We are really after the property status i.e... are there any statuses that relate to the property for a market appraisal?

[AshDeeming]

Hi @Filip5991 For property statues, the below can be used to segment - the highlighted are values would represent a property is that is yet to be marketed.

[Filip5991]

Hi @AshDeeming Apologies for the delayed response, it's been a crazy period :-)

If the selling/lettingStatus is what we need, what would be the best way to track all status updates of a property? I can see there are multiple webhooks available, like 'properties.selling.withdrawn' or 'properties.selling.instructed', but I don't think these fully match the statuses from your image? Plus I don't see any 'properties.lettings' webhooks? We are interested to capture every status change and pass it to our system, but I'm not sure if the status changes can be tracked with a webhook at all. Maybe the 'properties.modified' webhook also includes selling/letting status updates?

[AshDeeming]

Hi @Filip5991 No problem, hope things calm asap for you

The webhooks mentioned above relate to the standard subject available - it may be useful to build event filters, which allow you to filter which elements of the payload you're interested in; https://foundations-documentation.reapit.cloud/api/webhooks#building-event-filters

[Filip5991]

Hi @AshDeeming , I was planning to include an event filter anyway, but I wasn't sure with which webhook to start. Do we need to use the 'properties.modified' webhook, and then somehow build JSON schemas and filter the hook to only retrieve selling/letting status updates? Also, are there any instructions out there on how to build the event filter outside of https://json-schema.org/?

Thank you in advance :)

[AshDeeming]

Hi @Filip5991 Apologies for the delay - the modified webhook could be used The previously provided docs link is the relevant section - please let us know if more assistance required?

[HollyJoyPhillips]

Closing due to inactivity. Please comment or reopen if more assistance is needed. Thanks.

[github-actions[bot]]

It looks like you have commented on a closed issue. If your comment relates to a bug or feature request, please open a new issue, and include this issue number/url for reference. For more information on our processes, please click here