objednávka

Založit objednávku (závazná, čeká na platbu)

Založí ostrou objednávku (stejná pravidla jako pokladna). paymentMethod: "bank_transfer" (výchozí, zpětně kompatibilní) vrátí částku, IBAN, variabilní symbol a QR kód SPAYD. paymentMethod: "card" vrátí paymentUrl — odkaz na zabezpečenou stránku Stripe Checkout PRO TUTO OBJEDNÁVKU, kde kartu (nebo Apple/Google Pay) zadá sám zákazník; agent kartu nikdy nezadává ani nevidí. Po zaplacení jede stejný webhook, faktura a výroba jako u objednávky z webu. Vždy vrátí statusUrl a statusToken (autorizace pro GET /api/order/agent?statusToken, POST /payment-link a POST /cancel) a zákazníkovi odejde e-mail se stejnými údaji. Volej až po výslovném souhlasu zákazníka s položkami, dopravou a cenou z POST /api/order/agent/quote.

Ceny se počítají na serveru; při nesmyslné konfiguraci dostaneš 400/409 s vysvětlením a strojovým code. Při opakování po timeoutu pošli stejný idempotencyKey — vrátí se tatáž objednávka (replayed: true, u karty tentýž platební odkaz), nevznikne duplicita. Nezaplacená objednávka se ruší po 7 dnech (převod) nebo 48 hodinách (karta); zákazník dostane nejvýš jednu připomínku. Objednávky od 10 000 Kč nebo s IČO se automaticky neruší (řeší je člověk).

post/api/order/agent

Request

  • Base URL: https://konfigurator.suorigo.cz
  • URL: https://konfigurator.suorigo.cz/api/order/agent
  • Auth: none declared

Request body

shippingId'zasilkovna' | 'balikovna' | 'ppl-vydejni' | 'dpd-vydejni' | 'ppl' | 'dpd' required

způsob dopravy (POVINNÉ). zasilkovna/balikovna/ppl-vydejni/dpd-vydejni = výdejní místo (vyžaduje pickupPointId), ppl/dpd = na adresu (vyžaduje customer.address nebo deliveryStreet/deliveryCity/deliveryZip)

pickupPointIdstring

kód výdejního místa z GET /api/shipping/pickup-points — povinné u dopravy na výdejní místo, jinak 400 pickup_point_required

pickupPointNamestring

název výdejního místa (volitelné, doplní se samo)

deliverySpeedId'd7' | 'd14' | 'd30'

termín výroby; d14 = výchozí bez příplatku; nedostupný termín → 400 delivery_speed_unavailable (dostupnost všech termínů vrací quote_order)

promoCodestring
paymentMethod'bank_transfer' | 'card'

bank_transfer (výchozí, zpětně kompatibilní) = převod + QR; card = paymentUrl na Stripe Checkout, kartu zadává zákazník sám

consenttrue required

zákazník souhlasí s obchodními podmínkami (https://suorigo.cz/obchodni-podminky)

notesstring

vzkaz zákazníka dílně

idempotencyKeystring

unikátní klíč objednávky; stejný klíč + stejný obsah = stejná objednávka

Response

Objednávka založena (nebo vrácena existující při stejném idempotencyKey)

okboolean
statusinteger
errorstring
codestring

jen při chybě — viz components.schemas.Error

orderNumberstring

9 číslic, zároveň variabilní symbol

currency'CZK'
amountnumber

celkem k úhradě s DPH včetně dopravy

paymentMethod'bank_transfer' | 'card'
variableSymbolstring

jen paymentMethod bank_transfer

spaydStringstring

jen paymentMethod bank_transfer — SPAYD řetězec (QR platba)

spaydQrstring nullable

jen paymentMethod bank_transfer — data:image/png;base64 QR kód

paymentUrlstring

jen paymentMethod card — Stripe Checkout pro TUTO objednávku; kartu zadá zákazník sám

paymentUrlExpiresAtstring date-time nullable

jen paymentMethod card — do kdy odkaz platí (~24 h); pak nový přes POST /api/order/agent/payment-link

paymentState'pending' | 'paid' | 'processing' | 'requires_action'

jen paymentMethod card — stav platby kartou

status_'pending' | 'paid'
statusUrlstring

veřejná stránka stavu objednávky — předej zákazníkovi

statusTokenstring

poslední část statusUrl — autorizace pro GET /api/order/agent?statusToken, /payment-link a /cancel

paymentDueDatestring date-time

do kdy musí dorazit platba (karta 48 h, převod 3 dny; nezaplacený převod se ruší po 5 dnech); pak se nezaplacená objednávka ruší

expectedDeliveryDatestring date-time

očekávaný termín doručení podle zvoleného termínu výroby

emailSentboolean

false = e-mail neodešel, předej údaje z odpovědi

replayedboolean

true = odpověď na dřívější objednávku se stejným idempotencyKey

paymentInstructionsstring

hotový text pro zákazníka

Changes

No recorded changes to this operation across all 1 revision of this API.