Кіру немесе Тіркелу
Жаңалықтар мен оқиғалар

Жобалар мен жоспарлар үшін XML арнасы

1. Feed мақсаты

XML feed жылжымайтын мүлік жобалары мен типтік жоспарланымдар туралы құрылымдалған деректерді тасымалдайды. Оның мақсаты — қабылдаушы жүйеге жоба карточкаларын автоматты түрде құруға және жаңартуға, бағаларды, мәртебелерді, галереяларды, ыңғайлылықтарды, төлем шарттарын, EOI және девелоперлердің маркетингтік промоматериалдарын көрсетуге мүмкіндік беру.

Feed жоспарланымдарды жинақталған түрде береді: бір жоспарланым жазбасы типтік жоспарланымды және сол түрдегі қолжетімді бірліктер санын сипаттайды. Бұл нақты пәтерлердің, кеңселердің немесе учаскелердің тізімі емес.

  • realty-feed: бүкіл XML feed-тің түбірлік контейнері. Негізгі ID: —
  • offers: бір жоба немесе кешен. Негізгі ID: complex-id
  • layouts: жоба ішіндегі типтік жоспарланым. Негізгі ID: id
  • payment_plans: жобаның бір төлем нұсқасы. Негізгі ID: id
  • eoi_item: EOI-дің бір шарты. Негізгі ID: —
  • stock: девелопердің маркетингтік науқаны, жаңалығы немесе промохабары. Негізгі ID: —

1.1 XML Feed деген не

XML feed — жылжымайтын мүлік жобалары мен типтік жоспарланымдар туралы деректері бар құрылымдалған файл. Оның құрамына агенттік сайтында немесе каталогта нысандарды көрсету үшін қажет сипаттамалар, фотосуреттер, бағалар, мекенжайлар, мәртебелер, техникалық сипаттамалар, ыңғайлылықтар және өзге де деректер кіреді.

Қарапайым тілмен айтқанда, XML feed — бұл қабылдаушы жүйе тұрақты түрде жүктеп алып, оқып, нысан карточкаларын автоматты түрде жаңарту үшін пайдаланатын жылжымайтын мүлік деректер ағыны.

Деректерді Alnair ұсынады. Сайт әзірлеу, каталог әзірлеу, CRM интеграциясы және import логикасы клиенттің немесе клиенттің техникалық командасының жауапкершілігінде.

1.2 Агенттікке не қажет

XML feed пайдалану үшін агенттікте XML-ді тұрақты түрде жүктеп алуға, құрылымын талдауға және өз жүйесіндегі деректерді жаңартуға қабілетті жеке техникалық инфрақұрылым болуы қажет.

  • Website немесе нысандар каталогы: feed-тен алынған жобалар мен жоспарланымдар көрсетілетін орын.
  • Техникалық команда немесе developer: XML жүктеу, талдау және import орнату.
  • XML parser: XML құрылымын оқу және оны ішкі деректер моделіне түрлендіру.
  • Import module: жобалар мен жоспарланымдарды құру, жаңарту және өшіру.
  • Task scheduler: мысалы, cron немесе scheduler арқылы import-ты кесте бойынша тұрақты орындау.
  • Error logging: белгісіз enum мәндерін, бос өрістерді және жүктеу қателерін бақылау.

1.3 Агенттік XML Feed-ті қалай пайдаланады

Әдеттегі жұмыс үдерісі төмендегідей:

  1. Агенттік жүйе XML-ді жеке web-сілтемеден жүктеп алады.
  2. XML диагностика және қайта өңдеу үшін raw snapshot ретінде сақталады.
  3. Parser realty-feed, offers, layouts құрылымын және кірістірілген блоктарды оқиды.
  4. Import module жаңа жобалар мен жоспарланымдарды құрады немесе бұрынғыларын жаңартады.
  5. Жаңа feed-тен жоғалып кеткен нысандар inactive деп белгіленеді.
  6. Агенттік сайтында ең өзекті жоба карточкалары, бағалар, галереялар және мәртебелер көрсетіледі.

