Potisk triček a textilu na míru (ČR) — katalog, ceny, příprava designu a objednávky.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Stornuje NEZAPLACENOU objednávku, která ještě není ve výrobě — stejně jako tlačítko na stránce stavu (zákazník dostane e-mail o stornu, otevřená platba kartou se zavře). Zaplacenou objednávku stornovat nejde (napiš na [email protected]). Jen se statusToken a jen na výslovný pokyn zákazníka.
statusToken z create_order (poslední část statusUrl) — plný přístup
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Stornuje NEZAPLACENOU objednávku, která ještě není ve výrobě — stejně jako tlačítko na stránce stavu (zákazník dostane e-mail o stornu, otevřená platba kartou se zavře). Zaplacenou objednávku stornovat nejde (napiš na [email protected]). Jen se statusToken a jen na výslovný pokyn zákazníka.
| Argument | Type | Description |
|---|---|---|
| statusToken* | string | statusToken z create_order (poslední část statusUrl) — plný přístup |
{
"type": "object",
"required": [
"statusToken"
],
"properties": {
"statusToken": {
"type": "string",
"description": "statusToken z create_order (poslední část statusUrl) — plný přístup"
}
}
}Zvaliduje a uloží design (logo/text na stranách trička): vrátí vrstvy s nahranými URL pro create_order, orientační příplatek za potisk a previewUrl — odkaz, kde zákazník uvidí návrh na tričku v konfigurátoru (a může ho tam i sám objednat).
| Argument | Type | Description |
|---|---|---|
| layers* | array | vrstvy: {type:'image'|'text', side:'front'|'back'|'sideLeft'|'sideRight', x,y,width,height v % 0–100, rotation?, src? (https URL nebo data:URL obrázku), text?, fontFamily?, fontSize?, fill?} |
| colorId | string | |
| product* | string | |
| previewBackDataUrl | string | |
| previewFrontDataUrl | string |
{
"type": "object",
"required": [
"product",
"layers"
],
"properties": {
"layers": {
"type": "array",
"items": {
"type": "object"
},
"description": "vrstvy: {type:'image'|'text', side:'front'|'back'|'sideLeft'|'sideRight', x,y,width,height v % 0–100, rotation?, src? (https URL nebo data:URL obrázku), text?, fontFamily?, fontSize?, fill?}"
},
"colorId": {
"type": "string"
},
"product": {
"type": "string"
},
"previewBackDataUrl": {
"type": "string"
},
"previewFrontDataUrl": {
"type": "string"
}
}
}Založí ZÁVAZNOU objednávku (čeká na platbu). paymentMethod 'bank_transfer' (výchozí) vrátí číslo účtu, variabilní symbol a QR; 'card' vrátí paymentUrl — zabezpečenou stránku Stripe pro tuto objednávku, kde zákazník sám zadá kartu (agent kartu nikdy nezadává ani nevidí; po zaplacení jede faktura a výroba stejně jako u objednávky z webu). Vždy vrátí statusUrl a statusToken (pro get_order_status, get_payment_link, cancel_order) a zákazníkovi pošle e-mail. Volej až po výslovném souhlasu zákazníka s položkami a cenou z quote_order. Povinné: skutečný e-mail (doména musí přijímat poštu, jinak 422), jméno a příjmení, shippingId (+ pickupPointId u výdejního místa, jinak adresa), consent:true; nad 10 000 Kč bez IČO fakturační adresa. Kartou nejméně 15 Kč. Nezaplacená karta propadne po 48 h, převod po 7 dnech. Limity: 3 objednávky / IP / den, 2 nezaplacené a 3 objednávky za 24 h na e-mail (429). Při opakování po timeoutu pošli stejný idempotencyKey.
| Argument | Type | Description |
|---|---|---|
| items* | array | položky objednávky (každá velikost/barva zvlášť) |
| notes | string | vzkaz zákazníka k objednávce (co má dílna vědět); uloží se k zakázce jako poznámka od zákazníka, delší text se ořízne |
| consent* | boolean | souhlas zákazníka s obchodními podmínkami (https://suorigo.cz/obchodni-podminky), musí být true |
| customer* | object | zákazník: email (povinné, skutečná doména s poštou), name (povinné — jméno A příjmení, jde na daňový doklad), phone?, address? (doručovací adresa jedním řádkem u doručení na adresu) nebo deliveryStreet/deliveryCity/deliveryZip, firma: companyName?, ico? (doplní se z ARES), dic?, fakturační adresa billingStreet/billingCity/billingZip/billingCountry (nad 10 000 Kč bez IČO povinná) |
Vyhledá výdejní místa dopravce podle města, PSČ, ulice nebo názvu (Zásilkovna vč. Z-BOXů, Balíkovna, PPL ParcelShop, DPD Pickup). Vrácené `id` patří do create_order.pickupPointId.
| Argument | Type | Description |
|---|---|---|
| limit | integer | počet výsledků (výchozí 10) |
| query* | string | město, PSČ, ulice nebo název (min. 2 znaky), např. „Brno Lidická“ nebo „60200“ |
| shippingId* | string |
{
"type": "object",
"required": [
"shippingId",
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "počet výsledků (výchozí 10)"
},
"query": {
"type": "string",
"description": "město, PSČ, ulice nebo název (min. 2 znaky), např. „Brno Lidická“ nebo „60200“"
},
"shippingId": {
"enum": [
"zasilkovna",
"balikovna",
"ppl-vydejni",
"dpd-vydejni"
],
"type": "string"
}
}
}Stav objednávky: platba (pending/paid/failed/refunded), výroba (new → shipped/delivered, cancelled), očekávaný termín. Se statusToken navíc statusUrl, faktura (PDF po zaplacení) a sledování zásilky. S orderNumber + email jen základní stav (čísla objednávek jsou předvídatelná). Neshoda = found:false.
| Argument | Type | Description |
|---|---|---|
| string | e-mail zákazníka z objednávky — jen spolu s orderNumber | |
| orderNumber | string | číslo objednávky (9 číslic) — jen spolu s e-mailem |
| statusToken | string | statusToken z create_order (poslední část statusUrl) — plný přístup |
{
"type": "object",
"required": [],
"properties": {
"email": {
"type": "string",
"description": "e-mail zákazníka z objednávky — jen spolu s orderNumber"
},
"orderNumber": {
"type": "string",
"description": "číslo objednávky (9 číslic) — jen spolu s e-mailem"
},
"statusToken": {
"type": "string",
"description": "statusToken z create_order (poslední část statusUrl) — plný přístup"
}
}
}Vrátí odkaz na zaplacení existující objednávky kartou (paymentUrl na Stripe) — když zákazník odkaz ztratil nebo vypršel (platí ~24 h). Stejná cesta jako tlačítko „Dokončit platbu kartou“ na webu: otevřenou platbu znovu použije, zaplacenou jen potvrdí, rozpracované ověření v bance nechá doběhnout. Jen pro objednávky kartou (převod má platební údaje v create_order). Autorizace: statusToken → vrátí paymentUrl; orderNumber + email → odkaz NEvrací, pošle ho zákazníkovi na e-mail z objednávky (max 1× / 15 min, 3× / den).
| Argument | Type | Description |
|---|---|---|
| string | e-mail zákazníka z objednávky — jen spolu s orderNumber | |
| orderNumber | string | číslo objednávky (9 číslic) — jen spolu s e-mailem |
| statusToken | string | statusToken z create_order (poslední část statusUrl) — plný přístup |
{
"type": "object",
"required": [],
"properties": {
"email": {
"type": "string",
"description": "e-mail zákazníka z objednávky — jen spolu s orderNumber"
},
"orderNumber": {
"type": "string",
"description": "číslo objednávky (9 číslic) — jen spolu s e-mailem"
},
"statusToken": {
"type": "string",
"description": "statusToken z create_order (poslední část statusUrl) — plný přístup"
}
}
}Rychlý odhad ceny JEDNOHO produktu (vč. DPH) podle množství/velikostí a počtu potištěných stran. Přesnou cenu celé objednávky (doprava, kupón, termín) vrací quote_order.
| Argument | Type | Description |
|---|---|---|
| sizes | object | mapování velikost→počet, např. {"M":10,"L":5} |
| product* | string | |
| quantity | number | |
| promoCode | string | |
| printedSides | number | počet potištěných stran 0–4 |
| printSideHeightsCm | array | výška motivu v cm na každé potištěné straně |
{
"type": "object",
"required": [
"product"
],
"properties": {
"sizes": {
"type": "object",
"description": "mapování velikost→počet, např. {\"M\":10,\"L\":5}"
},
"product": {
"type": "string"
},
"quantity": {
"type": "number"
},
"promoCode": {
"type": "string"
},
"printedSides": {
"type": "number",
"description": "počet potištěných stran 0–4"
},
"printSideHeightsCm": {
"type": "array",
"items": {
"type": "number"
},
"description": "výška motivu v cm na každé potištěné straně"
}
}
}Vrátí katalog triček/mikin Suorigo (barvy, velikosti, ceny vč. množstevních slev) nebo jeden produkt podle id/slug.
| Argument | Type | Description |
|---|---|---|
| product | string | id nebo slug konkrétního produktu (volitelné) |
{
"type": "object",
"required": [],
"properties": {
"product": {
"type": "string",
"description": "id nebo slug konkrétního produktu (volitelné)"
}
}
}Dohledá firmu podle IČO v ARES (název, DIČ, sídlo) — pro nákup na firmu. Vrací pole ve tvaru create_order.customer (companyName, ico, dic, billingStreet…).
| Argument | Type | Description |
|---|---|---|
| ico* | string | IČO (7–8 číslic) |
{
"type": "object",
"required": [
"ico"
],
"properties": {
"ico": {
"type": "string",
"description": "IČO (7–8 číslic)"
}
}
}Přesná cena celé objednávky PŘED založením — stejný výpočet jako create_order (položky, doprava vč. dopravy zdarma od 1 500 Kč, kupón, termín výroby). Vrací totalVat, rozpis, dostupné termíny (deliverySpeeds), ceny dopravy a v `requirements` co ještě chybí k objednání. Nic neukládá.
| Argument | Type | Description |
|---|---|---|
| items* | array | položky objednávky (každá velikost/barva zvlášť) |
| customer | object | volitelné: email (kvůli limitu kupónu), name, ico, adresy — jen pro kontrolu requirements |
| promoCode | string | slevový kód; neplatný kód = chyba (nikdy tiše plná cena) |
| shippingId | string | doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (69 Kč), dpd-vydejni (89 Kč), ppl (na adresu, 119 Kč), dpd (na adresu, 109 Kč); od 1 500 Kč zdarma |
| pickupPointId | string | id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo) |
| deliverySpeedId | string | termín: d14 = do 14 prac. dní (výchozí, bez příplatku), d7 = do 7 dní +30 % (jen trička Standard), d30 = do měsíce −10 %; nedostupný termín = 400 s důvodem (quote_order ukáže dostupnost) |
| pickupPointName |
| promoCode | string | slevový kód; neplatný kód = chyba (nikdy tiše plná cena) |
| shippingId* | string | doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (69 Kč), dpd-vydejni (89 Kč), ppl (na adresu, 119 Kč), dpd (na adresu, 109 Kč); od 1 500 Kč zdarma |
| paymentMethod | string | bank_transfer = převod + QR (výchozí); card = odkaz na platbu kartou (Stripe Checkout, Apple/Google Pay podle prohlížeče) |
| pickupPointId | string | id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo) |
| idempotencyKey | string | libovolný unikátní klíč této objednávky (např. UUID); opakované volání se stejným klíčem a obsahem vrátí stejnou objednávku (replayed:true, u karty tentýž platební odkaz), stejný klíč s jiným obsahem = 409 |
| deliverySpeedId | string | termín: d14 = do 14 prac. dní (výchozí, bez příplatku), d7 = do 7 dní +30 % (jen trička Standard), d30 = do měsíce −10 %; nedostupný termín = 400 s důvodem (quote_order ukáže dostupnost) |
| pickupPointName | string | název výdejního místa (volitelné, doplní se samo) |
{
"type": "object",
"required": [
"items",
"customer",
"shippingId",
"consent"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product",
"size",
"quantity"
],
"properties": {
"size": {
"type": "string",
"description": "velikost z katalogu, např. M"
},
"layers": {
"type": "array",
"items": {
"type": "object"
},
"description": "vrstvy z create_design (určují příplatek za potisk)"
},
"colorId": {
"type": "string"
},
"product": {
"type": "string",
"description": "id nebo slug produktu z list_products"
},
"quantity": {
"type": "integer",
"minimum": 1
},
"colorName": {
"type": "string",
"description": "název barvy"
},
"printMethod": {
"type": "string"
}
}
},
"description": "položky objednávky (každá velikost/barva zvlášť)"
},
"notes": {
"type": "string",
"maxLength": 1000,
"description": "vzkaz zákazníka k objednávce (co má dílna vědět); uloží se k zakázce jako poznámka od zákazníka, delší text se ořízne"
},
"consent": {
"type": "boolean",
"description": "souhlas zákazníka s obchodními podmínkami (https://suorigo.cz/obchodni-podminky), musí být true"
},
"customer": {
"type": "object",
"required": [
"email",
"name"
],
"properties": {
"dic": {
"type": "string"
},
"ico": {
"type": "string"
},
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"address": {
"type": "string"
},
"billingZip": {
"type": "string"
},
"billingCity": {
"type": "string"
},
"companyName": {
"type": "string"
},
"deliveryZip": {
"type": "string"
},
"deliveryCity": {
"type": "string"
},
"billingStreet": {
"type": "string"
},
"billingCountry": {
"type": "string"
},
"deliveryStreet": {
"type": "string"
}
},
"description": "zákazník: email (povinné, skutečná doména s poštou), name (povinné — jméno A příjmení, jde na daňový doklad), phone?, address? (doručovací adresa jedním řádkem u doručení na adresu) nebo deliveryStreet/deliveryCity/deliveryZip, firma: companyName?, ico? (doplní se z ARES), dic?, fakturační adresa billingStreet/billingCity/billingZip/billingCountry (nad 10 000 Kč bez IČO povinná)"
},
"promoCode": {
"type": "string",
"description": "slevový kód; neplatný kód = chyba (nikdy tiše plná cena)"
},
"shippingId": {
"enum": [
"zasilkovna",
"balikovna",
"ppl-vydejni",
"dpd-vydejni",
"ppl",
"dpd"
],
"type": "string",
"description": "doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (69 Kč), dpd-vydejni (89 Kč), ppl (na adresu, 119 Kč), dpd (na adresu, 109 Kč); od 1 500 Kč zdarma"
},
"paymentMethod": {
"enum": [
"bank_transfer",
"card"
],
"type": "string",
"description": "bank_transfer = převod + QR (výchozí); card = odkaz na platbu kartou (Stripe Checkout, Apple/Google Pay podle prohlížeče)"
},
"pickupPointId": {
"type": "string",
"description": "id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo)"
},
"idempotencyKey": {
"type": "string",
"maxLength": 128,
"description": "libovolný unikátní klíč této objednávky (např. UUID); opakované volání se stejným klíčem a obsahem vrátí stejnou objednávku (replayed:true, u karty tentýž platební odkaz), stejný klíč s jiným obsahem = 409"
},
"deliverySpeedId": {
"enum": [
"d7",
"d14",
"d30"
],
"type": "string",
"description": "termín: d14 = do 14 prac. dní (výchozí, bez příplatku), d7 = do 7 dní +30 % (jen trička Standard), d30 = do měsíce −10 %; nedostupný termín = 400 s důvodem (quote_order ukáže dostupnost)"
},
"pickupPointName": {
"type": "string",
"description": "název výdejního místa (volitelné, doplní se samo)"
}
}
}| string |
| název výdejního místa (volitelné, doplní se samo) |
{
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product",
"size",
"quantity"
],
"properties": {
"size": {
"type": "string",
"description": "velikost z katalogu, např. M"
},
"layers": {
"type": "array",
"items": {
"type": "object"
},
"description": "vrstvy z create_design (určují příplatek za potisk)"
},
"colorId": {
"type": "string"
},
"product": {
"type": "string",
"description": "id nebo slug produktu z list_products"
},
"quantity": {
"type": "integer",
"minimum": 1
},
"colorName": {
"type": "string",
"description": "název barvy"
},
"printMethod": {
"type": "string"
}
}
},
"description": "položky objednávky (každá velikost/barva zvlášť)"
},
"customer": {
"type": "object",
"description": "volitelné: email (kvůli limitu kupónu), name, ico, adresy — jen pro kontrolu requirements"
},
"promoCode": {
"type": "string",
"description": "slevový kód; neplatný kód = chyba (nikdy tiše plná cena)"
},
"shippingId": {
"enum": [
"zasilkovna",
"balikovna",
"ppl-vydejni",
"dpd-vydejni",
"ppl",
"dpd"
],
"type": "string",
"description": "doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (69 Kč), dpd-vydejni (89 Kč), ppl (na adresu, 119 Kč), dpd (na adresu, 109 Kč); od 1 500 Kč zdarma"
},
"pickupPointId": {
"type": "string",
"description": "id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo)"
},
"deliverySpeedId": {
"enum": [
"d7",
"d14",
"d30"
],
"type": "string",
"description": "termín: d14 = do 14 prac. dní (výchozí, bez příplatku), d7 = do 7 dní +30 % (jen trička Standard), d30 = do měsíce −10 %; nedostupný termín = 400 s důvodem (quote_order ukáže dostupnost)"
},
"pickupPointName": {
"type": "string",
"description": "název výdejního místa (volitelné, doplní se samo)"
}
}
}