Place Orders
Overview
There are two ways to create orders in the Shirtigo Cockpit API. The best approach depends on your business model.
1. Order a Product
You create a product for each style in your collection upfront. When placing orders, you refer to the matching SKU of the existing productVariant. These products can also be transferred to integrations like Shopify.
Best for Fashion Brands (Limited Styles)
If you run a fashion brand with a limited number of styles, this is the recommended approach.
- Keeps your account organized.
- Enables detailed statistics and reporting.
In this case, you must create the predesigned product upfront and order the corresponding color-size variant. The SKU is generated by your system and can be retrieved using:
GET /projects/{project-reference}/products?include=projectProductColors
Note: Make sure to include
projectProductColorsin the request to get SKU details.
2. Order a Customized Base Product
You transfer all the necessary processing information along with the base_product_sku each time you place an order.
Best for Customization Businesses (Unique Designs)
If your business involves custom designs where each order is unique, this method is ideal.
- No need to pre-create products.
- Allows dynamic customization per order.
Simply match our base_product_sku or brand_product_sku with the blank product in your system.
You can find the SKUs in the color-size variant via the Catalog API or download our full catalog as an Excel file.
Order Requirements
To place an order, you must provide the following:
- Delivery Address (
delivery) – Required. - Sender Address (
sender) – Optional.
If not provided, the default address from your account will be used.
Note: The sender address must be a physically existing address in the country where the shipment is dropped off (Germany). - Product List – Either of the following formats:
amount + skuamount + base_product_sku + processings
Preventing Duplicate Orders
To prevent accidental duplicate orders, we strongly recommend setting:
"external_reference"– A unique reference for the order."check_unique_external_reference": true– Ensures that no orders exist for the given reference.
Processing Information (processings Object)
The processings object specifies the processing details (e.g., printing or embroidery).
Fields
| Field | Description |
|---|---|
processingarea_type | Defines which area of the product (e.g., front, back) will be processed. |
width / height | Dimensions in millimeters. |
design_reference | A pre-rendered design that has been created upfront. |
design_url | A URL linking directly to your design image. Ensure that the image is returned and not embedded in HTML. |
force_position | Overwrites the auto-positioning algorithm. Note: Printing textiles have a tolerance of +/-20mm. |
offset_top / offset_center | Adjusts design placement. |
Processing Options
Cropping
ignore_validation: Accepts files that do not meet the minimum resolution (1000px width or height).
⚠️ Note: The check is applied after cropping.
Extracting Size & Position
extract_size_and_position: Extracts print dimensions and positioning from the transferred file.- Assumes the file matches the base product processing area and is created at 300 DPI.
- You can override
offset_topandoffset_center.
Resizing
resize_to_processingarea: Resizes the design to fit the processing area.- First, reduces
offset_top. - Then, reduces the design dimensions if necessary.
- First, reduces
Order API Reference
To see the complete API documentation for placing an order, including request and response examples, refer to:
➡️ Place an Order – API Reference
Shipping Options
- If no shipping method is provided, the most economical option is automatically selected.
- If activated for your account, you can choose the shipping carrier and product manually.
- This option is only available for selected customers and must be activated by your key account manager.
This guide helps you understand and implement the Shirtigo Cockpit Order API effectively. For further details, refer to the official API documentation.