Негізгі интеграциялық мүмкіндіктер:

  • Автоматты жаңарту: жобалар мен жоспарланымдар қолмен араласусыз жаңартылады.
  • Нысан беттерін құру: feed деректері жоба және жоспарланым карточкалары үшін пайдаланылады.
  • Өзекті бағалар мен мәртебелер: сайт XML жаңартуларын кесте бойынша алады.
  • Сүзгілер мен іздеу: аудан, баға, нысан түрі, бөлме саны және алаң өрістері бойынша сүзуге болады.
  • Медиа галереялар: жоба фотолары, тақырыптық галереялар және жоспарланым суреттері интерфейсте көрсетіледі.

2. XML-дің жалпы құрылымы

<realty-feed>
  <generation-date>2026-06-17T12:06:39+04:00</generation-date>
  <offers>...</offers>
  <offers>...</offers>
</realty-feed>

  • realty-feed: объект. Feed-тің түбірлік блогы.
  • generation-date: datetime. XML жасалған күн мен уақыт. Деректің өзектілігін тексеру үшін қолданылады.
  • offers: object[]. Жобалар немесе кешендер тізімі. Әр offers блогында жоба деректері және оның жоспарланымдары болады.

2.1 Feed-ке қолжеткізу және жүктеу шектеулері

Feed клиентке жеке web-сілтеме арқылы беріледі. Сілтеме клиентке бірегей және қабылдаушы жүйе XML-ді автоматты жүктеп алу үшін пайдаланады.

Жеке сілтеме Alnair аккаунтындағы әкімшіге қолжетімді. Әкімші бұл сілтемені import орнату үшін клиенттің техникалық командасына бере алады.

  • Қолжеткізу түрі: жеке web-сілтеме. Клиентке арналған XML feed-тің жеке URL-і.
  • Сілтемені қайдан алуға болады: Alnair аккаунты. Сілтеме клиент әкімшісіне қолжетімді.
  • Feed жаңарту жиілігі: әр 4 сағат сайын. XML деректері Alnair жағында әр 4 сағат сайын жаңартылады.
  • Ең аз жүктеу аралығы: сағатына бір реттен жиі емес. Қабылдаушы жүйе feed-ке сағатына бір реттен артық жүгінбеуі тиіс.
  • Шектен асу: қолжеткізуді бұғаттау. Сұраулар тым жиілесе, feed-ке қолжеткізу уақытша бұғатталуы мүмкін.

Ұсынылатын интеграция логикасы: cron немесе scheduler арқылы жоспарлы жүктеуді баптау, соңғы алынған XML-ді сақтау және feed-ке сайттың әр бет жүктелген сайын сұрау жібермеу. Оңтайлы режим — жаңа деректер шамамен әр 4 сағат сайын пайда болатынын ескере отырып, feed-ті сағатына бір реттен жиі жүктемеу.

3. Жоба: <offers>

offers — feed-тің негізгі мәні. Ол жоба сипаттамасын, девелоперді, орналасқан жерін, құрылыс және сату мәртебесін, бағаларды, медианы, ыңғайлылықтарды, төлем жоспарларын, EOI, маркетингтік акцияларды және типтік жоспарланымдарды қамтиды.

<offers>
  <complex-id>5646</complex-id>
  <type>project</type>
  <logo>https://...</logo>
  <photo>https://...</photo>
  <title>...</title>
  <description>...</description>
  <price_on_request>1</price_on_request>
  <status>...</status>
  <construction_start_at>2025-01-01T00:00:00+04:00</construction_start_at>
  <construction_progress>15</construction_progress>
  <planned_completion_at>2027-12-31T00:00:00+04:00</planned_completion_at>
  <predicted_completion_at>2027-12-31T00:00:00+04:00</predicted_completion_at>
  <amenities>...</amenities>
  <developer>...</developer>
  <city>Dubai</city>
  <address>...</address>
  <latitude>25.000000</latitude>
  <longitude>55.000000</longitude>
  <districts>...</districts>
  <album>...</album>
  <albums>...</albums>
  <constructions_count>1</constructions_count>
  <for_sale_count>10</for_sale_count>
  <price>...</price>
  <br_prices>...</br_prices>
  <updated_at>2026-06-17T10:53:20+04:00</updated_at>
  <is_sold_out>0</is_sold_out>
  <payment_plans>...</payment_plans>
  <sales_status>...</sales_status>
  <stocks>...</stocks>
  <eoi>...</eoi>
  <service_charge>...</service_charge>
  <assignment>...</assignment>
  <is_limited_publication>0</is_limited_publication>
  <layouts>...</layouts>
