Spring til indhold
Bemærk:Oversættelsen af denne artikel er kun til rådighed for nemheds skyld. Oversættelsen oprettes automatisk via en oversættelsessoftware og er muligvis ikke blevet korrekturlæst. Den engelske version af denne artikel bør således anses for at være den gældende version, der indeholder de seneste oplysninger. Du kan få adgang til den her.

Overfør kontrakter til HubSpot

Sidst opdateret: 23 juli 2026

Gælder for:

Abonnement kræves A Revenue Hub -abonnement er påkrævet for at overføre kontrakter.

Licenser kræves Et Revenue Hub -licens er påkrævet for at overføre kontrakter.

Tilladelser kræves Der kræves superadministratorrettigheder for at udføre overførslen.

Overfør eksisterende kontrakter fra et ældre system til HubSpot for at administrere afregning, fakturering og indtægtsrapportering. Overførslen bevarer betalingsmetoder, kontrakthistorik og fremtidige afregningsplaner. Efter overførslen kan du bruge HubSpot som den centrale kilde til oplysninger om forpligtede indtægter. Læs mere om brug af kontrakter i HubSpot.

Før du går i gang

Inden du begynder at arbejde med denne funktion, skal du sikre dig, at du fuldt ud forstår, hvilke skridt der skal tages på forhånd, samt funktionens begrænsninger og de potentielle konsekvenser af at bruge den.

Forstå kravene

Forstå begrænsninger og overvejelser

  • Hvis du bruger Revenue Continuity, skal du teste importen i et sandkasse-miljø. Hvis der importeres forkerte data til din konto, kan du ikke rette historiske data i MRR-vandfaldsrapporter.
  • Når en kontrakt er aktiveret, bliver HubSpot det primære system for fakturering. Overførslen kan ikke fortrydes.
  • Eventuelle opdateringer af kontrakter skal foretages i HubSpot. Få mere at vide om visning og administration af kontrakter.
  • Efter aktivering kan du kun opdatere " Billing Start Date Override " og " Payment Method ID ", hvis kontrakten ikke har nogen betalte fakturaer eller betalinger.

Vælg migrationsformat

Inden migreringen skal du vælge et migrationsformat baseret på, hvordan du ønsker, at HubSpot skal administrere kontrakter efter migreringen. Migrationsformatet afhænger af indsamlingsprocessen og af, om du ønsker at medtage historiske kontraktændringer (f.eks. opgraderinger eller udvidelser).

Inddrivelsesproces

  • Manuelle betalinger: Efter migreringen genereres der fakturaer, som køberne skal betale manuelt.
  • Automatiske betalinger: Efter migreringen debiteres fakturaerne automatisk via en registreret betalingsmetode.

Omsætningskontinuitet

  • Ingen indtægtskontinuitet: Kontrakter importeres uden begivenheder, der ændrer indtægterne.
  • Omsætningskontinuitet: Brug ramp-nøgler til at gruppere linjeposter i faser og vise ændringshændelser (f.eks. opgraderinger, udvidelser, nedgraderinger) i MRR-vandfaldet i HubSpot. Hvis du bruger omsætningskontinuitet, skal du teste importen i et sandkasse-miljø. Hvis der importeres forkerte data til din konto, kan du ikke rette historiske data i MRR-vandfaldsrapporter.

Ramps

Rampenøgler

Rampnøgler grupperer flere linjeposter i faser. Rækker med samme rampnøgle behandles som én sammenhængende rampe.

I HubSpot genererer hver rampefase MRR-begivenheder (f.eks. ny forretning, opgradering, udvidelse), når hver fase begynder. Rampenøglen kan være en vilkårlig tekststreng (f.eks. ramp-a). Den samme streng skal være fælles for alle rækker i den pågældende rampe.

Strukturering af en rampe

