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.

Pentru conținutul public din TITLU și OBSERVATII, respectă și Regulile de publicare.

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, IMOPEDIA	ID_LOCAL trebuie să fie numeric și stabil la retrimiteri. Dacă CRM-ul nu are ID numeric stabil, salvează ID_LOCAL numeric returnat de API după prima publicare. AGENT_ID trebuie să existe pentru agenția indicată, de obicei după saveAgent sau după citirea listei prin getAgents. IMOPEDIA = 1 indică afișarea ofertei în listingul Imopedia.ro.
Date ofertă	DATA_APARITIE, DATA_MODIFICARE, TITLU, OBSERVATII	TITLU și OBSERVATII ajută la afișarea completă a anunțului.
Localizare	JUDET_ID, JUDET, ORAS, ZONA, ZONA_ID, REPER, GEO_LAT, GEO_LONG, GEO_ACCURACY	Pentru integrări noi, JUDET_ID este câmpul recomandat pentru județ. JUDET poate fi trimis ca text descriptiv. ZONA apare frecvent în erorile de validare când lipsește. 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_H_PRET, T_V_MONEDA, T_I_MONEDA, T_H_MONEDA, COMISION, COMISION_I, PLATA_TVA	Activează tranzacția relevantă cu valoarea 1; păstrează celelalte tranzacții inactive sau necompletate. Precizează comisionul aplicabil în câmpul dedicat tranzacției.
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:

• JUDET_ID completat pentru maparea județului; poți trimite și JUDET ca text descriptiv.
• ZONA completat sau mapat corect prin ZONA_ID.
• ID_LOCAL numeric, dacă este transmis. Nu trimite ID-uri CRM alfanumerice direct în câmpurile care cer identificator numeric; salvează identificatorul numeric returnat de API.
• AGENT_ID existent pentru agenția transmisă în AGENTIA; dacă getAgents nu returnează agentul dorit, creează-l sau actualizează-l prin saveAgent înainte de saveProperty.
• Cel puțin o tranzacție activă, de exemplu T_V_TRANZ = 1, T_I_TRANZ = 1 sau T_H_TRANZ = 1.
• Preț și monedă pentru tranzacția activă, de exemplu T_V_PRET și T_V_MONEDA.
• GEO_LAT și GEO_LONG în format numeric, fără text suplimentar.

Unele erori de validare pot fi returnate generic, de exemplu Internal server error pe câmpul server. Tratează acest răspuns ca eșec al operației: nu continua cu fișierele media, verifică mai întâi agentul, identificatorii, tranzacția activă, prețul, localizarea și tipurile numerice din payload.