Zakázky

Server

Download schema

Vytváření, úprava a přehled servisních zakázek.

Seznam zakázek

GET

https://nazev-spolecnosti.zaslat.cz/api/v1

/commissions

x-apikey (header)

Vrací stránkovaný seznam zakázek. Seznam je možné filtrovat podle níže uvedených parametrů.

⚠️ Zdrojová tabulka „Query parametry pro filtrování" nebyla při tvorbě této specifikace čitelná. Níže uvedené parametry jsou pouze ty, které se objevují v ukázkových dotazech ve zdrojové dokumentaci — tabulka pravděpodobně obsahuje další filtry (např. rozsah dat do, servisní středisko, typ/model výrobku). Parametry page a page_size jsou odvozeny z názvů polí v odpovědi (meta.page_current, meta.page_size), jejich přesný název na vstupu nebyl ověřen.

Seznam zakázek › query Parameters

status[]

CommissionStatus[] · style: form · explode: true

Filtrace podle stavu zakázky. Lze zadat opakovaně pro filtraci přes více stavů.

Enum values:

pending

incoming

processing

outgoing

finished

cancelled

created_from

string · date

Vrátí pouze zakázky vytvořené od tohoto data (včetně).

Example: 2021-06-20

number

string

Filtrace podle čísla zakázky (i částečné shody, viz příklad Z21D02).

Example: Z21D02

page

integer · min: 1

⚠️ Číslo stránky výsledků (název parametru odvozen, neověřeno).

page_size

integer

⚠️ Počet položek na stránku (název parametru odvozen, neověřeno).

Seznam zakázek › Responses

200

Seznam zakázek.

status

integer

PageMeta

Metadata stránkování seznamu.

Commission[]

GET/commissions

curl https://nazev-spolecnosti.zaslat.cz/api/v1/commissions \
  --header 'x-apikey: <api-key>'

Example Responses

{
  "status": 200,
  "meta": {
    "total": 83,
    "count": 20,
    "page_current": 1,
    "page_total": 5,
    "page_size": 20
  },
  "data": [
    {
      "id": 6350,
      "token": "bfd41c8e6a5361f7e4b95c0f",
      "type": "warranty",
      "number": "Z21D083991",
      "product_type_id": 3,
      "product_model": "MQ 3005 WH CREAM",
      "product_serial_number": "123-xxx-456",
      "external_id": "moje znacka 45",
      "status": "incoming",
      "substatus": null,
      "date_buy": "2021-06-03",
      "created": "2026-07-01 09:15:32",
      "customer_id": 1234,
      "customer_address": {
        "firstname": "Petr",
        "surname": "Novák",
        "email": "petr.novak@testapi.cz",
        "phone": "777888999",
        "company": "",
        "tin": null,
        "vatin": null,
        "street": "U Kolejí 12",
        "city": "Praha",
        "zip": "16200",
        "country": "CZ",
        "latLng": [
          50.0989,
          14.3323
        ]
      },
      "service_centre_id": 11,
      "service_centre_address": {
        "company": "Servis Praha s.r.o.",
        "firstname": "",
        "surname": "",
        "email": "servis@example.com",
        "phone": "+420222333444",
        "tin": "12345678",
        "vatin": "CZ12345678",
        "street": "Průmyslová 1200/4",
        "city": "Praha 10",
        "zip": "10200",
        "country": "CZ",
        "latLng": null
      },
      "activities": [],
      "shipments": []
    }
  ]
}

json

application/json

Detail zakázky

GET

https://nazev-spolecnosti.zaslat.cz/api/v1

/commissions/{id}

x-apikey (header)

Vrací detail jedné zakázky podle jejího interního ID.

Detail zakázky › path Parameters

id

integer · required

Interní ID zakázky.

Detail zakázky › Responses

200

Detail zakázky.

status

integer

Commission

Detail servisní zakázky.

GET/commissions/{id}

curl https://nazev-spolecnosti.zaslat.cz/api/v1/commissions/:id \
  --header 'x-apikey: <api-key>'

Example Responses

