Parcel · Integracje

API i integracje

Dane Parcel – działka, granice, MPZP, parametry i mapa – prosto do Twoich narzędzi: pliki, CRM, API i webhooki. Bez przepisywania.

★ Integracje w planach płatnych: Pakiet 5 (69 zł) lub Abonament agenta (99 zł / mies.) →

Dla kogo

Agenci nieruchomościEksport oferty do Excela lub CRM jednym kliknięciem, widok dla kupującego.
Biura nieruchomościOferty trafiają do CRM biura i dalej na portale – bez przepisywania.
DeweloperzyAnaliza banku ziemi: działki, MPZP i parametry przez API.
Sieci agentów i portaleSynchronizacja ofert między oddziałami i ogłoszeniami przez API + webhooki.
BankiAnaliza zabezpieczeń: parametry działki i MPZP, bez danych właściciela.
Geodeci i rzeczoznawcyGranice (WGS84 / PL-1992), powierzchnia i MPZP w CSV/JSON do własnych narzędzi.

Po co integrować

  • Jedno źródło danych – oficjalne i otwarte (GUGiK, Geoportal)
  • Koniec z ręcznym przepisywaniem i błędami
  • Zmiany trafiają do Twojego systemu automatycznie (webhooki)
  • Prywatność w standardzie – właściciel zawsze ***, bez hipotek i obciążeń

Co możesz zrobić

  • Pobierać oferty i działki jako CSV / XML / JSON
  • Wysyłać oferty do EstiCRM, ASARI, enova365, Symfonia, Galactica Virgo
  • Czytać i aktualizować oferty przez REST API
  • Dostawać powiadomienia, gdy oferta się zmieni

Metody integracji

📄 Eksport plikowy🔗 Konektory CRM⚙️ REST API🔔 Webhooki
📄
Poziom 1

Eksport plikowy

CSV · XML · JSON

Najprostsza integracja – bez programistów. Pełny zestaw danych z raportu lub listy ofert otwierasz w Excelu, Google Sheets, LibreOffice albo importujesz do bazy pośrednika.

Zastosowania

  • Małe biuro: cotygodniowa lista ofert w Excelu
  • Rzeczoznawca: parametry i granice działki do arkusza
  • Import XML do bazy pośrednika
Demo raportuZapytaj

Przykład

offer_id;offer_status;offer_title;offer_asking_price;parcel_id;commune;area_m2;mpzp_covered;mpzp_symbols;owner_name;kw_number;kw_persons
SBX-1;active;"Działka budowlana 1800 m² (PRZYKŁAD)";450000;SBX_141804_0.0001.1;"Gmina Przykładowa";1800;TAK/YES;MN;***;XX1X/********/*;***

# JSON / XML: ?fmt=json | ?fmt=xml
curl -H "X-API-Key: pk_sandbox_demo_parcel" \
  "https://parcel-staging.imetroll.com/sandbox/v1/offers?id=all&fmt=csv" -o offers.csv
🔗
Poziom 2

Konektory CRM

EstiCRM · ASARI · enova365 · Symfonia · Galactica Virgo

Gotowe konektory wysyłają ofertę do pipeline’u CRM z mapowaniem pól pod firmę; z CRM oferta trafia dalej na portale (Otodom, OLX i inne).

Zastosowania

  • Biuro: nowa oferta sama pojawia się w CRM
  • Zmiana statusu w Parcel aktualizuje rekord w CRM
  • Mapowanie pól do szablonów Twojego CRM
Zapytaj

Przykład

{ "connector": "esticrm",
  "mapping": {
    "offer_ref.title":        "title",
    "offer_ref.asking_price": "price",
    "parameters.area_m2":     "area",
    "mpzp.zones[0].symbol":   "custom.mpzp",
    "map.parcel_map_url":     "custom.map_link"
  },
  "trigger": "offer.created | offer.status_changed",
  "owner": "***" }
⚙️
Poziom 3

REST API

X-API-Key · JSON · pk_test_ / pk_live_

Oferty i działki przez REST: odczyt, filtrowanie, zmiana statusu. Klucz testowy wydasz sam w minutę, a otwartą piaskownicę wypróbujesz bez konta.

Zastosowania

  • Deweloper: dashboard banku ziemi
  • Portal: synchronizacja ofert
  • Bank: parametry zabezpieczenia w procesie kredytowym
