接收通知

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

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

使用通知时请记住这些功能。

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

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

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

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

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

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

接收响应超时：10秒。

Request

POST

/notification

Body

application/json
{
    "notificationType": "PING",
    "time": "2022-12-29T18:02:01Z"
}

Name

Description

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

...rest

oneOf PingNotificationDTO

验证通知。

notificationType = PING

...rest

oneOf OrderCreatedNotificationDTO

创建新订单的通知。

notificationType = ORDER_CREATED

可能有用的方法

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

GET v2/campaigns/{campaignId}/orders/{orderId} — 获取有关订单的详细信息。

...rest

oneOf OrderStatusUpdatedNotificationDTO

订单状态更改的通知。

notificationType = ORDER_STATUS_UPDATED

更改订单状态

使用方法 PUT v2/campaigns/{campaignId}/orders/{orderId}/status.

...rest

oneOf OrderCancelledNotificationDTO

订单取消通知。

notificationType = ORDER_CANCELLED

...rest

oneOf OrderCancellationRequestNotificationDTO

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

notificationType = ORDER_CANCELLATION_REQUEST

如果订单是由市场交付的，则不会发送。

确认或拒绝申请

使用方法 PUT v2/campaigns/{campaignId}/orders/{orderId}/cancellation/accept.

...rest

oneOf OrderReturnCreatedNotificationDTO

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

notificationType = ORDER_RETURN_CREATED

获取有关非购买或退款的详细信息

使用方法 GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}.

...rest

oneOf OrderReturnStatusUpdatedNotificationDTO

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

notificationType = ORDER_RETURN_STATUS_UPDATED

获取有关非购买或退款的详细信息

使用方法 GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}.

...rest

oneOf OrderUpdatedNotificationDTO

订单变更通知。

notificationType = ORDER_UPDATED

获取有关订单的详细信息

使用方法 GET v2/campaigns/{campaignId}/orders/{orderId}.

...rest

oneOf GoodsFeedbackCreatedNotificationDTO

创建新产品审核的通知。

notificationType = GOODS_FEEDBACK_CREATED

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

获取有关评论的详细信息

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

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

...rest

oneOf GoodsFeedbackCommentCreatedNotificationDTO

创建新审核评论的通知。

notificationType = GOODS_FEEDBACK_COMMENT_CREATED

获取有关评论的详细信息

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

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

...rest

oneOf ChatCreatedNotificationDTO

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

notificationType = CHAT_CREATED

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

与客户聊天

使用方法 GET v2/businesses/{businessId}/chat 在参数中指定聊天ID的地方 chatId.

...rest

oneOf ChatMessageSentNotificationDTO

聊天中新消息的通知。

notificationType = CHAT_MESSAGE_SENT

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

接收来自买方的信息

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

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

...rest

oneOf ChatArbitrageStartedNotificationDTO

争议开始的通知。

notificationType = CHAT_ARBITRAGE_STARTED

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

...rest

oneOf ChatArbitrageFinishedNotificationDTO

争议结束的通知。

notificationType = CHAT_ARBITRAGE_FINISHED

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

NotificationType

通知类型:

  • 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 — 争议结束了。

Type

Description

NotificationType

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

PingNotificationDTO

验证通知。

notificationType = PING

Name

Description

notificationType

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

time

Type: string<date-time>

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

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

OrderCreatedNotificationDTO

创建新订单的通知。

notificationType = ORDER_CREATED

可能有用的方法

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

GET v2/campaigns/{campaignId}/orders/{orderId} — 获取有关订单的详细信息。

Name

Description

campaignId*

Type: integer<int64>

活动ID。

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

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

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

createdAt*

Type: string<date-time>

创建订单的日期和时间。

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

items*

Type: NotificationOrderItemDTO[]

订单中的产品列表。
订单中有关产品的信息。

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

orderId*

Type: integer<int64>

的订单ID。

OrderStatusUpdatedNotificationDTO

订单状态更改的通知。

notificationType = ORDER_STATUS_UPDATED

更改订单状态

使用方法 PUT v2/campaigns/{campaignId}/orders/{orderId}/status.

Name

Description

campaignId*

Type: integer<int64>

活动ID。

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

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

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

orderId*

Type: integer<int64>

的订单ID。

status*

Type: OrderStatusType

订单状况:

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

  • RESERVED — 预订，但预订不足。

  • 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: OrderSubstatusType

订单处理的阶段（如果它具有状态 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 — 买方对产品的质量不满意。

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

    • PROCESSING_EXPIRED — 值不再使用。

    • PICKUP_EXPIRED — 订单在PVZ中的存储期已过期。

    • 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, UNKNOWN