</offers>

  • complex-id: integer. Alnair-дегі бірегей жоба ID. Upsert үшін сыртқы жоба ID ретінде пайдаланыңыз.
  • type: enum. Жоғарғы деңгейдегі мән түрі: project немесе compound. Шикі мәнді сақтап, жоғарғы деңгейлі жоба ретінде импорттаңыз.
  • logo: url. Жоба логотипі. Брендингте көрсетіңіз, cover ретінде пайдаланбаңыз.
  • photo: url. Жобаның негізгі суреті / cover. Card-та cover және жоба бетінде hero суреті ретінде пайдаланыңыз.
  • title: localized object. en/ru/ar тілдеріндегі жоба атауы. Интерфейс тіліне қарай көрсетіңіз.
  • description: localized HTML. en/ru/ar тілдеріндегі жоба сипаттамасы. Қауіпсіз түрде рендерлеңіз; HTML CDATA ішінде орналасқан.
  • price_on_request: 0/1. Бағаны жасыру жалауы. Егер 1 болса, “Баға сұрау бойынша” деп көрсетіңіз.
  • status: object. Құрылыс мәртебесі. sales_status-пен шатастырмаңыз.
  • construction_start_at: datetime. Құрылыстың басталу күні. Толтырылған болса, көрсетіңіз.
  • construction_progress: decimal. Құрылыстың аяқталу пайызы. Пайыз ретінде көрсетіңіз.
  • planned_completion_at: datetime. Жобаның жоспарланған аяқталу күні. Тапсыру күні ретінде қолданыңыз.
  • predicted_completion_at: datetime. Болжамды аяқталу күні. Жаңартылған аяқталу күні ретінде қолдануға болады.
  • amenities: object. Жобаның ыңғайлылықтары мен ерекшеліктері. key бойынша сәйкестендіріңіз.
  • developer: object. Жоба девелопері. Атауы мен логотипін сақтаңыз.
  • city / address: string. Жобаның қаласы мен мекенжайы. Орналасу деректерінде пайдаланыңыз.
  • latitude / longitude: decimal. Координаттар. Карта үшін пайдаланыңыз.
  • districts: object. Жоба аудандары. Сүзгілер мен жоба карточкасы үшін пайдаланыңыз.
  • album: object. Жобаның негізгі санатталмаған галереясы. Жалпы галерея ретінде көрсетіңіз.
  • albums: object. Тақырыптық жоба галереялары. Атауы бойынша топтаңыз.
  • for_sale_count: integer. Жобадағы қолжетімді бірліктер саны. Қолжетімділік ретінде көрсетуге болады.
  • price: object. Жобаның жалпы баға диапазоны. price_on_request=1 болса, жасырыңыз.
  • br_prices: object[]. Бөлме саны немесе санат бойынша бағалар. Сүзгілер мен тізімдер үшін пайдаланыңыз.
  • updated_at: datetime. Жобаның жаңарту күні. Синхрондау үшін қолданыңыз.
  • is_sold_out: 0/1. Сатылып біткенін білдіретін жалау. sales_status-пен бірге пайдаланыңыз.
  • payment_plans: object[]. Девелопер ұсынған төлем нұсқалары. Төлем нұсқалары ретінде көрсетіңіз.
  • sales_status: localized object. Жобаның сату мәртебесі. Сату кезеңін анықтайды.
  • stocks: object. Девелопердің маркетингтік науқандары мен промохабарлары. Промо-блоктар ретінде көрсетіңіз.
  • eoi: object. Interest білдіру. Тек Presale (EOI) үшін көрсетіңіз.
  • service_charge: object. Қызмет ақысы. Мән толтырылған болса, көрсетіңіз.
  • assignment: decimal. Cession шарты. Бос болса, көрсетілмеген дегенді білдіреді.
  • is_limited_publication: 0/1. Жариялау шектеуі. Егер 1 болса, рұқсатсыз жарияламаңыз.
  • layouts: object[]. Жобаның типтік жоспарланымдары. Жобаның еншілес мәндері ретінде импорттаңыз.

