Florea.cz / dokumentace

API dokumentace

Autorizace

Základní autorizace pomocí jména a hesla, které vám budou přiděleny na adrese michal.marek@florea.cz.

https://www.florea.cz/api/deliveryDates

[
    {
        "date": "2024-05-24", // datum
        "dayName": "pátek", // jméno dne, příp. dnes / zítra
        "dayInWeek": "5", // číslo dne v týdnu
        "price": {
            // aktuální cena našeho rozvozu
            "price": "119.830",
            "priceDph": 145
        },
        "priceDph": 145,
        "surcharge": 0, // výše doplatku / slevy oproti běžné ceně doručení, je-li nastavena speciální cena doručení
        "surchargeSign": "", // +/- dle toho, zda je doplatek či sleva
        "womenNamesday": "Jana", // jmeniny (pouze ženská jména)
        "personalCollectionOnly": false, // true v případě, že lze objednat jen osobní vyzvednutí
        "orderLimitOnTime": "10", // limit počtu objednávek pro doručení na minutu
        "orderLimitOnTimeAvailable": 0, // počet dostupných slotů pro doručení na minutu
        "blockDeliveryOntime": true, // true pokud nelze objednat doručení na minutu
        "orderLimitCustom": {
            // aktuálně nastavený počet slotů pro doručení na dopoledne / odpoledne
            "1": 10, // dopoledne
            "2": 10 // odpoledne
        },
        "orderLimitCustomAvailable": {
            // počet dostupných slotů pro doručení na dopoledne / odpoledne
            "1": 3, // dopoledne
            "2": 7 // odpoledne
        },
        "blockDeliveryCustom": {
            "1": false, // true pokud nelze objednat doručení na dopoledne
            "2": false // true pokud nelze objednat doručení na odpoledne
        },
        "blockDeliveryCustomOverall": false, // true pokud nelze objednat ani na dopoledne, ani na odpoledne
        "priceCustom": 346, // aktuální cena doručení na dopoledne / odpoledne vč. DPH
        "limits": {
            "orderLimit": "100", // limit počtu objednávek na tento den
            "ordersCount": "5", // aktuální počet objednávek na tento den
            "ordersRemaining": 95, // počet zývajících objednávek
            "stopOrders": false // true pokud na tento den již nelze objednat
        }
    },
    {
        "date": "2024-05-27",
        "dayName": "pondělí",
        "dayInWeek": "1",
        "price": {
            "price": "119.830",
            "priceDph": 145
        },
        "priceDph": 145,
        "surcharge": 0,
        "surchargeSign": "",
        "womenNamesday": null,
        "personalCollectionOnly": false,
        "orderLimitOnTime": "8",
        "orderLimitOnTimeAvailable": 8,
        "blockDeliveryOntime": false,
        "orderLimitCustom": {
            // aktuálně nastavený počet slotů pro doručení na dopoledne / odpoledne
            "1": 5, // dopoledne
            "2": 5 // odpoledne
        },
        "orderLimitCustomAvailable": {
            // počet dostupných slotů pro doručení na dopoledne / odpoledne
            "1": 0, // dopoledne
            "2": 0 // odpoledne
        },
        "blockDeliveryCustom": {
            "1": true, // true pokud nelze objednat doručení na dopoledne
            "2": true // true pokud nelze objednat doručení na odpoledne
        },
        "blockDeliveryCustomOverall": true, // true pokud nelze objednat ani na dopoledne, ani na odpoledne
        "priceCustom": 346, // aktuální cena doručení na dopoledne / odpoledne vč. DPH
        "limits": false
    }
]

https://www.florea.cz/api/productStock/12345

{
    "stock": 211, // aktuální počet kusů skladem
    "deliverableFrom": "0000-00-00", // datum pro předobjednání (pro případ, že jsou květiny teprve na cestě z burzy)
    "price": "72.73", // aktuální cena bez DPH
    "priceDph": "88.00" // aktuální cena vč. DPH
}

https://www.florea.cz/api/orders/2024-05-22

[
    "678662",
    "678672",
    "678673",
    "678681",
    "678684",
    "678689",
    "678691",
    "678694",
    "678697",
    "678702",
    "678737",
    "678759",
    "678771",
    "678775",
    "678778"
]

https://www.florea.cz/api/ordersUpdated/2024-05-22

[
    "678662",
    "678672",
    "678673",
    "678702",
    "678737",
    "678759",
    "678771",
    "678775",
    "678778"
]

https://www.florea.cz/api/order/123456

