Observera: Översättningen av denna artikel är endast avsedd att underlätta för dig. Översättningen har skapats automatiskt med hjälp av en översättningsprogramvara och har eventuellt inte korrekturlästs. Den engelska versionen av denna artikel bör därför betraktas som den gällande versionen med den senaste informationen. Du kan komma åt den här.

Flytta avtal till HubSpot

Senast uppdaterad: 23 juli 2026

Tillgänglig med något av följande abonnemang, om inte annat anges:

Revenue Hub Professional, Enterprise

Profiler krävs

Prenumeration krävs A Revenue Hub -abonnemang krävs för att migrera avtal.

Profiler krävs Ett Revenue Hub -licens krävs för att migrera avtal.

Behörigheter krävs Superadministratörsbehörighet krävs för att utföra migreringen.

Flytta befintliga avtal från ett äldre system till HubSpot för att hantera fakturering och intäktsrapportering. Vid migreringen bevaras betalningssätt, avtalshistorik och framtida faktureringsscheman. Efter migreringen kan du använda HubSpot som den centrala källan för bekräftade intäkter. Läs mer om hur du använder avtal i HubSpot.

Innan du börjar

Innan du börjar arbeta med den här funktionen bör du se till att du fullt ut förstår vilka åtgärder som måste vidtas i förväg, samt funktionens begränsningar och de potentiella konsekvenserna av att använda den.

Förstå kraven

Observera: om du är superadministratörkan du anmäla ditt konto till Faktureringsmigreringar till Revenue Hub-avtal .
Ditt HubSpot-konto måste använda Stripe som betalningsalternativ. Om du använder HubSpot Payments och vill migrera betalningsmetoder från ett externt Stripe-konto till HubSpot Payments, fyll i det här formuläret.
Formatera CSV-filen utifrån den betalningsinsamlingsprocess och det alternativ för intäktskontinuitet som du väljer. Läs mer om hur du väljer det migreringsformat som passar bäst för ditt företag.

Förstå begränsningar och överväganden

Om du använder intäktskontinuitet bör du testa importen i en sandlådemiljö. Om felaktiga data importeras till ditt konto kan du inte korrigera historiska data i MRR-vattenfallsrapporter.
När ett avtal har aktiverats blir HubSpot det system där faktureringen registreras. Migreringen kan inte ångras.
Alla uppdateringar av avtal måste göras i HubSpot. Läs mer om hur du visar och hanterar avtal.
Efter aktivering kan du uppdatera ”Billing Start Date Override” och ”Payment Method ID” endast om avtalet inte har några betalda fakturor eller betalningar.

Välj migreringsformat

Innan du migrerar ska du välja ett migreringsformat utifrån hur du vill att HubSpot ska hantera avtal efter migreringen. Migreringsformatet beror på insamlingsprocessen och på om du vill inkludera historiska händelser som rör avtalsändringar (t.ex. uppgraderingar eller utökningar).

Inbetalningsprocess

Manuella betalningar: efter migreringen genereras fakturor som köparna kan betala manuellt.
Automatiska betalningar: Efter migreringen debiteras fakturorna automatiskt med hjälp av en registrerad betalningsmetod.

Intäktskontinuitet

Ingen intäktskontinuitet: avtalen importeras utan händelser som påverkar intäkterna.
Intäktskontinuitet: använd rampnycklar för att gruppera radposter i faser och visa förändringshändelser (t.ex. uppgraderingar, utökningar, nedgraderingar) i MRR-vattenfallet i HubSpot. Om du använder intäktskontinuitet bör du testa importen i en sandlådemiljö. Om felaktiga data importeras till ditt konto kan du inte korrigera historiska data i MRR-vattenfallsrapporterna.

Ramp

Rampnycklar

Rampnycklar grupperar flera rader med enskilda poster i faser. Rader med samma rampnyckel behandlas som en sammanhängande ramp.

I HubSpot genererar varje rampfas MRR-händelser (t.ex. ny affär, uppgradering, utökning) när varje fas inleds. Rampnyckeln kan vara vilken textsträng som helst (t.ex. ramp-a). Samma sträng måste användas i alla rader i den rampen.

Strukturera en ramp

För att migrera ramper på ett framgångsrikt sätt ska du strukturera dem enligt följande:

Icke-överlappande datumintervall: villkoren för varje rad får inte överlappa villkoren för en annan rad. Om rampfaserna måste vara kontinuerliga bör varje fas börja när den föregående fasen slutar.
Villkor per fas: villkoren i varje rad gäller endast den fasen av avtalet, inte hela avtalstiden.
Total kvantitet per rad: ange den totala kvantiteten för posten under den fasen
Import-ID för rampnyckel: grupperar radposterna under samma ramp. Läs mer om hur du skapar en anpassad rampegenskap.

Observera:

Ett avtal kan innehålla poster med och utan ramp. För poster utan ramp lämnar du ramp_key_import_id tomt och använder samma import_unique_id som de relaterade avtalsraderna.
Ett avtal kan innehålla flera produkter som rampas upp oberoende av varandra. Varje produkt måste ha sitt eget ramp_key_import_id. Varje ramp genererar sina egna MRR-händelser.

Till exempel för ett 12-månadersavtal med prisändring efter tre månader:

Poster	Enhetspris	Antal	Löptid	Startdatum	ramp_key_import_id
Månadstjänst	100	1	3 månader	1 jan. 2026	`ramp-a`
Månadstjänst	100	2	9 månader	1 april 2026	`ramp-a`

Möjliga migreringsformat

Migreringsformat	Insamlingsprocess	Intäktskontinuitet
Manuella betalningar utan intäktskontinuitet	Manuella betalningar	Ingår inte
Manuella betalningar med intäktskontinuitet	Manuella betalningar	Ingår
Automatiska betalningar utan intäktskontinuitet	Automatiska betalningar	Ingår inte
Automatiska betalningar med intäktskontinuitet	Automatiska betalningar	Ingår

Förbered dig inför migreringen

Innan du påbörjar migreringen ska du konfigurera ditt konto och förbereda din CSV-fil utifrån det valda migreringsformatet.

Skapa anpassade egenskaper

Skapa de anpassade egenskaper som krävs innan du importerar din CSV-fil. Vilka egenskaper du behöver skapa beror på det valda migreringsformatet. Läs mer om hur du skapar anpassade egenskaper.

Migreringsformat	Objekt	Anpassat egenskapsnamn	Anpassad egenskapstyp	Valideringsregler	Används för
Alla alternativ	Kontrakt	`import_unique_id`	Enradig text	Kräver unika värden	Grupperar alla rader som tillhör samma avtal.
Manuella betalningar med kontinuerlig intäkt eller automatiska betalningar med kontinuerlig intäkt	Radposter	`ramp_key_import_id`	Enradig text	Ingen	Grupperar flera radposter i faser.

Konfigurera CSV-filen

Konfigurera CSV-filen som ska användas med importverktyget för att migrera avtal till HubSpot.

Exempel på CSV-filer

Använd CSV-exempelfilerna nedan, beroende på vilket migreringsformat du använder.

Migreringsformat	CSV-länk
Manuella betalningar, ingen intäktskontinuitet	Ladda ner
Manuella betalningar med intäktskontinuitet	Ladda ner
Automatiska betalningar, ingen intäktskontinuitet	Ladda ner
Automatiska betalningar med kontinuerliga intäkter	Ladda ner
Blandad modell: en produkt med stegvis prissättning och en produkt med fast avgift (utan stegvis prissättningsnyckel)	Ladda ner
Flera oberoende steg: Produkt A (`ramp-a`) och Produkt B (`ramp-b`) stiger separat	Ladda ner

CSV-format

Din CSV-fil bör innehålla följande kolumner och HubSpot-egenskaper.

Kolumnnamn	Objekt	Egenskap	Detaljer
Avtalets ikraftträdandedatum	Kontrakt	`hs_contract_effective_date`	Det datum då avtalet träder i kraft juridiskt sett.
Valutakod	Avtal	`hs_currency_code`	Valutakod, till exempel USD.
Namn	Kontrakt	`hs_name`	Kontraktets namn.
HubSpot-fakturering aktiverad	Kontrakt	`hs_hubspot_billing_enabled`	Måste vara `TRUE` för alla avtal som migreras.
Inkassoprocess	Kontrakt	`hs_collection_process`	Manuell eller automatisk. Måste överensstämma med migreringsformatet.
Överskrivning av faktureringsstartdatum	Avtal	`hs_billing_start_date_override`	Det datum då HubSpot börjar fakturera. Vid migrering måste detta vara ett framtida datum. Obligatoriskt för alla migreringsformat.
Betalningsmetod-ID	Avtal	`hs_external_payment_method_reference_id`	Lämna tomt för manuella betalningar. Krävs för automatiska betalningar.
E-post	Kontakt	`email`	Fakturakontaktens e-postadress.
Förnamn	Kontakt	`firstname`	Förnamn på faktureringskontakten.
Efternamn	Kontakt	`lastname`	Efternamn på faktureringskontakten.
Produkt	Rad	`hs_product_id`	Produktens post-ID. Migreringen refererar till en befintlig produktpost och skapar inte en ny produkt
Namn på enskild post	Rad	`name`	Namn på enskild artikel.
Enhetspris	Post	`price`	Pris per enhet i avtalsvalutan.
Antal	Radpost	`quantity`	Antalet rader under en fas.
import_unique_id	Radpost	Anpassad egenskap	Gemensamt ID för alla rader i samma avtal.
Term	Radpost	`hs_recurring_billing_period`	Löptiden för posten. När du använder ramp-perioder anger du löptiden för varje segment.
Frekvens för återkommande fakturering	Poster	`recurringbillingfrequency`	Faktureringsfrekvens (t.ex. månadsvis).
Startdatum för posten	Radpost	`hs_recurring_billing_start_date`	Startdatum för fakturering av posten.
ramp_key_import_id	Poster	Anpassad egenskap	Grupperar postfaserna i en ramp. Krävs för intäktskontinuitet. Lämna detta fält tomt för migreringsformat utan intäktskontinuitet.

