API API pro generování podacích lístků

PodaciListek.cz poskytuje možnost vyplňování podacích lístků za pomocí API. Přenos dat je realizován pomocí protokolu HTTP.

  • Typ požadavku - Požadavek je nutno odeslat pomocí protokolu HTTP pod hlavičkou POST.
  • Formát dat - Požadavek na PodaciListek.cz API je nutno zasílat ve formátu JSON.

Adresa API

  • 1.
    Verze 4 – https://podacilistek.cz/api/v4 – generování podacích lístků v PDF

Struktura

Schéma požadavku

{
  "tickets": [
    {
      "sender": {
        "name": "string",
        "street": "string",
        "city": "string",
        "post_code": "string",
        "phone": "string",
        "email": "string",
        "code": "string"
      },
      "receiver": {
        "name": "string",
        "street": "string",
        "street2": "string",
        "city": "string",
        "post_code": "string",
        "phone": "string",
        "email": "string"
      },
      "cash_on_delivery": "string",
      "declared_cash": "string",
      "note": "string"
    }
  ],
  "both_sides": false
}
tickets
pole podacích lístků (array)
sender
odesilatel – skupina údajů o odesilateli
receiver
příjemce – skupina údajů o příjemci
name
jméno na podacím lístku
street
ulice na podacím lístku
street2
druhý řádek ulice – pouze u příjemce
post_code
poštovní směrovací číslo
city
město
phone
telefonní číslo pro avízo
email
e-mail pro avízo
code
kód zákazníka
cash_on_delivery
dobírka v Kč
declared_cash
udaná cena v Kč
note
poznámka k lístku
both_sides
tisknout i druhou stranu lístku (true/false)

Příklad

Příklad požadavku curl pro 1 podací lístek v4:

curl -v -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "tickets": [
      {
        "sender": {
          "name": "Jan Novák",
          "street": "Václavské náměstí 1",
          "post_code": "11000",
          "city": "Praha 1"
        },
        "receiver": {
          "name": "Marie Svobodová",
          "street": "Náměstí Míru 5",
          "post_code": "12000",
          "city": "Praha 2"
        },
        "cash_on_delivery": "500",
        "note": "Křehké"
      }
    ],
    "both_sides": false
  }' \
  https://podacilistek.cz/api/v4 > podaci_listek.pdf
Přidat lístek
FakturaOnline.cz
Fakturujte online, rychle a bezpečně
Vystavit fakturu
Zdarma. Online.
Za 30 vteřin.