cURL

curl -X POST \
 /invoices/{id}/pdf \
 --header "Authorization: Bearer <token>" \
 --form "file=@invoice.pdf"

{
  "id": "<string>",
  "status": "<string>",
  "message": "<string>"
}

Invoice

Upload custom invoice PDF

Upload a custom-rendered PDF for an invoice that is currently in the Finalizing state. This endpoint is used by external PDF rendering engines that receive the invoice.pdf.generation_requested webhook.

Enterprise Feature: This endpoint requires the Custom PDF Rendering feature to be enabled.

After upload, Fynn will:

Optionally embed ZUGFeRD/Factur-X XML data (if configured)
Continue the invoice finalization process
Send notifications and trigger payment collection

^{Required permissions: invoice:write}

POST

invoices

{id}

pdf

cURL

curl -X POST \
 /invoices/{id}/pdf \
 --header "Authorization: Bearer <token>" \
 --form "file=@invoice.pdf"

{
  "id": "<string>",
  "status": "<string>",
  "message": "<string>"
}

Autorisierungen

Authorization

string

header

erforderlich

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Pfadparameter

string<uuid>

erforderlich

Invoice identifier

Body

multipart/form-data

file

erforderlich

The PDF file to upload

Antwort

PDF uploaded and invoice finalization continued

string

The invoice ID

status

string

The new invoice status

message

string

Success message

Finalize invoice Cancel invoice

Documentation Index

Autorisierungen

Pfadparameter

Body

Antwort