4. Локализацияланған өрістер

Локализацияланған өрістердің құрылымы бірдей: тегтің ішінде ағылшын, орыс және араб тілдеріндегі мәндер беріледі.

<title>
  <en>Project Name</en>
  <ru>Название проекта</ru>
  <ar>اسم المشروع</ar>
</title>

  • en: ағылшын тіліндегі мән. Ұсынылатын резервтік нұсқа.
  • ru: орыс тіліндегі мән.
  • ar: араб тіліндегі мән.

Резервтік ереже:

  1. Егер қолжетімді болса, интерфейс тілін пайдаланыңыз.
  2. Қажетті тіл бос болса, en қолданыңыз.
  3. Егер en бос болса, ru қолданыңыз.
  4. Егер ru бос болса, ar қолданыңыз.
  5. Егер барлық мәндер бос болса, өрісті көрсетпеңіз.

5. Мәртебелер

5.1 Құрылыс мәртебесі: <status>

Құрылыс мәртебесі жобаның физикалық күйін көрсетеді. Ол сату қолжетімділігін білдірмейді.

<status>
  <key>development_stage_progress</key>
  <en>In Progress</en>
  <ru>Строится</ru>
  <ar>قيد الإنشاء</ar>
</status>

  • Scheduled: жоба жоспарланған.
  • In Progress: құрылыс жүріп жатыр.
  • Ready: жоба аяқталған.
  • Stopped: құрылыс тоқтатылған.

5.2 Сату мәртебесі: <sales_status>

Сату мәртебесі жобаның коммерциялық кезеңін көрсетеді: хабарландыру, presale, launch, белсенді сатылым немесе sold out.

  • Preliminary Info: жобаның бастапқы ақпараты.
  • Announcement: жоба жарияланды.
  • Presale (EOI): EOI жинау жүріп жатыр.
  • Launch: сатылымның басталуы.
  • On Sale: жоба сатып алуға қолжетімді.
  • Sold Out: жоба түгел сатылған.
  • Pending: мәртебе жаңартуды күтуде.

6. Девелопер және орналасу

Бұл блоктар девелопер брендін және жобаның географиялық орналасуын көрсету үшін қажет.

<developer>
  <title>
    <en>Developer Name</en>
    <ru>Developer Name</ru>
    <ar>Developer Name</ar>
  </title>
  <logo>https://...</logo>
</developer>
<city>Dubai</city>
<address>Project Address, Dubai</address>
<latitude>25.01809076</latitude>
<longitude>55.13354525</longitude>
<districts>
  <district>Jumeirah Village Triangle (JVT)</district>
</districts>

  • developer.title: localized object. Девелопер атауы.
  • developer.logo: url. Девелопер логотипі.
  • city: string. Қала.
  • address: string. Мекенжай.
  • latitude / longitude: decimal. Картаға арналған координаттар.
  • districts.district: string[]. Жоба аудандары.

7. Бағалар

7.1 Жоба бағасы: <price>

Жоба деңгейіндегі баға жобадағы қолжетімді ұсыныстардың жалпы баға диапазонын көрсетеді.

<price>
  <min>815462</min>
  <max>2089780</max>
  <min_usd>222009</min_usd>
  <max_usd>568942</max_usd>
  <currency>AED</currency>
