Skip to main content

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 projectProductColors in 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:

  • Delivery Address (delivery) – Required
    The destination for the shipment.

  • Sender Address (sender) – Optional
    If not provided, the default account address is used. Must be a valid physical address in Germany (shipment drop-off location).

  • Product List (products) – Required
    Provide one of the following formats:

    • amount + sku
    • amount + base_product_sku + processings

  • Documents (documents) – Optional
    Additional order documents can be included:

    • Merchant Invoice: Added for customs processing.
    • Delivery Receipt: Custom receipt (requires activation by key account).
    • Return Label: Pre-generated return label (requires activation by key account).
      • Available in DIN A4 (return sheet + label) or DIN A6 (shipping label only).
    • Shipping Label: User provided shipping label (only available for enterprise customers).

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​

FieldDescription
processingarea_typeDefines which area of the product (e.g., front, back) will be processed.
width / heightDimensions in millimeters.
design_referenceA pre-rendered design that has been created upfront.
design_urlA URL linking directly to your design image. Ensure that the image is returned and not embedded in HTML.
force_positionWhen set to true, ensures the provided positioning is used exactly as specified, without automatic adjustments.
offset_topControls the vertical offset from the top in millimeters. Higher values move the design downward.
offset_centerControls the horizontal offset from the center in millimeters.

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_top and offset_center.

Resizing​

  • resize_to_processingarea: Resizes the design to fit the processing area.
    • First, reduces offset_top.
    • Then, reduces the design dimensions if necessary.

For consistent and accurate print positioning across orders, consider these important details:

  • Size Considerations: Processing area dimensions of a baseproduct are based on size L products. For smaller sizes (S, M), the maximum print size may be automatically reduced.

  • Positioning Tolerance: Due to manual textile handling, expect a standard tolerance of ±20mm in positioning.

  • Precise Control: For exact placement control:

    1. Set force_position: true
    2. Specify both offset_top and offset_center
    3. Ensure values account for the ±20mm tolerance

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.