REST API

Authorization

  • our base URL is:
 api.tdeu.de
  • Content-Type:
 application/json
  • X-API-Key:
 your X-API-Key
  • ClientSecret:
 your ClientSecret

POST Order

POST https://api.tdeu.de/v2019-10/orders

Please note: if you do not want to fill in some fields, please submit an empty string and do not leave out the whole object!

Request Parameters

order_number type: string required
min. length: 3; max. length: 45
forbidden Chars: # ; : . , " '
Order number
external_id type: string
max. length: 45
forbidden Chars: " '
Your Id, will be printed on your bill
creation_date type: DateTime required
Time that order was received at
currency type: string
max. length: 3 Default: EUR other see: ISO 4217
forbidden Chars: " '
Currency
allow_partial_delivery type: bool
default: false
Partial delivery allowed true/false
delivery_service type: long
max. length: 4
Delivery Service ID information
order_packing_sku type: string
max. length: 45 Default: EUR
forbidden Chars: " '
Special packaging for the whole order, requires further clarification and prior consultation
address_delivery required
Delivery address
address_sender required
Sender address, needs to be a german address. If you do not have a german address, see sender address information
address_bill
bill adress
positions type: array required
order positions
positions_packing_sku type: string
max. length: 45
forbidden Chars: " '
Special packaging for the individual position, requires further clarification and prior consultation.
order_item_id type: string
max. length: 35
forbidden Chars: " '
One-to-One id of your position-database, generated automatically if not specified.
quantity type: int required
max. length: 9
forbidden: everything other than numeric
quantity
price_duty type: double

required, when outside EU
forbidden: everything other than numeric
Price duty
sku type: string
max. length: 35
forbidden Chars: " '
Customer sku
name type: string
max. length: 35
forbidden Chars: " '
Sku name
base_article type: object required
article_number type: string
max. length: 35
forbidden Chars: " '
Article number / Product number, you can find the complete list of products in our Product List
images type: array required
Image Information
side type: string required
max. length: 3
forbidden Chars: " '
For further information see Printing Areas
printing_type type: long required
max. length: 4
For further information see Printing Types
image_url type: string required
max. length: 1000
forbidden Chars: " '
URL, Print-document only!, allowed extensions see Printing Types
preview_url type: string optional
max. length: 1000
forbidden Chars: " '
URL, Preview-document, allowed extensions: PNG JPG GIF

Request Sample

Responses

This section contains possible responses and further defines the response schema

Response Sample

Packstation

If you want to send Orders to a Packstation you need to pay attention to special features.

street : "Packstation"
street_number : The Number of the Packstation
care_of : Postnummer
zip_code : Zip-code of the Packstation
city : City of the Packstation
All packing stations can be found at Standortfinder

German Sender Address

If you do not have a german address to send your packages from, you can use our address as following:

company : Your company name
street : Grenzstraße
street_number : 15
zip_code : 06112
city : Halle

Field Lengths

last_name : 3-35 characters (last_name + first_name)
first_name : 3-35 characters (last_name + first_name)

Printing Types

Here you can find a summary of possible printing types.

printing_type ID printing_type description max size [x,y] resolution extension
0 unprinted textiles see our FAQ
2 digital direct-to-garment, on demand [4677px;5882px] 300dpi PNG TIF TIFF
32 sublimation sublimation, on demand [11811px;11811px] 300dpi PNG TIF TIFF

Image Information

Best results with following settings (Adobe Photoshop) For printing types 2 and 32

Image compresssion : LZW
Save transparency : yes
Pixel arrangement : Interleaved (RGBRGB)
Byte order : IBM PC
Layer compression : RLE

Printing Areas

Here you can find a summary of possible printing areas

side description
BM front
RM back
AL left arm
AR right arm
NI neck inside
NA neck outside

Delivery Service IDs

Here you can find information about the available delivery service IDs. If you prefer one of our optional services, you must provide the service ID. If no ID is provided, we will automatically assign a suitable delivery service based on the country code from our standard services.

ID description standard/optional
11 DHL package, up to 2kg, only when delivery country = DE standard
34 DHL Warenpost Premium International, up to 1 kg standard
32 DHL Warenpost, up to 1kg, only when delivery country = DE optional
39 DHL Express Economy, within Europe, up to 70 kg optional

Request Sample

Response Sample

GET Order

GET https://api.tdeu.de/v2019-10/orders/{orderNumber}

Request Parameters

order_number type: string
Order number

Request Sample

Responses

This section contains possible responses and further defines the response schema

Response Sample

Request Sample

Response Sample

GET Events

GET https://api.tdeu.de/v2019-10/orders/{orderNumber}/events

Request Parameters

order_number type: string required
min. length: 3; max. length: 45
Order number

Request Sample

Responses

This section contains possible responses and further defines the response schema

Response Sample

Request Sample

Response Sample

GET Stock

GET https://api.tdeu.de/v2019-10/stock/{sku}

Request Parameters

sku type: string required
max. length: 35
Customer sku

Request Sample

Responses

This section contains possible responses and further defines the response schema

Response Sample

Request Sample

Response Sample

POST Bulk Stock

POST https://api.tdeu.de/v2019-10/bulkStock

Request Parameters

sku type: string required
forbidden Chars: '

Request Sample

Responses

This section contains possible responses and further defines the response schema

Response Sample

Request Sample

Response Sample

GET Allstock

GET https://api.tdeu.de/v2019-10/allstock

Request Sample

Responses

This section contains possible responses and further defines the response schema

Response Sample

Request Sample

Response Sample

POST Cancel Order

POST https://api.tdeu.de/v2019-10/order/{OrderNumber}/cancel

Request Parameters

order_number type: string required
min. length: 3; max. length: 35
Order number

Request Sample

Responses

This section contains possible responses and further defines the response schema

Response Sample

Request Sample

Response Sample