配送中心 - Curosa

概览

配送中心端点返回您供应商账户下所有可用的配送中心。每个配送中心都与一个特定站点相关联，并描述了其运营能力。在 API 中处理库存和库存更新时，会引用配送中心代码。

身份验证

此端点需要身份验证。请在 Authorization 请求头中包含您的 API 令牌。有关获取令牌的更多信息，请参阅身份验证指南。

列出所有配送中心

获取您账户下所有可用配送中心的列表。

端点： GET https://curosa.com/api/v1/distribution-centres

请求

curl --location 'https://curosa.com/api/v1/distribution-centres' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

响应

返回 200 OK，其中的 data 数组包含所有配送中心：

{
    "data": [
        {
            "code": "DEMO-DC",
            "name": "Demo Distribution Centre",
            "site": {
                "code": "UK",
                "name": "United Kingdom"
            },
            "is_supplier_dc": true,
            "is_fulfillment_centre": true,
            "is_warehouse": true,
            "is_active": true,
            "leadtime_days": 0,
            "cutoff_time": "17:00:00"
        }
    ]
}

响应字段：

字段	类型	描述
`code`	string	配送中心的唯一标识符。在其他 API 调用中用作引用
`name`	string	配送中心的显示名称
`site`	object	此配送中心所属的站点
`site.code`	string	站点标识符（例如 `"UK"`）
`site.name`	string	站点显示名称（例如 `"United Kingdom"`）
`is_supplier_dc`	boolean	是否为供应商管理的配送中心
`is_fulfillment_centre`	boolean	该中心是否可以履行客户订单
`is_warehouse`	boolean	该中心是否可以存放库存
`is_active`	boolean	该配送中心当前是否处于运营状态
`leadtime_days`	integer	发货前处理所需的提前天数
`cutoff_time`	string	每日订单截单时间，超过该时间后的订单将在次日处理（格式：`"HH:MM:SS"`）

使用配送中心代码

code 值用于在其他 API 调用中引用配送中心，例如在设置产品库存水平时：

{
    "distribution_centre_stock": [
        {
            "distribution_centre_code": "DEMO-DC",
            "stock_quantity": 50
        }
    ]
}

速率限制

此端点的速率限制为 每小时 3,600 次请求。当前限制和剩余请求数将通过响应头中的 x-ratelimit-limit 和 x-ratelimit-remaining 返回。