Översikt
Integrationen mellan Pigello och HomeQ gör det möjligt att publicera lägenheter direkt från Pigello till HomeQ:s marknadsplats.
Pigello fungerar som källsystem för objekt-, annons- och kravprofilsdata. När en annons publiceras skickas relevant information automatiskt till HomeQ där bostaden blir tillgänglig för sökande.
I Pigello 2.0 är Pigello även källsystem för kravprofiler. Det innebär att ändringar som görs på kravprofiler i Pigello kan synkroniseras till redan publicerade annonser i HomeQ.
Kom igång med integrationen
Innan annonser kan publiceras behöver integrationen aktiveras. Hör av er till Pigello för hjälp med aktiveringen och matchningen av fastigheter och lägenheter/bostäder mellan Pigello och HomeQ.
Aktiveringen omfattar normalt följande steg:
HomeQ-integrationen aktiveras i er miljö.
Ett segment i Pigello kopplas mot motsvarande organisation i HomeQ.
Webhook URL kopieras från Pigello till HomeQ, se aktiveringsflödet i Pigello för mer information.
Fastigheter i Pigello matchas mot fastigheter i HomeQ.
Lägenheter i Pigello matchas mot bostäder i HomeQ.
Publiceringsinställningar verifieras.
Testpublicering genomförs.
När aktiveringen är slutförd kan annonser skapas och publiceras direkt från Pigello.
Förutsättningar för publicering
För att en lägenhet ska kunna publiceras till HomeQ måste vissa uppgifter vara korrekt konfigurerade. Här kommer en genomgång av uppgifter som bör kontrolleras i Pigello.
Obligatoriska lägenhetsuppgifter
Fält i Pigello | Beskrivning |
Uthyrningsbar yta | Måste vara större än 0 m². |
Lägenhetsnummer | Måste bestå av exakt 4 siffror. |
Lägenhetskategori | Måste anges. Översätts till antal rum i HomeQ. |
Våningar | Måste vara ifylld. |
Yta | Måste vara minst 1 m². |
Månadshyra | Måste vara större än 0 kr. |
Krav på adressuppgifter
HomeQ validerar adressinformation innan publicering som avser adressuppgifter för både fastigheter och lägenheter.
Fält | Krav |
Gatuadress | Endast tillåtna tecken. |
Gatunummer | Endast siffror med eventuellt efterföljande bokstav. |
Postnummer | Exakt 5 siffror. |
Ort | Endast bokstäver, mellanslag och bindestreck. |
Adressens latitud och longitud | Används för kartpositionering. Integrationen gör att försök att slå upp latitud och longitud via överföringen till HomeQ. |
Exempel:
Fält | Godkänt | Ej godkänt |
Gatuadress | Storgatan | Storgatan/Östra |
Gatunummer | 12A | 12-14 |
Postnummer | 12345 | 1234 |
Ort | Malmö | Malmö! |
Krav på områdesinformation
Fält | Krav |
Områdesbenämning | Minst 2 tecken |
Områdesbeskrivning | Minst 200 tecken |
Om områdesbeskrivningen (marknadsbeskrivning) är för kort kommer publiceringen nekas av HomeQ.
Kravprofiler i Pigello 2.0
I Pigello 2.0 är Pigello huvudsystem för kravprofiler.
Det innebär att:
Kravprofiler huvudsakligen skapas och underhålls i Pigello, se undantag nedan.
Kravprofiler skickas till HomeQ vid publicering.
Ändringar i kravprofilen kan påverka redan publicerade annonser.
Nedan beskrivs de olika delarna av en kravprofil som påverkar integrationen med HomeQ.
Målgrupp
Varje kravprofil måste ha en målgrupp som kan översättas till HomeQ.
Följande målgrupper stöds:
Alla
Senior
Student
Ungdom
Följande målgrupper saknar motsvarighet i HomeQ men kan fortfarande väljas i Pigello:
Coliving
Försörjningsstöd
Kollektivboende
Ålderskrav
HomeQ kräver att både lägsta och högsta tillåtna ålder anges.
Följande fält behöver därför vara ifyllda:
Minsta tillåtna ålder
Högsta tillåtna ålder
Om något av fälten saknas kan kravprofilen inte synkroniseras.
Husdjur och rökning
Följande inställningar kan överföras till HomeQ:
Pigello | HomeQ |
Tillåt husdjur | Tillåt husdjur i bostaden |
Tillåt rökning | Tillåt rökning i bostaden |
Inkomstkrav
Pigello stöder två olika typer av inkomstkrav.
Typ i Pigello | Motsvarighet i HomeQ | Beräkning |
Lön innan betald hyra | Inkomst relativt hyra | Månadshyra × Inkomstfaktor |
Lön efter betald hyra | Inkomst efter hyra baserat på normalbelopp | Normalbelopp × Inkomstfaktor |
Inkomstfaktor
Inkomstfaktorn är obligatorisk för kravprofiler som ska synkroniseras till HomeQ.
Beroende på valt inkomstkrav används faktorn för att beräkna motsvarande krav i HomeQ.
Tillåtna inkomstkällor
Tillåtna inkomstkällor kan skickas till HomeQ för följande målgrupper:
Alla
Senior
Student
Ungdom
Pigello (tillåtna inkomstkällor) | HomeQ |
<Blankt> | Tillåt tillsvidareanställning (sätts alltid) |
Studielån | Tillåt studentinkomst |
Visstidsanställning | Tillåt tidsbegränsad anställning |
Arbetslöshetsersättning (A-kassa) | A-kassa |
Aktivitetsersättning | Aktivitetsersättning |
Aktivitetsstöd | Aktivitetsstöd |
Barnbidrag | Barnbidrag |
Barnpension/efterlevandestöd | Barnpension |
Bostadsbidrag | Bostadsbidrag |
Bostadstillägg | Bostadstillägg |
Etableringstillägg | Etableringsersättning och Etableringstillägg |
Försörjningsstöd | Försörjningsstöd |
Föräldrapenning (Försäkringskassan) | Föräldrapenning |
Merkostnadsersättning | Merkostnadsersättning |
Sjukpenning (Försäkringskassan) | Sjukpenning |
Underhållsbidrag | Underhållsbidrag |
Underhållsstöd | Underhållsstöd |
Utvecklingsersättning | Utvecklingsersättning |
Omvårdnadsbidrag | Vårdbidrag |
Pension | <Påverkar inte HomeQ> |
Studiebidrag | <Påverkar inte HomeQ> |
Tillsvidareanställning | <Påverkar inte HomeQ> |
Obs: Inkomstkällorna Pension, Studiebidrag och Tillsvidareanställning kan väljas i Pigello men påverkar inte kravprofilen i HomeQ.
HomeQ-specifika kravprofilsinställningar
Följande inställningar går inte att konfigurera på kravprofiler i Pigello och kan redigeras på integrerade kravprofilerna i HomeQ. Notera att dessa inställningar inte påverkas av eventuella uppdateringen av kravprofiler som sker i Pigello.
Tillåt sökande med en borgensman
Inkomstkrav för borgensman relativt till hyran
Investeringsstödsbostad
Antal tillåtna betalningsanmärkningar
Sökande kan ha skuldsaldo
Sökande kan få skuldsanering
Tillåt sökande med personlig konkurs
Extra hyresgäster utöver antal rum
Publicera en annons
När objektet uppfyller samtliga krav kan annonsen publiceras.
Öppna annonsen i Pigello och klicka på Skapa publicering.
Välj Skapa publicering till HomeQ.
Ange publiceringsdatum och klockslag för publiceringen.
Vid publicering skickar Pigello bland annat:
Områdesinformation
Fastighetsinformation
Lägenhetsinformation
Bilder inklusive planritning(ar)
Annonsdetaljer
Hyresuppgifter
Tillträdesdatum
Kravprofil
Kontaktuppgifter
Publiceringsdatum
Efter lyckad publicering blir annonsen tillgänglig på HomeQ.
Uppdatering av publicerade annonser
När en annons redan är publicerad kan vissa ändringar synkroniseras till HomeQ.
Exempel:
Publicering – Publiceringsdatum fr.o.m.
Annons – Kravprofil
Annons – Inflyttningsdatum
Annons – Utflyttningsdatum
Annons – Annonserad hyra
Annons – Tidig inflytt möjlig
Annonsdetaljer – Lägenhetsbeskrivning
Annonsdetaljer – Attribut (Hiss, Balkong, Kökstyp m.m.)
Annonsdetaljer – Uthyrningsvillkor
Område – Områdesbeskrivning
Lägenhet – Kategori
Lägenhet – Area
Lägenhet – Våningar
Ändringar som görs i Pigello uppdaterar motsvarande annons i HomeQ vid nästa synkronisering.
Publicering av nyproduktion
Det går att skapa nyproduktionsprojekt i HomeQ och integrera publicerade annonser från Pigello till dessa projekt. Så gör du för att komma igång:
Skapa fastigheter och eventuella byggnader samt lägenheter, som ska ingå i HomeQ nyproduktionsprojekt, i Pigello.
Lägg till de nya fastigheterna i segmentet för HomeQ och synkronisera dessa till HomeQ. Synkroniseringen sker via aktiveringsflödet för HomeQ i integrationsinställningar.
Skapa nyproduktionsprojekt i HomeQ och lägg till fastigheterna till projektet, via dialogen Hantera fastigheter i HomeQ.
Skapa annonsdetaljer och annonser för lägenheterna i Pigello. Notera att lägenheterna inte får ha tidigare annonser i HomeQ, annars kommer de nya annonserna inte att räknas som nyproduktion i HomeQ.
Publicera annonserna i Pigello och notera att bostäderna och annonserna skapas i HomeQ samt visas inom nyproduktionsprojektet i HomeQ.
Hämtning av kandidater till Pigello
När en sökande i HomeQ blir reserverad för en annons blir kandidaten integrerad till annonsen i Pigello. Integrationen sker via Webhook, som blev konfigurerad vid aktiveringen av HomeQ-integrationen.
Kandidaten visas på annonsen i Pigello och användare kan välja att skapa ett avtalsutkast med kandidaten eller neka den. Integrationen skickar över information till HomeQ när avtalsdokumentet för klarmarkerade avtalet har skrivits under av alla parter, vilket innebär att annonsen avslutas både i Pigello och HomeQ.
Vid nekande måste en nekandeorsak anges, som kommer att integreras tillbaka till HomeQ tillsammans med nekad kandidat. Därefter måste en ny sökande reserveras i HomeQ för att en ny kandidat ska integreras till annonsen i Pigello.
Vanliga orsaker till att publicering misslyckas
Kontrollera följande om en annons inte kan publiceras:
Lägenhetsnummer består inte av exakt fyra siffror.
Områdesbeskrivningen är för kort.
Månadshyran saknas på objektet eller har värdet 0 kr.
Postnummer har fel format.
Gatunummer innehåller otillåtna tecken.
Ålderskrav saknas på kravprofilen.
Inkomstfaktor saknas.
Målgruppen saknar motsvarighet i HomeQ.
Fastighet eller bostad är inte matchad mot HomeQ.
Sammanfattning
Integrationen mellan Pigello och HomeQ gör det möjligt att hantera hela publiceringsprocessen från Pigello. För att publiceringen ska lyckas måste både objektdata och kravprofiler uppfylla HomeQ:s valideringskrav.
Pigello ansvarar för objektdata, annonser och kravprofiler medan HomeQ fungerar som marknadsplats för sökande. Genom automatisk synkronisering av annonser, kravprofiler och kandidater minskar administrationen samtidigt som uthyrningsprocessen blir snabbare, säkrare och mer effektiv.