- Vidensbase
- Omsætning
- Kontrakter
- Overfør kontrakter til HubSpot
I betaOverfør kontrakter til HubSpot
Sidst opdateret: 23 juli 2026
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
-
Bemærk venligst: Hvis du er superadministrator, kan du tilmelde din konto til Faktureringsmigreringer til Revenue Hub-kontrakter .
-
Din HubSpot-konto skal bruge Stripe som betalingsbehandlingsmulighed. Hvis du bruger HubSpot-betalinger og ønsker at overføre betalingsmetoder fra en ekstern Stripe-konto til HubSpot-betalinger, skal du udfylde denne formular.
-
Formater CSV-filen ud fra den betalingsinddrivelsesproces og den indtægtskontinuitetsmulighed, du vælger. Få mere at vide om, hvordan du vælger det overførselsformat, der passer bedst til din virksomhed.
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_idstå tomt og bruge det sammeimport_unique_idsom 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. |
| 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.
- 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.
- Klik på Import øverst til højre.
- I afsnittet Importer en fil skal du klikke på Importer data.
- Klik på Avanceret import (alle objekter).
- Klik på Kontrakter under Objekter. Objektet Linjeposter vælges automatisk.
- Klik på Næste nederst til højre.
- 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.
- Klik på "Næste" nederst til højre.
- Kortlæg kolonnerne i importfilen til HubSpot-egenskaber. Få mere at vide om CSV-egenskabskortlægning.
- Klik på Næste nederst til højre.
- Indtast et navn til importen i feltet Importnavn.
- 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.
- Klik på rullemenuen "Datoformat", og vælg et datoformat.
- Klik på rullemenuen "Tidszone", og vælg en tidszone.
- Klik på rullemenuen " Talformat", og vælg et talformat.
- 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.
- Markér afkrydsningsfeltet »Berig poster« for at berige posterne under importen. Læs mere om berigelse af kontakt- og virksomhedsoplysninger.
- 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:
- Opdater eventuelle faktureringsdatoer til en fremtidig dato.
- 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:
- Opdater din CSV-fil med de nye ID'er.
- 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. |