> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SFTP-datastruktur

## 1. Introduktion

Denne dokumentation beskriver, hvordan du strukturerer dine datafiler — **produkter**, **ordrer**, **returneringer** og relaterede data — i vores SFTP-miljø, når dit dedikerede rum er klargjort.

Hvis du driver flere butikker eller har flere miljøer (prod, preprod osv.), skal du oprette en separat undermappe for hver (det kan også være forskellige brands, forskellige lande osv.).

### Eksempel på mappestruktur

```
/root_space
    /shop_fr
    /shop_en
    /shop_it
```

***

## 2. Dataoverførselsplan

Datafiler bør ideelt set overføres **dagligt** mellem:

* **02:00**
* **05:00**

Dette tidsrum sikrer optimal behandling og dataindsamling.

***

## 3. Filorganiseringsstandarder

I hver butikmappe skal du oprette følgende mapper:

* `products`
* `orders`
* `returns`
* `return_reasons` (valgfri)
* `misc` (valgfri)

**Bemærkninger:**

* Mappen `return_reasons` bruges til eksportfiler med yderligere returdata såsom årsager angivet af kunder. Disse eksporter er valgfrie.
* Mappen `misc` kan indeholde diverse filer. Hvis du ønsker at bruge denne mappe, bedes du drøfte hierarkiet og strukturen med os på forhånd for at sikre kompatibilitet.

Hver eksport skal placeres i den passende mappe og **nul-dateret** ved hjælp af et tidsstemplet filnavn.

### Eksempel på filnavnsformat

```
products_2025-01-15T02-00-00.csv
```

***

## 4. Krav til eksportindhold

En detaljeret specifikation af forventede felter, formater og begrænsninger for hver datasetkategori er tilgængelig i dokumentationen **Dataoverførsler: Skabelon**.

**Nøglekrav til produktkatalogseksporter:**

* Eksportér **alle produktvarianter**, inkl. udsolgte varer
* Inkludér et **felt for seneste ændringsdato** til inkrementel behandling
* Vedligehold komplet variantinformation for at muliggøre korrekt størrelsesanalyse
* Tilføj valgfrit et deaktiveringsflag til Kleep-tilstedeværelseskontrol

Se venligst skabelonen for omfattende feltdefinitioner og eksempler.

***

## 5. Håndtering af gentagne data på tværs af eksporter

Poster kan legitimt forekomme i flere daglige eksporter. F.eks. kan en given returnering være inkluderet flere gange på tværs af forskellige filer.

Vores indsamlingssystem håndterer automatisk deduplikering og behandler kun den **seneste version** af hver post.

***

## 6. Retningslinjer for dataformat

Alle eksporter bør leveres i **CSV**-format.

Excel-filer (`.xlsx`) frarådes, da de introducerer formateringsinkonsekvenser og kan komplicere automatiserede indsamlingsworkflows.

* **Datetime:** Brug ISO 8601-format: `YYYY-MM-DDTHH:MM:SSZ`, eksempel: `2025-01-15T14:30:00Z`
* **Kodning:** UTF-8-kodning for alle tekstfelter, escap specialtegn korrekt i CSV
* **Booleske værdier:** Brug `true`/`false` (med små bogstaver) eller `True`/`False`
* **Decimalværdier:** Brug punktum (`.`) som decimalseparator. Eksempel: `129.99` ikke `129,99`
* **Null-værdier:** Tom streng for manglende valgfrie tekstfelter i CSV'er, brug null i JSON'er

### Filnavnskonvention

***

Som specificeret i SFTP-datastrukturdokumentationen skal du bruge følgende format:

```
{data_type}_{timestamp}.csv
```

Eksempler:

* `products_2025-01-15T02-00-00.csv`
* `orders_2025-01-15T02-00-00.csv`
* `returns_2025-01-15T02-00-00.csv`

***

## 7. Eksport af historiske data

Hvis du skal levere **historiske data** (dvs. data, der ikke er en del af de daglige eksporter), kan du eksportere op til **ét år af historiske poster** for alle datatyper, inkl.:

* **Produkter**
* **Ordrer**
* **Returneringer**

Historiske datasæt kan overføres enten **via SFTP** eller, hvis det er mere belejligt, **via et andet aftalt medie**.

# Eksempel på en komplet SFTP-struktur

```
/root_space
    /shop_fr
        /products
            products_2025-01-15T02-00-00.csv
            products_2025-01-16T02-00-00.csv
        /orders
            orders_2025-01-15T02-00-00.csv
            orders_2025-01-16T02-00-00.csv
        /returns
            returns_2025-01-15T02-00-00.csv
            returns_2025-01-16T02-00-00.csv
        /return_reasons
            return_reasons_2025-01-15T02-00-00.csv  (valgfri)
        /misc
            (valgfri, drøft venligst hierarki med os)

    /shop_en
        /products
        /orders
        /returns
        /return_reasons
        /misc

    /shop_it
        /products
        /orders
        /returns
        /return_reasons
        /misc

```

***