{
  "status": 200,
  "data": {
    "id": 6350,
    "token": "bfd41c8e6a5361f7e4b95c0f",
    "type": "warranty",
    "number": "Z21D083991",
    "product_type_id": 3,
    "product_model": "MQ 3005 WH CREAM",
    "product_serial_number": "123-xxx-456",
    "external_id": "moje znacka 45",
    "status": "processing",
    "substatus": null,
    "date_buy": "2021-06-03",
    "created": "2026-07-01 09:15:32",
    "customer_id": 1234,
    "customer_address": {
      "firstname": "Petr",
      "surname": "Novák",
      "email": "petr.novak@testapi.cz",
      "phone": "777888999",
      "company": "",
      "tin": null,
      "vatin": null,
      "street": "U Kolejí 12",
      "city": "Praha",
      "zip": "16200",
      "country": "CZ",
      "latLng": [
        50.0989,
        14.3323
      ]
    },
    "service_centre_id": 11,
    "service_centre_address": {
      "company": "Servis Praha s.r.o.",
      "firstname": "",
      "surname": "",
      "email": "servis@example.com",
      "phone": "+420222333444",
      "tin": "12345678",
      "vatin": "CZ12345678",
      "street": "Průmyslová 1200/4",
      "city": "Praha 10",
      "zip": "10200",
      "country": "CZ",
      "latLng": null
    },
    "activities": [
      {
        "id": 18001,
        "commission_id": 6350,
        "commission_number": "Z21D083991",
        "type": "status",
        "created": "2026-07-01 09:15:32",
        "user_name": "SYSTEM",
        "is_internal": 0,
        "is_customer": 0,
        "message": "Zakázka byla vytvořena.",
        "files": []
      },
      {
        "id": 18002,
        "commission_id": 6350,
        "commission_number": "Z21D083991",
        "type": "message",
        "created": "2026-07-02 14:02:10",
        "user_name": "SERVIS",
        "is_internal": 0,
        "is_customer": 0,
        "message": "Přístroj přijat, zahajujeme diagnostiku.",
        "files": []
      }
    ],
    "shipments": [
      {
        "id": 9101,
        "commission_id": 6350,
        "commission_number": "Z21D083991",
        "number": "IZ0123456789",
        "number_carrier": "12345678901234",
        "carrier": "DPD",
        "type": "incoming",
        "collection": "dropoff",
        "collection_date": null,
        "status": "delivered",
        "tracking": [
          {
            "date": "2026-07-02",
            "time": "08:45:00",
            "location": "Depo Praha",
            "name": "Zásilka byla doručena do servisu.",
            "status": "delivered"
          }
        ],
        "label": "https://returns-demo.zaslat.cz/labels/download/bfd41c8e",
        "label_printed": 1,
        "from": {
          "firstname": "Petr",
          "surname": "Novák",
          "street": "U Kolejí 12",
          "city": "Praha",
          "zip": "16200",
          "country": "CZ"
        },
        "to": {
          "company": "Servis Praha s.r.o.",
          "street": "Průmyslová 1200/4",
          "city": "Praha 10",
          "zip": "10200",
          "country": "CZ"
        },
        "cod": 0,
        "cod_currency": "CZK",
        "cod_variable": null,
        "cod_bank_account_id": null,
        "weight": 5,
        "last_error": null,
        "created": "2026-07-01 09:15:40"
      }
    ]
  }
}

json

application/json

Vytvoření zakázky

POST

https://nazev-spolecnosti.zaslat.cz/api/v1

/commissions/create

x-apikey (header)

Vytvoří novou zakázku a případně objedná dopravu od zákazníka do servisu.

Zakázku lze vytvořit i bez objednávky dopravy (shipment_from_customer: false) — jde potom o jednosměrnou zakázku, sloužící pouze k zaslání výrobku zákazníkovi zpět. Obousměrná zakázka obsahuje na konci servisního procesu jak dopravu od zákazníka, tak dopravu zpět k zákazníkovi.