updatedAt*

Type: string<date-time>

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

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

OrderCancelledNotificationDTO

订单取消通知。

notificationType = ORDER_CANCELLED

Name

Description

campaignId*

Type: integer<int64>

活动ID。

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

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

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

cancelledAt*

Type: string<date-time>

取消订单的日期和时间。

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

items*

Type: NotificationOrderItemDTO[]

订单中的产品列表。
订单中有关产品的信息。

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

orderId*

Type: integer<int64>

的订单ID。

OrderCancellationRequestNotificationDTO

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

notificationType = ORDER_CANCELLATION_REQUEST

如果订单是由市场交付的，则不会发送。

确认或拒绝申请

使用方法 PUT v2/campaigns/{campaignId}/orders/{orderId}/cancellation/accept.

Name

Description

campaignId*

Type: integer<int64>

活动ID。

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

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

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

orderId*

Type: integer<int64>

的订单ID。

requestedAt*

Type: string<date-time>

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

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

OrderReturnCreatedNotificationDTO

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

notificationType = ORDER_RETURN_CREATED

获取有关非购买或退款的详细信息

使用方法 GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}.

Name

Description

campaignId*

Type: integer<int64>

活动ID。

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

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

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

createdAt*

Type: string<date-time>

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

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

items*

Type: NotificationReturnItemDTO[]

非购买或退货的项目列表。
关于非购买或退货的产品的信息。

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

orderId*

Type: integer<int64>

的订单ID。

returnId*

Type: integer<int64>

非购买或退款的ID。

returnType*

Type: ReturnType

用于过滤的订单类型:

  • UNREDEEMED — 非购买。

  • RETURN — 退款。

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

Enum: UNREDEEMED, RETURN

OrderReturnStatusUpdatedNotificationDTO

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

notificationType = ORDER_RETURN_STATUS_UPDATED

获取有关非购买或退款的详细信息

使用方法 GET v2/campaigns/{campaignId}/orders/{orderId}/returns/{returnId}.

Name

Description

campaignId*

Type: integer<int64>

活动ID。

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

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

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

orderId*

Type: integer<int64>

的订单ID。

returnId*

Type: integer<int64>

非购买或退款的ID。

statuses*

Type: NotificationUpdatedReturnStatusesDTO

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

仅返回已更改的状态。

对于非购买，只 shipmentStatus.

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

updatedAt*

Type: string<date-time>

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

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

OrderUpdatedNotificationDTO

订单变更通知。

notificationType = ORDER_UPDATED

获取有关订单的详细信息

使用方法 GET v2/campaigns/{campaignId}/orders/{orderId}.

Name

Description

campaignId*

Type: integer<int64>

活动ID。

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

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

⚠️ 不要发送商店ID，这是在市场上的卖家帐户旁边的商店名称和一些报告。

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

orderId*

Type: integer<int64>

的订单ID。

updateType*

Type: OrderUpdateType

Тип изменения заказа.

Enum: SHIPMENT_DATE_UPDATED, DELIVERY_DATE_UPDATED, UNKNOWN

updatedAt*

Type: string<date-time>

订单更改的日期和时间。

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

GoodsFeedbackCreatedNotificationDTO

创建新产品审核的通知。

notificationType = GOODS_FEEDBACK_CREATED

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

获取有关评论的详细信息

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

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

Name

Description

businessId*

Type: integer<int64>

内阁ID。

createdAt*

Type: string<date-time>

创建审核的日期和时间。

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

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

feedbackId*

Type: integer<int64>

的审查ID。

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

publishedAt*

Type: string<date-time>

发表评论的日期和时间。

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

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

GoodsFeedbackCommentCreatedNotificationDTO

创建新审核评论的通知。

notificationType = GOODS_FEEDBACK_COMMENT_CREATED

获取有关评论的详细信息

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

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

Name

Description

businessId*

Type: integer<int64>

内阁ID。

commentId*

Type: integer<int64>

评论评论的ID。

createdAt*

Type: string<date-time>

创建注释的日期和时间。

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

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

ChatCreatedNotificationDTO

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

notificationType = CHAT_CREATED

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

与客户聊天

使用方法 GET v2/businesses/{businessId}/chat 在参数中指定聊天ID的地方 chatId.

Name

Description

businessId*

Type: integer<int64>

内阁ID。

chatId*

Type: integer<int64>

的聊天ID。

createdAt*

Type: string<date-time>

创建聊天的日期和时间。

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

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

ChatMessageSentNotificationDTO

聊天中新消息的通知。

notificationType = CHAT_MESSAGE_SENT

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

接收来自买方的信息

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

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

