接收通知
市场向商店发送有关事件的通知:
- 创建新订单;
- 订单修改;
- 订单状态更改;
- 创建与客户的新聊天;
- 在聊天中添加新消息;
- 争端的开始;
- 争端的结束;
- 创建新产品评论;
- 创建新的评论评论;
- 创建订单取消请求;
- 取消订单;
- 创建新的非购买或退款;
- 更改非购买或退款状态。
Учитывайте эти особенности в работе с уведомлениями
-
燕基科斯.市场可以为同一事件发送多个通知。
在某些情况下,这是正常行为。 例如,由于搜索快递员,订单状态可能会发生变化。
-
通知中的时间、对市场请求的响应以及您的系统中的时间可能会有所不同。
这是由于在发送通知时,订单状态可能已经不同。
在请求
POST notification活动时间到了createdAt,updatedAt或cancelledAt. 参数的选择取决于通知的类型。
考虑事件的稍后时间是相关的。 它可以在通知中,响应市场请求返回,或存储在您的系统中。
接收响应超时:常规通知为10秒,验证通知为1秒 PING.
Request
POST
/notification
Body
application/json
{
"notificationType": "PING",
"time": "2025-01-01T00:00:00Z"
}
|
Name |
Description |
|
notificationType |
Type: string 通知类型:
Enum: |
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_CREATEDtime
Type: string<date-time>
商店处理通知的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00Z验证通知。
notificationType=PINGExample
{ "notificationType": "PING", "time": "2025-01-01T00:00:00Z" } -
Type: object
campaignId
Type: integer
广告系列(商店)的ID — 通过API工作时,代表您在Yandex市场系统中的商店的技术标识符。 它与您的商店唯一链接,但仅用于自动交互。
您可以使用查询找到它 GET v2/campaigns 或者在市场上的卖家办公室找到它。 点击您的帐户图标→ 设置 在左边的菜单中,选择 Api和模块:
- 座 运动ID;
- 标签 查询日志 →块中的下拉列表 显示日志.
⚠️ 不要把它与:
- 商店的标识符,显示在商家的个人帐户中。
- 广告活动。
Min value:
1createdAt
Type: string<date-time>
创建订单的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00Zitems
Type: object[]
count
Type: integer
品的数量。
offerId
Type: string
你的 SKU — 系统中的产品ID。
使用规则 SKU:
-
对于每个产品 SKU 一定有一个。
-
已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。
SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助.
重要
值开头和结尾的空格会自动删除。 例如,
" SKU123 "和"SKU123"它们将被视为相同的值。Min length:
1Max length:
255Pattern:
^(?=.*\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_CREATEDorderId
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:
1notificationType
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_CREATEDorderId
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,UNKNOWNsubstatus
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,UNKNOWNupdatedAt
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:
1cancelledAt
Type: string<date-time>
取消订单的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00Zitems
Type: object[]
count
Type: integer
品的数量。
offerId
Type: string
你的 SKU — 系统中的产品ID。
使用规则 SKU:
-
对于每个产品 SKU 一定有一个。
-
已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。
SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助.
重要
值开头和结尾的空格会自动删除。 例如,
" SKU123 "和"SKU123"它们将被视为相同的值。Min length:
1Max length:
255Pattern:
^(?=.*\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_CREATEDorderId
Type: integer
的订单ID。
订单取消通知。
notificationType=ORDER_CANCELLEDExample
{ "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:
1notificationType
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_CREATEDorderId
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:
1createdAt
Type: string<date-time>
创建非购买或退款的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00Zitems
Type: object[]
count
Type: integer
品的数量。
offerId
Type: string
你的 SKU — 系统中的产品ID。
使用规则 SKU:
-
对于每个产品 SKU 一定有一个。
-
已经设置 SKU 它不能被释放并重新用于另一个产品。 每个产品都应该收到一个以前从未在目录中使用过的新标识符。
SKU 产品可以在市场上的卖方帐户中更改。 阅读有关如何做到这一点。 在市场对卖家的帮助.
重要
值开头和结尾的空格会自动删除。 例如,
" SKU123 "和"SKU123"它们将被视为相同的值。Min length:
1Max length:
255Pattern:
^(?=.*\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_CREATEDorderId
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:
1notificationType
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_CREATEDorderId
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,UNKNOWNshipmentStatus
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:
1notificationType
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_CREATEDorderId
Type: integer
的订单ID。
updatedAt
Type: string<date-time>
订单更改的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00ZupdateType
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:
1createdAt
Type: string<date-time>
创建审核的日期和时间。
它可能不同于
publishedAt,由于审查已经进行了一段时间的温和。日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00ZfeedbackId
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_CREATEDpublishedAt
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:
1commentId
Type: integer
评论评论的ID。
createdAt
Type: string<date-time>
创建注释的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00ZnotificationType
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:
1chatId
Type: integer
的聊天ID。
createdAt
Type: string<date-time>
创建聊天的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00ZnotificationType
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:
1chatId
Type: integer
的聊天ID。
messageId
Type: string
消息的ID。
Example:
examplenotificationType
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_CREATEDsentAt
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:
1chatId
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_CREATEDstartedAt
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:
1chatId
Type: integer
的聊天ID。
finishedAt
Type: string<date-time>
争议结束的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00ZnotificationType
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:
1createdAt
Type: string<date-time>
创建问题的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00ZnotificationType
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_CREATEDquestionId
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:
1createdAt
Type: string<date-time>
创建响应的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00ZnotificationType
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:
1commentId
Type: integer
注释的ID。
createdAt
Type: string<date-time>
创建注释的日期和时间。
日期格式: ISO 8601 具有相对于 UTC. 例如,
2017-11-21T00:00:00.213Z.Example:
2025-01-01T00:00:00ZnotificationType
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: Max length: Example: |
|
time |
Type: string<date-time> 格式的通知处理开始的日期和时间 UTC. Example: |
|
version |
Type: string 的集成版本。 Min length: Max length: Example: |
400 Bad Request
如果市场发送了不正确的通知,请返回状态 400 与错误的描述。
Body
application/json
{
"error": {
"type": "UNKNOWN",
"message": "example"
}
}
|
Name |
Description |
||||
|
error |
Type: object
处理通知时出错。 Example
|
500 Internal Server Error
如果您遇到技术错误,请返回状态 500. 商店的API没有响应
Body
application/json
{
"error": {
"type": "UNKNOWN",
"message": "example"
}
}
|
Name |
Description |
||||
|
error |
Type: object
处理通知时出错。 Example
|