JTL API v1 – Korrekturrechnung PDF liefert Auftrag-Template statt Gutschrift-Template

thecorleone

Neues Mitglied
1. Juli 2026
3
1
Hallo zusammen,
da viele Endpunkte der JTL API v2 aktuell noch nicht fertiggestellt bzw. verfügbar sind, verwende ich derzeit für den Abruf des PDF-Inhalts einer Gutschrift noch den entsprechenden Endpoint der API v1:

Code:
v1/creditNotes/6/output/pdf

Der API-Aufruf funktioniert grundsätzlich und ich erhalte auch ein PDF zurück.

Allerdings wird dabei nicht das von mir für die Rechnungkorrektur angepasste Template/Layout verwendet. Stattdessen wird das Auftrag-Template ausgegeben.

Ich habe das Layout und Design der Gutschrift bereits entsprechend angepasst und würde erwarten, dass beim Aufruf des Rechnungkorrektur PDFs auch dieses Template verwendet wird.

Hat jemand von euch das gleiche Problem bzw. kann mir sagen, ob das Verhalten bei diesem Endpoint bekannt ist?

Oder gibt es eine bestimmte Einstellung bzw. einen anderen Endpoint, den ich verwenden muss, damit das für Gutschriften hinterlegte Template verwendet wird?

Verwendeter Endpoint:
v1/creditNotes/{id}/output/pdf

Vielen Dank schon einmal für eure Hilfe!

P.S.: Entschuldigt bitte, falls ich hier etwas übersehe. Ich beschäftige mich erst seit Kurzem mit JTL und der JTL API.
 

Morimus

Sehr aktives Mitglied
16. Mai 2019
727
185
Wenn du magst, poste gerne den vollständigen API-Request.
Also HTTP-Methode, URL einschließlich Query-Parametern und die relevanten Header.
Zugangsdaten und personenbezogene Daten bitte schwärzen.

Interessant wäre außerdem, ob Belegnummer und Positionen im API-PDF zur Rechnungskorrektur passen oder ob tatsächlich der zugehörige Auftrag ausgegeben wird.

Dann lässt sich besser unterscheiden, ob der falsche Beleg oder lediglich die falsche Vorlage verwendet wird.
 

thecorleone

Neues Mitglied
1. Juli 2026
3
1
Ich verwende folgenden Endpoint:

https://192.168.1.36:5883/api/Mandant_1/v1/creditNotes/1/output/pdf

Header:

Authorization: Wawi XXXXXXXXXXXXXXXXXXXXX
x-appid: MyApp
x-appversion: 1.0.0
Ich erhalte erfolgreich den Filestream Content als Ergebnis und kann diesen auch als PDF speichern. Allerdings wird dabei das falsche Formular/Template verwendet.

Wie bereits in meinem vorherigen Beitrag erwähnt, wird das PDF mit dem Template „Auftrag“ erstellt und nicht mit dem gewünschten Template „Rechnungskorrektur“.

Übrigens: Wenn ich in JTL-Wawi die Vorschau der Rechnungskorrektur öffne, wird das richtige Template bzw. Design angezeigt.
 

Anhänge

  • 1790605514662.png
    1790605514662.png
    69,6 KB · Aufrufe: 12
  • 1790606204322.png
    1790606204322.png
    5,6 KB · Aufrufe: 11
Zuletzt bearbeitet:

Morimus

Sehr aktives Mitglied
16. Mai 2019
727
185
Vorweg. Falls es sich irgendwie umsetzen lässt, steig auf die Cloud-API um.

Dein Aufruf enthält bislang keine Formular-ID.
Der PDF-Endpunkt unterstützt den optionalen Query-Parameter formId.

Also beispielsweise:
.../v1/creditNotes/1/output/pdf?formId=<ID>

Die numerische formId lässt sich aus Swagger nicht ablesen.
Falls du mehrere Vorlagen hast, könnte es daher notwendig sein, die entsprechende ID beispielsweise über die Datenbank zu ermitteln.
 

thecorleone

Neues Mitglied
1. Juli 2026
3
1
Vorweg. Falls es sich irgendwie umsetzen lässt, steig auf die Cloud-API um.

Dein Aufruf enthält bislang keine Formular-ID.
Der PDF-Endpunkt unterstützt den optionalen Query-Parameter formId.

Also beispielsweise:
.../v1/creditNotes/1/output/pdf?formId=<ID>

Die numerische formId lässt sich aus Swagger nicht ablesen.
Falls du mehrere Vorlagen hast, könnte es daher notwendig sein, die entsprechende ID beispielsweise über die Datenbank zu ermitteln.
Hi Morimus, danke für die Antwort.
Mir war dieser optionale Parameter aufgefallen, aber ich habe keinen Weg gefunden, an die formId zu kommen.
Ich werde versuchen, sie über die Datenbank zu finden.
Danke sehr.
 
  • Gefällt mir
Reaktionen: Morimus

Ähnliche Themen