接收通知

市场向商店发送有关事件的通知:

  • 创建新订单;
  • 订单修改;
  • 订单状态更改;
  • 创建与客户的新聊天;
  • 在聊天中添加新消息;
  • 争端的开始;
  • 争端的结束;
  • 创建新产品评论;
  • 创建新的评论评论;
  • 创建订单取消请求;
  • 取消订单;
  • 创建新的非购买或退款;
  • 更改非购买或退款状态。

Учитывайте эти особенности в работе с уведомлениями

  • 燕基科斯.市场可以为同一事件发送多个通知。

    在某些情况下,这是正常行为。 例如,由于搜索快递员,订单状态可能会发生变化。

  • 通知中的时间、对市场请求的响应以及您的系统中的时间可能会有所不同。

    这是由于在发送通知时,订单状态可能已经不同。

    在请求 POST notification 活动时间到了 createdAt, updatedAtcancelledAt. 参数的选择取决于通知的类型。

考虑事件的稍后时间是相关的。 它可以在通知中,响应市场请求返回,或存储在您的系统中。

接收响应超时:常规通知为10秒,验证通知为1秒 PING.

Request

POST

/notification

Body

application/json
{
  "notificationType": "PING",
  "time": "2025-01-01T00:00:00Z"
}

Name

Description

notificationType

Type: string

通知类型:

  • PING — 验证通知。
  • ORDER_CREATED — 一个新的秩序已经建立。
  • ORDER_CANCELLED — 订单已被取消。
  • ORDER_STATUS_UPDATED — 订单状态已更改。
  • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
  • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
  • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
  • ORDER_UPDATED — 顺序已更改。
  • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
  • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
  • CHAT_CREATED — 已创建与买方的新聊天。
  • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
  • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
  • CHAT_ARBITRAGE_FINISHED — 争议结束了。
  • QUESTION_CREATED — 创建了一个新问题。
  • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
  • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