Starta migreringen

När du har konfigurerat din CSV-fil kan du börja migrera avtal till HubSpot.

I ditt HubSpot-konto klickar du på Mer och navigerar sedan till Intäkter > Contracts. Om Mer inte visas i ditt konto navigerar du direkt till Intäkter > Contracts.
Klicka på Importera längst upp till höger.
I avsnittet Importera en fil klickar du på Importera data.
Klicka på Avancerade importer (alla objekt).
Under Objekt klickar du på Kontrakt. Objektet för enskilda poster väljs automatiskt.
Klicka på Nästa längst ned till höger.
Konfigurera hur du vill importera dina data:
- Ladda upp en fil: dra och släpp, eller klicka på Välj en fil och välj sedan din importfil.
- Kopiera och klistra in: klicka på Klistra in direkt från ditt kalkylblad och klistra in dina data. Data måste kopieras från en kalkylbladsfil (t.ex. Numbers, Google Sheets).
- Språk: om du importerar data på ett annat språk än ditt standardspråk klickar du på rullgardinsmenyn ”Välj språk för kolumnrubrikerna i din fil” och väljer språket. Genom att välja rätt språk kan HubSpot bättre matcha dina kolumnrubriker med befintliga standardegenskaper. Om det inte finns någon matchning i det valda språket söker HubSpot efter en engelsk egenskap som passar.
Klicka på Nästa längst ned till höger.
Koppla kolumnerna i importfilen till HubSpot-egenskaper. Läs mer om CSV-egenskapskopplingar.
Klicka på Nästa längst ned till höger.
I fältet Importnamn anger du ett namn för importen.
Klicka på rullgardinsmenyn Välj rättslig grund för behandling av en kontakts data och välj en rättslig grund. Läs mer om att spåra den rättsliga grunden för behandling i HubSpot.
Klicka på rullgardinsmenyn för datumformat och välj ett datumformat.
Klicka på rullgardinsmenyn Tidszon och välj en tidszon.
Klicka på rullgardinsmenyn ”Talformat” och välj ett talformat.
Markera kryssrutan Ange dessa kontakter som marknadsföringskontakter om du vill använda de importerade kontakterna med HubSpots marknadsföringsverktyg. Läs mer om marknadsföringskontakter.
Markera kryssrutan ”Berika poster” för att berika posterna under importen. Läs mer om berikning av kontakt- och företagsuppgifter.
Klicka på " Slutför import" längst ned till höger.

Felsökning

Granska vanliga importfel och stegen för att åtgärda dem. Om du stöter på ett annat fel, granska din CSV-formatering och egenskapsmappningarna och försök sedan importera igen.

Överskrivning av faktureringsstartdatum i det förflutna

Felet ”Faktureringsstartdatumet ligger i det förflutna ” uppstår när faktureringsstartdatumet för en radpost i CSV-filen ligger i det förflutna.

Så här åtgärdar du felet:

Uppdatera eventuella faktureringsdatum till ett framtida datum.
Spara CSV-filen och starta importen igen.

Ogiltigt eller saknat Stripe-betalningsmetod-ID

Detta fel uppstår när alternativet för automatiska betalningar har valts som inkasseringsmetod, men ett Stripe-betalningsmetod-ID inte har lagts till i CSV-filen.

För att åtgärda detta fel gör du antingen följande:

Ändra poster för automatiska betalningar till manuella betalningar.
Lägg till ett Stripe-betalningsmetod-ID för poster för automatiska betalningar i CSV-filen.

Kopiera import_unique_id från ett tidigare försök

Om en import misslyckas kan HubSpot fortfarande registreraimport_unique_id värdena från den misslyckade importen.