Objekte

get
https://api.propstack.de
/v1/units?with_meta=1
Objekte lesen
Eine Excel-Datei mit allen relevanten Felder eines Objektes, gruppiert nach Objekttyp:
exposee-fields.xlsx
27KB
Binary
Objekt-Felder (für Exposés speziell)
Mehrsprachigkeit
In Propstack kann man bestimmte Texte eines Objektes in mehreren Sprachen einstellen. Folgende Felder können übersetzt werden:
1.Überschrift (title)
2.Objektbeschreibung (description_note)
3.Lagebeschreibung (location_note)
4.Ausstattung (furnishing_note)
5.Sonstiges (other_note)
6.Käuferprovision (courtage)
7.Provisionshinweis (courtage_note)
Um die Objekte in einer anderen Sprache zu erhalten gibt man einen weiteren Parameter locale mit. Standardmäßig erhält man die deutsche Sprache. Über locale=en würde man die englischen Texte erhalten.
Weitere Filtermöglichkeiten
Folgende Felder kann man zusätzlich über die API filtern anhand von "ab-bis" Angaben:
Kaufpreis: price
Kaltmiete: base_rent
Warmmiete: total_rent
Fläche: property_space_value
Wohnfläche: living_space
Grundstücksfläche: plot_area
Zimmer: number_of_rooms
Schlafzimmer: number_of_bed_rooms
Badezimmer: number_of_bath_rooms
Etage: floor
Baujahr: construction_year
Die Parameter dafür haben immer ein _from oder _to angehängt, um zu bestimmen ob es ab diesem Wert gilt oder bis zu diesem Wert. Beispiel:
?price_from=300000&price_to=350000 wirft alle Objekte aus, deren Preis zwischen 300.000 und 350.000 € liegen. ?plot_area=1500 wirft alle Objekte aus, deren Grundstücksfläche über 1.500qm beträgt.
Sortierungsmöglichkeiten
Auftragsnummer: exposee_id
Baujahr: construction_year
Einheitenummer: unit_id.raw
Etage: floor
Erstellungsdatum: created_at
Fläche: property_space_value
Grundstücksfläche: plot_area
Kaltmiete: base_rent
Kaufpreis: price
Preis: object_price
Fläche/qm: price_per_sqm
Status: property_status_position
Straße: street_number.raw
Verkaufsdatum: sold_date
Warmmiete: total_rent
Zimmer: number_of_rooms
Zuletzt bearbeitet: updated_at
Mögliche Vermarktungsart (marketing_type): 
1.BUY 
2.RENT
Mögliche Oberkategorie für Objekttypen object_type:
1.LIVING
2.COMMERCIAL
3.INVESTMENT
Mögliche Objekttypen (rs_type):
1.APARTMENT
2.HOUSE
3.TRADE_SITE
4.GARAGE
5.SHORT_TERM_ACCOMODATION
6.OFFICE
7.GASTRONOMY
8.INDUSTRY
9.STORE
10.SPECIAL_PURPOSE
11.INVESTMENT
(Text-)Felder, die in verschiedenen Sprachen hinterlegt werden können:
title
description_note
location_note
furnishing_note
other_note
long_description_note
long_location_note
long_furnishing_note
long_other_note
courtage
courtage_note
Mögliche Objektarten (rs_category):
ROOF_STOREY - Dachgeschoss
LOFT - Loft
MAISONETTE - Maisonette
PENTHOUSE - Penthouse
TERRACED_FLAT - Terrassenwohnung
GROUND_FLOOR - Erdgeschosswohnung
APARTMENT - Etagenwohnung
RAISED_GROUND_FLOOR - Hochparterre
HALF_BASEMENT - Souterrain
OTHER - Sonstige
SINGLE_FAMILY_HOUSE - Einfamilienhaus
TWO_FAMILY_HOUSE - Zweifamilienhaus
TERRACE_HOUSE - Reihenhaus
MID_TERRACE_HOUSE - Reihenmittelhaus
TERRACE_END_HOUSE - Reihenendhaus
END_TERRACE_HOUSE - Reiheneckhaus
MULTI_FAMILY_HOUSE - Mehrfamilienhaus
TOWNHOUSE - Stadthaus
FINCA - Finca
FREEHOLD_FLAT - Eigentumswohnung
BUNGALOW - Bungalow
FARMHOUSE - Bauernhaus
SEMIDETACHED_HOUSE - Doppelhaushälfte
VILLA - Villa
CASTLE_MANOR_HOUSE - Burg/Schloss
SPECIAL_REAL_ESTATE - Besondere Immobilie
TWIN_SINGLE_FAMILY_HOUSE - Doppeleinfamilienhaus
GARAGE - Garage
STREET_PARKING - Außenstellplatz
CARPORT - Carport
DUPLEX - Duplex
CAR_PARK - Parkhaus
UNDERGROUND_GARAGE - Tiefgarage
DOUBLE_GARAGE - Doppelgarage
NO_INFORMATION - Keine Angabe
STUDIO - Atelier
OFFICE - Büro
OFFICE_FLOOR - Büroetage
OFFICE_BUILDING - Bürohaus
OFFICE_CENTRE - Bürozentrum
OFFICE_STORAGE_BUILDING - Büro-/ Lagergebäude
SURGERY - Praxis
SURGERY_FLOOR - Praxisetage
SURGERY_BUILDING - Praxishaus
COMMERCIAL_CENTRE - Gewerbezentrum
LIVING_AND_COMMERCIAL_BUILDING - Wohn- und Geschäftsgebäude
OFFICE_AND_COMMERCIAL_BUILDING - Büro- und Geschäftsgebäude
BAR_LOUNGE - Barbetrieb/Lounge
CAFE - Café
CLUB_DISCO - Club/Diskothek
GUESTS_HOUSE - Gästehaus
TAVERN - Gaststätte
HOTEL - Hotel
HOTEL_RESIDENCE - Hotelanwesen
HOTEL_GARNI - Hotel garni
PENSION - Pension
RESTAURANT - Restaurant
SHOWROOM_SPACE - Ausstellungsfläche
SHOPPING_CENTRE - Einkaufszentrum
FACTORY_OUTLET - Factory Outlet
DEPARTMENT_STORE - Kaufhaus
KIOSK - Kiosk
STORE - Laden
SELF_SERVICE_MARKET - SB-Markt
SALES_AREA - Verkaufsfläche
SALES_HALL - Verkaufshalle
RESIDENCE - Anwesen
FARM - Bauernhof
HORSE_FARM - Reiterhof
VINEYARD - Weingut
REPAIR_SHOP - Werkstatt
LEISURE_FACILITY - Freizeitanlage
INDUSTRIAL_AREA - Gewerbefläche
SPECIAL_ESTATE - Spezialobjekt
LIVING_BUSINESS_HOUSE - Wohn- und Geschäftshaus
HOUSING_ESTATE - Wohnanlage
MICRO_APARTMENTS - Micro-Apartments
COMMERCIAL_BUILDING - Geschäftshaus
SHOP_SALES_FLOOR - Laden/Verkaufsfläche
SUPERMARKET - Supermarkt
RETAIL_PARK - Fachmarktzentrum
BOARDING_HOUSE - Boarding House
CLINIC - Klinik
ASSISTED_LIVING - Betreutes Wohnen
HALL_STORAGE - Halle/Logistik
INDUSTRIAL_PROPERTY - Produktion/Fertigung
post
https://api.propstack.de/v1
/units
Objekt anlegen
Objekt anlegen mit Eigentümer
Beim Anlegen eines Objektes kann auch gleichzeitig ein Eigentümer mitverknüpft werden. Der Payload dafür sieht wie folgt aus:
{
  "property": {
    "title": "Nice apartment",
    // ...
    "relationships_attributes": [{
        "internal_name": "owner",
        "related_client_id": 123
    }]
  }
}
Der Eigentümer muss vorher in Propstack existieren. Die ID des Kontaktes wird dann unter related_client_id mitgegeben.
Objekt anlegen mit einem verknüpften Kontakt
Beim Anlegen eines Objektes kann auch gleichzeitig ein Kontakt (Partner) mitverknüpft werden. Der Payload dafür sieht wie folgt aus:
{
  "property": {
    "title": "Nice apartment",
    // ...
    "relationships_attributes": [{
        "internal_name": "partner",
        "name": "Käufer",
        "related_client_id": 123
    }]
  }
}
Der Kontakt muss vorher in Propstack existieren. Die ID des Kontaktes wird dann unter related_client_id mitgegeben.
put
https://api.propstack.de/v1
/units/:id
Objekt bearbeiten
delete
https://api.propstack.de/v1
/units/:id
Objekt löschen
get
https://api.propstack.de/v1
/units/:id?new=1
Objekt lesen
get
https://api.propstack.de
/v1/property_statuses
Objekt-Stati lesen
Last modified 2yr ago