Uzyskaj klucz API (samoobsługa) →Dokumentacja API

Przykład

curl -H "X-API-Key: pk_test_XXXXXXXX…" \
  "https://parcel-staging.imetroll.com/api/v1/offers?id=10&view=buyer"

curl -X PATCH -H "X-API-Key: pk_test_XXXXXXXX…" \
  -H "Content-Type: application/json" -d '{"status":"reserved"}' \
  "https://parcel-staging.imetroll.com/api/v1/offers?id=10"

# otwarta piaskownica, bez konta:
curl -H "X-API-Key: pk_sandbox_demo_parcel" \
  "https://parcel-staging.imetroll.com/sandbox/v1/offers?id=SBX-1"

Wypróbuj – piaskownica API

Bez konta. Publiczny klucz piaskownicy, fikcyjne dane, 30 zapytań/min na IP, reset co noc. Key: pk_sandbox_demo_parcel · Base: /sandbox/v1

curl -H "X-API-Key: pk_sandbox_demo_parcel" "https://parcel-staging.imetroll.com/sandbox/v1/offers"
🔔
Poziom 3

Webhooki

HMAC-SHA256 · ponowienia · log dostaw

Parcel wywołuje Twój endpoint HTTPS, gdy oferta się zmieni. Każde żądanie jest podpisane (HMAC-SHA256), ponawiane przy błędzie i widoczne w logu dostaw.

Zastosowania

  • Odświeżenie CRM po offer.status_changed
  • Powiadomienie zespołu na Slack/Teams
  • Ponowne zaindeksowanie ogłoszenia na portalu
Dokumentacja webhookówWyślij testowy webhook ↓

Przykład

POST https://crm.example.com/parcel-webhook
X-Parcel-Event: offer.status_changed
X-Parcel-Signature: t=1793554496,v1=<hex HMAC-SHA256(secret, t + "." + body)>

{ "id": "evt_…", "type": "offer.status_changed", "api_version": "v1",
  "data": { "offer": { "offer_ref": { "id": 10, "status": "reserved" },
            "previous_status": "active", "owner": { "name": "***" } } } }

// weryfikacja (PHP):
$ok = hash_equals(hash_hmac('sha256', $t.'.'.$body, $secret), $v1);

Prywatność: właściciel zawsze ***, osoby z KW zakryte, brak danych z działów III/IV KW (hipoteki, obciążenia). KW pobierana wyłącznie z numeru podanego przez użytkownika. Cennik tylko do prezentacji; płatność online za pakiety integracji w przygotowaniu. Zobacz cennik →

Narzędzia plikowe – zobacz na prawdziwym raporcie

Wszystkie pliki poniżej to prawdziwe eksporty z raportu demo (Piaseczno, działka 9/5). Sandbox API jest bezpłatny dla wszystkich. Pełne integracje i narzędzia plikowe są w cenie abonamentu od 69 zł, a dla agentów Agency – w planach Studio i Agencja.

DXF – plan działki do CAD

DXF – plan działki do CAD

Granica, numery, wierzchołki, działki sąsiednie, tabela współrzędnych i opis (warstwy). Otwiera się w AutoCAD, ArchiCAD, BricsCAD i QGIS. Układy PL-1992 lub PL-2000. Dla architektów, geodetów, projektantów.

  1. Otwórz raport działki → „Eksport”.
  2. Wybierz DXF i układ (PL-1992 albo PL-2000).
  3. Otwórz plik w CAD – warstwy GRANICA, NUMER, WIERZCHOLKI, SASIEDZI, TABELA, OPIS.
  4. Agent: dołącz DXF do oferty lub wyślij architektowi klienta.
⬇ Przykładowy plik · DXF
GeoJSON – działka w GIS i na mapach www

GeoJSON – działka w GIS i na mapach www

Geometria działki z danymi (TERYT, gmina, powierzchnia, MPZP) w WGS84 albo PL-1992. Do QGIS, ArcGIS, mapy na stronie biura lub portalu.

  1. Raport → „Eksport” → GeoJSON (WGS84 lub 2180).
  2. Przeciągnij plik do QGIS albo wczytaj do mapy (Leaflet/MapLibre/Google My Maps).
  3. Agent: pokaż granicę działki na mapie w ofercie online.
⬇ Przykładowy plik · GEOJSON
SHP – shapefile dla GIS