For at migrere ramper korrekt skal du strukturere dem som følger:

  • Ikke-overlappende datointervaller: Vilkårene for hver række må ikke overlappe med vilkårene for en anden række. Hvis rampefaserne skal være sammenhængende, skal hver fase starte, når den foregående fase slutter.
  • Løbetid pr. fase: Løbetiden for hver række dækker kun den pågældende fase af kontrakten, ikke hele kontraktperioden.
  • Samlet mængde i hver række: Indtast den samlede mængde for linjeposten i den pågældende fase
  • Import-ID for rampe-nøgle: Grupperer linjeposterne under den samme rampe. Få mere at vide om oprettelse af en brugerdefineret rampe-egenskab.

Bemærk venligst:

  • En kontrakt kan indeholde linjeposter med og uden ramp-funktion. For linjeposter uden ramp-funktion skal du lade ramp_key_import_id stå tomt og bruge det samme import_unique_id som de relaterede kontraktrækker.
  • En kontrakt kan indeholde flere produkter, der rampes uafhængigt af hinanden. Hvert produkt skal have sit eget ramp_key_import_id. Hver ramp genererer sine egne MRR-begivenheder.

For eksempel for en 12-måneders kontrakt med en prisændring efter tre måneder:

Linjepost Enhedspris Antal Løbetid Startdato ramp_key_import_id
Månedlig service 100 1 3 måneder 1. januar 2026 ramp-a
Månedlig service 100 2 9 måneder 1. april 2026 ramp-a

Mulige migrationsformater

Migreringsformat Inddrivelsesproces Indtægtskontinuitet
Manuelle betalinger uden indtægtskontinuitet Manuelle betalinger Ikke inkluderet
Manuelle betalinger med indtægtskontinuitet Manuelle betalinger Omfatter
Automatiske betalinger uden indtægtskontinuitet Automatiske betalinger Ikke inkluderet
Automatiske betalinger med indtægtskontinuitet Automatiske betalinger Inkluderet

Forbered dig på migreringen

Inden du påbegynder overførslen, skal du opsætte din konto og forberede din CSV-fil i henhold til det valgte overførselsformat.

Opret brugerdefinerede egenskaber

Opret de nødvendige brugerdefinerede egenskaber, inden du importerer din CSV-fil. De egenskaber, du skal oprette, afhænger af det valgte migrationsformat. Få mere at vide om oprettelse af brugerdefinerede egenskaber.

Migreringsformat Objekt Navn på brugerdefineret egenskab Brugerdefineret egenskabstype Valideringsregler Anvendes til
Alle indstillinger Kontrakter import_unique_id Tekst på én linje Kræver unikke værdier Grupperer alle rækker, der hører til den samme kontrakt.
Manuelle betalinger med indtægtskontinuitet eller Automatiske betalinger med indtægtskontinuitet Linjeposter ramp_key_import_id Tekst på én linje Ingen Grupperer flere linjeposter i faser.

Konfigurer CSV-filen

Konfigurer CSV-filen, der skal bruges med importværktøjet til at migrere kontrakter til HubSpot.

Eksempler på CSV-filer

Brug eksemplerne på CSV-filer nedenfor, afhængigt af det migreringsformat, du bruger.

Migreringsformat CSV-link
Manuelle betalinger, ingen indtægtskontinuitet Download
Manuelle betalinger med indtægtskontinuitet Download
Automatiske betalinger, ingen indtægtskontinuitet Download
Automatiske betalinger med indtægtskontinuitet Download
Blandet: ét produkt med stigende pris og ét produkt med fast gebyr (uden ramp-nøgle) Download
Flere uafhængige stigningskurver: Produkt A (ramp-a) og Produkt B (ramp-b) stiger hver for sig Download

CSV-format

Din CSV-fil skal indeholde følgende kolonner og HubSpot-egenskaber.

