Gå til innhold
Merk:: Denne artikkelen er oversatt av praktiske årsaker. Oversettelsen opprettes automatisk ved hjelp av oversettingsprogramvare, og det er ikke sikkert at den er korrekturlest. Den engelske versjonen av denne artikkelen skal regnes som den regjerende versjonen med den nyeste informasjonen. Du finner den her.

Overføre kontrakter til HubSpot

Sist oppdatert: 23 juli 2026

Tilgjengelig med et av følgende abonnementer, unntatt der det er angitt:

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

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_id stå tomt og bruker samme import_unique_id som 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.

  1. 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.
  2. Klikk på «Importer» øverst til høyre.
  3. I delen Importer en fil klikker du på Importer data.
  4. Klikk på Avansert import (alle objekter).
  5. Under «Objekter» klikker du på «Kontrakter». Objektet «Linjeposter» velges automatisk.
  6. Klikk på «Neste» nederst til høyre.
  7. 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.
  8. Klikk på «Neste» nederst til høyre.
  9. Tilordne kolonnene i importfilen til HubSpot-egenskaper. Les mer om CSV-egenskapstilordninger.
  10. Klikk på «Neste» nederst til høyre.
  11. I feltet «Importnavn» skriver du inn et navn på importen.
  12. 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.
  13. Klikk på rullegardinmenyen «Datoformat » og velg et datoformat.
  14. Klikk på rullegardinmenyen «Tidssone» og velg en tidssone.
  15. Klikk på rullegardinmenyen «Tallformat» og velg et tallformat.
  16. 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.
  17. Merk av i avmerkingsboksen «Utvid oppføringer» for å utvide oppføringene under importen. Les mer om utvidelse av kontakt- og bedriftsopplysninger.
  18. 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:

  1. Oppdater eventuelle faktureringsdatoer til en fremtidig dato.
  2. 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:

  1. Oppdater CSV-filen med nye ID-er.
  2. 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.
Var denne artikkelen nyttig?
Dette skjemaet brukes kun for tilbakemeldinger om dokumentasjon. Se hvordan du kan få hjelp med HubSpot.