# 特殊价格查询（SpecialPrices）
|   接口地址    | /id/b1s/v1/SpecialPrices |
|---|---|
| 接口API功能描述 | 特殊价格接口                   |
| 调用方式      | Get                      |
| 可涵盖范围     | 采购核价单、业务报价单              |
   
请求地址参数
|  参数名称  |                                              参数说明                                               |                              地址示例                              |
|---|---|---|
| ()     | 在地址中加入(业务伙伴代码，物料代码)返回指定特殊价格信息                                                                   | /id/b1s/v1/SpecialPrices(CardCode='C001',ItemCode='I0001')     |
| select | 返回参数筛选，不包括在值中的单据头参数将不会返回，无法限制行明细参数                                                              | /id/b1s/v1/SpecialPrices?$select=ItemCode,CardCode,Price       |
| filter | 筛选条件，特殊价格的条件值为 "$filter=startswith(CardCode, 'a')" | /id/b1s/v1/ApprovalRequests ?$filter=startswith(CardCode, 'C') |
   
返回参数
|     参数名称     | 上级参数  |  参数描述  |  参数类型  |      参数说明       |
|---|---|---|---|---|
| value        |       | 返回值    | List   | 指定单张时无此层级       |
| ItemCode     | Value | 物料代码   |        |                 |
| CardCode     | Value | 业务伙伴代码 |        |                 |
| Price        | Value | 价格     |        |                 |
| Currency     | Value | 币种     |        |                 |
| Valid        | Value | 是否可用   |        | 可用-tYES;不可用-tNO |
| ValidFrom    | Value | 可用起始日期 | String |                 |
| ValidTo      | Value | 可用结束日期 | String |                 |
| PriceListNum | value | 价格清单编号 | int    |                 |
   
返回样例：
{
"value": \[
{
"ItemCode": "11024",
"CardCode": "C23900",
"Price": 111.0,
"Currency": "RMB",
"DiscountPercent": -11.0,
"PriceListNum": 1,
"AutoUpdate": "tYES",
"SourcePrice": "sc_PrimaryCurrency",
"Valid": "tYES",
"ValidFrom": "2022-01-01T00:00:00Z",
"ValidTo": "2025-01-01T00:00:00Z",
"SpecialPriceDataAreas": \[\]
},
{
"ItemCode": "11026",
"CardCode": "C23900",
"Price": 201.0,
"Currency": "RMB",
"DiscountPercent": -0.50,
"PriceListNum": 1,
"AutoUpdate": "tYES",
"SourcePrice": "sc_PrimaryCurrency",
"Valid": "tYES",
"ValidFrom": "2022-01-01T00:00:00Z",
"ValidTo": "2025-01-01T00:00:00Z",
"SpecialPriceDataAreas": \[\]
}
\]
}