Skip to main content
POST
/
v1
/
channel
/
order
/
invoice
Upload Invoice
curl --request POST \
  --url https://scx-sbx.api.jtl-software.com/v1/channel/order/invoice \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/x-www-form-urlencoded' \
  --data '
{
  "invoice": {
    "type": "INVOICE",
    "sellerId": "4711",
    "orderId": "43523-43432-43532",
    "invoiceNumber": "<string>",
    "transactionDate": "2023-11-07T05:31:56Z",
    "taxCalculationDate": "2023-11-07T05:31:56Z",
    "currency": "<string>",
    "billingAddress": {
      "lastName": "Nym",
      "street": "Leyboldstrasse",
      "city": "Hürth",
      "country": "DE",
      "firstName": "Arno",
      "gender": "male",
      "companyName": "<string>",
      "houseNumber": "14a",
      "addition": "1. UG",
      "postcode": "50354",
      "phone": "+49 0221 123456",
      "state": "NRW"
    },
    "originalInvoiceNumber": "<string>",
    "transactionDetails": "<string>",
    "shipmentDate": "2023-11-07T05:31:56Z",
    "taxAddressRole": "shipFrom",
    "exportOutsideEu": true,
    "sellerVatNumber": "<string>",
    "buyerVatNumber": "<string>",
    "orderList": [
      {
        "orderId": "43523-43432-43532",
        "purchasedAt": "2023-11-07T05:31:56Z",
        "transactionItemList": [
          {
            "orderItemId": "<string>",
            "orderItemType": "ITEM",
            "totalGrossPriceWithDiscounts": 1,
            "totalNetPriceWithDiscounts": 1,
            "totalVatAmountWithDiscounts": 1,
            "vatRate": 1,
            "sku": "<string>",
            "title": "<string>",
            "quantity": 1,
            "discounts": [
              {
                "totalGrossPrice": 0,
                "totalNetPrice": 0,
                "totalVatAmount": 0,
                "name": "10% Winter Sale",
                "discountId": "D1265327",
                "vatRate": 0
              }
            ]
          }
        ]
      }
    ]
  },
  "document": "<string>"
}
'
{
  "errorList": [
    {
      "code": "GEN404",
      "message": "Not found",
      "severity": "error",
      "hint": null
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer JWT issued to a seller after they sign up for a JTL-Scx subscription via the JTL Customer Center. Usage format: Bearer <JWT>.

Body

multipart/x-www-form-urlencoded

Invoice metadata together with the binary PDF document for a marketplace order.

Multipart payload combining invoice metadata with the binary PDF document for upload.

invoice
object
required
document
file
required

The Invoice document as binary data must be type of PDF and have a maximum size of 16 MB.

Response

Invoice received