Kolonnenavn Objekt Egenskab Detaljer
Kontraktens ikrafttrædelsesdato Kontrakt hs_contract_effective_date Den dato, hvor kontrakten træder i kraft.
Valutakode Kontrakt hs_currency_code Valutakode, f.eks. USD.
Navn Kontrakt hs_name Kontraktnavn.
HubSpot-fakturering aktiveret Kontrakt hs_hubspot_billing_enabled Skal være TRUE for alle kontrakter, der migreres.
Inddrivelsesproces Kontrakt hs_collection_process Manuel eller automatisk. Skal stemme overens med migreringsformatet.
Overskrivning af faktureringsstartdato Kontrakt hs_billing_start_date_override Den dato, hvor HubSpot begynder at fakturere. Dette skal være en fremtidig dato ved migrering. Påkrævet for alle migreringsformater.
Betalingsmetode-ID Kontrakt hs_external_payment_method_reference_id Lad feltet være tomt ved manuelle betalinger. Kræves ved automatiske betalinger.
E-mail Kontakt email Faktureringskontaktens e-mail-adresse.
Fornavn Kontakt firstname Fornavn på faktureringskontakten.
Efternavn Kontakt lastname Efternavn på faktureringskontakten.
Produkt Linjepost hs_product_id Produktets post-ID. Migreringen henviser til en eksisterende produktpost og opretter ikke et nyt produkt
Navn på linjepost Linjepost name Navn på linjepost.
Enhedspris Linjepost price Enhedspris i kontraktvalutaen.
Antal Linjepost quantity Mængden pr. linjepost i en fase.
import_unique_id Linjepost Brugerdefineret egenskab Fælles ID for alle rækker i samme kontrakt.
Term Linjepost hs_recurring_billing_period Linjepostens løbetid. Når der anvendes ramp-perioder, skal løbetiden angives for hvert segment.
Hyppighed for tilbagevendende fakturering Linjepost recurringbillingfrequency Faktureringshyppighed (f.eks. månedligt).
Startdato for linjeposten Linjepost hs_recurring_billing_start_date Startdato for fakturering af linjeposten.
ramp_key_import_id Linjepost Brugerdefineret egenskab Grupperer linjepostfaser i én rampe. Påkrævet for indtægtskontinuitet. Lad dette felt være tomt for migrationsformater uden indtægtskontinuitet.

Start overførslen

Når du har konfigureret din CSV-fil, kan du begynde at migrere kontrakter til HubSpot.

  1. Klik på Mere på din HubSpot-konto, og navigér derefter til Omsætning > Kontrakter. Hvis Mere ikke vises på din konto, skal du navigere direkte til Omsætning > Kontrakter.
  2. Klik på Import øverst til højre.
  3. I afsnittet Importer en fil skal du klikke på Importer data.
  4. Klik på Avanceret import (alle objekter).
  5. Klik på Kontrakter under Objekter. Objektet Linjeposter vælges automatisk.
  6. Klik på Næste nederst til højre.
  7. Konfigurer, hvordan du vil importere dine data:
    • Upload en fil: træk og slip, eller klik på Vælg en fil, og vælg derefter din importfil.
    • Kopier og indsæt: Klik på Indsæt direkte fra dit regneark, og indsæt dine data. Dataene skal kopieres fra en regnearksfil (f.eks. Numbers, Google Sheets).
    • Sprog: Hvis du importerer data på et andet sprog end dit standardsprog, skal du klikke på rullemenuen " Vælg sproget for kolonneoverskrifterne i din fil " og vælge sproget. Ved at vælge det rigtige sprog kan HubSpot bedre matche dine kolonneoverskrifter med eksisterende standardegenskaber. Hvis der ikke er noget match på det valgte sprog, vil HubSpot søge efter en engelsk egenskab, der passer.
  8. Klik på "Næste" nederst til højre.
  9. Kortlæg kolonnerne i importfilen til HubSpot-egenskaber. Få mere at vide om CSV-egenskabskortlægning.
  10. Klik på Næste nederst til højre.
  11. Indtast et navn til importen i feltet Importnavn.
  12. Klik på rullemenuen Vælg retsgrundlag for behandling af en kontakts data, og vælg et retsgrundlag. Få mere at vide om sporing af retsgrundlag for behandling i HubSpot.
  13. Klik på rullemenuen "Datoformat", og vælg et datoformat.
  14. Klik på rullemenuen "Tidszone", og vælg en tidszone.
  15. Klik på rullemenuen " Talformat", og vælg et talformat.
  16. Markér afkrydsningsfeltet " Indstil disse kontakter som marketingkontakter ", hvis du vil engagere de importerede kontakter ved hjælp af HubSpots marketingværktøjer. Få mere at vide om marketingkontakter.
  17. Markér afkrydsningsfeltet »Berig poster« for at berige posterne under importen. Læs mere om berigelse af kontakt- og virksomhedsoplysninger.
  18. Klik på " Afslut import" nederst til højre.

