Uwaga: Tłumaczenie tego artykułu jest podane wyłącznie dla wygody. Tłumaczenie jest tworzone automatycznie za pomocą oprogramowania tłumaczącego i mogło nie zostać sprawdzone. W związku z tym, angielska wersja tego artykułu powinna być uważana za wersję obowiązującą, zawierającą najnowsze informacje. Możesz uzyskać do niej dostęp tutaj.

Przenieś umowy do HubSpot

Data ostatniej aktualizacji: 23 lipca 2026

Dostępne z każdą z następujących podpisów, z wyjątkiem miejsc, w których zaznaczono:

Revenue Hub Professional, Enterprise

Wymagane stanowiska

Wymagana subskrypcja A Revenue Hub .

Wymagane stanowiska Revenue Hub miejsce w usłudze Revenue Hub.

Wymagane uprawnienia Do przeprowadzenia migracji wymagane są uprawnienia superadministratora.

Przenieś istniejące umowy ze starego systemu do HubSpot, aby zarządzać rozliczeniami, fakturowaniem i raportowaniem przychodów. Podczas migracji zachowane zostaną metody płatności, historia umów oraz przyszłe harmonogramy rozliczeń. Po migracji możesz korzystać z HubSpot jako scentralizowanego źródła wiarygodnych danych dotyczących przychodów z tytułu zawartych umów. Dowiedz się więcej o korzystaniu z umów w HubSpot.

Zanim zaczniesz

Zanim zaczniesz korzystać z tej funkcji, upewnij się, że w pełni rozumiesz, jakie kroki należy podjąć z wyprzedzeniem, a także jakie są ograniczenia tej funkcji i potencjalne konsekwencje jej użycia.

Zapoznaj się z wymaganiami

Uwaga: jeśli jesteś superadministratorem, możesz włączyć swoje konto do migracji rozliczeń do umów w Revenue Hub .
Twoje konto HubSpot musi korzystać z Stripe jako opcji przetwarzania płatności. Jeśli korzystasz z płatności HubSpot i chcesz przenieść metody płatności z zewnętrznego konta Stripe do płatności HubSpot, wypełnij ten formularz.
Sformatuj plik CSV zgodnie z wybranym procesem pobierania płatności i opcją ciągłości przychodów. Dowiedz się więcej o wyborze formatu migracji najlepiej dostosowanego do Twojej firmy.

Zapoznaj się z ograniczeniami i kwestiami, które należy wziąć pod uwagę

Jeśli korzystasz z funkcji ciągłości przychodów, przetestuj import w środowisku testowym. Jeśli do konta zostaną zaimportowane nieprawidłowe dane, nie będzie można skorygować danych historycznych w raportach kaskadowych dotyczących MRR.
Po aktywacji umowy HubSpot staje się systemem referencyjnym do celów rozliczeniowych. Migracji nie można cofnąć.
Wszelkie aktualizacje umów należy wprowadzać w HubSpot. Dowiedz się więcej o przeglądaniu umów i zarządzaniu nimi.
Po aktywacji możesz zaktualizować „Billing Start Date Override” (Nadpisanie daty rozpoczęcia rozliczeń) oraz „Payment Method ID” (Identyfikator metody płatności) tylko wtedy, gdy w umowie nie ma żadnych opłaconych faktur ani płatności.

Wybierz format migracji

Przed migracją wybierz format migracji w oparciu o to, w jaki sposób chcesz, aby HubSpot zarządzał umowami po migracji. Format migracji zależy od procesu gromadzenia danych oraz od tego, czy chcesz uwzględnić historyczne zdarzenia związane ze zmianami w umowach (np. aktualizacje lub rozszerzenia).

Proces pobierania płatności

Płatności ręczne: po migracji generowane są faktury, które nabywcy muszą opłacić ręcznie.
Płatności automatyczne: po migracji faktury są automatycznie rozliczane przy użyciu zarejestrowanej metody płatności.

Ciągłość przychodów

Brak ciągłości przychodów: umowy są importowane bez zdarzeń związanych ze zmianą przychodów.
Ciągłość przychodów: użyj kluczy rampowych, aby pogrupować pozycje w fazy i wyświetlić zdarzenia zmian (np. aktualizacje, rozszerzenia, obniżenia planu) na wykresie kaskadowym MRR w HubSpot. Jeśli korzystasz z ciągłości przychodów, przetestuj import w środowisku testowym. Jeśli do konta zostaną zaimportowane nieprawidłowe dane, nie będzie można skorygować danych historycznych w raportach kaskadowych MRR.

Rampy

Klucze ramp

Klucze ramp grupują wiele wierszy pozycji w fazy. Wiersze z tym samym kluczem rampy są traktowane jako jedna ciągła rampa.

W HubSpot każda faza rampy generuje zdarzenia MRR (np. nowa umowa, aktualizacja, rozszerzenie) w momencie rozpoczęcia każdej fazy. Kluczem rampy może być dowolny ciąg tekstowy (np. ramp-a). Ten sam ciąg musi być wspólny dla wszystkich wierszy tej rampy.

Struktura rampy

Aby pomyślnie przenieść rampy, należy je zorganizować w następujący sposób:

Nienakładające się zakresy dat: okresy obowiązywania w każdym wierszu nie mogą nakładać się na okresy obowiązywania w innym wierszu. Jeśli fazy rampy muszą być ciągłe, każda faza powinna rozpoczynać się w momencie zakończenia poprzedniej fazy.
Okresy obowiązywania w poszczególnych fazach: okres obowiązywania w każdym wierszu obejmuje wyłącznie daną fazę umowy, a nie cały okres obowiązywania umowy.
Całkowita ilość w każdym wierszu: wprowadź całkowitą ilość dla pozycji w tej fazie
Identyfikator importu klucza rampy: grupuje pozycje w ramach tej samej rampy. Dowiedz się więcej o tworzeniu niestandardowej właściwości rampy.

Uwaga:

Umowa może zawierać pozycje z okresem rozruchu oraz bez niego. W przypadku pozycji bez okresu rozruchu pozostaw pole ramp_key_import_id puste i użyj tego samego import_unique_id, co w powiązanych wierszach umowy.
Umowa może obejmować wiele produktów, których wartości są zwiększane niezależnie. Każdy produkt musi mieć własny identyfikator ` ramp_key_import_id. Każdy wzrost generuje własne zdarzenia MRR.

Na przykład w przypadku 12-miesięcznej umowy z zmianą ceny po trzech miesiącach:

Pozycja	Cena jednostkowa	Ilość	Okres obowiązywania	Data rozpoczęcia	ramp_key_import_id
Usługa miesięczna	100	1	3 miesiące	1 stycznia 2026 r.	`ramp-a`
Usługa miesięczna	100	2	9 miesięcy	1 kwietnia 2026 r.	`ramp-a`

Możliwe formaty migracji

Format migracji	Proces pobierania	Ciągłość przychodów
Płatności ręczne bez ciągłości przychodów	Płatności ręczne	Nie uwzględniono
Płatności ręczne z ciągłością przychodów	Płatności ręczne	Obejmuje
Płatności automatyczne bez ciągłości przychodów	Płatności automatyczne	Nie obejmuje
Płatności automatyczne z ciągłością przychodów	Płatności automatyczne	W zestawie

Przygotowanie do migracji

Przed rozpoczęciem migracji skonfiguruj swoje konto i przygotuj plik CSV zgodnie z wybranym formatem migracji.

Utwórz właściwości niestandardowe

Przed zaimportowaniem pliku CSV utwórz wymagane właściwości niestandardowe. Właściwości, które musisz utworzyć, zależą od wybranego formatu migracji. Dowiedz się więcej o tworzeniu właściwości niestandardowych.

Format migracji	Obiekt	Nazwa właściwości niestandardowej	Typ właściwości niestandardowej	Reguły walidacji	Służy do
Wszystkie opcje	Umowy	`import_unique_id`	Tekst w jednym wierszu	Wymagaj unikalnych wartości	Grupuje wszystkie wiersze należące do tej samej umowy.
Płatności ręczne z ciągłością przychodów lub Płatności automatyczne z ciągłością przychodów	Pozycje	`ramp_key_import_id`	Tekst w jednym wierszu	Brak	Grupuje wiele wierszy pozycji w fazy.

Skonfiguruj plik CSV

Skonfiguruj plik CSV, który będzie używany z narzędziem do importu w celu migracji umów do HubSpot.

Przykładowe pliki CSV

Skorzystaj z poniższych przykładowych plików CSV, w zależności od używanego formatu migracji.

Format migracji	Link do pliku CSV
Płatności ręczne, brak ciągłości przychodów	Pobierz
Płatności ręczne z ciągłością przychodów	Pobierz
Płatności automatyczne, brak ciągłości przychodów	Pobierz
Płatności automatyczne z gwarancją ciągłości przychodów	Pobierz
Model mieszany: jeden produkt z progresywną opłatą i jeden produkt z opłatą ryczałtową (bez klucza progresji)	Pobierz
Wiele niezależnych planów taryfowych: produkt A (`ramp-a`) i produkt B (`ramp-b`) mają oddzielne plany taryfowe	Pobierz

Format CSV

Plik CSV powinien zawierać następujące kolumny i właściwości HubSpot.

Nazwa kolumny	Obiekt	Właściwość	Szczegóły
Data wejścia w życie umowy	Umowa	`hs_contract_effective_date`	Data, od której umowa staje się prawnie wiążąca.
Kod waluty	Umowa	`hs_currency_code`	Kod waluty, np. USD.
Nazwa	Umowa	`hs_name`	Nazwa umowy.
Włączone rozliczenia HubSpot	Umowa	`hs_hubspot_billing_enabled`	Musi mieć `TRUE` dla wszystkich umów objętych migracją.
Proces windykacji	Umowa	`hs_collection_process`	Ręczny lub automatyczny. Musi być zgodny z formatem migracji.
Zmiana daty rozpoczęcia rozliczeń	Umowa	`hs_billing_start_date_override`	Data, od której HubSpot rozpoczyna rozliczanie. W przypadku migracji musi to być data przyszła. Wymagane dla wszystkich formatów migracji.
Identyfikator metody płatności	Umowa	`hs_external_payment_method_reference_id`	W przypadku płatności ręcznych pozostaw puste. Wymagane w przypadku płatności automatycznych.
E-mail	Kontakt	`email`	Adres e-mail osoby kontaktowej ds. rozliczeń.
Imię	Kontakt	`firstname`	Imię osoby kontaktowej ds. rozliczeń.
Nazwisko	Kontakt	`lastname`	Nazwisko osoby kontaktowej ds. rozliczeń.
Produkt	Pozycja	`hs_product_id`	Identyfikator rekordu produktu. Migracja odwołuje się do istniejącego rekordu produktu i nie tworzy nowego produktu
Nazwa pozycji	Pozycja	`name`	Nazwa pozycji.
Cena jednostkowa	Pozycja	`price`	Cena jednostkowa w walucie umowy.
Ilość	Pozycja	`quantity`	Ilość pozycji w danej fazie.
import_unique_id	Pozycja	Właściwość niestandardowa	Wspólny identyfikator dla wszystkich wierszy w tej samej umowie.
Termin	Pozycja	`hs_recurring_billing_period`	Okres obowiązywania pozycji. W przypadku stosowania okresów przejściowych należy wprowadzić okres dla każdego segmentu.
Częstotliwość rozliczeń cyklicznych	Pozycja	`recurringbillingfrequency`	Częstotliwość rozliczeń (np. co miesiąc).
Data rozpoczęcia pozycji	Pozycja	`hs_recurring_billing_start_date`	Data rozpoczęcia rozliczania pozycji.
ramp_key_import_id	Pozycja	Właściwość niestandardowa	Grupuje fazy pozycji w jedną rampę. Wymagane dla ciągłości przychodów. Pozostaw to pole puste w przypadku formatów migracji bez ciągłości przychodów.

Rozpocznij migrację

Po skonfigurowaniu pliku CSV możesz rozpocząć migrację umów do HubSpot.

Na koncie HubSpot kliknij Więcej, a następnie przejdź do Przychód > Kontrakty. Jeśli opcja Więcej się nie pojawia, przejdź bezpośrednio do sekcji Przychód > Kontrakty.
W prawym górnym rogu kliknij Importuj.
W sekcji „Importuj plik ” kliknij „Importuj dane”.
Kliknij opcję „Zaawansowany import (wszystkie obiekty)”.
W sekcji Obiekty kliknij Umowy. Obiekt pozycji zostanie wybrany automatycznie.
W prawym dolnym rogu kliknij Dalej.
Skonfiguruj sposób importu danych:
- Prześlij plik: przeciągnij i upuść lub kliknij „Wybierz plik”, a następnie wybierz plik do importu.
- Skopiuj i wklej: kliknij op cję „Wklej bezpośrednio z arkusza kalkulacyjnego” i wklej dane. Dane muszą być skopiowane z pliku arkusza kalkulacyjnego (np. Numbers, Arkusze Google).
- Język: jeśli importujesz dane w języku innym niż domyślny, kliknij menu rozwijane „Wybierz język nagłówków kolumn w pliku ” i wybierz język. Wybór właściwego języka pozwala HubSpot lepiej dopasować nagłówki kolumn do istniejących właściwości domyślnych. Jeśli w wybranym języku nie ma dopasowania, HubSpot wyszuka właściwość w języku angielskim, która będzie pasować.
W prawym dolnym rogu kliknij „Dalej”.
Przypisz kolumny w pliku importowym do właściwości HubSpot. Dowiedz się więcej o mapowaniu właściwości CSV.
W prawym dolnym rogu kliknij „Dalej”.
W polu „Nazwa importu ” wprowadź nazwę importu.
Kliknij menu rozwijane „Wybierz podstawę prawną przetwarzania danych kontaktu ” i wybierz podstawę prawną. Dowiedz się więcej o śledzeniu podstawy prawnej przetwarzania w HubSpot.
Kliknij menu rozwijane „Format daty ” i wybierz format daty.
Kliknij menu rozwijane „Strefa czasowa ” i wybierz strefę czasową.
Kliknij menu rozwijane „Format liczb ” i wybierz format liczb.
Zaznacz pole wyboru „Ustaw te kontakty jako kontakty marketingowe ”, jeśli chcesz angażować zaimportowane kontakty za pomocą narzędzi marketingowych HubSpot. Dowiedz się więcej o kontaktach marketingowych.
Zaznacz pole wyboru „Wzbogacaj rekordy”, aby wzbogacić rekordy podczas importu. Dowiedz się więcej o wzbogacaniu danych kontaktowych i firmowych.
W prawym dolnym rogu kliknij przycisk „Zakończ import”.

Rozwiązywanie problemów

Zapoznaj się z typowymi błędami importu i instrukcjami dotyczącymi ich rozwiązywania. Jeśli napotkasz inny błąd, sprawdź formatowanie pliku CSV i mapowanie właściwości, a następnie spróbuj ponownie przeprowadzić import.

Zastąpienie daty rozpoczęcia rozliczeń datą z przeszłości

Błąd „Data rozpoczęcia rozliczeń z przeszłości” występuje, gdy data rozpoczęcia rozliczeń pozycji w pliku CSV przypada w przeszłości.

Aby rozwiązać ten błąd:

Zaktualizuj wszystkie daty rozliczeniowe, ustawiając datę w przyszłości.
Zapisz plik CSV i uruchom import ponownie.

Nieprawidłowy lub brakujący identyfikator metody płatności Stripe

Ten błąd pojawia się, gdy jako proces pobierania opłat wybrano opcję automatycznych płatności, ale do pliku CSV nie dodano identyfikatora metody płatności Stripe.

Aby rozwiązać ten błąd, należy:

Zmień wpłaty z automatycznych na ręczne.
Dodaj identyfikator metody płatności Stripe dla pozycji dotyczących płatności automatycznych w pliku CSV.

Skopiuj identyfikator import_unique_id z poprzedniej próby

Jeśli import się nie powiedzie, HubSpot może nadal zarejestrować wartościimport_unique_id z nieudanego importu.