Importera och exportera en kontrakts-CSV-fil
Du kan använda CSV-filen (komma-separerade-värden) för att importera kontrakt från en tredjeparts prenumerationsapp till Shopify Subscriptions-app eller exportera kontrakt från Shopify Subscriptions-app.
Se Öppna och redigera en CSV-fil för mer information om att använda CSV-filer.
På den här sidan
Ladda ner ett exempel på CSV-fil
Du kan ladda ner och visa ett exempel på kontrakt CSV-fil för att använda som mall.
Överväganden för kontrakt CSV-fil
Granska följande överväganden innan du använder en kontrakts-CSV-fil för att importera kontrakt.
Formatera CSV-filen
Verifiera att din kontrakts-CSV-fil uppfyller följande kriterier, så att den importeras korrekt:
- Den första raden i ditt kontrakts CSV-fil måste vara kolumnrubrikerna som anges i tabellen för kontrakts CSV-beskrivning.
- Varje kolumn måste separeras med komman.
- En CSV-fil får ha en maximal storlek på 10 MB.
Förstå användarnamnskolumnen
Användarnamnet används för att unikt identifiera varje kontrakt. Användarnamn används för att hantera data på följande sätt:
- Gruppera kontrakt med flera radobjekt: Kontrakt med flera radobjekt grupperas efter ett gemensamt användarnamnet.
- Förhindra duplicerade kontrakt: Duplicerade kontrakt ignoreras vid import. Om en rad med samma namn tidigare importerades hoppas den raden över i den nya importprocessen. Denna mekanism hjälper till att undvika duplicering av data.
Flera radobjektkontrakt
Kontrakt som innehåller flera radobjekt kräver en separat rad för varje radobjekt och grupperas tillsammans med användarnamnskolumnen.
Om ett kontrakt till exempel har tre radobjekt måste varje radobjekt läggas till som en separat rad. Den första raden innehåller all kontraktsinformation, och de kommande två raderna innehåller endast värden i följande kolumner:
- användarnamn
- line_variant_id
- line_quantity
- line_current_price
- Valfritt: line_selling_plan_id
- Valfritt: line_selling_plan_name
Användarnamnet måste vara identiskt för alla tre kolumnerna. Alla andra kolumner i rader två och tre måste vara tomma. Du kan ladda ner CSV-exempelmallen för att se ett exempel på ett kontrakt med flera radobjekt.
Beskrivning av csv-filen
Den information som används i kontrakt-CSV-filen ingår i följande kategorier: * Namnet på kontraktet * Kund- och faktureringsinformation * Leveransmetod och information * De artiklar som ingår i prenumerationen
Alla kolumner måste läggas till i CSV-filen för att de ska importeras korrekt, och alla fält krävs om inte annat anges.
| Kolumn | Beskrivning |
|---|---|
| Handle | Användarnamn är de unika identifierarna för varje kontrakt. Till exempel red-shirt. Användarnamn kan innehålla bokstäver och siffror och är vanligtvis en kombinerad sträng av bokstäver, siffror eller båda. Varje kontrakt måste ha ett unikt namn. |
| upcoming_billing_date | Det kommande faktureringsdatumet för kontraktet. Tiden är i UTC (Coordinated Universal Time) och måste formateras som ÅÅÅÅ-MM-DDTHH:MM:SSZ. Klockan 15.50 den 7 september 2019 i tidszonen UTC representeras till exempel som 2019-09-07T15:50:00Z. Datumvärdet för den kommande faktureringen måste ställas in på ett datum och en tid som är minst 24 timmar efter det datum och den tid då CSV-filen importeras. |
| customer_id | Kund-id. Id-numret måste matcha id-numret för en befintlig kund i Shopify-administratören och ska vara en siffersträng. Till exempel 6320530986896. |
| currency_code | Kontraktets valutakod. Valutakoden måste matcha en valuta som är aktiv i din butik. |
| status | Kontraktets status. Kontrakt kan ha en av följande statusar:
|
| cadence_interval | Prenumerationens leveransfrekvens. Ett kontrakt kan ha ett av följande kadensintervall:
|
| cadence_interval_count | Prenumerationens leveransfrekvens inom det övergripande tidsintervallet. Till exempel är kadensintervallet för varje månad 1 och kadensintervallet för varannan vecka är 2. |
| customer_payment_method_id | Id:t för den betalningsmetod som kunden använde för kontraktet. Id:t är en unik alfanumerisk kod. Till exempel 24e8c839c47ef47d30ad28346d130e74 |
| delivery_price | Priset för leveransen i korrekt valutaformat. |
| delivery_method_type | Prenumerationens leveransmetod. Leveransmetoden måste ha en av följande typer:
|
| delivery_address_first_name | Mottagarens förnamn på leveransadressen. Detta fält krävs endast för leveransmetoderna Frakt och Lokal leverans. |
| delivery_address_last_name | Sista namnet på leveransadressens mottagare. Detta fält krävs endast för metoder med Leverans och Lokal leverans. |
| delivery_address_address1 | Den första raden i leveransadressen. Detta fält krävs endast för leveransmetoderna Frakt och Lokal leverans. |
| delivery_address_address2 | Den andra raden i leveransadressen. Det här fältet krävs endast om adressen har ett andra fält och leveransmetoden är Frakt eller Lokal leverans. |
| delivery_address_city | Leveransadressens stad. Detta fält krävs endast för leveransmetoderna Frakt och Lokal leverans. |
| delivery_address_province_code |
ISO-koden för provins eller delstat i leveransadressen. Detta fält krävs endast för leveransmetoderna Frakt och Lokal leverans. |
| delivery_address_country_code |
ISO-koden för land i leveransadressen. Detta fält krävs endast för leveransmetoderna Frakt och Lokal leverans. |
| delivery_address_company | Företagsnamnet för leveransadressen. Detta fält krävs endast om ordern gäller ett företag och leveransmetoden är Frakt eller Lokal leverans. |
| delivery_address_zip | Leveransadressens postnummer. Detta fält krävs endast för leveransmetoderna Frakt och Lokal leverans. |
| delivery_address_phone | Telefonnumret till leveransadressen – till exempel +1 (613) 555-5555. Detta fält krävs endast för metoderna Leverans och Lokal leverans . |
| delivery_local_delivery_phone | Telefonnumret till leveransadressen. Detta fält krävs för prenumerationer med leveransmetoden Lokal leverans. |
| delivery_local_delivery_instructions | Instruktioner för Lokal leverans. Detta fält behöver endast inkluderas när anvisningar om prenumerationer med leveransmetoden Lokal leverans. |
| delivery_pickup_method_location_id | Plats-id för leveransmetoden upphämtning. Detta fält krävs endast för prenumerationer med leveransmetoden Lokal upphämtning. |
| line_variant_id | Id för varje radobjekt som ingår i prenumerationen – till exempel 53154087005812. Om det finns flera radobjekt som ingår i prenumerationen måste varje radartikel läggas till som en ny rad med ett unikt variant-id. |
| line_quantity | Kvantiteten för varje radobjekt som ingår i prenumerationen. Om det finns flera radobjekt som ingår i prenumerationen ska den tillagda kvantiteten vara för den specifika artikeln, inte den totala kvantiteten för alla artiklar som ingår. |
| line_current_price | Priset för prenumerationsposten i korrekt valutaformat. |
| line_selling_plan_id | Id för prenumerationsplanen – till exempel 3607724288. Detta fält är frivilligt. |
| line_selling_plan_name | Namnet på prenumerationsplanen. Detta fält är frivilligt. |
Importera avtal med en CSV-fil
Du kan använda en CSV-fil för att importera befintliga kontrakt från en berättigad tredjepartsprenumerationsapp från Shopifys appbutik eller från Shopifys prenumerationsapp i en annan butik.
En CSV-fil kan inte användas för att redigera eller skriva över befintliga kontrakt. Duplikat av befintliga kontrakt ignoreras vid import.
Importera kontrakt från en prenumerationsapp från tredjepart
Du kanske kan importera kontrakt från en prenumerationsapp från tredjepart. Överväg följande när du importerar från en tredjepartsapp:
- Om din prenumerationsapp från tredjepart inte är integrerad med Shopify-kassan kan du inte importera dina kontrakt.
- Du kan inte importera data direkt från din tredjepartsapp. Du måste lägga till kontraktsinformationen från din tredjepartsapp i en CSV som är kompatibel med Shopify Subscriptions-appen i rätt format för att kunna importera.
- Om din prenumerationsapp från tredjepart inte har en exportfunktion eller om den exporterade informationen inte innehåller alla nödvändiga uppgifter kontaktar du apputvecklaren för support.
Steg:
- Gå till Prenumerationer > Kontrakt från din Shopify-admin.
- Klicka på Importera.
- Klicka på Lägg till fil och välj sedan den CSV-fil som du vill importera.
- Klicka på Ladda upp fil.
När din CSV-fil har laddats upp får du ett bekräftelsemeddelande från Shopify till det e-postkonto du använt för att konfigurera din Shopify-butik. Läs lösningar på vanliga importfel för att lösa eventuella importproblem.
Exportera kontrakt med en CSV-fil
Du kan exportera dina kontrakt för att spara dem, eller importera dem till en annan Shopify-butik där du har appen Shopify Subscriptions installerad.
Steg:
- Gå till Prenumerationer > Kontrakt från din Shopify-admin.
- Klicka på Exportera.