给开发者

开发者通过 Partner API v1 把店铺或收银台接到 Delieta。租户来自钥匙。请求从不发送 companyId 或 tenantSlug。钱是整 grosz；v1 唯一货币是 PLN。

签发钥匙

面板：设置 → 集成。明文钥匙只显示一次。格式：dlt_live_… 或 dlt_test_…。

• 秘密钥匙（orders:write、eta:quote）活在服务器上。永不进浏览器，永不叫 NEXT_PUBLIC_。
• 可发布钥匙只有 catalog:read。可以放进静态店，因为它读不到任何私密内容。

测试钥匙读的目录和 live 一样，但不会创建订单（test_key_readonly）。POST /api/v1/orders 需要 dlt_live_…。

先读菜单，再报价，再下单

三个调用，按这个顺序，关掉店铺回路：

1. GET /api/v1/menu — 钥匙所属公司的目录。Scope catalog:read。
2. POST /api/v1/quotes — 到某地址的分钟窗。Scope eta:quote。永远是区间，不是保证。
3. POST /api/v1/orders — 厨房票据。Scope orders:write。Idempotency-Key 头必填。

201 响应带着 order.trackingUrl。那就是你给顾客的链接 — /o/… 页。不要发明第二个跟踪 URL。

读厨房接没接

若公司要求接受，新票据从 pending_acceptance 开始。状态由人或时限改变 — 不是你的后端。所以才有 GET /api/v1/orders/{id}：它花的是读取配额，不是创建配额。

店铺契约，不是 webhook

静态店（Next 导出）在构建时烘焙菜单，购物车是 { itemId, quantity }。那是店铺契约。Delieta 不托管那家店。

没有订单状态 webhook。轮询 GET。

完整参考，与 GET /api/v1/openapi 一致：Partner API。