---
title: "Stav objednávky"
method: GET
path: "/api/order/agent"
tags: ["objednávka"]
---

# Stav objednávky

`GET /api/order/agent`

## Request

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

Se `statusToken` (poslední část statusUrl z create_order) vrátí plný stav: odkaz na fakturu po zaplacení, sledování zásilky a příznaky `payable`/`cancellable`. Bez tokenu vyžaduje `orderNumber` I `email` (ověření vlastnictví — čísla objednávek jsou předvídatelná) a vrátí jen základní stav. Bez parametrů vrátí strojovou nápovědu k POST.

## Query parameters

- `statusToken` string
- `orderNumber` string
- `email` string, email

## Response `200`

Nalezeno

- OrderStatus
  - `found` boolean
  - `orderNumber` string
  - `paymentStatus` 'pending' | 'paid' | 'failed' | 'refunded'
  - `paymentMethod` 'bank_transfer' | 'card'
  - `fulfillmentStatus` string
  - `cancelled` boolean
  - `totalVat` number
  - `currency` string
  - `createdAt` string, date-time
  - `paidAt` string, date-time, nullable
  - `expectedDeliveryDate` string, date-time, nullable
  - `payable` boolean: jde ještě zaplatit (převodem podle instrukcí, nebo kartou přes POST /api/order/agent/payment-link)
  - `cancellable` boolean: jde stornovat přes POST /api/order/agent/cancel (jen se statusToken)
  - `statusUrl` string: jen se statusToken
  - `invoice` object, nullable: jen se statusToken, po zaplacení
    - `number` string
    - `pdfUrl` string
  - `tracking` object, nullable: jen se statusToken
    - `carrier` string, nullable
    - `number` string
    - `url` string, nullable
  - `shippingMethod` string, nullable: jen se statusToken
  - `note` string: jen bez statusToken — upozornění, že detaily jsou jen s tokenem

## Other responses

- `404`: Nenalezeno nebo e-mail nesouhlasí (found:false)
- `429`: Překročen limit (per IP, per e-mail, globální nebo denní). Text v `error` říká, co se stalo a co dělat; typicky počkej nebo odkaž zákazníka na https://konfigurator.suorigo.cz.

---

[API](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty.md) · [All operations](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty/llms.txt) · [OpenAPI document](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty/revisions/08c6a3ef2349?raw)