> For the complete documentation index, see [llms.txt](https://docs4.simutek.se/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs4.simutek.se/artiklar/importera-papper.md).

# Importera papper

## XML (Kepa)

XML-filen måste följa formatet [paper-pricelist v2.0.0](https://github.com/scppc/paper-pricelist) samt [Simutek:s tilläggskrav för finpapper](https://github.com/simutek-ab/paper-pricelist-conformance).

{% hint style="success" %}
Detta är det rekommenderade formatet då det följer en standard och innehåller flest kontroller.
{% endhint %}

{% hint style="success" %}
Pappersleverantören kan i förväg försäkra sig att deras fil kommer att gå bra att importera i *GKS* genom att använda [online-validatorn](https://validator.simutek.se/).
{% endhint %}

#### Validering

Vid import av en XML-fil till GKS3 kommer först en validering att ske som säkerställer att all information finns tillgänglig och är korrekt så att artiklarna kan användas vid kalkylering. Upptäckts något problem kommer det kategoriseras enligt:

* **Varningar**. Dessa är enbart för kännedom. Importen kommer ändå gå att genomföra och kalkylering med artiklarna ska vara möjlig.
* **Fel**. Upptäcks någon artikel med fel kommer import av hela filen att nekas. Artiklar med fel saknar väsentlig information så att en kalkylering inte är möjlig eller skulle bli felaktig.

#### Steg för att importera en XML-fil

Gå i menyn *Salg > Importere papir*:

1. Ladda upp din prisfil genom att:
   1. Välj en Leverantör och ange ett prispåslag.
   2. Klicka på Choose File och välj din XML-fil.
   3. Klicka på **LAST OPP**. Vänta tills du tas till steg 2.
2. Kontrollera att filen är korrekt. Då ska det stå: `0 errors`.
3. Klicka på **IMPORT**.\
   Vänta medan importen pågår som kan ta upp till 5 minuter.
4. När importen är klar tas du till steg 3 och det visas:\
   **Prisfilen er importer.**

## Excel

Ett enklare format avsett för tryckeriets **egna papper**, det vill säga papper som inte kommer i en leverantörs prisfil.

Skillnader mot XML:

* Ett pris utan stafflingsnivåer (mängdrabatter).
* Färre uppgifter om pappret, till exempel ingen tjocklek eller minsta beställningskvantitet.

#### Steg för att importera en Excel-fil

Gå i menyn *Försäljning > Importera papper*:

1. Klicka på **Ladda ner Excel-mall** och fyll i dina papper. Spara filen som `.xlsx`.
2. Välj **Leverantör** och ange **Prispåslag** i procent.
3. Välj din fil och klicka på **LADDA UPP**.
4. Kontrollera att det står `0 errors` och klicka på **IMPORTERA**.

Precis som för XML nekas hela filen om någon rad innehåller ett fel. Varningar stoppar inte importen.

#### Kolumner

Rubrikerna ska stå på rad 1, exakt som i mallen (på engelska), och data börjar på rad 2. Endast det första bladet läses in och tomma rader hoppas över.

| Kolumn       | Krävs | Innehåll                                                                                                             |
| ------------ | ----- | -------------------------------------------------------------------------------------------------------------------- |
| Article No   | Ja    | Leverantörens artikelnummer. Måste vara unikt i filen. Artikelnumret i GKS blir leverantörens prefix + detta nummer. |
| Article Name | Ja    | Artikelnamn, max 100 tecken. Längre namn kapas.                                                                      |
| Grammage     | Ja    | Ytvikt i g/m². Heltal större än 0.                                                                                   |
| Width        | Ja    | Bredd i mm.                                                                                                          |
| Height       | Nej   | Höjd i mm. Fylls i för ark, lämnas tom för rulle.                                                                    |
| Sales Unit   | Ja    | Enheten som priset avser: `1000Sheets`, `Kg`, `Meter` eller `M2`.                                                    |
| Package Unit | Nej   | Förpackningsenhet, till exempel `PALL`.                                                                              |
| Package Qty  | Nej   | Antal per förpackning, till exempel `5000`.                                                                          |
| Price        | Ja    | Inköpspris per försäljningsenhet, se nedan. Tal större än 0.                                                         |

{% hint style="info" %}
Ange priser och mått som tal i cellerna, inte som text. Text måste ha punkt som decimaltecken, till exempel `125.50`.
{% endhint %}

#### Pris och försäljningsenhet

Price är alltid **inköpspriset (kostnaden)**. Priset mot kund räknas fram med det prispåslag som anges vid importen.

| Sales Unit   | Price avser                       | Måste vara ifyllt för rätt pris |
| ------------ | --------------------------------- | ------------------------------- |
| `Kg`         | Pris per kg                       | –                               |
| `1000Sheets` | Pris per 1000 ark                 | Width, Height och Grammage      |
| `Meter`      | Pris per löpmeter i angiven bredd | Width och Grammage              |
| `M2`         | Pris per m²                       | Grammage                        |

#### Vid omimport

Vid varje import tas **alla** pappersartiklar för den valda leverantören bort och ersätts med innehållet i filen. Det gäller även pappersartiklar som lagts upp för hand eller som importerats tidigare.

{% hint style="warning" %}
Lägg upp egna papper på en egen leverantör, till exempel "Eget papper". Annars försvinner de när leverantörens prisfil importeras nästa gång.
{% endhint %}