关闭文件
方法适用于模式：FBY, FBS, Express 和 DBS.
如果您使用API-Key令牌，调用该方法时需要具备列表中可用权限之一
- finance-and-accounting — 查看财务信息和报告
- all-methods — 全面管理账户
- all-methods:read-only — 查看所有数据
返回带有关闭文档格式的ZIP存档 PDF 指定月份。
文件的组成取决于合同的类型
-
就业协议
- 提供服务法
- 发票
- 统计摘要报告
- 关于执行转让和解决相互索赔的报告 (代理人报告)
-
推广协议 （2024年9月30日之后未在俄罗斯结束）
- 服务提供法
- 发票 如果税收计划需要它
-
营销协议
- 提供服务法
- 发票
- 预付发票
- 个人户口结单
- 法案详情
您可以查找生成状态，并使用请求获取到存档的链接。 GET v2/reports/info/{reportId}.
| ⚙️ 限制: 每小时1,000个请求 |
|---|
Request
POST
https://api.partner.market.yandex.ru/v2/reports/closure-documents/generate
Body
application/json
{
"campaignId": 1,
"monthOfYear": {
"year": 2025,
"month": 12
},
"contractTypes": [
"INCOME"
]
}
|
Name |
Description |
||||
|
campaignId |
Type: integer 广告系列（商店）的ID — 通过API工作时，代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接，但仅用于自动交互。 您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中，选择 Api和模块:
⚠️ 不要把它与:
Min value: |
||||
|
monthOfYear |
Type: object
月份和年份。 Example |
||||
|
contractTypes |
Type: string[] | null 需要关闭文件的合同类型。 如果您不指定它们，则将返回包含所有找到的合同的文档的存档。 Min items: Max items: Unique items: Example |
Responses
200 OK
ZIP档案与关闭文件的格式 PDF.
Body
application/json
{
"status": "OK",
"result": {
"reportId": "example",
"estimatedGenerationTime": 0
}
}
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
result
Type: object
estimatedGenerationTime
Type: integer
预计生成时间以毫秒为单位。
reportId
Type: string
跟踪生成状态和接收完成的报告或文档所需的ID。
Example:
example跟踪生成状态和接收完成的报告或文档所需的ID。
Example
{ "reportId": "example", "estimatedGenerationTime": 0 }Example
{ "result": { "reportId": "example", "estimatedGenerationTime": 0 } }
400 Bad Request
请求包含不正确的数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
401 Unauthorized
请求中未指定授权数据。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
403 Forbidden
授权数据不正确或禁止访问资源。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
420 Method Failure
已超出资源访问限制。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
500 Internal Server Error
Yandex中的内部错误。 市场。 有关错误的更多信息
Body
application/json
{
"status": "OK",
"errors": [
{
"code": "example",
"message": "example"
}
]
}
Type: object
All of 1 type
-
Type: object
All of 2 types
-
Type: object
status
Type: string
响应的类型。 可能的值:
OK— 没有错误。ERROR— 处理请求时出错。
Enum:
OK,ERROR服务器响应的标准包装器。
Example
{ "status": "OK" } -
Type: object
errors
Type: object[]
code
Type: string
的错误代码。
Example:
examplemessage
Type: string
错误的描述。
Example:
example错误列表。
Min items:
1Example
[ { "code": "example", "message": "example" } ]Example
{ "errors": [ { "code": "example", "message": "example" } ] }
服务器错误的标准包装器。
Example
{ "status": "OK", "errors": [ { "code": "example", "message": "example" } ] } -
No longer supported, please use an alternative and newer version.
它列出了过去一个月市场向卖方提供的所有服务。
阅读更多关于该法案的信息 燕基科斯.对卖家的市场帮助.
它列出了市场在过去一个月向卖家提供的所有服务。
这是一份由政府特别法令规定的强制性文件。
发票包含与所提供服务证书中相同的信息。 使用act进行会计和分析更方便。
这是一份由政府特别法令规定的强制性文件。
发票包含与服务交付证书相同的信息。 使用act进行会计和分析更方便。
商店的会计需要一份总结报告，以反映会计中的商品销售情况。
这份报告是为根据模型经营的商店编制的 FBY 和 FBS. 它表示项目的数量和数量:
- 发送给客户;
- 交付给客户;
- 买家没有回购;
- 买家还了。
阅读更多有关报告的资料 燕基科斯.对卖家的市场帮助.
该报告显示了市场从客户那里收到了多少钱，已经转移给卖家的钱，以及它还欠了多少钱。
阅读更多有关报告的资料 燕基科斯.对卖家的市场帮助.
该法案规定:
- 市场提供给客户的所有产品折扣的总额;
- 市场已提供给客户的所有运费折扣总额（仅适用于型号 DBS);
- 以加分为单位的付款总额。
显示卖家尚未花费的月初余额金额。 这份文件对会计很有用.
显示卖家余额 — 费用和月底的余额。
显示卖方或广告商的所有品牌提供的服务。 详细信息对于会计目的很有用。