One of 17 types
  • Type: object

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    time

    Type: string<date-time>

    商店处理通知的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    验证通知。

    notificationType = PING

    Example
    {
      "notificationType": "PING",
      "time": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    campaignId

    Type: integer

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

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

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

    ⚠️ 不要把它与:

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

    Min value: 1

    createdAt

    Type: string<date-time>

    创建订单的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    items

    Type: object[]

    count

    Type: integer

    品的数量。

    offerId

    Type: string

    你的 SKU — 系统中的产品ID。

    使用规则 SKU:

    • 对于每个产品 SKU 一定有一个。

    • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

    SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助.

    重要

    值开头和结尾的空格会自动删除。 例如, " SKU123 ""SKU123" 它们将被视为相同的值。

    什么是 SKU 以及如何分配它

    Min length: 1

    Max length: 255

    Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

    Example: example

    订单中的产品列表。

    Example
    [
      {
        "offerId": "example",
        "count": 0
      }
    ]
    

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    orderId

    Type: integer

    的订单ID。

    创建新订单的通知。

    notificationType = ORDER_CREATED

    Методы, которые могут быть полезны

    POST v2/campaigns/{campaignId}/orders/{orderId}/external-id — 传输外部订单ID。

    POST v1/businesses/{businessId}/orders — 获取有关订单的详细信息(通过 orderIds).

    Example
    {
      "notificationType": "PING",
      "orderId": 0,
      "campaignId": 1,
      "items": [
        {
          "offerId": "example",
          "count": 0
        }
      ],
      "createdAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    campaignId

    Type: integer

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

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

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

    ⚠️ 不要把它与:

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

    Min value: 1

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    orderId

    Type: integer

    的订单ID。

    status

    Type: string

    订单状况:

    • PLACING — 它正在处理,准备预订。

    • RESERVED — 保留,但注册不足(仅适用于LaaS)。

    • UNPAID — 已发出,但尚未付款(如果在结账时选择付款)。

    • PROCESSING — 它正在处理中。

    • DELIVERY — 转移到送货服务。

    • PICKUP — 送到取件点。

    • DELIVERED — 由买方接收。

    • CANCELLED — 取消。

    • PENDING — 等待卖方处理。

    • PARTIALLY_RETURNED — 部分退款。

    • RETURNED — 全额回来了。

    • UNKNOWN — 状态不明。

    也可以返回其他值。 您不需要处理它们。

    Enum: PLACING, RESERVED, UNPAID, PROCESSING, DELIVERY, PICKUP, DELIVERED, CANCELLED, PENDING, PARTIALLY_RETURNED, RETURNED, UNKNOWN

    substatus

    Type: string

    订单处理阶段(状态 PROCESSING)或取消订单的原因(状态 CANCELLED).

    • 状态中的订单值 PROCESSING:

      • STARTED — 订单已确认,可以处理。

      • READY_TO_SHIP — 订单已组装并准备装运。

    • 状态中的订单值 CANCELLED:

      • RESERVATION_EXPIRED — 客户没有在10分钟内完成预订订单。

      • USER_NOT_PAID — 买方没有为订单付款(对于付款类型 PREPAID)30分钟。

      • USER_UNREACHABLE — 无法联系买家。 为此取消,必须满足以下条件:

        • 至少3个电话从8到21在买方的时区;
        • 第一次和第三次通话之间的休息时间至少为90分钟;
        • 连接不短于5秒。

        如果不满足其中至少一个条件(号码不可用时除外),您将无法取消订单。 将返回带有错误代码400的响应。

      • USER_CHANGED_MIND — 客户因个人原因取消了订单。

      • USER_REFUSED_DELIVERY — 买方对交货条件不满意.

      • USER_REFUSED_PRODUCT — 该产品不适合买方。

      • SHOP_FAILED — 商店无法完成订单。

      • USER_REFUSED_QUALITY — 买方对产品的质量不满意。

      • USER_IDENTIFICATION_MISMATCH — 买方的身份证明文件与订单中的数据不匹配。

      • REPLACING_ORDER — 买方决定主动更换另一种产品。

      • PROCESSING_EXPIRED — 值不再使用。

      • PICKUP_EXPIRED — 取货点的订单保质期已过期。

      • TOO_MANY_DELIVERY_DATE_CHANGES — 订单被推迟了太多次。

      • TOO_LONG_DELIVERY — 订单太长时间无法交付。

      • INCORRECT_PERSONAL_DATA — 对于来自国外的订单,收件人的信息不正确,订单将不会在海关检查。

    • TECHNICAL_ERROR — 市场方面的技术错误。 联系支持。

    也可以返回其他值。 您不需要处理它们。

    Enum: RESERVATION_EXPIRED, USER_NOT_PAID, USER_UNREACHABLE, USER_CHANGED_MIND, USER_REFUSED_DELIVERY, USER_REFUSED_PRODUCT, SHOP_FAILED, USER_REFUSED_QUALITY, REPLACING_ORDER, PROCESSING_EXPIRED, PENDING_EXPIRED, SHOP_PENDING_CANCELLED, PENDING_CANCELLED, USER_FRAUD, RESERVATION_FAILED, USER_PLACED_OTHER_ORDER, USER_BOUGHT_CHEAPER, MISSING_ITEM, BROKEN_ITEM, WRONG_ITEM, PICKUP_EXPIRED, DELIVERY_PROBLEMS, LATE_CONTACT, CUSTOM, DELIVERY_SERVICE_FAILED, WAREHOUSE_FAILED_TO_SHIP, DELIVERY_SERVICE_UNDELIVERED, PREORDER, AWAIT_CONFIRMATION, STARTED, PACKAGING, READY_TO_SHIP, SHIPPED, ASYNC_PROCESSING, WAITING_USER_INPUT, WAITING_BANK_DECISION, BANK_REJECT_CREDIT_OFFER, CUSTOMER_REJECT_CREDIT_OFFER, CREDIT_OFFER_FAILED, AWAIT_DELIVERY_DATES_CONFIRMATION, SERVICE_FAULT, DELIVERY_SERVICE_RECEIVED, USER_RECEIVED, WAITING_FOR_STOCKS, AS_PART_OF_MULTI_ORDER, READY_FOR_LAST_MILE, LAST_MILE_STARTED, ANTIFRAUD, DELIVERY_USER_NOT_RECEIVED, DELIVERY_SERVICE_DELIVERED, DELIVERED_USER_NOT_RECEIVED, USER_WANTED_ANOTHER_PAYMENT_METHOD, USER_RECEIVED_TECHNICAL_ERROR, USER_FORGOT_TO_USE_BONUS, DELIVERY_SERVICE_NOT_RECEIVED, DELIVERY_SERVICE_LOST, SHIPPED_TO_WRONG_DELIVERY_SERVICE, DELIVERED_USER_RECEIVED, WAITING_TINKOFF_DECISION, COURIER_SEARCH, COURIER_FOUND, COURIER_IN_TRANSIT_TO_SENDER, COURIER_ARRIVED_TO_SENDER, COURIER_RECEIVED, COURIER_NOT_FOUND, COURIER_NOT_DELIVER_ORDER, COURIER_RETURNS_ORDER, COURIER_RETURNED_ORDER, WAITING_USER_DELIVERY_INPUT, PICKUP_SERVICE_RECEIVED, PICKUP_USER_RECEIVED, CANCELLED_COURIER_NOT_FOUND, COURIER_NOT_COME_FOR_ORDER, DELIVERY_NOT_MANAGED_REGION, INCOMPLETE_CONTACT_INFORMATION, INCOMPLETE_MULTI_ORDER, INAPPROPRIATE_WEIGHT_SIZE, TECHNICAL_ERROR, SORTING_CENTER_LOST, COURIER_SEARCH_NOT_STARTED, LOST, AWAIT_PAYMENT, AWAIT_LAVKA_RESERVATION, USER_WANTS_TO_CHANGE_ADDRESS, FULL_NOT_RANSOM, PRESCRIPTION_MISMATCH, DROPOFF_LOST, DROPOFF_CLOSED, DELIVERY_TO_STORE_STARTED, USER_WANTS_TO_CHANGE_DELIVERY_DATE, WRONG_ITEM_DELIVERED, DAMAGED_BOX, AWAIT_DELIVERY_DATES, LAST_MILE_COURIER_SEARCH, PICKUP_POINT_CLOSED, LEGAL_INFO_CHANGED, USER_HAS_NO_TIME_TO_PICKUP_ORDER, DELIVERY_CUSTOMS_ARRIVED, DELIVERY_CUSTOMS_CLEARED, FIRST_MILE_DELIVERY_SERVICE_RECEIVED, AWAIT_AUTO_DELIVERY_DATES, AWAIT_USER_PERSONAL_DATA, NO_PERSONAL_DATA_EXPIRED, CUSTOMS_PROBLEMS, AWAIT_CASHIER, WAITING_POSTPAID_BUDGET_RESERVATION, AWAIT_SERVICEABLE_CONFIRMATION, POSTPAID_BUDGET_RESERVATION_FAILED, AWAIT_CUSTOM_PRICE_CONFIRMATION, READY_FOR_PICKUP, TOO_MANY_DELIVERY_DATE_CHANGES, TOO_LONG_DELIVERY, DEFERRED_PAYMENT, POSTPAID_FAILED, INCORRECT_PERSONAL_DATA, CUSTOMS_FAILED_MARKET, CUSTOMS_FAILED_USER_COMMERCIAL_ITEMS, CUSTOMS_FAILED_USER_DUTY_NOT_PAID, CUSTOMS_FAILED_USER_INVALID_PERSONAL_DATA, CUSTOMS_FAILED_USER_ADDITIONAL_DATA_NOT_PROVIDED, AWAIT_PAYMENT_AFTER_DELIVERY, AWAIT_USER_STEAM_FAST_URL, USER_IDENTIFICATION_MISMATCH, UNKNOWN

    updatedAt

    Type: string<date-time>

    订单状态更改的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    订单状态更改的通知。

    notificationType = ORDER_STATUS_UPDATED

    Чтобы изменить статус заказа

    Example
    {
      "notificationType": "PING",
      "orderId": 0,
      "campaignId": 1,
      "status": "PLACING",
      "substatus": "RESERVATION_EXPIRED",
      "updatedAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    campaignId

    Type: integer

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

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

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

    ⚠️ 不要把它与:

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

    Min value: 1

    cancelledAt

    Type: string<date-time>

    取消订单的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    items

    Type: object[]

    count

    Type: integer

    品的数量。

    offerId

    Type: string

    你的 SKU — 系统中的产品ID。

    使用规则 SKU:

    • 对于每个产品 SKU 一定有一个。

    • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

    SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助.

    重要

    值开头和结尾的空格会自动删除。 例如, " SKU123 ""SKU123" 它们将被视为相同的值。

    什么是 SKU 以及如何分配它

    Min length: 1

    Max length: 255

    Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

    Example: example

    订单中的产品列表。

    Example
    [
      {
        "offerId": "example",
        "count": 0
      }
    ]
    

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    orderId

    Type: integer

    的订单ID。

    订单取消通知。

    notificationType = ORDER_CANCELLED

    Example
    {
      "notificationType": "PING",
      "orderId": 0,
      "campaignId": 1,
      "items": [
        {
          "offerId": "example",
          "count": 0
        }
      ],
      "cancelledAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    campaignId

    Type: integer

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

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

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

    ⚠️ 不要把它与:

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

    Min value: 1

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    orderId

    Type: integer

    的订单ID。

    requestedAt

    Type: string<date-time>

    创建取消请求的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    创建订单取消请求的通知(对于 DBS-商店)。

    notificationType = ORDER_CANCELLATION_REQUEST

    如果订单交付到市场的PVZ,则不会发送。

    Чтобы подтвердить или отклонить заявку

    Example
    {
      "notificationType": "PING",
      "orderId": 0,
      "campaignId": 1,
      "requestedAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    campaignId

    Type: integer

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

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

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

    ⚠️ 不要把它与:

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

    Min value: 1

    createdAt

    Type: string<date-time>

    创建非购买或退款的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    items

    Type: object[]

    count

    Type: integer

    品的数量。

    offerId

    Type: string

    你的 SKU — 系统中的产品ID。

    使用规则 SKU:

    • 对于每个产品 SKU 一定有一个。

    • 已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。

    SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助.

    重要

    值开头和结尾的空格会自动删除。 例如, " SKU123 ""SKU123" 它们将被视为相同的值。

    什么是 SKU 以及如何分配它

    Min length: 1

    Max length: 255

    Pattern: ^(?=.*\S.*)[^\x00-\x08\x0A-\x1f\x7f]{1,255}$

    Example: example

    尚未购买或退回的项目列表。

    Example
    [
      {
        "offerId": "example",
        "count": 0
      }
    ]
    

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    orderId

    Type: integer

    的订单ID。

    returnId

    Type: integer

    非购买或退款的ID。

    returnType

    Type: string

    过滤类型:

    • UNREDEEMED — 非购买。

    • RETURN — 退款。

    如果您没有指定它,响应将包括非购买和退款。

    Enum: UNREDEEMED, RETURN

    创建新的非购买或退款的通知。

    notificationType = ORDER_RETURN_CREATED

    Чтобы получить подробную информацию о невыкупе или возврате

    Example
    {
      "notificationType": "PING",
      "orderId": 0,
      "returnId": 0,
      "returnType": "UNREDEEMED",
      "campaignId": 1,
      "items": [
        {
          "offerId": "example",
          "count": 0
        }
      ],
      "createdAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    campaignId

    Type: integer

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

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

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

    ⚠️ 不要把它与:

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

    Min value: 1

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    orderId

    Type: integer

    的订单ID。

    returnId

    Type: integer

    非购买或退款的ID。

    statuses

    Type: object

    refundStatus

    Type: string

    退款状况:

    • STARTED_BY_USER — 由买方从他的个人帐户创建。

    • REFUND_IN_PROGRESS — 等待退款的决定(待定)。

    • REFUNDED — 钱已经退了。

    • FAILED — 无法向买方退款。

    • WAITING_FOR_DECISION — 等待决定(DBS).

    • DECISION_MADE — 已就退款作出决定(DBS).

    • REFUNDED_WITH_BONUSES — 退款是用加分或促销代码进行的.

    • REFUNDED_BY_SHOP — 这家商店自己退款了.

    • COMPLETE_WITHOUT_REFUND — 不需要退款。

    • CANCELLED — 退款已被取消。

    • REJECTED — 退款被审核或PVZ拒绝。

    • PREMODERATION_DISPUTE — 退款有争议(FBY, FBS 和 Express).

    • PREMODERATION_DECISION_WAITING — 等待决定(FBY, FBS 和 Express).

    • PREMODERATION_DECISION_MADE — 已就退款作出决定(FBY, FBS 和 Express).

    • PREMODERATION_SELECT_DELIVERY — 用户选择送货方式(FBY, FBS 和 Express).

    • UNKNOWN — 状态未知,请联系支持。

    Enum: STARTED_BY_USER, REFUND_IN_PROGRESS, REFUNDED, FAILED, WAITING_FOR_DECISION, DECISION_MADE, REFUNDED_WITH_BONUSES, REFUNDED_BY_SHOP, CANCELLED, REJECTED, COMPLETE_WITHOUT_REFUND, PREMODERATION_DISPUTE, PREMODERATION_DECISION_WAITING, PREMODERATION_DECISION_MADE, PREMODERATION_SELECT_DELIVERY, UNKNOWN

    shipmentStatus

    Type: string

    退款或非购买转移状态:

    • CREATED — 退款或不购买是由买方创建的(已发行)。

    • RECEIVED — 退款已准备好装运(从买方接受).

    • IN_TRANSIT — 在途中退款或不购买(发货)。

    • READY_FOR_PICKUP — 退款或不购买准备交付到商店.

    • PICKED — 退款或不购买已发给商店.

    • LOST — 退款或不购买丢失(在运输过程中)。

    • EXPIRED — 买方没有按时携带产品退货(退款被取消)。

    • CANCELLED — 退款或不购买已被取消.

    • FULFILMENT_RECEIVED — 市场仓库接受退款或不购买.

    • PREPARED_FOR_UTILIZATION — 退款或不购买已被放置在处置队列中。

    • NOT_IN_DEMAND — 退款或不购买没有从邮局领取。

    • UTILIZED — 退款或不购买处理.

    • READY_FOR_EXPROPRIATION — 退回或未回购的商品发送转售(销售前检查)。

    • RECEIVED_FOR_EXPROPRIATION — 退回或未回购的商品被接受转售(销售)。

    • UNKNOWN — 状态未知,请联系支持。

    Enum: CREATED, RECEIVED, IN_TRANSIT, READY_FOR_PICKUP, PICKED, LOST, EXPIRED, CANCELLED, FULFILMENT_RECEIVED, PREPARED_FOR_UTILIZATION, NOT_IN_DEMAND, UTILIZED, READY_FOR_EXPROPRIATION, RECEIVED_FOR_EXPROPRIATION, UNKNOWN

    有关更新非购买或退款状态的信息。

    仅返回已更改的状态。

    对于非购买,只 shipmentStatus.

    参数 shipmentStatus 没有到达退款与选项 廉价婚姻的快速退款,当产品仍然与买方。

    Example
    {
      "refundStatus": "STARTED_BY_USER",
      "shipmentStatus": "CREATED"
    }
    

    updatedAt

    Type: string<date-time>

    更改非购买或退款状态的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    非购买或退款状态更改的通知。

    notificationType = ORDER_RETURN_STATUS_UPDATED

    Чтобы получить подробную информацию о невыкупе или возврате

    Example
    {
      "notificationType": "PING",
      "orderId": 0,
      "returnId": 0,
      "campaignId": 1,
      "statuses": {
        "refundStatus": "STARTED_BY_USER",
        "shipmentStatus": "CREATED"
      },
      "updatedAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    campaignId

    Type: integer

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

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

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

    ⚠️ 不要把它与:

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

    Min value: 1

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    orderId

    Type: integer

    的订单ID。

    updatedAt

    Type: string<date-time>

    订单更改的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    updateType

    Type: string

    订单变更类型:

    • SHIPMENT_DATE_UPDATED — 更改装运日期.
    • DELIVERY_DATE_UPDATED — 更改交货日期。
    • UNKNOWN — 未知类型。

    Enum: SHIPMENT_DATE_UPDATED, DELIVERY_DATE_UPDATED, UNKNOWN

    订单变更通知。

    notificationType = ORDER_UPDATED

    Чтобы получить подробную информацию о заказе

    使用方法 POST v1/businesses/{businessId}/orders 带过滤器 orderIds.

    Example
    {
      "notificationType": "PING",
      "orderId": 0,
      "campaignId": 1,
      "updateType": "SHIPMENT_DATE_UPDATED",
      "updatedAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    businessId

    Type: integer

    内阁ID。

    Min value: 1

    createdAt

    Type: string<date-time>

    创建审核的日期和时间。

    它可能不同于 publishedAt,由于审查已经进行了一段时间的温和。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    feedbackId

    Type: integer

    的审查ID。

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    publishedAt

    Type: string<date-time>

    发表评论的日期和时间。

    它可能不同于 createdAt,由于审查已经进行了一段时间的温和。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    创建新产品审核的通知。

    notificationType = GOODS_FEEDBACK_CREATED

    燕基科斯.只有当评论被审核和发布时,市场才会发送有关评论的通知。

    Чтобы получить подробную информацию об отзывах

    使用方法 POST v2/businesses/{businessId}/goods-feedback 在参数中指定它们的Id feedbackIds.

    如果客户或市场已删除评论,您将无法获得信息。

    Example
    {
      "notificationType": "PING",
      "feedbackId": 0,
      "businessId": 1,
      "createdAt": "2025-01-01T00:00:00Z",
      "publishedAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    businessId

    Type: integer

    内阁ID。

    Min value: 1

    commentId

    Type: integer

    评论评论的ID。

    createdAt

    Type: string<date-time>

    创建注释的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    创建新审核评论的通知。

    notificationType = GOODS_FEEDBACK_COMMENT_CREATED

    Чтобы получить подробную информацию о комментариях к отзыву

    使用方法 POST v2/businesses/{businessId}/goods-feedback/comments 在参数中指定它们的Id commentIds.

    如果用户或市场删除了添加评论或评论,您将无法收到信息。

    Example
    {
      "notificationType": "PING",
      "commentId": 0,
      "businessId": 1,
      "createdAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    businessId

    Type: integer

    内阁ID。

    Min value: 1

    chatId

    Type: integer

    的聊天ID。

    createdAt

    Type: string<date-time>

    创建聊天的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    与买方创建新聊天的通知。

    notificationType = CHAT_CREATED

    它适用于所有类型的聊天。

    Рекомендуемая обработка

    在通知CHAT_CREATED在您的系统中创建一个聊天并保存 chatId.

    使用该方法通过聊天获取信息 GET v2/businesses/{businessId}/chat 并保存订单号,退货ID(如果有)和买家的公开详细信息。

    为此重新请求聊天上下文 chatId 不需要。

    Example
    {
      "notificationType": "PING",
      "chatId": 0,
      "businessId": 1,
      "createdAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    businessId

    Type: integer

    内阁ID。

    Min value: 1

    chatId

    Type: integer

    的聊天ID。

    messageId

    Type: string

    消息的ID。

    Example: example

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    sentAt

    Type: string<date-time>

    发送邮件的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    聊天中新消息的通知。

    notificationType = CHAT_MESSAGE_SENT

    它适用于所有类型的聊天。

    它不发送贴纸信息。

    Чтобы получить сообщение от покупателя

    使用方法 GET v2/businesses/{businessId}/chats/message 在哪里指定Id:

    • 聊天室 — chatId;
    • 信息 — messageId.

    如果聊天已经保存(已处理 CHAT_CREATED)在您的系统中,您不需要再次请求有关它的信息 — 使用保存的上下文。

    Example
    {
      "notificationType": "PING",
      "chatId": 0,
      "messageId": "example",
      "businessId": 1,
      "sentAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    businessId

    Type: integer

    内阁ID。

    Min value: 1

    chatId

    Type: integer

    的聊天ID。

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    startedAt

    Type: string<date-time>

    争议开始的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    争议开始的通知。

    notificationType = CHAT_ARBITRAGE_STARTED

    不是来和那种类型的人聊天的 DIRECT. 了解有关此类聊天的更多信息

    Example
    {
      "notificationType": "PING",
      "chatId": 0,
      "businessId": 1,
      "startedAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    businessId

    Type: integer

    内阁ID。

    Min value: 1

    chatId

    Type: integer

    的聊天ID。

    finishedAt

    Type: string<date-time>

    争议结束的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    争议结束的通知。

    notificationType = CHAT_ARBITRAGE_FINISHED

    不是来和那种人聊天的 DIRECT. 了解有关此类聊天的更多信息

    Example
    {
      "notificationType": "PING",
      "chatId": 0,
      "businessId": 1,
      "finishedAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    businessId

    Type: integer

    内阁ID。

    Min value: 1

    createdAt

    Type: string<date-time>

    创建问题的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    questionId

    Type: integer

    的问题ID。

    创建新问题的通知。

    notificationType = QUESTION_CREATED

    Чтобы получить подробную информацию о вопросе

    使用方法 POST v1/businesses/{businessId}/goods-questions 其中在参数中指定其ID questionIds.

    Example
    {
      "notificationType": "PING",
      "questionId": 0,
      "businessId": 1,
      "createdAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    answerId

    Type: integer

    的响应ID。

    businessId

    Type: integer

    内阁ID。

    Min value: 1

    createdAt

    Type: string<date-time>

    创建响应的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    创建问题的新答案的通知。

    notificationType = QUESTION_ANSWER_CREATED

    Чтобы получить подробную информацию об ответе на вопрос

    使用方法 POST v1/businesses/{businessId}/goods-questions/answers 其中在参数中指定其ID answerIds.

    Example
    {
      "notificationType": "PING",
      "answerId": 0,
      "businessId": 1,
      "createdAt": "2025-01-01T00:00:00Z"
    }
    
  • Type: object

    answerId

    Type: integer

    的响应ID。

    businessId

    Type: integer

    内阁ID。

    Min value: 1

    commentId

    Type: integer

    注释的ID。

    createdAt

    Type: string<date-time>

    创建注释的日期和时间。

    日期格式: ISO 8601 具有相对于 UTC. 例如, 2017-11-21T00:00:00.213Z.

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

    notificationType

    Type: string

    通知类型:

    • PING — 验证通知。
    • ORDER_CREATED — 一个新的秩序已经建立。
    • ORDER_CANCELLED — 订单已被取消。
    • ORDER_STATUS_UPDATED — 订单状态已更改。
    • ORDER_RETURN_CREATED — 已创建新的非购买或退款。
    • ORDER_CANCELLATION_REQUEST — 已创建订单取消请求(对于 DBS-商店)。
    • ORDER_RETURN_STATUS_UPDATED — 未购买或退款状态已更改。
    • ORDER_UPDATED — 顺序已更改。
    • GOODS_FEEDBACK_CREATED — 已创建新产品评论。
    • GOODS_FEEDBACK_COMMENT_CREATED — 已创建新的产品评论注释。
    • CHAT_CREATED — 已创建与买方的新聊天。
    • CHAT_MESSAGE_SENT — 添加了新的聊天消息。
    • CHAT_ARBITRAGE_STARTED — 在买方的要求下,开始了争议。
    • CHAT_ARBITRAGE_FINISHED — 争议结束了。
    • QUESTION_CREATED — 创建了一个新问题。
    • QUESTION_ANSWER_CREATED — 问题的新答案已经创建。
    • QUESTION_COMMENT_CREATED — 一个新的评论已经创建的问题的答案。

    Enum: PING, ORDER_CREATED, ORDER_CANCELLED, ORDER_STATUS_UPDATED, ORDER_RETURN_CREATED, ORDER_CANCELLATION_REQUEST, ORDER_RETURN_STATUS_UPDATED, ORDER_UPDATED, GOODS_FEEDBACK_CREATED, GOODS_FEEDBACK_COMMENT_CREATED, CHAT_CREATED, CHAT_MESSAGE_SENT, CHAT_ARBITRAGE_STARTED, CHAT_ARBITRAGE_FINISHED, QUESTION_CREATED, QUESTION_ANSWER_CREATED, QUESTION_COMMENT_CREATED

    对问题的答案创建新评论的通知。

    notificationType = QUESTION_COMMENT_CREATED

    Чтобы получить подробную информацию о комментарии к ответу на вопрос

    使用方法 POST v1/businesses/{businessId}/goods-questions/answers 在参数中指定响应ID的位置 answerIds.

    Example
    {
      "notificationType": "PING",
      "answerId": 0,
      "commentId": 0,
      "businessId": 1,
      "createdAt": "2025-01-01T00:00:00Z"
    }
    

Responses

200 OK

通知处理的信息的有效请求的响应。

Body

application/json
{
  "version": "example",
  "name": "example",
  "time": "2025-01-01T00:00:00Z"
}

Name

Description

name

Type: string

集成的名称。

Min length: 1

Max length: 100

Example: example

time

Type: string<date-time>

格式的通知处理开始的日期和时间 UTC.

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

version

Type: string

的集成版本。

Min length: 1

Max length: 100

Example: example

400 Bad Request

如果市场发送了不正确的通知,请返回状态 400 与错误的描述。

Body

application/json
{
  "error": {
    "type": "UNKNOWN",
    "message": "example"
  }
}

Name

Description

error

Type: object

message

Type: string

错误的描述。

Example: example

type

Type: string

错误类型:

  • UNKNOWN — 未知错误。
  • WRONG_EVENT_FORMAT — 通知类型不正确。
  • DUPLICATED_EVENT — 重复通知。

Enum: UNKNOWN, WRONG_EVENT_FORMAT, DUPLICATED_EVENT

处理通知时出错。

Example
{
  "type": "UNKNOWN",
  "message": "example"
}

500 Internal Server Error

如果您遇到技术错误,请返回状态 500. 商店的API没有响应

Body

application/json
{
  "error": {
    "type": "UNKNOWN",
    "message": "example"
  }
}

Name

Description

error

Type: object

message

Type: string

错误的描述。

Example: example

type

Type: string

错误类型:

  • UNKNOWN — 未知错误。
  • WRONG_EVENT_FORMAT — 通知类型不正确。
  • DUPLICATED_EVENT — 重复通知。

Enum: UNKNOWN, WRONG_EVENT_FORMAT, DUPLICATED_EVENT

处理通知时出错。

Example
{
  "type": "UNKNOWN",
  "message": "example"
}