介绍
# BrickLink
使用 `scripts/bricklink.py`。
## 安装设置
请参阅 [SETUP.md](SETUP.md) 了解先决条件和安装说明。
## 命令
### 只读
- `bricklink.py get-orders [--direction in|out] [--status ...] [--include-status ...] [--exclude-status ...] [--filed true|false]` - 列出您收到或发出的订单。 - `bricklink.py get-order <order_id>` - 获取特定订单的详细信息。 - `bricklink.py get-order-items <order_id>` - 获取特定订单的批次商品。 - `bricklink.py get-order-messages <order_id>` - 获取与特定订单关联的消息。 - `bricklink.py get-order-feedback <order_id>` - 获取与特定订单关联的反馈。
- `bricklink.py get-feedback [--direction in|out]` - 列出您收到的 (`in`) 或发布的 (`out`) 反馈。 - `bricklink.py get-feedback-item <feedback_id>` - 根据 id 获取单条反馈。
- `bricklink.py get-notifications` - 列出未读推送通知 (`/notifications`)。
- `bricklink.py get-categories` - 列出所有目录分类。 - `bricklink.py get-category <category_id>` - 根据 id 获取单个分类。
- `bricklink.py get-colors` - 列出所有目录颜色。 - `bricklink.py get-color <color_id>` - 根据 id 获取单个颜色。
- `bricklink.py get-inventories [--item-type ...] [--status ...] [--category-id ...] [--color-id ...]` - 列出您商店的库存批次（支持包含/排除筛选器）。 - `bricklink.py get-inventory <inventory_id>` - 根据 id 获取单个库存批次。
- `bricklink.py get-item <type> <no>` - 获取目录商品（PART/SET/MINIFIG/…）。 - `bricklink.py get-supersets <type> <no> [--color-id N]` - 列出包含指定商品的商品。 - `bricklink.py get-subsets <type> <no> [--color-id N] [--box true|false] [--instruction true|false] [--break-minifigs true|false] [--break-subsets true|false]` - 将商品拆解为其包含的子项。 - `bricklink.py get-price-guide <type> <no> [--color-id N] [--guide-type stock|sold] [--new-or-used N|U] [--country-code XX] [--region ...] [--currency-code XXX] [--vat N|Y|O]` - 获取价格指南统计数据。 - `bricklink.py get-known-colors <type> <no>` - 列出目录商品的已知颜色。
### 修改类
> **注意：** 订单修改操作（update-order、update-order-status、update-payment-status）仅适用于 **店铺订单**（direction=out，即您是卖家的情形）。购买订单（direction=in）将返回 404 —— BrickLink API 不允许买家修改订单状态或归档/存档收到的订单。请使用 BrickLink 网站进行这些操作。
- `bricklink.py update-order <order_id> [--remarks ...] [--is-filed true|false] [--shipping-...] [--cost-...]` — 更新允许的订单字段（物流单号、备注、运费/成本字段）。仅限店铺订单。 - `bricklink.py update-order-status <order_id> <status>` — 更新订单状态。仅限店铺订单。 - `bricklink.py update-payment-status <order_id> <payment_status>` — 更新订单的付款状态。仅限店铺订单。 - `bricklink.py send-drive-thru <order_id> [--mail-me]` — 为订单发送一封“免下车取货”邮件。
- `bricklink.py post-feedback --order-id N --rating 0|1|2 [--comment ...]` - 为订单发布新反馈。 - `bricklink.py reply-feedback <feedback_id> --reply "..."` - 回复您收到的反馈。
- `bricklink.py create-inventory [--item-type ... --item-no ... --color-id N --quantity N --unit-price ... --new-or-used N|U ...]` - 通过参数创建单个库存批次。 - `bricklink.py create-inventory --file batch.json` - 通过经过验证的 JSON 文件创建多个库存批次（仅限 workspace 或 /tmp 目录）。 - `bricklink.py update-inventory <inventory_id> [--quantity N --unit-price ... --new-or-used N|U --remarks ...]` - 更新库存批次。 - `bricklink.py delete-inventory <inventory_id>` - 删除库存批次。
### 实用工具
- `bricklink.py order-detail-html <order_id> [--out path] [--inline-images]` - 获取订单及商品详情，并生成紧凑的 HTML 视图（类似于 BrickLink 的 orderDetail.asp）。