Při vytvoření zakázky včetně dopravy (shipment_from_customer: true) je zakázka po doručení zásilky do servisu automaticky přepnuta do stavu processing. V době od vytvoření do doručení je zakázka ve stavu incoming — zakázky vytvořené servisním střediskem přes API jsou totiž automaticky schválené (na rozdíl od zakázek zadaných koncovým zákazníkem přes frontend, které čekají ve stavu pending na schválení).

Vytvoření zakázky › Request Body

CreateCommissionRequest

object · required

Objekt určující adresu zákazníka.

shipment_from_customer

boolean · required

Příznak, zda má zakázka příchozí zásilku od zákazníka (true – obousměrná zakázka) nebo ne (false – jednosměrná zakázka).

date_buy

string · date · required

Datum zakoupení výrobku ve formátu YYYY-MM-DD.

message

string · required

Popis závady.

type

CommissionType · enum · required

Typ zakázky.

Enum values:

warranty

afterWarranty

object

Vyžadováno pouze pokud shipment_from_customer: true.

product_id

integer

ID modelu výrobku (získané voláním GET /product-model). Je nutné zvolit právě jednu z variant product_id nebo external_key — model výrobku musí existovat a být přiřazen alespoň k jednomu servisnímu středisku.

external_key

string

Externí označení modelu výrobku (alternativa k product_id, viz výše).

invoice_file_token

string

Token souboru dokladu o nákupu, získaný voláním POST /commissions/upload-file. Povinné v případě záruční (warranty) zakázky.

external_id

string | null

Značka zákazníka / externí identifikátor.

product_serial_number

string

Sériové číslo výrobku.

pre_sale_service

boolean

Předprodejní servis.

refund_money

boolean

Požadavek na vrácení kupní ceny výrobku po dokončení zakázky.

Vytvoření zakázky › Responses

Úspěšné vytvoření zakázky.

status

integer

Commission

Detail servisní zakázky.

POST/commissions/create

curl https://nazev-spolecnosti.zaslat.cz/api/v1/commissions/create \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-apikey: <api-key>' \
  --data '{
  "customer": {
    "company": "",
    "firstname": "Petr",
    "surname": "Novák",
    "street": "U Kolejí 12",
    "city": "Praha",
    "zip": "16200",
    "country": "CZ",
    "phone": "777888999",
    "email": "petr.novak@testapi.cz"
  },
  "shipment_from_customer": true,
  "shipment": {
    "collection": "dropoff",
    "collection_date": null
  },
  "date_buy": "2021-06-03",
  "product_id": 11,
  "type": "warranty",
  "invoice_file_token": "ljHIOHi5fsfsjuhe578fsdSFFgs",
  "external_id": null,
  "message": "Pristroj nefunguje."
}'

Example Request Body

{
  "customer": {
    "company": "",
    "firstname": "Petr",
    "surname": "Novák",
    "street": "U Kolejí 12",
    "city": "Praha",
    "zip": "16200",
    "country": "CZ",
    "phone": "777888999",
    "email": "petr.novak@testapi.cz"
  },
  "shipment_from_customer": true,
  "shipment": {
    "collection": "dropoff",
    "collection_date": null
  },
  "date_buy": "2021-06-03",
  "product_id": 11,
  "type": "warranty",
  "invoice_file_token": "ljHIOHi5fsfsjuhe578fsdSFFgs",
  "external_id": null,
  "message": "Pristroj nefunguje."
}

json

application/json

Example Responses