</price>

  • min: decimal. Ең төмен баға.
  • max: decimal. Ең жоғары баға.
  • min_usd: decimal. USD-дағы ең төмен баға.
  • max_usd: decimal. USD-дағы ең жоғары баға.
  • currency: enum. Негізгі валюта, әдетте AED.

Егер price_on_request = 1 болса, price толтырылғанына қарамастан нақты бағалар көпшілікке көрсетілмейді.

7.2 Санат бойынша бағалар: <br_prices>

br_prices бағалар мен алаңдарды бөлме саны немесе нысан түрі бойынша топтайды. Бұл сүзгілер мен қысқа жоба карточкалары үшін пайдалы.

<br_prices>
  <key>1</key>
  <count>7</count>
  <min_price>1070564</min_price>
  <max_price>1289674</max_price>
  <min_price_m2>17204</min_price_m2>
  <max_price_m2>18483</max_price_m2>
  <currency>AED</currency>
  <min_area><m2>57.92</m2><ft2>623.45</ft2></min_area>
  <max_area><m2>74.17</m2><ft2>798.36</ft2></max_area>
</br_prices>

  • studio: студиялар.
  • 1-6: жатын бөлмелер саны.
  • villa: виллалар.
  • townhouse: таунхаустар.
  • n: қолданылмайды / тұрғын емес санат / басқа.

8. Медиа

Feed-тегі медиа бірнеше түрге бөлінеді. Оларды мақсаттарын ескермей бір галереяға біріктіруге болмайды: бір сурет жоба cover-і, екіншісі логотип, үшіншісі промо-сурет, ал төртіншісі жоспар сызбасы болуы мүмкін.

  • logo: offers.logo. Жоба логотипі. Жоба брендингінде көрсетіңіз; cover ретінде пайдаланбаңыз.
  • photo: offers.photo. Жобаның негізгі суреті / cover. Карточкада cover және жоба бетінде hero суреті ретінде қолданыңыз.
  • album.image: offers.album.image. Жобаның негізгі санатталмаған галереясы. Жалпы жоба галереясында көрсетіңіз.
  • albums.album.images.image: offers.albums.album.images.image. Тақырыптық жоба галереясы. albums.album.title бойынша топтаңыз.
  • developer.logo: offers.developer.logo. Девелопер логотипі. Девелопер блогында көрсетіңіз.
  • stocks.stock.logo: offers.stocks.stock.logo. Маркетингтік науқан суреті. Промо-блок ішінде көрсетіңіз.
  • layouts.album.image: offers.layouts.album.image. Нақты типтік жоспарланым галереясы. Жоспарланым деңгейінде көрсетіңіз.
  • levels_photos.level_photo.image: offers.layouts.levels_photos.level_photo.image. Деңгей бойынша жоспар суреті. Қабат жоспары ретінде пайдаланыңыз.

<photo>https://...</photo>
<album>
  <image>https://...</image>
</album>
<albums>
  <album>
    <title><en>Infrastructure</en><ru>Инфраструктура</ru><ar>...</ar></title>
    <images>
      <image>https://...</image>
    </images>
  </album>
</albums>

  • Project presentation: жоба таныстырылымының суреттері.
  • Construction progress: құрылыс барысының фотолары.
  • Finishing examples: әрлеу үлгілері.
  • Infrastructure: жоба инфрақұрылымы.
  • View: көріністер мен айнала.

Әр жоба үшін әрбір санат міндетті түрде болмауы мүмкін. Егер санат атауы бос болса, суреттерді санатталмаған күйде импорттауға немесе жалпы галереяға орналастыруға болады.

Ағымдағы құрылымда story үшін бөлек XML тегі жоқ. Жаңалықтар, промохабарлар және жоба маркетингтік материалдары stocks арқылы беріледі. Құрылыс тарихы үшін, егер albums ішінде болса, Construction progress санатын қолдануға болады.

9. Ыңғайлылықтар

