Connect :BRREG // Dokumentasjon

Dette er en samleside for teknisk dokumentasjon knyttet til Connect :BRREG.

Ta kontakt om noe er uklart.

Connect :BRREG

Krav

En HubSpot-konto
- Du trenger en Starter-lisens eller høyere hvis du ønsker å synkronisere egenskaper, siden den grunnleggende HubSpot-lisensen kun tillater 10 tilpassede felter og grunnversjonen av installasjonen synkroniserer 10 felter.
Installasjonsrettigheter i HubSpot-kontoen din (eller snakk med din administrator).
Et eksisterende felt på bedriftsobjektet ditt som lagrer det norske organisasjonsnummeret
- Feltet må ha ett av følgende underliggende systemnavn*:
  - organisasjonsnummer (Hvis du er basert i Norge er dette sannsynligvis den mest sannsynlige)
  - orgnummer (den late varianten)
  - vat (hvis du jobber internasjonalt)
  - organization_number (amerikanisert oversettelse)
- Hvis det ikke har noen av disse feltene vil det ikke være noe unikt for oss å matche i Brønnøysund.
- Vi returnerer noen nyttige opplysninger til kortinformasjonen hvis du ikke har et av de standard systemnavnene.
Hvordan finner jeg egenskaps-systemnavnet? Se: denne guiden
Hva gjør jeg hvis systemnavnet ikke er på listen? Gi oss beskjed, så kan vi hjelpe deg.

Installasjonsprosess

Klikk på "Installer nå"-lenken på denne siden på Frei-nettsiden https://frei.as/connect-install
Alternativt naviger direkte hit https://connect.frei.as/publicapi/install
Velg kontoen du vil installere i (du trenger installasjonsrettigheter i kontoen)
Aksepter vilkårene (se under for hvorfor vi trenger de respektive tillatelsene)
Du bør nå se "Suksess-siden". Herfra kan du enten lese dokumentasjonen (dvs. denne siden) eller returnere til portalen din hvor CRM-kortet nå skal være installert.
Åpne et selskapskort i HubSPot, og du skal finne Connect :BRREG-kortet nederst på siden i høyre kolonne.

Hvorfor vi trenger alle disse tillatelsene

Grunnleggende informasjon om HubSpot-kontoen - Dette er et krav for alle apper og gjør det mulig for oss å koble til deg.
Lesetilgang til Bedrift-objektet - Påkrevd for alle app-nivåer for å lese organisasjonsnummeret før vi henter data fra Brønnøysund. Uten dette har appen ingenting å gjøre.
Lese- og skrivetilgang til Bedrift-skjemaet - Påkrevd for at vi skal kunne opprette feltene å skrive til når vi synkroniserer data fra Brønnøysund.
Importere og eksportere Bedrift-data - For pro-nivået og oppover. Når vi utfører en første synkronisering med Brønnøysund, eksporterer vi en fil som kun inneholder organisasjonsnummeret og HubSpot-ID-en for hver bedrift i HubSpot-kontoen. Disse bedriftene matches mot Brønnøysund-data og re-importeres med de nylig beriket feltene. Vi gjør dette av flere grunner, men hovedsakelig fordi det er (mye) raskere og det betyr at vi har mindre sannsynlighet for å tømme API-rategrensene dine på HubSpot.

Hva gjør den?

CRM-kortet på Bedrifter henter data fra BRREG og viser det til deg. Du kan til og med "skriv til selskap", hvis du ønsker å kopiere den informasjonen til proprietære felter.

Premium-versjonen av appen synkroniserer data på tvers av alle bedriftene dine.

Actions

"Skriv til selskap" - I Basic versjon, kopierer data fra CRM kortet over til det nåværende selskapet som vises. Første gang denne handlingen skjer, opprettes appen nye egenskaper på selskapsobjektet under gruppen “Frei Connect BRREG”. Deretter skrives følgende informasjon:

HubSpot Basic CRM card	HubSpot saved property label	HubSpot property name
Navn	BRREG Navn	`fc_brreg_navn`
Organisasjonsform	BRREG Organisasjonsform	`fc_brreg_organisasjonsform_beskrivelse`
Næringskode	BRREG Næringskode	`fc_brreg_naeringskode`
Antall ansatte	BRREG Antall ansatte	`fc_brreg_antallansatte`
Stiftelsesdato	BRREG Stiftelsesdato	`fc_brreg_stiftelsesdato`
Poststed	BRREG Forretningsadresse poststed	`fc_brreg_forretningsadresse_poststed`
Kommunenummer	BRREG Forretningsadresse kommunenummer	`fc_brreg_forretningsadresse_kommunenummer`
Styreleder	BRREG Roller styreleder	`fc_brreg_roller_styre_leder`
(vises ikke)	BRREG Roller daglig leder	`fc_brreg_roller_daglig_leder`
(vises ikke)	BRREG Organisasjonsnummer	`fc_brreg_organisasjonsnummer`