Fejlfinding

Gennemgå almindelige importfejl og trinene til at løse dem. Hvis du støder på en anden fejl, skal du gennemgå din CSV-formatering og egenskabskortlægning og derefter prøve at importere igen.

Overskrivning af faktureringsstartdato i fortiden

Fejlen " Faktureringsstartdatoen ligger i fortiden " opstår, når faktureringsstartdatoen for en linjepost i CSV-filen ligger i fortiden.

Sådan løser du denne fejl:

  1. Opdater eventuelle faktureringsdatoer til en fremtidig dato.
  2. Gem CSV-filen, og start importen igen.

Ugyldigt eller manglende Stripe-betalingsmetode-ID

Denne fejl opstår, når indstillingen "Automatiske betalinger" er valgt som opkrævningsproces, men der ikke er tilføjet et Stripe-betalingsmetode-ID til CSV-filen.

For at løse denne fejl skal du enten:

  • Skift poster for automatiske betalinger til manuelle betalinger.
  • Tilføj et Stripe-betalingsmetode-ID til posterne for automatiske betalinger i CSV-filen.

Kopier import_unique_id fra et tidligere forsøg

Hvis en import mislykkes, kan HubSpot stadig registrereimport_unique_id værdierne fra den mislykkede import.

Sådan løser du denne fejl:

  1. Opdater din CSV-fil med de nye ID'er.
  2. Importer den opdaterede CSV-fil.

Ordliste

Gennemgå følgende termer, inden du migrerer kontrakter til HubSpot.

Løbetid Beskrivelse
Automatiske betalinger En opkrævningsproces, hvor fakturaer automatisk debiteres ved hjælp af en gemt betalingsmetode.
Tilsidesættelse af faktureringsstartdato Den dato, hvor HubSpot skal begynde at fakturere for den overførte kontrakt.
Inddrivelsesproces Hvordan betalinger inddrives efter migreringen. Betalinger kan inddrives manuelt af køberen eller automatisk ved hjælp af en registreret betalingsmetode.
import_unique_id En brugerdefineret egenskab, der bruges til at gruppere rækker, der hører til den samme kontrakt under migreringen.
Manuelle betalinger En inddrivelsesproces, hvor fakturaer genereres i HubSpot, og køberne betaler dem manuelt.
Migreringsformat Den CSV-struktur, der bruges til importen. Migrationsformatet afhænger af, hvordan betalingerne skal inddrives, og om du ønsker at medtage indtægtskontinuitet.
MRR Månedlig tilbagevendende omsætning. I HubSpot bruges MRR til at rapportere tilbagevendende omsætning fra kontrakter.
MRR-vandfald En omsætningsrapport, der viser, hvordan den tilbagevendende omsætning ændrer sig over tid på grund af begivenheder såsom nye kunder, opgraderinger, udvidelser, nedgraderinger og kundeafgang.
Betalingsmetode-ID Den eksterne betalingsmetodereference, der bruges til kontrakter med automatiske betalinger.
Ramp En ændring i pris eller mængde, der sker i løbet af en kontraktperiode.
Ramp-nøgle En værdi, der bruges til at gruppere relaterede linjeposter i én rampe.
Rampefase En periode inden for en ramp. Hver fase har sin egen løbetid, pris, mængde og startdato.
ramp_key_import_id En brugerdefineret linjepost-egenskab, der bruges til at gruppere linjeposter i rampefaser under migreringen.
Omsætningskontinuitet En indstilling, der inkluderer historiske kontraktændringer, såsom opgraderinger, udvidelser eller nedgraderinger, så disse kan afspejles i omsætningsrapporteringen.
Hovedregistreringssystem Det primære system, der bruges til at administrere og vedligeholde kontrakt- og faktureringsoplysninger efter migreringen.
Var denne artikel nyttig?
Denne formular bruges kun til dokumentationsfeedback. Læs, hvordan du kan få hjælp hos HubSpot.