{
  "status": 200,
  "data": {
    "id": 6351,
    "token": "c0f41bfd2eb6987d41c8e6a5",
    "type": "warranty",
    "number": "Z26D084102",
    "product_type_id": 3,
    "product_model": "MQ 3005 WH CREAM",
    "product_serial_number": null,
    "external_id": null,
    "status": "incoming",
    "substatus": null,
    "date_buy": "2021-06-03",
    "created": "2026-07-06 10:12:05",
    "customer_id": 1235,
    "customer_address": {
      "firstname": "Petr",
      "surname": "Novák",
      "email": "petr.novak@testapi.cz",
      "phone": "777888999",
      "company": "",
      "street": "U Kolejí 12",
      "city": "Praha",
      "zip": "16200",
      "country": "CZ"
    },
    "service_centre_id": 11,
    "service_centre_address": {
      "company": "Servis Praha s.r.o.",
      "street": "Průmyslová 1200/4",
      "city": "Praha 10",
      "zip": "10200",
      "country": "CZ"
    },
    "activities": [
      {
        "id": 18101,
        "commission_id": 6351,
        "commission_number": "Z26D084102",
        "type": "status",
        "created": "2026-07-06 10:12:05",
        "user_name": "SYSTEM",
        "is_internal": 0,
        "is_customer": 0,
        "message": "Zakázka byla vytvořena.",
        "files": []
      }
    ],
    "shipments": [
      {
        "id": 9102,
        "commission_id": 6351,
        "commission_number": "Z26D084102",
        "number": "IZ1234567890",
        "number_carrier": null,
        "carrier": "DPD",
        "type": "incoming",
        "collection": "dropoff",
        "collection_date": null,
        "status": "created",
        "tracking": [],
        "label": "https://returns-demo.zaslat.cz/labels/download/c0f41bfd",
        "label_printed": 0,
        "cod": 0,
        "cod_currency": "CZK",
        "weight": 5,
        "last_error": null,
        "created": "2026-07-06 10:12:08"
      }
    ]
  }
}

json

application/json

Úprava zakázky

POST

https://nazev-spolecnosti.zaslat.cz/api/v1

/commissions/edit

x-apikey (header)

Slouží ke změně údajů zakázky a k objednání dopravy ze servisu zpět k zákazníkovi.

Pokud je objednávána doprava zpět k zákazníkovi (shipment_to_customer: true), zakázka se po doručení zásilky zpět zákazníkovi automaticky uzavře a vygenerují se příslušné notifikace. Bez zásilky zákazníkovi zůstává zakázka otevřená až do ručního uzavření (servisním střediskem, nebo nastavením status přes toto API).

Objednaná odchozí zásilka se vytvoří na nejbližší termín svozu; zakázka musí být ve stavu outgoing (lze nastavit současně s objektem shipment) a automaticky se exportuje dopravci.

⚠️ Zdrojová tabulka „BODY" pro tento endpoint nebyla při tvorbě této specifikace čitelná. Pole požadavku níže byla rekonstruována z ukázkových JSON požadavků v dokumentaci — doporučujeme ověřit proti zdrojové tabulce, zejména u pole product_model (v ukázce se objevuje jako vstupní pole, ačkoli se stejnojmenné pole jinak jeví jako odvozené z product_id/external_key).

Úprava zakázky › Request Body

Alespoň jedno z polí `id` nebo `number` je povinné a zakázka musí příslušet servisnímu středisku volajícího uživatele.

EditCommissionRequest

id

integer

Interní ID zakázky (alternativa k number).

number

string

Číslo zakázky (alternativa k id).

product_id

integer

product_model

string

⚠️ Objevuje se v ukázkovém požadavku jako vstupní pole; jinde v dokumentaci je stejné pole popsáno jako odvozené od product_id/external_key — nebylo možné ověřit, zda jde skutečně o přímo editovatelnou hodnotu.

product_serial_number

string

type

CommissionType · enum

Typ zakázky.

Enum values:

warranty

afterWarranty

external_id

string | null

date_buy

string · date

status

string · enum

Nastavení jiného než aktuálního stavu zakázky vyvolá navazující akce (push notifikace, e-mailová notifikace).

Enum values:

pending

incoming

processing

outgoing

finished

cancelled

object

Uvádí se pouze v případě, že je potřeba editovat kontaktní údaje zákazníka. Povinné firstname + surname, nebo company.

shipment_to_customer

boolean

Příznak objednání odchozí zásilky zpět zákazníkovi.

object

Vyžadováno společně s shipment_to_customer: true.

Úprava zakázky › Responses

Úspěšné uložení změny.

status

integer

message

string

Commission

Detail servisní zakázky.

POST/commissions/edit