Name

Description

businessId*

Type: integer<int64>

内阁ID。

chatId*

Type: integer<int64>

的聊天ID。

messageId*

Type: string

消息的ID。

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

sentAt*

Type: string<date-time>

发送邮件的日期和时间。

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

ChatArbitrageStartedNotificationDTO

争议开始的通知。

notificationType = CHAT_ARBITRAGE_STARTED

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

Name

Description

businessId*

Type: integer<int64>

内阁ID。

chatId*

Type: integer<int64>

的聊天ID。

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

startedAt*

Type: string<date-time>

争议开始的日期和时间。

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

ChatArbitrageFinishedNotificationDTO

争议结束的通知。

notificationType = CHAT_ARBITRAGE_FINISHED

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

Name

Description

businessId*

Type: integer<int64>

内阁ID。

chatId*

Type: integer<int64>

的聊天ID。

finishedAt*

Type: string<date-time>

争议结束的日期和时间。

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

notificationType*

Type: NotificationType

通知类型:

  • 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 — 争议结束了。

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

NotificationOrderItemDTO

订单中有关产品的信息。

Name

Description

count*

Type: integer

品的数量。

offerId*

Type: string

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

使用规则 SKU:

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

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

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

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

OrderStatusType

订单状况:

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

  • RESERVED — 预订，但预订不足。

  • UNPAID — 已发出，但尚未付款（如果在结账时选择付款）。

  • PROCESSING — 它正在处理中。

  • DELIVERY — 转移到送货服务。

  • PICKUP — 送到取件点。

  • DELIVERED — 由买方接收。

  • CANCELLED — 取消。

  • PENDING — 等待卖方处理。

  • PARTIALLY_RETURNED — 部分退款。

  • RETURNED — 全额回来了。

  • UNKNOWN — 状态不明。

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

Type

Description

OrderStatusType

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

OrderSubstatusType

订单处理的阶段（如果它具有状态 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 — 买方对产品的质量不满意。

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

    • PROCESSING_EXPIRED — 值不再使用。

    • PICKUP_EXPIRED — 订单在PVZ中的存储期已过期。

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

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

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

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

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

Type

Description

OrderSubstatusType

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, UNKNOWN

NotificationReturnItemDTO

关于非购买或退货的产品的信息。

Name

Description

count*

Type: integer

品的数量。

offerId*

Type: string

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

使用规则 SKU:

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

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

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

什么是 SKU 以及如何分配它

Min length: 1

Max length: 255

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

ReturnType

用于过滤的订单类型:

  • UNREDEEMED — 非购买。

  • RETURN — 退款。

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

Type

Description

ReturnType

Enum: UNREDEEMED, RETURN

NotificationUpdatedReturnStatusesDTO

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

仅返回已更改的状态。

对于非购买，只 shipmentStatus.

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

Name

Description

refundStatus

Type: RefundStatusType

退款状况:

  • 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: ReturnShipmentStatusType

退款转移状况:

  • 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

OrderUpdateType

订单变更类型:

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

Type

Description

OrderUpdateType

Enum: SHIPMENT_DATE_UPDATED, DELIVERY_DATE_UPDATED, UNKNOWN

RefundStatusType

退款状况:

  • 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 — 状态不明。

Type

Description

RefundStatusType

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

ReturnShipmentStatusType

退款转移状况:

  • 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 — 状态不明。

Type

Description

ReturnShipmentStatusType

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

Responses

200 OK

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

Body

application/json
{
    "version": "string",
    "name": "string",
    "time": "2022-12-29T18:02:01Z"
}

Name

Description

name*

Type: string

集成的名称。

Min length: 1

Max length: 100

time*

Type: string<date-time>

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

version*

Type: string

的集成版本。

Min length: 1

Max length: 100

400 Bad Request

如果市场发送了错误的通知，返回状态 400 与错误的描述。

Body

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

Name

Description

error

Type: NotificationApiErrorDTO

处理通知时出错。

NotificationApiErrorDTO

处理通知时出错。

Name

Description

message

Type: string

错误的描述。

type

Type: NotificationApiErrorType

错误类型:

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

Enum: UNKNOWN, WRONG_EVENT_FORMAT, DUPLICATED_EVENT

NotificationApiErrorType

错误类型:

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

Type

Description

NotificationApiErrorType

Enum: UNKNOWN, WRONG_EVENT_FORMAT, DUPLICATED_EVENT

500 Internal Server Error

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

Body

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

Name

Description

error

Type: NotificationApiErrorDTO

处理通知时出错。

No longer supported, please use an alternative and newer version.

上一篇
错误消息
下一篇
对于1C：公司