amenities жоба ыңғайлылықтары мен ерекшеліктерін сипаттайды. Интеграция үшін key қолданған дұрыс, ал көрсету үшін локализацияланған мәндер пайдаланылуы керек.

<amenities>
  <amenity>
    <key>project_facilities_gym</key>
    <en>Gym</en>
    <ru>Тренажёрный зал</ru>
    <ar>صالة رياضية</ar>
  </amenity>
</amenities>

  • amenities: object. Ыңғайлылықтар контейнері.
  • amenity: object. Бір ыңғайлылық.
  • key: enum. Техникалық кілт.
  • en / ru / ar: string. Ыңғайлылық атауы үш тілде.

projecet_hotel_license кілтінде қате бар, бірақ ол Hotel License ретінде сәйкестендірілуті тиіс. Alias-ты қолдап, import-ты бұзбау ұсынылады.

10. Маркетингтік промоакциялар: <stocks>

stocks — девелоперлердің маркетингтік науқандары, жаңалықтары және промохабарлары. Оларға арнайы бағалар, жеңілдіктер, launch шарттары, EOI хабарландырулары, уақытша төлем ұсыныстары және жарнамалық материалдар кіруі мүмкін. Бұл блок тауар қоры емес және бірліктердің қолжетімділігін анықтамайды.

<stocks>
  <stock>
    <title>...</title>
    <description>...</description>
    <start_at>2025-06-26T00:00:00+04:00</start_at>
    <end_at/>
    <logo>https://...</logo>
  </stock>
</stocks>

  • stocks: object. Маркетингтік хабарламалар контейнері.
  • stock: object. Бір науқан, жаңалық немесе промо-хабарландыру.
  • title: localized object. Промоның атауы.
  • description: localized HTML. Промо сипаттамасы.
  • start_at: datetime. Басталу күні.
  • end_at: datetime. Аяқталу күні; бос болуы мүмкін.
  • logo: url. Промо суреті.

Нысан қолжетімділігі үшін stocks емес, for_sale_count, layouts.sale_units_count және sales_status қолданыңыз.

11. EOI

EOI — Expression of Interest дегенді білдіреді. Бұл блок Presale (EOI) мәртебесіндегі жобалар үшін алдын ала қызығушылық немесе депозит шарттарын сипаттайды.

<eoi>
  <is_eoi_return>0</is_eoi_return>
  <eoi_items>
    <eoi_item>
      <price>100000</price>
      <percent/>
      <description>
        <en>EOI amount for 2 Bedrooms</en>
        <ru>Сумма EOI для 2-комнатных</ru>
        <ar>...</ar>
      </description>
    </eoi_item>
  </eoi_items>
</eoi>

  • is_eoi_return: 0/1/empty. 0 = қайтарылмайды, 1 = қайтарылады, empty = көрсетілмеген.
  • eoi_items: object. EOI шарттары контейнері.
  • eoi_item: object. Бір EOI шарты.
  • price: decimal. Белгіленген EOI сомасы.
  • percent: decimal. Қолданылса, EOI пайызы.
  • description: localized object. Шарт сипаттамасы.
  • sales_status.en = Presale (EOI) және eoi_items толтырылған: EOI көрсетіңіз.
  • Кез келген басқа sales_status: EOI жасырыңыз.

12. Қызмет ақысы және Assignment

<service_charge>
  <value>172.22</value>
  <unit>sq. m</unit>
  <currency>AED</currency>
</service_charge>
<assignment>40.00</assignment>

  • service_charge.value: қызмет ақысының мөлшері. Егер бос болса, блокты көрсетпеңіз.
  • service_charge.unit: есептеу бірлігі, әдетте sq. m. Бос болуы мүмкін.
  • service_charge.currency: валюта, әдетте AED. Бос болуы мүмкін.
  • assignment: assignment жасауға болатын пайыз. Empty = ақпарат көрсетілмеген, шектеу емес.

13. Төлем жоспарлары: <payment_plans>