curl https://nazev-spolecnosti.zaslat.cz/api/v1/commissions/edit \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'x-apikey: <api-key>' \
  --data '{
  "number": "Z21D083991",
  "product_id": 11,
  "product_model": "MQ 3005 WH CREAM",
  "product_serial_number": "123-xxx-456",
  "type": "warranty",
  "external_id": "moje znacka 45",
  "date_buy": "2021-06-03",
  "status": "outgoing",
  "customer": {
    "firstname": "Jaroslav",
    "surname": "Novák",
    "company": "Zaslat s.r.o.",
    "street": "Jindřišská 12/1027",
    "city": "Praha 4",
    "zip": "14000",
    "phone": "+420777152225",
    "email": "novotny@dummymail.com",
    "country": "CZ"
  },
  "shipment_to_customer": true,
  "shipment": {
    "collection": "pickup",
    "weight": 21
  }
}'

Example Request Body

{
  "number": "Z21D083991",
  "product_id": 11,
  "product_model": "MQ 3005 WH CREAM",
  "product_serial_number": "123-xxx-456",
  "type": "warranty",
  "external_id": "moje znacka 45",
  "date_buy": "2021-06-03",
  "status": "outgoing",
  "customer": {
    "firstname": "Jaroslav",
    "surname": "Novák",
    "company": "Zaslat s.r.o.",
    "street": "Jindřišská 12/1027",
    "city": "Praha 4",
    "zip": "14000",
    "phone": "+420777152225",
    "email": "novotny@dummymail.com",
    "country": "CZ"
  },
  "shipment_to_customer": true,
  "shipment": {
    "collection": "pickup",
    "weight": 21
  }
}

json

application/json

Example Responses

{
  "status": 200,
  "message": "OK. Saved.",
  "data": {
    "id": 6350,
    "token": "bfd41c8e6a5361f7e4b95c0f",
    "type": "warranty",
    "number": "Z21D083991",
    "product_type_id": 3,
    "product_model": "MQ 3005 WH CREAM",
    "product_serial_number": "123-xxx-456",
    "external_id": "moje znacka 45",
    "status": "outgoing",
    "substatus": null,
    "date_buy": "2021-06-03",
    "created": "2026-07-01 09:15:32",
    "customer_id": 1234,
    "customer_address": {
      "firstname": "Jaroslav",
      "surname": "Novák",
      "company": "Zaslat s.r.o.",
      "email": "novotny@dummymail.com",
      "phone": "+420777152225",
      "street": "Jindřišská 12/1027",
      "city": "Praha 4",
      "zip": "14000",
      "country": "CZ"
    },
    "service_centre_id": 11,
    "service_centre_address": {
      "company": "Servis Praha s.r.o.",
      "street": "Průmyslová 1200/4",
      "city": "Praha 10",
      "zip": "10200",
      "country": "CZ"
    },
    "activities": [],
    "shipments": [
      {
        "id": 9103,
        "commission_id": 6350,
        "commission_number": "Z21D083991",
        "number": "IZ2345678901",
        "number_carrier": null,
        "carrier": "DPD",
        "type": "outgoing",
        "collection": "pickup",
        "collection_date": "2026-07-07",
        "status": "created",
        "tracking": [],
        "label": null,
        "label_printed": 0,
        "cod": 0,
        "cod_currency": "CZK",
        "weight": 21,
        "last_error": null,
        "created": "2026-07-06 11:40:12"
      }
    ]
  }
}

json

application/json

Nahrání souboru k zakázce

POST

https://nazev-spolecnosti.zaslat.cz/api/v1

/commissions/upload-file

x-apikey (header)

Slouží k nahrání souboru potřebného u záručních oprav, zejména dokladu o nákupu výrobku. Vrácený token se následně použije v poli invoice_file_token při vytvoření zakázky. Povolené koncovky: PDF, JPG, JPEG. Maximální velikost souboru je 2 MB.

Nahrání souboru k zakázce › Request Body

file

string · required

Nahrávaný soubor (PDF, JPG nebo JPEG, max. 2 MB).

Nahrání souboru k zakázce › Responses

200

Soubor byl uložen na externí úložiště.

UploadFileResponse

status

integer

message

string

token

string

Token souboru, použije se v poli invoice_file_token.

url

string

Adresa uloženého souboru na externím úložišti.

execution_time

number · float

Aktivity