{
    "id": "123456", // ID objednávky
    "archive": false, // true pokud je objednávka v archivu
    "shop": "1", // ID shopu, z kterého bylo objednáno
    "type": "1", // 1 = běžná, 2 = storno, 3 = reklamace, 4 = dodací list, 5 = faktura, 6 = opravný daň. doklad
    "user": "123456", // ID uživatele
    "dateCreated": "2024-05-14 17:19:03", // datum a čas vytvoření
    "dateUpdated": "2024-05-15 12:34:52", // datum a čas poslední editace
    "dateCanceled": "0000-00-00 00:00:00", // datum a čas provedení storna / reklamace
    "dateDue": "0000-00-00", // datum splatnosti
    "datePaid": "0000-00-00", // datum zaplacení
    "dateTaxSupply": "0000-00-00", // datum zd. plnění
    "dateDelivery": "2024-05-14", // vybraný datum dodání
    "dateDeliveryReal": "0000-00-00 00:00:00", // datum a čas skutečného doručení
    "shipping": {
        // informace o zvolené dopravě
        "id": "1",
        "name": "Doručení chlazenými vozy KAMKOLIV po ČR"
    },
    "payment": {
        // informace o zvolené platbě
        "id": "5",
        "name": "Kartou on-line",
        "cod": "0", // 0/1 dobírka
        "codCard": "0", // 0/1 dobírka kartou
        "card": "1", // 0/1 kartou on-line
        "bankTransfer": "0", // 0/1 převod na účet
        "paypal": "0", // 0/1 Paypal
        "twisto": "0", // 0/1 Twisto
        "googlepay": "0", // 0/1 Google Pay
        "applepay": "0" // 0/1 Apple Pay
    },
    "paymentStatus": "0", // stav platby - 0 = neplaceno, 1 = placeno, 2 = dobírka
    "currency": "CZK", // měna, v které objednávka vznikla
    "exchangeRate": "0.00", // směnný kurz v době vzniku objednávky
    "payer": {
        // údaje o kupujícícm
        "name": "Jan Novák",
        "company": "Florea Holland s.r.o",
        "companyIc": "02777606",
        "companyDic": "CZ02777606",
        "street": "Roháčova 145/14",
        "city": "Praha 3",
        "zip": "13000",
        "phone": "+420123456789",
        "email": "obchod@florea.cz"
    },
    "gifted": {
        // údaje o obdarovaném
        "name": "Jana Nováková",
        "company": "Florea Holland s.r.o",
        "street": "Roháčova 145/14",
        "city": "Praha 3",
        "zip": "13000",
        "country": "CZ",
        "phone": "+420123456789",
        "gps": "50.086590,14.454358"
    },
    "note": "", // poznámka zákazníka
    "noteCourier": "", // poznámka pro kurýra
    "noteAdmin": "", // interní poznámka
    "bouquetsQuantity": "0", // počet kytic v objednávce (zadává ZS)
    "operator": {
        // údaje o operátorovi; není-li přiřazen, vrací null
        "id": "111",
        "name": "Jiří Nápomocný"
    },
    "courier": "0", // číslo přiděleného kurýra
    "courierOrder": "0", // pořadí v rozvozovém plánu kurýra
    "courierDeliveryTime": "00:00:00", // naplánovaný čas dodání
    "products": [
        {
            "id": "88415", // ID produktu
            "type": "1", // 1 = běžný, 2 = sleva, 3 = platba, 4 = doručení, 5 = předobjednávka
            "name": "Kytice 25 růžových růží BABYFACE 60cm", // název produktu
            "quantity": "1.00", // počet kusů
            "price": "557.02", // cena
            "priceDph": "673.99", // cena včetně DPH
            "pricePurchase": "0.00", // nákupní cena
            "dph": "21", // sazba DPH
            "bouquetType": "1", // 0 = běžný produkt, 1 = kytice, 2 = produkt uvnitř kytice
            "bouquetId": "88415", // ID kytice (vyplněno v případě bouquetTyp = 1 nebo 2)
            "prebound": "0" // 0/1 předvázaná kytice
        },
        {
            "id": "47215",
            "type": "1",
            "name": "Růžová růže BABYFACE 60cm (S)",
            "quantity": "25.00",
            "price": "",
            "priceDph": "",
            "pricePurchase": "4.00",
            "dph": "",
            "bouquetType": "2",
            "bouquetId": "88415",
            "prebound": "0"
        },
        {
            "id": "0",
            "type": 3,
            "name": "Kartou on-line",
            "quantity": "1.00",
            "price": "0.00",
            "priceDph": "0.00",
            "pricePurchase": "0.00",
            "dph": "21",
            "bouquetType": "0",
            "bouquetId": "0",
            "prebound": "0"
        },
        {
            "id": "0",
            "type": 4,
            "name": "Profesionální rozvoz květin s GPS sledováním",
            "quantity": "1.00",
            "price": "0.00",
            "priceDph": "0.00",
            "pricePurchase": "0.00",
            "dph": "21",
            "bouquetType": "0",
            "bouquetId": "0",
            "prebound": "0"
        }
    ]
}

Proměnné

Proměnné lze vkládat do libovolného textu, který je zadáván přes editor, případně i v jiných případech, kdy je na to v adminu vždy upozorněno.

Globální proměnné

Globální proměnné lze použít v jakémkoliv textu, který je zadáván přes editor.

Lokální proměnné - Rozvoz květin

Tyto proměnné lze použít pouze u automatických stránek typu Rozvoz květin.