payment_plans девелоперден алынған нысан бойынша төлем нұсқаларын сипаттайды. Бір жобада бірнеше төлем жоспары болуы мүмкін. Әр жоспар төлемді кезеңдерге бөледі: брондау, құрылыс, тапсыру және тапсырудан кейінгі кезең. Алымдар мен қосымша төлемдер бөлек беріледі, сондықтан жалпы пайыз 100%-дан асуы мүмкін. Мысалы, 104% дегеніміз нысан бағасының 100% + 4% DLD fee болуы мүмкін.

  • Basic: id, title, currency. Жоспар идентификаторы, атауы және валютасы. title — enum емес, еркін мәтін.
  • Booking: on_booking_percent, on_booking_fix, on_booking_payments_count, on_booking_fees. Брондау кезеңіндегі төлемдер мен алымдар.
  • Construction: on_construction_percent, on_construction_fix, on_construction_payments_count, on_construction_fees. Құрылыс кезіндегі төлемдер.
  • Handover: on_handover_percent, on_handover_fix, on_handover_payments_count, on_handover_fees. Нысанды тапсыру кезіндегі төлемдер.
  • Post-handover: post_handover_percent, post_handover_fix, on_post_handover_payments_count, on_post_handover_fees. Тапсырудан кейінгі төлемдер.
  • ROI: roi_percent, roi_fix, roi_payments_count, roi_fees. ROI немесе кепілдендірілген табыс схемаларына арналған өрістер.
  • Additional fees: additional, additional_percent, additional_fix, additional_fix_m2. Қосымша төлемдер, мысалы DLD Fee.
  • Periods: period_after_handover, period_after_roi. Қайталанатын төлемдердің жиілігі.
  • Totals: price_total, fees_included_total. Жоспардың жалпы сомалары және кіретін алымдар.

14. Жоспарланымдар: <layouts>

layouts жобаның ішіндегі типтік жоспарланымды сипаттайды. Бұл нақты пәтер немесе кеңсе емес, жинақталған бірлік түрі.

  • id: integer. Бірегей жоспарланым ID. Сыртқы жоспарланым ID ретінде пайдаланыңыз.
  • title: localized object. Жоспарланым атауы. Интерфейс тіліне қарай көрсетіңіз.
  • project_id: integer. Ата-аналық жоба ID. offers.complex-id-пен байланыстырыңыз.
  • building_name: localized object. Ғимарат атауы. Бос болса, көрсетпеңіз.
  • price_on_request: 0/1. Бағаны жасыру жалауы. Егер 1 болса, бағаны көрсетпеңіз.
  • area_min / area_max: object. Алаң диапазоны. m2 және ft2.
  • area_balcony_min / area_balcony_max: object. Балкон алаңының диапазоны. Бос болуы мүмкін.
  • type: localized object. Нысан түрі. Unit type сілтемесін қараңыз.
  • sale_units_count: integer. Осы түрдегі қолжетімді бірліктер саны. Бұл учаскелер тізімі емес.
  • album: object. Жоспарланым галереясы. Жоспарланым деңгейінде көрсетіңіз.
  • levels_photos: object. Деңгейлер бойынша суреттер. Қабат жоспары ретінде пайдаланыңыз.
  • floors_count: integer. Деңгейлер саны. 1, 2, 3, т.б.
  • rooms_count: localized object. Бөлме саны. Rooms count сілтемесін қараңыз.
  • price: object. Жоспарланым бағасының диапазоны. price_on_request=1 болса, жасырыңыз.
  • is_limited_publication: 0/1. Жариялау шектеуі. Егер 1 болса, көпшілікке жасырыңыз.

