Place Order

Submits a new order. Each order can include any number of designs and standalone logos.

Designs vs. Logos #

Designs are complete kits that Jet Sport produces. Jet Sport applies the design (and every logo that's part of it) onto the clothing — you receive finished garments. Use the `designs` array for these.

Logos are standalone logo items (e.g., heat transfers, embroidery patches) produced separately and shipped to you as loose items, not applied to any garment. Use the `logos` array when you want logo stock to apply yourself or hold for later.

A design always includes its own logos automatically. You don't need to add the design's logos to the `logos` array — they come with the design. Only use `logos` when you want logos shipped on their own.

POST /api/orders

Headers #

Note: Including an Idempotency-Key is strongly recommended for production use to prevent duplicate orders on network retries.

Body #

At least one of `designs` or `logos` must contain at least one entry.

Delivery Address Object #

Design Object #

Each entry in the `designs` array represents one design ordered, with one or more size/quantity instances.

Supply either `designId` or `designMul`. The design must be finalized (status "Done") and accessible to your vendor.

Instance Object #

Represents a single garment configuration: a size, a quantity, and (for designs with NameLogo / NumberLogo placeholders) the typed values to apply.

Logo Value Object #

If the same logo is placed multiple times on a design (e.g., a player name on Front and Back), the typed value applies to all placements — you cannot set different values per placement.

Logo Object #

Each entry in the `logos` array orders a logo on its own (e.g., a transfer with no design). The shape depends on the logo type.

Supply either `logoId` or `logoSku`. For NumberLogo, supply `digits` instead of `quantity`/`value`.

Digit Object #

For NumberLogo bare orders. Each entry orders a number to be applied N times — the system splits multi-digit values into the individual digit transfers automatically.

Example Request #

{
  "reference": "PO-2026-0042",
  "comment": "The clothes should be at Jet Sport by monday",
  "originOfDelivery": "Tee Jays Warehouse",
  "email": "vendor@example.com",
  "contactName": "Peter Smith",
  "deliveryAddress": {
    "name": "Football Club ABC",
    "address": "Stadium Road 1",
    "zip": "8800",
    "city": "Viborg",
    "country": "DK",
    "contactPerson": "Peter Smith"
  },
  "designs": [
    {
      "designId": 299571,
      "instances": [
        { "size": "M", "quantity": 1 },
        { "size": "L", "quantity": 1 },
        { "size": "XL", "quantity": 5 }
      ]
    },
    {
      "designId": 298791,
      "instances": [
        {
          "size": "M",
          "quantity": 5,
          "name": "Smith",
          "number": "10"
        },
        {
          "size": "L",
          "quantity": 7,
          "name": "Jones",
          "number": "27"
        }
      ]
    }
  ],
  "logos": [
    {
      "logoId": 100113,
      "quantity": 18
    },
    {
      "logoId": 494679,
      "digits": [{ "digit": "1", "quantity": 5 }]
    }
  ]
}

Returns #

Returns `202 Accepted`. The order has been queued for placement. Use the returned `id` with the Retrieve an Order endpoint to poll for completion.

{
  "id": 4711,
  "orderNumber": "20002502",
  "status": "Pending"
}