Validare și câmpuri recomandate

Acest capitol documentează câmpurile recomandate pentru publicarea unei oferte complete, separat de payload-ul minim acceptat tehnic. Lista de mai jos este orientativă și a fost rafinată din fluxuri reale de integrare, fără date personale sau identificatori reali.

Set minim recomandat pentru publicare

Pentru majoritatea ofertelor, trimite cel puțin aceste câmpuri:

Categorie Câmpuri recomandate Observații
Identificare AGENTIA, ID_LOCAL, TIP_IMOBIL_REAL, AGENT_ID ID_LOCAL trebuie păstrat stabil la retrimiteri. AGENT_ID trebuie să existe pentru agenția indicată.
Date ofertă DATA_APARITIE, DATA_MODIFICARE, TITLU, OBSERVATII TITLU și OBSERVATII ajută la afișarea completă a anunțului.
Localizare JUDET, ORAS, ZONA, ZONA_ID, REPER, GEO_LAT, GEO_LONG, GEO_ACCURACY JUDET și ZONA apar frecvent în erorile de validare când lipsesc. Coordonatele ajută afișarea pe hartă.
Tranzacție și preț T_V_TRANZ, T_I_TRANZ, T_H_TRANZ, T_V_PRET, T_I_PRET, T_V_MONEDA, T_I_MONEDA, COMISION, PLATA_TVA Activează tranzacția relevantă cu valoarea 1; păstrează celelalte tranzacții inactive sau necompletate.
Suprafață și compartimentare SUPR_UTILA, SUPR_CONSTR, SUPR_TEREN, NRCAM, NRDORMITOARE, NR_BAI, ETAJ, NRETAJE, NR_BALCOANE Alege câmpurile potrivite pentru tipul imobilului. Pentru terenuri sunt importante SUPR_TEREN, DESCHIDERE, T_INTRAVILAN și T_EXTRAVILAN.
Caracteristici DOTARI, DETALII, FINISAJE, VECINATATI, DESTINATII_TEXT, STARE_IMOBIL, MOBILAT, AN_CONSTRUCTIE Folosește valorile din nomenclatoare când câmpul are valori controlate.
Contact CONTACT_PERS, CONTACT_TEL, CONTACT_EMAIL sau AGENT_ID Dacă nu folosești un agent salvat, trimite date de contact valide în payload.
Media VIDEO_INFO, imagini prin addFile, lista finală prin syncFiles Media se sincronizează după saveProperty; vezi Fișiere media.

Pentru detalii despre tipuri, descrieri și valori controlate, folosește Structura ofertelor împreună cu Nomenclatoare și exemplele din Exemple.

Minim tehnic vs minim recomandat

API-ul poate accepta payload-uri minime în unele scenarii de test sau sincronizare parțială. Pentru afișarea corectă a unei oferte publice, payload-ul trebuie să conțină și câmpurile recomandate pentru descriere, localizare, preț, tranzacție și contact.

Erori frecvente observate

Înainte de trimitere, validează explicit: