Opisy kolumn CSV zamówienia w aplikacji Transporter
Opisy kolumn dla pliku CSV zamówień.
Aby zaimportować zamówienia do Shopify za pomocą aplikacji Transporter, potrzebny jest plik CSV, który zawiera tylko ten typ rekordu.
Przykładowy plik CSV
Pobierz przykładowy plik CSV: orders.csv
Można użyć narzędzia wiersza polecenia aplikacji Transporter, aby wygenerować ten plik CSV lub utworzyć go samodzielnie na podstawie niżej opisanego formatu.
Opisy kolumn
W poniższej tabeli opisano nagłówki kolumn dla pliku CSV.
Kolumna | Opis | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Name (Required) |
Identyfikator zamówienia, który Ty widzisz na panelu administracyjnym Shopify, a klient na fakturze. Ten identyfikator musi być unikalny w Twoim sklepie. Np.; #1001 , 1001-A i SH1001 . Ta kolumna jest wymagana. |
||||||||||
Adres e-mail klienta. | |||||||||||
Financial Status | Status płatności powiązanych z zamówieniem. Prawidłowe wartości:
|
||||||||||
Fulfillment Status | Status zamówienia w odniesieniu do zrealizowanych pozycji. Prawidłowe wartości:
|
||||||||||
Currency | Kod z trzema literami (format ISO 4217) dla waluty używanej do płatności. Na przykład USD lub EUR . |
||||||||||
Buyer Accepts Marketing | Czy klient wyraził zgodę na otrzymywanie informacji marketingowych. Prawidłowe wartości:
|
||||||||||
Cancel Reason | Powód anulowania zamówienia. Prawidłowe wartości:
|
||||||||||
Cancelled At | Data i godzina (format ISO 8601) anulowania zamówienia. | ||||||||||
Closed At | Data i godzina (format ISO 8601) zamknięcia zamówienia. | ||||||||||
Tags | Ciąg rozdzielanych przecinkami tagów, które są używane do filtrowania i wyszukiwania. Każdy tag rozdzielany przecinkami może mieć maksymalnie 255 znaków. Np.: „Sprawdzone, zapakowane, dostarczone” . |
||||||||||
Note | Opcjonalna notatka dołączona do zamówienia. Tę notatkę może wyświetlić klient. Np. „Klient zmienił zdanie”.
|
||||||||||
Phone | Unikalny numer telefonu (format E.164) klienta. Numer telefonu można wprowadzić przy użyciu różnych formatów, ale każdy format musi reprezentować numer, który można wybrać z dowolnego miejsca na świecie. Obowiązują następujące formaty: 6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Referring Site | Witryna, w której klient kliknął link prowadzący do Twojego sklepu. Na przykład "http://www.anexample.com"
|
||||||||||
Processed At |
Data i godzina (format ISO 8601), kiedy zamówienie zostało pierwotnie utworzone na innej platformie. Ta wartość pojawia się na zamówieniu na panelu administracyjnym Shopify i jest to data używana w raportach sprzedaży. Wartością domyślną jest data i godzina importu zamówienia. Informacje na temat wartości, które wpływają na analizy finansów i płatności, znajdują się w sekcji |
||||||||||
Source name | Pochodzenie zamówienie (np. nazwa platformy). Tej wartości nie można edytować po zakończeniu importu. Np. Transporter . |
||||||||||
Total weight | Suma wszystkich wag pozycji (sformatowanych jako liczba całkowita) w gramach. Np. 11 . |
||||||||||
Total Tax | Suma wszystkich podatków (Podatek od ceny 1,..., Wysyłka 1 stawka podatku) dla zamówienia (musi być liczbą dodatnią). Ta kolumna jest wymagana, gdy podatek jest naliczany jako część zamówienia (na przykład, gdy istnieje wartość w kolumnie Podatek od ceny 1). Jeśli nie dodasz wartości w tej kolumnie, łączna wartość Twojego zamówienia nie będzie zawierać żadnych opłat podatkowych. | ||||||||||
Shipping Company | Nazwa firmy, jeśli istnieje w adresie wysyłki. | ||||||||||
Shipping Name | Imię i nazwisko osoby przypisanej do adresu wysyłki. Do adresu musi być przypisana nazwa. Może to być Shipping Name lub Shipping First Name i Shipping Last Name . |
||||||||||
Shipping Phone | Numer telefonu (format E.164) powiązany z adresem wysyłki. Numer telefonu można wprowadzić przy użyciu różnych formatów, ale każdy format musi reprezentować numer, który można wybrać z dowolnego miejsca na świecie. Obowiązują wszystkie formaty: 6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Shipping First Name | Imię osoby przypisanej do adresu wysyłki. Do adresu musi być przypisana powiązana z nią nazwa. Może to być Shipping First Name i Shipping Last Name lub Shipping Name . |
||||||||||
Shipping Last Name | Nazwisko osoby przypisanej do adresu wysyłki. Do adresu musi być przypisana powiązana z nią nazwa. Może to być Shipping First Name i Shipping Last Name lub Shipping Name . |
||||||||||
Shipping Address1 | Pierwsza linia adresu wysyłki. Ta kolumna jest wymagana dla adresu. Np. 150 Elgin St . |
||||||||||
Shipping Address2 | Opcjonalna linia adresu wysyłki. Np. Unit 202 . |
||||||||||
Shipping City | Nazwa miasta adresu wysyłki. Ta kolumna jest wymagana dla adresu wysyłki. Np. Ottawa lub Sydney . |
||||||||||
Shipping Province | Nazwa regionu klienta (np. prowincja, stan, prefektura lub terytorium). Jeśli dołączasz tę kolumnę, wymagana jest kolumna Shipping Province Code . Np.: Mexico city , Tasmania , New South Wales lub New York . |
||||||||||
Shipping Province Code | Kod przypisany do jednostki podziału administracyjnego (ISO 3166-2 ) dla regionu, takiego jak stan, prowincja, prefektura lub terytorium w kraju. Ta kolumna jest wymagana, jeśli dołączasz kolumnę Shipping Province . Kod ISO3116-2 składa się z następujących części:
|
||||||||||
Shipping Zip | Kod pocztowy dla adresu klienta. Na przykład K2P 1L4 , 90210 lub 110 012 . |
||||||||||
Shipping Country | Nazwa kraju w adresie wysyłki. Ta kolumna jest wymagana dla adresu. Np.: Kanada, Indie lub Australia. | ||||||||||
Shipping Country Code | Dwuliterowy kod (ISO 3166-1 Alpha-2) dla kraju adresu klienta. Na przykład CA dla Kanady. Podaj Shipping Country code nawet, jeśli podajesz Shipping Country . |
||||||||||
Billing Company | Firma osoby przypisanej do adresu rozliczeniowego. | ||||||||||
Billing Name | Imię i nazwisko klienta przypisanego do płatności. Adres musi mieć powiązaną z nim nazwę. Może to być Billing Name lub Billing First Name i Billing Last Name . |
||||||||||
Billing Phone | Numer telefonu (format E.164) powiązany z adresem rozliczeniowym. Numer telefonu można wprowadzić przy użyciu różnych formatów, ale każdy format musi reprezentować numer, który można wybrać z dowolnego miejsca na świecie. Obowiązują następujące formaty: 6135551212 +16135551212 (613)555-1212 +1 613-555-1212
|
||||||||||
Billing First Name | Imię osoby przypisanej do metody płatności. Adres musi zawierać powiązaną nazwę. Może to być Billing First Name i Billing Last Name lub Billing Name . |
||||||||||
Billing Last Name | Nazwisko osoby przypisanej do metody płatności. Adres musi zawierać powiązaną nazwę. Może to być Billing First Name i Billing Last Name lub Billing Name . |
||||||||||
Billing Address1 | Pierwsza linia adresu rozliczeniowego. Np. 150 Elgin St . Ta kolumna jest wymagana dla adresu rozliczeniowego. |
||||||||||
Billing Address2 | Opcjonalna linia adresu rozliczeniowego. Np. Unit 202 . |
||||||||||
Billing City | Nazwa miasta adresu rozliczeniowego. Ta kolumna jest wymagana dla adresu rozliczeniowego. Np. Ottawa , Delhi i Auckland . |
||||||||||
Billing Province | Nazwa regionu (np. województwo, stan, prefektura lub terytorium), w którym znajduje się adres rozliczeniowy. Jeśli dodasz tę kolumnę, wymagana jest kolumna Shipping Province Code . Na przykład: miasto Meksyk , Nowy Jork lub Nunavut i Nowa Południowa Walia . |
||||||||||
Billing Province Code | Kod jednostki podziału administracyjnego (ISO 3166-2) dla regionu, takiego jak stan, prowincja, prefektura lub terytorium w kraju. Ta kolumna jest wymagana, gdy podasz kolumnę Billing Province . Kod ISO3116-2 składa się z następujących części:
|
||||||||||
Billing Zip | Kod pocztowy adresu rozliczeniowego. Np. K2P 1L4 . |
||||||||||
Billing Country | Nazwa kraju adresu rozliczeniowego. Ta kolumna jest wymagana dla adresu rozliczeniowego. Np.: Kanada , Indie i Niemcy . |
||||||||||
Billing Country Code | Dwuliterowy kod (ISO 3166-1 Alpha-2) dla kraju adresu rozliczeniowego. Na przykład CA dla Kanady. Podaj Country code , nawet jeśli podajesz Country . |
||||||||||
Lineitem name (Required) |
Nazwa zamówionego wariantu produktu. Na przykład Niebieska koszulka . Ta kolumna jest wymagana. |
||||||||||
Lineitem variant ID | Identyfikator wariantu produktu, który został zamówiony. Użyj tej kolumny, aby połączyć pozycję w tym zamówieniu z wariantem produktu, który istnieje w Twoim sklepie. Na przykład 7513594 . Musisz upewnić się, że ID w tej kolumnie pasuje do ID wariantu produktu ze sklepu lub pozostaw tę kolumnę pustą. Jeśli aplikacja Transporter nie może znaleźć w Twoim sklepie wariantu produktu, który odpowiada ID w tej kolumnie, nie ma on wpływu na import. Produkt zostanie jeszcze dodany do zamówienia, ale nie zostanie dopasowany do produktu w Twoim sklepie w celach analitycznych. |
||||||||||
Lineitem quantity | Liczba zamówionych wariantów produktu. Ta kolumna akceptuje tylko dodatnie liczby całkowite. Wartość domyślna to 1. Na przykład 3 . |
||||||||||
Lineitem price (Required) |
Cena wariantu produktu przed zastosowaniem rabatów. Na przykład, 10,50 ,25 i 30 . Ta kolumna jest wymagana. |
||||||||||
Lineitem variant title | Konkretny wariant produktu. Na przykład Mały . |
||||||||||
Lineitem compare at price | Porównanie lub sugerowana cena wariantu produktu. Na przykład 15 . |
||||||||||
Lineitem sku | Numer jednostki magazynowania (SKU) produktu (wariantu produktu). | ||||||||||
Lineitem requires shipping | Czy wariant produktu wymagał wysyłki. Prawidłowe wartości:
|
||||||||||
Lineitem taxable | Czy wariant produktu podlegał opodatkowaniu. Prawidłowe wartości:
|
||||||||||
Lineitem fulfillment status | Status realizacji pojedynczych pozycji zamówienia. Prawidłowe wartości:
|
||||||||||
Taxes Included | Ustalenie, czy podatki zostały uwzględnione w oryginalnym zamówieniu. Prawidłowe wartości:
|
||||||||||
Tax 1 Title | Nazwa pierwszego naliczonego podatku. Np. HST lub VAT . |
||||||||||
Tax 1 Price | Kwota (ISO 4217) podatku naliczona dla pozycji zamówienia. Np. 1,50 . Jeśli istnieje wartość dla tej kolumny, należy także dołączyć kolumnę Total Tax . |
||||||||||
Tax 1 Rate | Stawka (wartość dziesiętna) podatku naliczana na pozycje. Np. ,07 w przypadku 7-procentowej stawki podatku. |
||||||||||
Tax 2 Title | Nazwa drugiego naliczanego podatku. | ||||||||||
Tax 2 Price | Kwota (ISO 4217) podatku do naliczenia. Jeżeli istnieje wartość dla tej kolumny, należy także dołączyć kolumnę Total Tax . |
||||||||||
Tax 2 Rate | Stawka podatku naliczona dla pozycji. | ||||||||||
Tax 3 Title | Nazwa trzeciego naliczanego podatku. | ||||||||||
Tax 3 Price | Kwota (ISO 4217) podatku naliczona dla pozycji zamówienia. Jeśli istnieje wartość dla tej kolumny, należy także dołączyć kolumnę Total Tax . |
||||||||||
Tax 3 Rate | Stawka podatku naliczona dla pozycji. | ||||||||||
Transaction Amount | Kwota (wartość dziesiętna) pieniędzy ustalona dla transakcji. Np. 50,00 . Ta kolumna jest wymagana w przypadku częściowej płatności lub częściowego zwrotu. |
||||||||||
Transaction Kind | Typ transakcji. Ta kolumna jest wymagana, jeśli dołączono jedną z kolumn transakcji. Prawidłowe wartości:
|
||||||||||
Transaction Status | Status transakcji. Prawidłowe wartości:
|
||||||||||
Transaction Processed At |
Data i godzina (format ISO 8601) pierwotnego wykonania transakcji na innej platformie. Ta wartość pojawia się w zamówieniu na panelu administracyjnym Shopify i jest to data używana w raportach finansowych. Wartością domyślną jest data i godzina zaimportowania zamówienia. Jeśli otrzymałeś(-aś) płatność w tym samym czasie, gdy zamówienie zostało utworzone, wartości |
||||||||||
Transaction Gateway | Nazwa bramki, poprzez którą transakcja została wyprowadzona. Listę bramek można znaleźć na stronie Bramki płatnicze Shopify. | ||||||||||
Transaction Location ID | Identyfikator lokalizacji, w której dokonano transakcji. Ten identyfikator musi być zgodny z identyfikatorem lokalizacji ustawionym w Twoim sklepie. Wartości, które nie pasują do identyfikatorów lokalizacji transakcji w sklepie, nie są importowane. | ||||||||||
Transaction Source Name | Pochodzenie transakcji. Przykładowe wartości: web , pos , iphone i android . |
||||||||||
Shipping Line Code | Odwołanie do metody wysyłki. Wartością domyślną jest Shipping line title . |
||||||||||
Shipping Line Price | Wartość metody wysyłki. Ta kolumna jest wymagana, jeśli dołączona jest kolumna Shipping line title . |
||||||||||
Shipping Line Source | Miejsce nadania przesyłki. | ||||||||||
Shipping Line Title | Tytuł metody wysyłki. Ta kolumna jest wymagana, jeśli dołączona jest kolumna Shipping line price . |
||||||||||
Shipping Line Carrier Identifier | Identyfikator usługi przewoźnika, który podał stawkę wysyłki. Wartość jest zwykle potrzebna w przypadku korzystania z usługi zewnętrznego przewoźnika. | ||||||||||
Shipping Line Requested Fulfillment Service ID | Identyfikator usługi realizacji żądającej metody wysyłki. Wartość jest zwykle potrzebna, gdy metoda wysyłki wymaga przetworzenia przez usługę realizacji wykonywaną przez firmę zewnętrzną. | ||||||||||
Shipping Tax 1 Title | Nazwa podatku naliczonego dla pozycji wysyłki. Np. HST . |
||||||||||
Shipping Tax 1 Rate | Stawka podatku (wartość dziesiętna) naliczana dla pozycji wysyłki. Np. 0,15 dla 15% (procent) stawki podatku od wysyłki. |
||||||||||
Shipping Tax 1 Price | Kwota (format ISO 4217) podatku naliczanego dla pozycji wysyłki. Jeśli istnieje wartość dla tej kolumny, należy także dołączyć kolumnę Total Tax . Np. 1,50 . |
||||||||||
Discount Code | Kod rabatowy. Ta kolumna jest wymagana, jeśli dołączona jest kolumna Discount type . |
||||||||||
Discount Amount |
Wartość rabatu w walucie sklepu, która została odjęta od zamówienia. Ta kolumna jest wymagana, jeśli dołączona jest kolumna Upewnij się, że wprowadzona wartość odpowiada |
||||||||||
Discount Type |
Typ rabatu. Prawidłowe wartości:
W wartościach jest rozróżniana wielkość liter. Rabatów nie można stosować do określonych pozycji w zamówieniu. Aby dowiedzieć się więcej, zapoznaj się z tematem Importowanie rabatów. |
||||||||||
Metafield Namespace | Kontener dla zbioru metapól. Aby zaimportować metapola, musisz podać wartości we wszystkich 4 kolumnach metapól (Metafield Namespace , Metafield Key , Metafield Value i Metafield Type ). Zdefiniuj niestandardową przestrzeń nazw dla swoich metapól, aby odróżnić je od przestrzeni nazw używanych przez aplikacje i Shopify (łącznie z domyślną wartością global ). Maksymalna długość: 20 znaków. |
||||||||||
Metafield Key | Nazwa meta pola. Maksymalna długość: 30 znaków. Ta kolumna jest wymagana, jeśli dołączone są inne kolumny meta pola. | ||||||||||
Metafield Value | Informacje, które mają być przechowywane jako metadane. Ta kolumna jest wymagana, jeśli dołączone są inne kolumny meta pola. | ||||||||||
Metafield Type | Typ informacji meta pola. Prawidłowe wartości:
|
Nazwa pliku
Nazwa pliku CSV musi zawierać słowo order
(nazwa zawartego w nim typu obiektu). Np. myorders.csv. Plik musi mieć format UTF-8.
Adresy
Adres wysyłki w zamówieniu staje się domyślnym adresem klienta. Podczas importowania zamówienia, do którego jest przypisany klient aplikacja Transporter wyszukuje klienta w Twoim sklepie Shopify:
- Jeśli transporter znajdzie klienta, zamówienie jest powiązane z klientem, a adres wysyłki w zamówieniu jest ustawiony jako domyślny adres klienta.
- Jeśli Transporter nie znajdzie klienta, klient zostanie dodany i powiązany z zamówieniem.
Kilka transakcji
Dodatkowe transakcje można dodać do zamówienia, tworząc oddzielne wiersze dla każdej z nich. W każdym wierszu należy dołączyć Order name
, aby połączyć transakcje z zamówieniem.
Status realizacji zamówienia
Status realizacji zamówienia powinien być określany na podstawie statusu realizacji pozycji, które tworzą to zamówienie:
- Jeśli żadna pozycja zamówienia nie zostanie zrealizowana, pole statusu realizacji zamówienia powinno pozostać puste, aby wskazać, że zamówienie nie zostało zrealizowane.
- Jeśli pojedyncze pozycje mają dowolną kombinację statusów (
fulfilled
lubunfulfilled
), zamówienie powinno mieć status realizacjipartial
. - Jeśli wszystkie pojedyncze pozycje zostaną zrealizowane, zamówienie powinno mieć status realizacji
fulfilled
.
Importowanie rabatów
Rabaty można stosować tylko na poziomie zamówienia, a nie do określonych pozycji w zamówieniu. Jeśli masz zamówienie, w którym zastosowano rabaty w odniesieniu do danych pozycji, ustal całkowitą kwotę rabatu i zastosuj ją do całego zamówienia. Dzięki temu raporty dotyczące sprzedaży są dokładne.