Anhang hochladen

Mit diesem Endpunkt können Sie einen Anhang für einen Beleg hochladen.

Request

curl --request PUT \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/receipts/123/attachments' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
  "filename": "beleg_2024_11_15.pdf",
  "file_contents": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+PgplbmRvYmoKMiAwIG9iago8PC9UeXBlL1BhZ2VzL0NvdW50IDEvS2lkc1szIDAgUl0+PgplbmRvYmoKMyAwIG9iago8PC9UeXBlL1BhZ2UvTWVkaWFCb3hbMCAwIDYxMiA3OTJdL1BhcmVudCAyIDAgUj4+CmVuZG9iago..."
}'

Pflichtfelder

Die folgenden Felder sind beim Hochladen eines Anhangs erforderlich:

• filename (string): Der Name der hochzuladenden Datei
• file_contents (string): Base64-kodierte Dateiinhalte

Parameter

• id (integer, erforderlich): Die ID des Belegs, zu dem der Anhang hinzugefügt werden soll

Response

Erfolgreiches Hochladen

{
	"success": true
}

Das erfolgreiche Hochladen gibt ein Objekt mit success: true zurück.

Fehlercodes

• 401 Unauthorized: Ungültige oder fehlende Authentifizierung
• 404 Not Found: Beleg mit der angegebenen ID wurde nicht gefunden
• 500 Internal Server Error: Hochladen fehlgeschlagen

Hinweise

• Die Dateiinhalte müssen im Base64-Format kodiert sein
• Stellen Sie sicher, dass die Dateigröße die vom System erlaubten Limits nicht überschreitet
• Unterstützte Dateiformate sollten vor dem Hochladen überprüft werden
• Der filename sollte eine gültige Dateierweiterung enthalten (z.B. .pdf, .jpg, .png)

Beispiel mit Base64-Kodierung

Datei in Base64 kodieren (Bash)

base64 -i beleg.pdf

Vollständiges Beispiel

PUT /api/v1/receipts/123/attachments

{
	"filename": "rechnung_november.pdf",
	"file_contents": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+PgplbmRvYmoKMiAwIG9iago8PC9UeXBlL1BhZ2VzL0NvdW50IDEvS2lkc1szIDAgUl0+PgplbmRvYmoKMyAwIG9iago8PC9UeXBlL1BhZ2UvTWVkaWFCb3hbMCAwIDYxMiA3OTJdL1BhcmVudCAyIDAgUj4+CmVuZG9iago..."
}

Response:

{
	"success": true
}