Komfortkasse API v2
POST /order/{orderNumber}/invoice/{invoiceNumber}
Api key

Upload an invoice PDF (or similar) for an order.

If this is the first invoice submitted for the order and the shop is configured to send invoices by letter post, this call may also trigger Komfortkasse to send the invoice to the customer as a physical letter. Do not call this multiple times for the same invoiceNumber — repeat uploads of an existing invoice file are silently ignored, but you should still treat the call as non-idempotent for triggering side effects.

Path parameters

  • orderNumber string Required

    Order number (unique per shop).

  • invoiceNumber string Required

    Invoice number.

multipart/form-data

Body Required

  • file string(binary) Required

    Invoice file (PDF).

Responses

  • 200

    Invoice file accepted.

  • 400 application/json

    Invalid request — for example missing required fields or wrong format.

    Hide response attribute Show response attribute object
    • error string Required

      Error message.
  • 401 application/json

    Authentication failed — API key missing or invalid.

    Hide response attribute Show response attribute object
    • error string Required

      Error message.
  • 404 application/json

    Resource not found (e.g. unknown order number).

    Hide response attribute Show response attribute object
    • error string Required

      Error message.
POST /order/{orderNumber}/invoice/{invoiceNumber} 
curl \
 --request POST 'https://ssl.komfortkasse.eu/api/v2/order/123456/invoice/100072533' \
 --header "X-Komfortkasse-API-Key: $API_KEY" \
 --header "Content-Type: multipart/form-data" \
 --form "file=@file"
Response examples (400) 
{
  "error": "Invalid request"
}
Response examples (401) 
{
  "error": "API Key missing"
}
Response examples (404) 
{
  "error": "Order not found"
}