- Kunnskapsdatabase
- Inntekt
- Kontrakter
- Overføre kontrakter til HubSpot
I betaOverføre kontrakter til HubSpot
Sist oppdatert: 23 juli 2026
Tilgjengelig med et av følgende abonnementer, unntatt der det er angitt:
-
Revenue Hub Professional, Enterprise
-
Seter påkrevd
Abonnement påkrevd A Revenue Hub -abonnement er påkrevd for å migrere kontrakter.
Seter påkrevd Et Revenue Hub -lisens er nødvendig for å migrere kontrakter.
Tillatelser påkrevd Superadministratorrettigheter er påkrevd for å utføre overføringen.
Overfør eksisterende kontrakter fra et eldre system til HubSpot for å håndtere fakturering og inntektsrapportering. Overføringen bevarer betalingsmåter, kontraktshistorikk og fremtidige faktureringsplaner. Etter overføringen kan du bruke HubSpot som den sentrale kilden til opplysninger om forpliktede inntekter. Les mer om hvordan du bruker kontrakter i HubSpot.
Før du setter i gang
Før du begynner å jobbe med denne funksjonen, må du sørge for at du fullt ut forstår hvilke tiltak som må iverksettes på forhånd, samt funksjonens begrensninger og potensielle konsekvenser ved bruk av den.
Forstå kravene
-
Vær oppmerksom på: Hvis du er superadministrator, kan du melde kontoen din på Faktureringsmigreringer til Revenue Hub-kontrakter .
-
HubSpot-kontoen din må bruke Stripe som betalingsbehandlingsalternativ. Hvis du bruker HubSpot-betalinger og ønsker å migrere betalingsmetoder fra en ekstern Stripe-konto til HubSpot-betalinger, fyller du ut dette skjemaet.
-
Formater CSV-filen basert på innkrevingsprosessen og alternativet for inntektskontinuitet du velger. Les mer om hvordan du velger det overføringsformatet som passer best for din bedrift.
Forstå begrensninger og hensyn
- Hvis du bruker Revenue Continuity, bør du teste importen i et sandkasse-miljø. Hvis feil data importeres til kontoen din, kan du ikke korrigere historiske data i MRR-vannfallrapporter.
- Når en kontrakt er aktivert, blir HubSpot det offisielle systemet for fakturering. Overføringen kan ikke angres.
- Eventuelle oppdateringer av kontrakter må gjøres i HubSpot. Les mer om hvordan du viser og administrerer kontrakter.
- Etter aktivering kan du oppdatere «Billing Start Date Override» og «Payment Method ID» bare hvis kontrakten ikke har betalte fakturaer eller betalinger.
Velg migreringsformat
Før du migrerer, må du velge et migreringsformat basert på hvordan du ønsker at HubSpot skal håndtere kontrakter etter migreringen. Migreringsformatet avhenger av innsamlingsprosessen og om du ønsker å inkludere historiske endringer i kontraktene (f.eks. oppgraderinger eller utvidelser).
Innkassingsprosess
- Manuelle betalinger: Etter migreringen genereres fakturaer som kjøperne kan betale manuelt.
- Automatiske betalinger: Etter migreringen belastes fakturaene automatisk ved hjelp av en registrert betalingsmetode.
Inntektskontinuitet
- Ingen inntektskontinuitet: Kontrakter importeres uten hendelser som endrer inntekten.
- Inntektskontinuitet: Bruk rampenøkler til å gruppere linjeposter i faser og vise endringshendelser (f.eks. oppgraderinger, utvidelser, nedgraderinger) i MRR-vannfallet i HubSpot. Hvis du bruker inntektskontinuitet, bør du teste importen i et sandkasse-miljø. Hvis feil data importeres til kontoen din, kan du ikke korrigere historiske data i MRR-vannfallrapporter.
Ramp
Rampenøkler
Rampenøkler grupperer flere linjeposter i faser. Linjer med samme rampenøkkel behandles som én sammenhengende rampe.
I HubSpot genererer hver rampefase MRR-hendelser (f.eks. ny forretning, oppgradering, utvidelse) når hver fase starter. Rampenøkkelen kan være en hvilken som helst tekststreng (f.eks. ramp-a). Den samme strengen må brukes i alle radene i den aktuelle rampen.
Strukturering av en rampe
For å migrere ramper på en vellykket måte, må du strukturere dem som følger:
- Ikke-overlappende datointervaller: vilkårene for hver rad må ikke overlappe med vilkårene for en annen rad. Hvis rampefasene må være sammenhengende, bør hver fase starte når den forrige fasen slutter.
- Løpetid per fase: Løpetiden for hver rad gjelder kun den aktuelle fasen av kontrakten, ikke hele kontraktens løpetid.
- Totalt antall i hver rad: oppgi det totale antallet for linjeposten i den aktuelle fasen
- Import-ID for rampe: grupperer linjepostene under samme rampe. Les mer om hvordan du oppretter en tilpasset rampeegenskap.
Merk:
- En kontrakt kan inneholde linjeposter med og uten rampe. For linjeposter uten rampe lar du
ramp_key_import_idstå tomt og bruker sammeimport_unique_idsom de relaterte kontraktslinjene. - En kontrakt kan inneholde flere produkter som har uavhengige opptrappinger. Hvert produkt må ha sin egen
ramp_key_import_id. Hver opptrapping genererer sine egne MRR-hendelser.
For eksempel, for en 12-måneders kontrakt med prisendring etter tre måneder:
| Linjepost | Enhetspris | Antall | Løpetid | Startdato | ramp_key_import_id |
|---|---|---|---|---|---|
| Månedlig tjeneste | 100 | 1 | 3 måneder | 1. januar 2026 | ramp-a |
| Månedlig tjeneste | 100 | 2 | 9 måneder | 1. april 2026 | ramp-a |
Mulige migreringsformater
| Migreringsformat | Innkassingsprosess | Inntektskontinuitet |
|---|---|---|
| Manuelle betalinger uten inntektskontinuitet | Manuelle betalinger | Ikke inkludert |
| Manuelle betalinger med inntektskontinuitet | Manuelle betalinger | Inkluderer |
| Automatiske betalinger uten inntektskontinuitet | Automatiske betalinger | Ikke inkludert |
| Automatiske betalinger med inntektskontinuitet | Automatiske betalinger | Inkludert |
Forbered deg på migreringen
Før du starter migreringen, må du konfigurere kontoen din og forberede CSV-filen din i henhold til det valgte migreringsformatet.
Opprett egendefinerte egenskaper
Opprett de nødvendige egendefinerte egenskapene før du importerer CSV-filen. Hvilke egenskaper du må opprette, avhenger av det valgte migreringsformatet. Les mer om hvordan du oppretter egendefinerte egenskaper.
| Migreringsformat | Objekt | Navn på egendefinert egenskap | Egendefinert egenskapstype | Valideringsregler | Brukes til |
|---|---|---|---|---|---|
| Alle alternativer | Kontrakter | import_unique_id |
Enlinjet tekst | Krev unike verdier | Grupperer alle rader som tilhører samme kontrakt. |
| Manuelle betalinger med inntektskontinuitet eller automatiske betalinger med inntektskontinuitet | Linjeposter | ramp_key_import_id |
Enkeltekst | Ingen | Grupperer flere linjeposter i faser. |
Konfigurer CSV-filen
Konfigurer CSV-filen som skal brukes med importverktøyet for å migrere kontrakter til HubSpot.
Eksempler på CSV-filer
Bruk CSV-eksempelfilene nedenfor, avhengig av hvilket migreringsformat du bruker.
| Migreringsformat | CSV-lenke |
|---|---|
| Manuelle betalinger, ingen inntektskontinuitet | Last ned |
| Manuelle betalinger med inntektskontinuitet | Last ned |
| Automatiske betalinger, ingen inntektskontinuitet | Last ned |
| Automatiske betalinger med kontinuerlig inntekt | Last ned |
| Blandet: ett produkt med trinnvis prisøkning og ett produkt med fast avgift (uten rampenøkkel) | Last ned |
Flere uavhengige trinn: Produkt A (ramp-a) og Produkt B (ramp-b) har separate trinn |
Last ned |
CSV-format
CSV-filen din bør inneholde følgende kolonner og HubSpot-egenskaper.
| Kolonnenavn | Objekt | Egenskap | Detaljer |
|---|---|---|---|
| Kontraktens ikrafttredelsesdato | Kontrakt | hs_contract_effective_date |
Datoen da kontrakten trer i kraft juridisk sett. |
| Valutakode | Kontrakt | hs_currency_code |
Valutakode, for eksempel USD. |
| Navn | Kontrakt | hs_name |
Kontraktnavn. |
| HubSpot-fakturering aktivert | Kontrakt | hs_hubspot_billing_enabled |
Må være TRUE for alle kontrakter som migreres. |
| Innkassoprosess | Kontrakt | hs_collection_process |
Manuell eller automatisk. Må samsvare med migreringsformatet. |
| Overskrivelse av faktureringsstartdato | Kontrakt | hs_billing_start_date_override |
Datoen HubSpot begynner å fakturere. Dette må være en fremtidig dato ved migrering. Påkrevd for alle migreringsformater. |
| Betalingsmetode-ID | Kontrakt | hs_external_payment_method_reference_id |
La feltet stå tomt for manuelle betalinger. Påkrevd for automatiske betalinger. |
| E-post | Kontakt | email |
E-postadressen til faktureringskontakten. |
| Fornavn | Kontakt | firstname |
Fornavn til faktureringskontakten. |
| Etternavn | Kontakt | lastname |
Etternavn til faktureringskontakten. |
| Produkt | Varepost | hs_product_id |
Produktets post-ID. Migreringen refererer til en eksisterende produktpost og oppretter ikke et nytt produkt |
| Navn på linjepost | Linjepost | name |
Navn på linjepost. |
| Enhetspris | Linjepost | price |
Enhetspris i kontraktsvalutaen. |
| Antall | Linjepost | quantity |
Antall linjeposter i løpet av en fase. |
| import_unique_id | Linjepost | Egendefinert egenskap | Felles ID for alle rader i samme kontrakt. |
| Begrep | Linjepost | hs_recurring_billing_period |
Løpetiden for linjeposten. Når du bruker opptrappinger, angir du løpetiden for hvert segment. |
| Frekvens for gjentatt fakturering | Linjepost | recurringbillingfrequency |
Faktureringsfrekvens (f.eks. månedlig). |
| Startdato for linjepost | Linjepost | hs_recurring_billing_start_date |
Startdato for fakturering av linjeposten. |
| ramp_key_import_id | Linjepost | Egendefinert egenskap | Grupperer linjepostfaser i én rampe. Nødvendig for inntektskontinuitet. La dette feltet stå tomt for migreringsformater uten inntektskontinuitet. |
Start overføringen
Når du har konfigurert CSV-filen, kan du begynne å migrere kontrakter til HubSpot.
- I HubSpot-kontoen din klikker du på Mer, og så navigerer du til Inntekt > Kontrakter. Hvis Mer ikke vises i kontoen din, navigerer du direkte til Inntekt > Kontrakter.
- Klikk på «Importer» øverst til høyre.
- I delen Importer en fil klikker du på Importer data.
- Klikk på Avansert import (alle objekter).
- Under «Objekter» klikker du på «Kontrakter». Objektet «Linjeposter» velges automatisk.
- Klikk på «Neste» nederst til høyre.
- Konfigurer hvordan du vil importere dataene dine:
- Last opp en fil: dra og slipp, eller klikk på «Velg en fil» og velg deretter importfilen.
- Kopier og lim inn: Klikk på «Lim inn direkte fra regnearket» og lim inn dataene dine. Dataene må kopieres fra en regnearkfil (f.eks. Numbers, Google Sheets).
- Språk: Hvis du importerer data på et annet språk enn standardspråket ditt, klikker du på rullegardinmenyen «Velg språket for kolonneoverskriftene i filen din » og velger språket. Ved å velge riktig språk kan HubSpot bedre tilpasse kolonneoverskriftene dine til eksisterende standardegenskaper. Hvis det ikke finnes noen samsvarende egenskaper på det valgte språket, vil HubSpot søke etter en engelsk egenskap som samsvarer.
- Klikk på «Neste» nederst til høyre.
- Tilordne kolonnene i importfilen til HubSpot-egenskaper. Les mer om CSV-egenskapstilordninger.
- Klikk på «Neste» nederst til høyre.
- I feltet «Importnavn» skriver du inn et navn på importen.
- Klikk på rullegardinmenyen «Velg rettslig grunnlag for behandling av kontaktens data » og velg et rettslig grunnlag. Les mer om sporing av rettslig grunnlag for behandling i HubSpot.
- Klikk på rullegardinmenyen «Datoformat » og velg et datoformat.
- Klikk på rullegardinmenyen «Tidssone» og velg en tidssone.
- Klikk på rullegardinmenyen «Tallformat» og velg et tallformat.
- Merk av i avmerkingsboksen «Angi disse kontaktene som markedsføringskontakter» hvis du ønsker å benytte de importerte kontaktene ved hjelp av HubSpots markedsføringsverktøy. Les mer om markedsføringskontakter.
- Merk av i avmerkingsboksen «Utvid oppføringer» for å utvide oppføringene under importen. Les mer om utvidelse av kontakt- og bedriftsopplysninger.
- Klikk på «Fullfør import» nederst til høyre.
Feilsøking
Gå gjennom vanlige importfeil og trinnene for å løse dem. Hvis du støter på en annen feil, bør du sjekke CSV-formateringen og egenskapstilordningene, og deretter prøve å importere på nytt.
Overskrivelse av faktureringsstartdato i fortiden
Feilen «Faktureringsstartdatoen ligger i fortiden » oppstår når faktureringsstartdatoen for en linjepost i CSV-filen ligger i fortiden.
Slik løser du denne feilen:
- Oppdater eventuelle faktureringsdatoer til en fremtidig dato.
- Lagre CSV-filen og start importen på nytt.
Ugyldig eller manglende Stripe-betalingsmetode-ID
Denne feilen oppstår når alternativet for automatiske betalinger er valgt som innkrevingsprosess, men en Stripe-betalingsmetode-ID ikke ble lagt til i CSV-filen.
For å løse denne feilen, gjør enten følgende:
- Endre oppføringene for automatiske betalinger til manuelle betalinger.
- Legg til en Stripe-betalingsmetode-ID for oppføringer for automatiske betalinger i CSV-filen.
Dupliser import_unique_id fra et tidligere forsøk
Hvis en import mislykkes, kan HubSpot likevel registrereimport_unique_id verdiene fra den mislykkede importen.
For å løse denne feilen:
- Oppdater CSV-filen med nye ID-er.
- Importer den oppdaterte CSV-filen.
Ordliste
Gå gjennom følgende begreper før du migrerer kontrakter til HubSpot.
| Løpetid | Beskrivelse |
|---|---|
| Automatiske betalinger | En innkrevingsprosess der fakturaer belastes automatisk ved hjelp av en lagret betalingsmetode. |
| Overstyring av faktureringsstartdato | Datoen da HubSpot skal begynne å fakturere for den migrerte kontrakten. |
| Innkrevingsprosess | Hvordan betalinger innkreves etter migrering. Betalinger kan innkreves manuelt av kjøperen eller automatisk ved hjelp av en registrert betalingsmetode. |
| import_unique_id | En tilpasset egenskap som brukes til å gruppere rader som tilhører samme kontrakt under migreringen. |
| Manuelle betalinger | En innkrevingsprosess der fakturaer genereres i HubSpot og kjøpere betaler dem manuelt. |
| Migreringsformat | CSV-strukturen som brukes til importen. Migreringsformatet avhenger av hvordan betalingene skal innkreves og om du ønsker å inkludere inntektskontinuitet. |
| MRR | Månedlig gjentakende inntekt. I HubSpot brukes MRR til å rapportere gjentakende inntekter fra kontrakter. |
| MRR-vannfall | En inntektsrapport som viser hvordan gjentakende inntekter endres over tid på grunn av hendelser som nye kunder, oppgraderinger, utvidelser, nedgraderinger og kundefrafall. |
| Betalingsmetode-ID | Den eksterne betalingsmetodereferansen som brukes for kontrakter med automatiske betalinger. |
| Ramp | En endring i pris eller mengde som skjer i løpet av en kontraktsperiode. |
| Rampenøkkel | En verdi som brukes til å gruppere relaterte linjeposter i én rampe. |
| Rampefase | En periode innenfor en rampe. Hver fase har sin egen løpetid, pris, mengde og startdato. |
| ramp_key_import_id | En tilpasset linjevareegenskap som brukes til å gruppere linjevarer i rampefaser under migrering. |
| Inntektskontinuitet | Et alternativ som inkluderer historiske kontraktsendringer, for eksempel oppgraderinger, utvidelser eller nedgraderinger, slik at disse kan gjenspeiles i inntektsrapporteringen. |
| Registreringssystem | Det primære systemet som brukes til å administrere og vedlikeholde kontrakts- og faktureringsinformasjon etter migrering. |