15. Enum мәндерінің сілтемесі

  • Project type: project, compound.
  • Sales status: Preliminary Info, Announcement, Presale (EOI), Launch, On Sale, Sold Out, Pending.
  • Construction status: Scheduled, Ready, Stopped, In Progress.
  • Unit type: Apartment, Villa, Townhouse, Duplex, Triplex, Penthouse, Retail, Office, Suite.
  • Rooms count: Studio, 1 BR, 2 BR, 3 BR, 4 BR, 5 BR, 6 BR, 7 BR, 8 BR, NA.
  • BR price key: studio, 1, 2, 3, 4, 5, 6, villa, townhouse, n.
  • Gallery category: Project presentation, Construction progress, Finishing examples, Infrastructure, View.
  • Currency: AED.
  • Service charge unit: sq. m.
  • Boolean flags: 0, 1; кейбір өрістер үшін empty рұқсат етіледі.

Егер feed-те сілтеме тізімінде жоқ мән кездессе, import сәтсіз аяқталмауы тиіс. Мән шикі түрде сақталуы, unknown ретінде сәйкестендірілуі және қарау үшін журналға жазылуы керек.

16. Бос мәндер

Бос мән “0” емес, “көрсетілмеген” дегенді білдіреді. Бос тегтер <field/> немесе <field></field> түрінде болуы мүмкін.

  • assignment: assignment шарты көрсетілмеген.
  • service_charge.value: қызмет ақысы көрсетілмеген.
  • eoi.is_eoi_return: EOI қайтарылымдылығы көрсетілмеген.
  • area_balcony_min.m2: балкон алаңы көрсетілмеген.
  • description.en: сипаттама жоқ.

17. Көрсету ережелері

  • Баға жасырылған: price_on_request = 1. “Баға сұрау бойынша” деп көрсетіңіз.
  • Баға көрінеді: price_on_request = 0. min/max бағаны көрсетіңіз.
  • EOI: sales_status.en = Presale (EOI) және EOI толтырылған. EOI көрсетіңіз.
  • EOI өзекті емес: sales_status.en != Presale (EOI). EOI жасырыңыз.
  • Sold out: is_sold_out = 1 немесе sales_status.en = Sold Out. “Sold out” деп көрсетіңіз немесе тізімнен жасырыңыз.
  • Limited publication: is_limited_publication = 1. Көпшілікке жарияламаңыз.
  • Assignment бос: assignment бос. Assignment блогын көрсетпеңіз.
  • Service charge бос: service_charge.value бос. Қызмет ақысын көрсетпеңіз.

18. Import ережелері

  • Жоба: complex-id бойынша іздеңіз; табылса, жаңартыңыз; табылмаса, құрыңыз.
  • Жоспарланым: layouts.id бойынша іздеңіз; project_id арқылы жобамен байланыстырыңыз.
  • Жою: егер нысан жаңа feed-тен жоғалса, оны бірден жоймай, inactive деп белгілеңіз.
  • Unknown enum: шикі мәнді сақтаңыз, unknown ретінде белгілеңіз және журналға жазыңыз.
  • Бос мәндер: нақты өріске тән ереже болмаса, оларды 0-ге түрлендірмеңіз.

Project field → Source

  • external_project_id: complex-id.
  • raw_offer_type: type.
  • title_*: title.
  • description_*: description.
  • developer_name: developer.title.
  • developer_logo_url: developer.logo.
  • city/address/coordinates: city, address, latitude, longitude.
  • districts: districts.district.
  • construction_status: status.en.
  • sales_status: sales_status.en.
  • price_min / price_max: price.
  • price_on_request: price_on_request.
  • galleries: photo, album, albums.
  • payment_plans: payment_plans.
  • eoi: eoi.
  • stocks: stocks.
  • source_updated_at: updated_at.

Layout field → Source

  • external_layout_id: layouts.id.
  • external_project_id: layouts.project_id.
  • title_*: layouts.title.
  • building_name_*: building_name.
  • unit_type: type.en.
  • rooms_count: rooms_count.en.
  • sale_units_count: sale_units_count.
  • area_min / area_max: area_min, area_max.
  • balcony_min / balcony_max: area_balcony_min, area_balcony_max.
  • floors_count: floors_count.
  • price_min / price_max: price.
  • layout_gallery: album.
  • levels_photos: levels_photos.
  • is_limited_publication: is_limited_publication.