Quote an order

Developing

POST

/orders/quote

Prices a basket and returns exactly what POST /orders would charge — without creating anything.

Same body, same validation, same error codes as POST /orders. Nothing is written and nothing is reserved,
so a product can still sell out between the quote and the order.

Use it to render the basket and the total in your own checkout. The response has no uid,
internal_id, number, status, payment_status or created_at — only totals, applied, items and warnings.

Required ability: orders:write.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Priced basket. Nothing was created.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

🟠422Parameter Error

🟠429

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://fodimi.pl/api_public/orders/quote' \
--header 'Content-Type: application/json' \
--data-raw '{
    "restaurant_uid": "b06a191d-8e22-4707-8c1e-9b5119cf4461",
    "delivery_type": "DELIVERY",
    "status": "NEW",
    "payment": {
        "status": "NOT_PAID",
        "method": "CASH"
    },
    "customer": {
        "name": "Jan",
        "surname": "Kowalski",
        "email": "jan@example.com",
        "phone": "+48500600700"
    },
    "delivery_address": {
        "street_and_number": "Długa 5/3",
        "city": "Warszawa",
        "post_code": "00-001",
        "latitude": 52.23,
        "longitude": 21.01,
        "comments": "domofon 12"
    },
    "items": [
        {
            "product_id": 4211,
            "quantity": 2,
            "variant_price_id": 8912,
            "comments": "bez cebuli",
            "addon_groups": [
                {
                    "id": 88,
                    "selection": [
                        301,
                        302
                    ],
                    "removed": [
                        305
                    ]
                }
            ]
        },
        {
            "product_id": 4290,
            "quantity": 1,
            "set_selections": [
                {
                    "step_id": 11,
                    "step_product_id": 77
                },
                {
                    "step_id": 12,
                    "step_product_id": 81
                }
            ]
        }
    ],
    "promo_code": "LATO20",
    "tip": 5
}'

Response Example

200 - Success Example

{
    "totals": {
        "products": 84,
        "packages": 2,
        "environmental_fees": 0.5,
        "deposit": 0,
        "handling_fee": 0,
        "delivery_cost": 9,
        "tip": 5,
        "promo_code_discount": 16.8,
        "special_offer_discount": 0,
        "total": 83.7,
        "currency": "PLN"
    },
    "applied": {
        "promo_code": "LATO20",
        "special_offer": null,
        "delivery_zone": {
            "id": 9,
            "name": "Strefa 1",
            "min_order_amount": 40
        }
    },
    "items": [
        {
            "product_id": 4211,
            "name": "Margherita",
            "quantity": 2,
            "unit_price": 42,
            "subtotal": 84,
            "variant": {
                "name": "40 cm"
            },
            "addons": [
                {
                    "id": 301,
                    "group_id": 88,
                    "name": "Ser",
                    "price": 4,
                    "removed": false
                }
            ],
            "set_selections": [],
            "package_price": 2
        }
    ],
    "warnings": [
        {
            "code": "special_offer_applied",
            "message": "Do zamówienia została automatycznie zastosowana promocja lokalu."
        }
    ]
}

Modified at 2026-09-12 12:21:09

Create an order

Get menu