收到有关交付、出口或处置申请的文件

方法适用于模式FBY.

如果您使用API-Key令牌,调用该方法时需要具备列表中可用权限之一

返回申请文件。

⚙️ 限制: 每小时1,000个请求

Request

POST

https://api.partner.market.yandex.ru/v2/campaigns/{campaignId}/supply-requests/documents

Path parameters

Name

Description

campaignId

Type: integer

广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。

您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:

  • 运动ID;
  • 标签 查询日志 →块中的下拉列表 显示日志.

⚠️ 不要把它与:

  • 商店的标识符,显示在商家的个人帐户中。
  • 广告活动。

Min value: 1

Body

application/json
{
  "requestId": 1
}

Name

Description

requestId

Type: integer

的应用程序ID。

仅在API中使用

在市场上无法在卖方的帐户中找到应用程序。 要做到这一点,请使用 marketplaceRequestIdwarehouseRequestId.

Min value: 1

Responses

200 OK

文档列表和链接。

Body

application/json
{
  "status": "OK",
  "result": {
    "documents": [
      {
        "type": "SUPPLY",
        "url": "example",
        "createdAt": "2025-01-01T00:00:00Z"
      }
    ]
  }
}

Type: object

All of 2 types
  • Type: object

    status

    Type: string

    响应的类型。 可能的值:

    • OK — 没有错误。
    • ERROR — 处理请求时出错。

    Enum: OK, ERROR

    服务器响应的标准包装器。

    Example
    {
      "status": "OK"
    }
    
  • Type: object

    result

    Type: object

    documents

    Type: object[]

    createdAt

    Type: string<date-time>

    创建文档的日期和时间。

    Example: 2025-01-01T00:00:00Z

    type

    Type: string

    文件类别:

    • 商店上传的文档

      • SUPPLY — 的产品清单。
      • ADDITIONAL_SUPPLY — 附加交付中的产品列表。
      • VIRTUAL_DISTRIBUTION_CENTER_SUPPLY — [多派递]产品一览表(*multisupply).
      • TRANSFER — 回收的物品清单。
      • WITHDRAW — 出口货物清单。
    • 交付货物

      • VALIDATION_ERRORS — 货物交付中的错误。
      • CARGO_UNITS — 货物位置的标签。
    • 额外交货和拒收货物

      • ADDITIONAL_SUPPLY_ACCEPTABLE_GOODS — 适合额外交付的产品。
      • ADDITIONAL_SUPPLY_UNACCEPTABLE_GOODS — 出口拒收货物。
    • 货物标签

      • INBOUND_UTD — 传入更新。
      • OUTBOUND_UTD — 传出UPD。
      • IDENTIFIERS — 产品标签代码。
      • CIS_FACT — 接受带有标签代码的产品。
      • ITEMS_WITH_CISES — 需要标签的产品。
      • REPORT_OF_WITHDRAW_WITH_CISES — 标记的货物从仓库出口。
      • SECONDARY_ACCEPTANCE_CISES — 二次验收后验收的标记商品。
      • RNPT_FACT — 批次注册号(RNPT)的已接受货物。
    • 使徒行传

      • ACT_OF_WITHDRAW — 的退货凭证。
      • ANOMALY_CONTAINERS_WITHDRAW_ACT — 撤回被拒收货物的行为。
      • ACT_OF_WITHDRAW_FROM_STORAGE — 从负责任的存储中扣款的行为。
      • ACT_OF_RECEPTION_TRANSFER — 验收和转让证书.
      • ACT_OF_DISCREPANCY — 差异的行为。
      • SECONDARY_RECEPTION_ACT — 次接受的行为。

    Enum: SUPPLY, ADDITIONAL_SUPPLY, VIRTUAL_DISTRIBUTION_CENTER_SUPPLY, TRANSFER, INBOUND_UTD, OUTBOUND_UTD, ADDITIONAL_SUPPLY_ACCEPTABLE_GOODS, ADDITIONAL_SUPPLY_UNACCEPTABLE_GOODS, VALIDATION_ERRORS, WITHDRAW, ACT_OF_WITHDRAW, ANOMALY_CONTAINERS_WITHDRAW_ACT, ACT_OF_WITHDRAW_FROM_STORAGE, ACT_OF_RECEPTION_TRANSFER, ACT_OF_DISCREPANCY, SECONDARY_RECEPTION_ACT, CARGO_UNITS, IDENTIFIERS, CIS_FACT, ITEMS_WITH_CISES, REPORT_OF_WITHDRAW_WITH_CISES, SECONDARY_ACCEPTANCE_CISES, RNPT_FACT

    url

    Type: string

    Min length: 1

    Max length: 2000

    Example: example

    文件列表。

    Min items: 0

    Example
    [
      {
        "type": "SUPPLY",
        "url": "example",
        "createdAt": "2025-01-01T00:00:00Z"
      }
    ]
    

    申请文件的信息。

    Example
    {
      "documents": [
        {
          "type": "SUPPLY",
          "url": "example",
          "createdAt": "2025-01-01T00:00:00Z"
        }
      ]
    }
    
    Example
    {
      "result": {
        "documents": [
          {
            "type": "SUPPLY",
            "url": "example",
            "createdAt": "2025-01-01T00:00:00Z"
          }
        ]
      }
    }
    

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: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "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: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "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: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "code": "example",
          "message": "example"
        }
      ]
      
      Example
      {
        "errors": [
          {
            "code": "example",
            "message": "example"
          }
        ]
      }
      

    服务器错误的标准包装器。

    Example
    {
      "status": "OK",
      "errors": [
        {
          "code": "example",
          "message": "example"
        }
      ]
    }
    

404 Not Found

找不到请求的资源。 有关错误的更多信息

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: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "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: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "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: example

      message

      Type: string

      错误的描述。

      Example: example

      错误列表。

      Min items: 1

      Example
      [
        {
          "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.

阅读它在什么 燕基科斯.对卖家的市场帮助.