SHP – shapefile dla GIS

Spakowany shapefile (.shp, .dbf, .shx, .prj) z atrybutami działki i MPZP, PL-1992 lub PL-2000. Dla urzędów, geodetów i analityków GIS.

  1. Raport → „Eksport” → SHP.
  2. Rozpakuj ZIP i dodaj warstwę w QGIS/ArcGIS – układ wczyta się z .prj.
⬇ Przykładowy plik · ZIP
PDF – mapa A4 w skali

PDF – mapa A4 w skali

Arkusz A4 z granicą na ortofotomapie lub mapie, skala dobierana 1:500–1:2000, PL/EN. Do druku, dla klienta, banku, rzeczoznawcy.

  1. Raport → „Eksport” → Mapa PDF A4.
  2. Wydrukuj albo dołącz do oferty i maila.
  3. Agent: mapa PDF jako pierwszy załącznik oferty.
⬇ Przykładowy plik · PDF
PNG – mapa A4 jako obraz

PNG – mapa A4 jako obraz

Ta sama mapa A4 jako obraz – do galerii zdjęć oferty, social media, prezentacji.

  1. Raport → „Eksport” → PNG A4.
  2. Dodaj obraz jako zdjęcie w ofercie lub prezentacji.
⬇ Przykładowy plik · PNG
CSV / XML / JSON – dane oferty

CSV / XML / JSON – dane oferty

Pełny zestaw danych oferty i działki (bez danych osobowych). CSV do Excela, Google Sheets, LibreOffice; XML/JSON do CRM i portali.

  1. Lista ofert lub raport → CSV / XML / JSON.
  2. Excel: Dane → Z pliku tekstowego/CSV, UTF-8, separator „;”.
  3. Agent: import do CRM biura (EstiCRM, ASARI – beta).
⬇ Przykładowy plik · CSV

Dla kogo

GeodetaGeoJSON, SHP lub DXF w PL-2000/PL-1992 prosto do programu geodezyjnego – szybszy start mapy do celów projektowych.
ArchitektDXF jako podkład w ArchiCAD/AutoCAD + informacja o planie miejscowym (uchwała, rysunek) z raportu.
Inżynier budowy / drógDojazd i otoczenie, sieci uzbrojenia w okolicy (GESUT, informacyjnie), mapy PDF/PNG do prezentacji dla inwestora.
Inwestor / deweloperJednolite raporty i dane CSV/JSON kilku działek – łatwe porównanie powierzchni, MPZP i odległości.
Bank / rzeczoznawcaRaport PDF i mapa A4 w skali jako załącznik do analizy – bez danych o hipotekach i obciążeniach.
Kupujący prywatnySzukasz działki sam? Raport PDF i mapa pokażą granice, plan miejscowy i odległości, zanim pojedziesz na oględziny.
Gmina / urządSHP i GeoJSON do systemu GIS – warstwy działek z atrybutami.

Co zmieści się w opisie oferty agenta

Działka nr 9/5, gm. Piaseczno (powiat piaseczyński, woj. mazowieckie). Powierzchnia ok. 2215,6 m² (z geometrii ewidencyjnej, orientacyjnie), granica o 12 punktach załamania – mapa granic i ortofotomapa w załączniku.

Plan miejscowy: działka w obszarze obowiązującego MPZP (uchwała 1312/XLIII/2014 z 2014-02-12). Przeznaczenie i parametry zabudowy – w rysunku i treści planu (link w raporcie).

Okolica (w linii prostej): przystanek Lamina 04 – 201 m, sklep Netto – 505 m, przychodnia – 167 m, szkoła – 693 m, apteka – 706 m, przedszkole – 883 m.

Sieci uzbrojenia w okolicy (GESUT, informacyjnie): wodociąg, kanalizacja, gaz, energetyka, telekomunikacja, ciepłownictwo.

Do pobrania: plan działki DXF (AutoCAD, ArchiCAD) oraz pełny raport PDF: https://parcel-staging.imetroll.com/demo/

Tekst z prawdziwych danych raportu demo. Brak w raporcie danych o nasłonecznieniu i spadkach terenu – nie wpisujemy ich.

Używamy wyłącznie niezbędnych plików cookies (sesja logowania, zapis Twojego wyboru). Nie używamy cookies analitycznych ani reklamowych. Polityka cookies