office-alexander-logistics/doc/KSeF/KSEF_CLIENT.md

ksef-client

Um die ksef-client Library nutzen zu können muss man eine relativ komplexe prozedur durchlaufen um Zugrifff darauf zu erhalen:

1. Personal Access Token (PAT) erstellen

Du brauchst einen GitHub-Token, damit dein Projekt das Paket aus GitHub Packages herunterladen darf.

So machst du das:

1. Klicke oben rechts auf GitHub auf dein Profil.
2. Gehe zu Settings.
3. Links unten: Developer settings.
4. Dann: Personal access tokens.
5. Dann: Tokens (classic).
6. Klicke: Generate new token (classic).

Beim Erstellen:

• Vergib irgendeinen Namen (z. B. „ksef-client access“).
• Wähle nur ein einziges Häkchen:

👉 read:packages

• Token generieren → Token kopieren! Du siehst ihn nur einmal.

2. Maven für GitHub Packages konfigurieren

Damit Maven die Pakete laden kann, musst du GitHub Packages in der Datei ~/.m2/settings.xml eintragen.

👉 Inhalt, den du einfügen musst:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
    <servers>
      <server>
            <id>github-cirfmf</id>
            <username>rsoika</username>
            <password>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</password>
       </server>

    </servers>
</settings>

3. Repository in deiner pom.xml eintragen

Füge das in deine pom.xml ein:

<repositories>
    <repository>
        <id>github-cirfmf</id>
        <url>https://maven.pkg.github.com/CIRFMF/ksef-client-java</url>
    </repository>
</repositories>

4. Abhängigkeit hinzufügen

Auch in die pom.xml:

 ..
        <dependency>
			<groupId>pl.akmf.ksef-sdk</groupId>
			<artifactId>ksef-client</artifactId>
			<version>3.0.4</version>
		</dependency>
...