Skip to main content
Glama

Suorigo Konfigurátor

by cz.suorigo.konfigurator
OverviewDiscussionsAdmin

create_order

Idempotent

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.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
itemsYespoložky objednávky (každá velikost/barva zvlášť)
notesNovzkaz 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
consentYessouhlas zákazníka s obchodními podmínkami (https://suorigo.cz/obchodni-podminky), musí být true
customerYeszá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á)
promoCodeNoslevový kód; neplatný kód = chyba (nikdy tiše plná cena)
shippingIdYesdoprava: 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
paymentMethodNobank_transfer = převod + QR (výchozí); card = odkaz na platbu kartou (Stripe Checkout, Apple/Google Pay podle prohlížeče)
pickupPointIdNoid výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo)
idempotencyKeyNolibovolný 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
deliverySpeedIdNotermí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)
pickupPointNameNonázev výdejního místa (volitelné, doplní se samo)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / shippingId / description
      Previous value: -"doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (79 Kč), dpd-vydejni (89 Kč), ppl / dpd (na adresu, 129 Kč); od 1 500 Kč zdarma"New value: +"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"
  2. Changed2 schema fields changed
    • changedInput schema / properties / shippingId / description
      Previous value: -"doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (79 Kč), dpd-vydejni (89 Kč), ppl / dpd (na adresu, 129 Kč); od 1 500 Kč zdarma; osobni (Šitbořice) jen se slevovým kódem, který ho odemyká"New value: +"doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (79 Kč), dpd-vydejni (89 Kč), ppl / dpd (na adresu, 129 Kč); od 1 500 Kč zdarma"
    • changedInput schema / properties / shippingId / enum
      Previous value: -[
-  "zasilkovna",
-  "balikovna",
-  "ppl-vydejni",
-  "dpd-vydejni",
-  "ppl",
-  "dpd",
-  "osobni"
-]New value: +[
+  "zasilkovna",
+  "balikovna",
+  "ppl-vydejni",
+  "dpd-vydejni",
+  "ppl",
+  "dpd"
+]
  3. Changed3 schema fields changed
    • changedInput schema / properties / deliverySpeedId / description
      Previous value: -"termín: d14 = do 14 prac. dní (výchozí, bez příplatku), d7 = do 7 dní +30 % (jen trička Standard), rush3 = expres do 3 prac. dnů +100 % (jen černá/bílá trička Standart, objednávka 1 500–5 000 Kč, podání do 12:00), d30 = do měsíce −10 %; nedostupný termín = 400 s důvodem (quote_order ukáže dostupnost)"New value: +"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)"
    • changedInput schema / properties / deliverySpeedId / enum
      Previous value: -[
-  "rush3",
-  "d7",
-  "d14",
-  "d30"
-]New value: +[
+  "d7",
+  "d14",
+  "d30"
+]
    • changedInput schema / properties / items / items / properties / colorName / description
      Previous value: -"název barvy (rozhoduje i o expresu: jen černá/bílá)"New value: +"název barvy"
  4. Changed16 schema fields changed
    • changedInput schema / properties / consent / description
      Previous value: -"souhlas s obchodními podmínkami, musí být true"New value: +"souhlas zákazníka s obchodními podmínkami (https://suorigo.cz/obchodni-podminky), musí být true"
    • changedInput schema / properties / customer / description
      Previous value: -"{email (povinné), name?, phone?, address?, companyName?, ico?, dic?, billingStreet?, billingCity?, billingZip?, billingCountry?}"New value: +"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á)"
    • addedInput schema / properties / customer / properties
      Added value: +{
+  "address": {
+    "type": "string"
+  },
+  "billingCity": {
+    "type": "string"
+  },
+  "billingCountry": {
+    "type": "string"
+  },
+  "billingStreet": {
+    "type": "string"
+  },
+  "billingZip": {
+    "type": "string"
+  },
+  "companyName": {
+    "type": "string"
+  },
+  "deliveryCity": {
+    "type": "string"
+  },
+  "deliveryStreet": {
+    "type": "string"
+  },
+  "deliveryZip": {
+    "type": "string"
+  },
+  "dic": {
+    "type": "string"
+  },
+  "email": {
+    "type": "string"
+  },
+  "ico": {
+    "type": "string"
+  },
+  "name": {
+    "type": "string"
+  },
+  "phone": {
+    "type": "string"
+  }
+}
    • addedInput schema / properties / customer / required
      Added value: +[
+  "email",
+  "name"
+]
    • addedInput schema / properties / deliverySpeedId
      Added value: +{
+  "description": "termín: d14 = do 14 prac. dní (výchozí, bez příplatku), d7 = do 7 dní +30 % (jen trička Standard), rush3 = expres do 3 prac. dnů +100 % (jen černá/bílá trička Standart, objednávka 1 500–5 000 Kč, podání do 12:00), d30 = do měsíce −10 %; nedostupný termín = 400 s důvodem (quote_order ukáže dostupnost)",
+  "enum": [
+    "rush3",
+    "d7",
+    "d14",
+    "d30"
+  ],
+  "type": "string"
+}
    • changedInput schema / properties / idempotencyKey / description
      Previous value: -"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), stejný klíč s jiným obsahem = 409"New value: +"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"
    • changedInput schema / properties / items / description
      Previous value: -"položky: {product (id/slug), colorId?, colorName?, size, quantity, printMethod?, layers? (z create_design)}"New value: +"položky objednávky (každá velikost/barva zvlášť)"
    • addedInput schema / properties / items / items / properties
      Added value: +{
+  "colorId": {
+    "type": "string"
+  },
+  "colorName": {
+    "description": "název barvy (rozhoduje i o expresu: jen černá/bílá)",
+    "type": "string"
+  },
+  "layers": {
+    "description": "vrstvy z create_design (určují příplatek za potisk)",
+    "items": {
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "printMethod": {
+    "type": "string"
+  },
+  "product": {
+    "description": "id nebo slug produktu z list_products",
+    "type": "string"
+  },
+  "quantity": {
+    "minimum": 1,
+    "type": "integer"
+  },
+  "size": {
+    "description": "velikost z katalogu, např. M",
+    "type": "string"
+  }
+}
    • addedInput schema / properties / items / items / required
      Added value: +[
+  "product",
+  "size",
+  "quantity"
+]
    • addedInput schema / properties / paymentMethod
      Added value: +{
+  "description": "bank_transfer = převod + QR (výchozí); card = odkaz na platbu kartou (Stripe Checkout, Apple/Google Pay podle prohlížeče)",
+  "enum": [
+    "bank_transfer",
+    "card"
+  ],
+  "type": "string"
+}
    • addedInput schema / properties / pickupPointId
      Added value: +{
+  "description": "id výdejního místa z find_pickup_points (povinné u dopravy na výdejní místo)",
+  "type": "string"
+}
    • addedInput schema / properties / pickupPointName
      Added value: +{
+  "description": "název výdejního místa (volitelné, doplní se samo)",
+  "type": "string"
+}
    • addedInput schema / properties / promoCode / description
      Added value: +"slevový kód; neplatný kód = chyba (nikdy tiše plná cena)"
    • changedInput schema / properties / shippingId / description
      Previous value: -"např. 'zasilkovna','balikovna','ppl','dpd' (volitelné)"New value: +"doprava: zasilkovna (výdejní místo / Z-BOX, 89 Kč), balikovna (69 Kč), ppl-vydejni (79 Kč), dpd-vydejni (89 Kč), ppl / dpd (na adresu, 129 Kč); od 1 500 Kč zdarma; osobni (Šitbořice) jen se slevovým kódem, který ho odemyká"
    • addedInput schema / properties / shippingId / enum
      Added value: +[
+  "zasilkovna",
+  "balikovna",
+  "ppl-vydejni",
+  "dpd-vydejni",
+  "ppl",
+  "dpd",
+  "osobni"
+]
    • changedInput schema / required
      Previous value: -[
-  "items",
-  "customer",
-  "consent"
-]New value: +[
+  "items",
+  "customer",
+  "shippingId",
+  "consent"
+]
  5. Changed1 schema field changed
    • addedInput schema / properties / idempotencyKey
      Added value: +{
+  "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), stejný klíč s jiným obsahem = 409",
+  "maxLength": 128,
+  "type": "string"
+}
  6. Changed2 schema fields changed
    • addedInput schema / properties / notes / description
      Added value: +"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"
    • addedInput schema / properties / notes / maxLength
      Added value: +1000
  7. First observed

TDQS

Score is being calculated.

All Suorigo Konfigurátor toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources