tmc.js 0.3.33 → 0.3.34

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2022 James ZHANG(TheNorthMemory)
+Copyright (c) 2022-2024 James ZHANG(TheNorthMemory)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -134,11 +134,11 @@ new Tmc('your_app_key', 'your_app_secret', { autoReplyConfirmation: false })
 
 ## 支持的TOPICS
 
-<details><summary>共计 84+ 类别，491+ 消息数</summary>
+<details><summary>共计 84+ 类别，494+ 消息数</summary>
 
 | 类别 | 消息数 |
 | --- | --- |
-| 淘宝交易 | 24 |
+| 淘宝交易 | 25 |
 | 淘宝退款 | 13 |
 | 淘宝商品 | 13 |
 | 淘宝分销 | 27 |
@@ -159,7 +159,7 @@ new Tmc('your_app_key', 'your_app_secret', { autoReplyConfirmation: false })
 | 营销平台 | 1 |
 | OpenIM消息 | 1 |
 | 网上法庭 | 8 |
-| 电子发票 | 20 |
+| 电子发票 | 21 |
 | 航旅度假交易 | 8 |
 | YunOS YoC | 2 |
 | 淘宝直播API | 3 |
@@ -192,7 +192,7 @@ new Tmc('your_app_key', 'your_app_secret', { autoReplyConfirmation: false })
 | 商旅API | 3 |
 | 阿里健康-O2O中台 | 2 |
 | 业务平台新零售-消息上行 | 2 |
-| 大麦第三方票务供应商接入 | 6 |
+| 大麦第三方票务供应商接入 | 7 |
 | TVOS应用审核平台 | 1 |
 | Gifting送礼 | 1 |
 | 五道口商品 | 2 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tmc.js",
-  "version": "0.3.33",
+  "version": "0.3.34",
   "description": "Event driven and chained Taobao Message Channel(TMC) for NodeJS",
   "author": "James ZHANG",
   "license": "MIT",

package/types/alibaba.d.ts

@@ -599,6 +599,16 @@ declare namespace Alibaba.Invoice {
     trade_type: number;
   }
 
+  /** 获取xml发票文件 */
+  interface GetXmlFile {
+    /** 全电发票的发票号码 */
+    invoice_no: string;
+    /** 订单号 */
+    platform_tid: string;
+    /** 卖家Nick */
+    seller_nick?: string;
+  }
+
   /** 税控服务开票申请 */
   interface InvoiceApply {
     /** 开票申请ID */

package/types/damai.d.ts

@@ -50,6 +50,12 @@ declare namespace Damai.Distribution {
     voucher_ids: number[];
   }
 
+  /** 项目退款规则 */
+  interface RefundRule {
+    /** 项目id */
+    project_id: number;
+  }
+
   /** 票品状态变更 */
   interface TicketItemStatus {
     /** 是否可售 */

package/types/index.d.ts

@@ -142,6 +142,8 @@ declare interface TaoTopicsDescriptor {
   alibaba_invoice_DiskOffline(fn: (this: TaoMessageConsumer, message: IncomingMessage.AlibabaInvoiceDiskOffline) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.AlibabaInvoiceFlowBuket 电子发票 > 资源包开通/订购记录同步} */
   alibaba_invoice_FlowBuket(fn: (this: TaoMessageConsumer, message: IncomingMessage.AlibabaInvoiceFlowBuket) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.AlibabaInvoiceGetXmlFile 电子发票 > 获取xml发票文件} */
+  alibaba_invoice_GetXmlFile(fn: (this: TaoMessageConsumer, message: IncomingMessage.AlibabaInvoiceGetXmlFile) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.AlibabaInvoiceInvoiceApply 电子发票 > 税控服务开票申请} */
   alibaba_invoice_InvoiceApply(fn: (this: TaoMessageConsumer, message: IncomingMessage.AlibabaInvoiceInvoiceApply) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.AlibabaInvoiceLogistics 电子发票 > 发票对外通知物流信息} */
@@ -386,6 +388,8 @@ declare interface TaoTopicsDescriptor {
   damai_distribution_ProjectStatus(fn: (this: TaoMessageConsumer, message: IncomingMessage.DamaiDistributionProjectStatus) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.DamaiDistributionRefundOrder 大麦第三方票务供应商接入 > 退票通知} */
   damai_distribution_RefundOrder(fn: (this: TaoMessageConsumer, message: IncomingMessage.DamaiDistributionRefundOrder) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.DamaiDistributionRefundRule 大麦第三方票务供应商接入 > 项目退款规则} */
+  damai_distribution_RefundRule(fn: (this: TaoMessageConsumer, message: IncomingMessage.DamaiDistributionRefundRule) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.DamaiDistributionTicketItemStatus 大麦第三方票务供应商接入 > 票品状态变更} */
   damai_distribution_TicketItemStatus(fn: (this: TaoMessageConsumer, message: IncomingMessage.DamaiDistributionTicketItemStatus) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.DamaiTradeTicketStatusPush 大麦票单状态 > 大麦票单状态推送} */
@@ -662,6 +666,8 @@ declare interface TaoTopicsDescriptor {
   taobao_modifysku_ResultNotify(fn: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoModifyskuResultNotify) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOcTradeTagChanged 交易全链路 > oc订单标签变更} */
   taobao_oc_TradeTagChanged(fn: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOcTradeTagChanged) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.TaobaoOfnOrderStatusSync 淘宝交易 > 以旧换新回收单状态同步} */
+  taobao_ofn_OrderStatusSync(fn: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOfnOrderStatusSync) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOpenaccountDataSync 导购平台 > openaccount数据同步} */
   taobao_openaccount_DataSync(fn: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOpenaccountDataSync) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOpencrmAuthTouchMessage 客户运营平台API > 营销短信授权消息} */
@@ -1190,6 +1196,8 @@ declare interface TaoTopicsDescriptor {
   taobao_modifysku(fn: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoModifysku) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOc} */
   taobao_oc(fn: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOc) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.TaobaoOfn} */
+  taobao_ofn(fn: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOfn) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOpenaccount} */
   taobao_openaccount(fn: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOpenaccount) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOpencrm} */
@@ -1403,6 +1411,8 @@ declare interface TaoEventsListener {
   on(topic: 'alibaba_invoice_DiskOffline', listener: (this: TaoMessageConsumer, message: IncomingMessage.AlibabaInvoiceDiskOffline) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.AlibabaInvoiceFlowBuket 电子发票 > 资源包开通/订购记录同步} */
   on(topic: 'alibaba_invoice_FlowBuket', listener: (this: TaoMessageConsumer, message: IncomingMessage.AlibabaInvoiceFlowBuket) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.AlibabaInvoiceGetXmlFile 电子发票 > 获取xml发票文件} */
+  on(topic: 'alibaba_invoice_GetXmlFile', listener: (this: TaoMessageConsumer, message: IncomingMessage.AlibabaInvoiceGetXmlFile) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.AlibabaInvoiceInvoiceApply 电子发票 > 税控服务开票申请} */
   on(topic: 'alibaba_invoice_InvoiceApply', listener: (this: TaoMessageConsumer, message: IncomingMessage.AlibabaInvoiceInvoiceApply) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.AlibabaInvoiceLogistics 电子发票 > 发票对外通知物流信息} */
@@ -1647,6 +1657,8 @@ declare interface TaoEventsListener {
   on(topic: 'damai_distribution_ProjectStatus', listener: (this: TaoMessageConsumer, message: IncomingMessage.DamaiDistributionProjectStatus) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.DamaiDistributionRefundOrder 大麦第三方票务供应商接入 > 退票通知} */
   on(topic: 'damai_distribution_RefundOrder', listener: (this: TaoMessageConsumer, message: IncomingMessage.DamaiDistributionRefundOrder) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.DamaiDistributionRefundRule 大麦第三方票务供应商接入 > 项目退款规则} */
+  on(topic: 'damai_distribution_RefundRule', listener: (this: TaoMessageConsumer, message: IncomingMessage.DamaiDistributionRefundRule) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.DamaiDistributionTicketItemStatus 大麦第三方票务供应商接入 > 票品状态变更} */
   on(topic: 'damai_distribution_TicketItemStatus', listener: (this: TaoMessageConsumer, message: IncomingMessage.DamaiDistributionTicketItemStatus) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.DamaiTradeTicketStatusPush 大麦票单状态 > 大麦票单状态推送} */
@@ -1923,6 +1935,8 @@ declare interface TaoEventsListener {
   on(topic: 'taobao_modifysku_ResultNotify', listener: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoModifyskuResultNotify) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOcTradeTagChanged 交易全链路 > oc订单标签变更} */
   on(topic: 'taobao_oc_TradeTagChanged', listener: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOcTradeTagChanged) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.TaobaoOfnOrderStatusSync 淘宝交易 > 以旧换新回收单状态同步} */
+  on(topic: 'taobao_ofn_OrderStatusSync', listener: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOfnOrderStatusSync) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOpenaccountDataSync 导购平台 > openaccount数据同步} */
   on(topic: 'taobao_openaccount_DataSync', listener: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOpenaccountDataSync) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOpencrmAuthTouchMessage 客户运营平台API > 营销短信授权消息} */
@@ -2451,6 +2465,8 @@ declare interface TaoEventsListener {
   on(topic: 'taobao_modifysku', listener: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoModifysku) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOc} */
   on(topic: 'taobao_oc', listener: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOc) => void): TaoMessageConsumer;
+  /** {@link IncomingMessage.TaobaoOfn} */
+  on(topic: 'taobao_ofn', listener: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOfn) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOpenaccount} */
   on(topic: 'taobao_openaccount', listener: (this: TaoMessageConsumer, message: IncomingMessage.TaobaoOpenaccount) => void): TaoMessageConsumer;
   /** {@link IncomingMessage.TaobaoOpencrm} */

package/types/message.in.d.ts

@@ -103,6 +103,8 @@ declare namespace IncomingMessage {
   type AlibabaInvoiceDiskOffline = Message & { content?: MessageContent & { topic?: 'alibaba_invoice_DiskOffline', content?: string | Alibaba.Invoice.DiskOffline } };
   /** {@link Alibaba.Invoice.FlowBuket 电子发票 > 资源包开通/订购记录同步} */
   type AlibabaInvoiceFlowBuket = Message & { content?: MessageContent & { topic?: 'alibaba_invoice_FlowBuket', content?: string | Alibaba.Invoice.FlowBuket } };
+  /** {@link Alibaba.Invoice.GetXmlFile 电子发票 > 获取xml发票文件} */
+  type AlibabaInvoiceGetXmlFile = Message & { content?: MessageContent & { topic?: 'alibaba_invoice_GetXmlFile', content?: string | Alibaba.Invoice.GetXmlFile } };
   /** {@link Alibaba.Invoice.InvoiceApply 电子发票 > 税控服务开票申请} */
   type AlibabaInvoiceInvoiceApply = Message & { content?: MessageContent & { topic?: 'alibaba_invoice_InvoiceApply', content?: string | Alibaba.Invoice.InvoiceApply } };
   /** {@link Alibaba.Invoice.Logistics 电子发票 > 发票对外通知物流信息} */
@@ -347,6 +349,8 @@ declare namespace IncomingMessage {
   type DamaiDistributionProjectStatus = Message & { content?: MessageContent & { topic?: 'damai_distribution_ProjectStatus', content?: string | Damai.Distribution.ProjectStatus } };
   /** {@link Damai.Distribution.RefundOrder 大麦第三方票务供应商接入 > 退票通知} */
   type DamaiDistributionRefundOrder = Message & { content?: MessageContent & { topic?: 'damai_distribution_RefundOrder', content?: string | Damai.Distribution.RefundOrder } };
+  /** {@link Damai.Distribution.RefundRule 大麦第三方票务供应商接入 > 项目退款规则} */
+  type DamaiDistributionRefundRule = Message & { content?: MessageContent & { topic?: 'damai_distribution_RefundRule', content?: string | Damai.Distribution.RefundRule } };
   /** {@link Damai.Distribution.TicketItemStatus 大麦第三方票务供应商接入 > 票品状态变更} */
   type DamaiDistributionTicketItemStatus = Message & { content?: MessageContent & { topic?: 'damai_distribution_TicketItemStatus', content?: string | Damai.Distribution.TicketItemStatus } };
   /** {@link Damai.Trade.TicketStatusPush 大麦票单状态 > 大麦票单状态推送} */
@@ -623,6 +627,8 @@ declare namespace IncomingMessage {
   type TaobaoModifyskuResultNotify = Message & { content?: MessageContent & { topic?: 'taobao_modifysku_ResultNotify', content?: string | Taobao.Modifysku.ResultNotify } };
   /** {@link Taobao.Oc.TradeTagChanged 交易全链路 > oc订单标签变更} */
   type TaobaoOcTradeTagChanged = Message & { content?: MessageContent & { topic?: 'taobao_oc_TradeTagChanged', content?: string | Taobao.Oc.TradeTagChanged } };
+  /** {@link Taobao.Ofn.OrderStatusSync 淘宝交易 > 以旧换新回收单状态同步} */
+  type TaobaoOfnOrderStatusSync = Message & { content?: MessageContent & { topic?: 'taobao_ofn_OrderStatusSync', content?: string | Taobao.Ofn.OrderStatusSync } };
   /** {@link Taobao.Openaccount.DataSync 导购平台 > openaccount数据同步} */
   type TaobaoOpenaccountDataSync = Message & { content?: MessageContent & { topic?: 'taobao_openaccount_DataSync', content?: string | Taobao.Openaccount.DataSync } };
   /** {@link Taobao.Opencrm.AuthTouchMessage 客户运营平台API > 营销短信授权消息} */
@@ -1048,6 +1054,7 @@ declare namespace IncomingMessage {
    * - {@link AlibabaInvoiceApplyResult 电子发票 > 开票申请审核结果}
    * - {@link AlibabaInvoiceDiskOffline 电子发票 > 税盘下架单新增和更新通知}
    * - {@link AlibabaInvoiceFlowBuket 电子发票 > 资源包开通/订购记录同步}
+   * - {@link AlibabaInvoiceGetXmlFile 电子发票 > 获取xml发票文件}
    * - {@link AlibabaInvoiceInvoiceApply 电子发票 > 税控服务开票申请}
    * - {@link AlibabaInvoiceLogistics 电子发票 > 发票对外通知物流信息}
    * - {@link AlibabaInvoicePaperOpsReturn 电子发票 > 纸票操作结果回传（打印、作废等）}
@@ -1064,6 +1071,7 @@ declare namespace IncomingMessage {
     | AlibabaInvoiceApplyResult
     | AlibabaInvoiceDiskOffline
     | AlibabaInvoiceFlowBuket
+    | AlibabaInvoiceGetXmlFile
     | AlibabaInvoiceInvoiceApply
     | AlibabaInvoiceLogistics
     | AlibabaInvoicePaperOpsReturn
@@ -1371,6 +1379,7 @@ declare namespace IncomingMessage {
    * - {@link DamaiDistributionPreSaleToNow 大麦第三方票务供应商接入 > 预售改开票}
    * - {@link DamaiDistributionProjectStatus 大麦第三方票务供应商接入 > 项目状态推送}
    * - {@link DamaiDistributionRefundOrder 大麦第三方票务供应商接入 > 退票通知}
+   * - {@link DamaiDistributionRefundRule 大麦第三方票务供应商接入 > 项目退款规则}
    * - {@link DamaiDistributionTicketItemStatus 大麦第三方票务供应商接入 > 票品状态变更}
    */
   type DamaiDistribution = DamaiDistributionPerformCancel
@@ -1378,6 +1387,7 @@ declare namespace IncomingMessage {
     | DamaiDistributionPreSaleToNow
     | DamaiDistributionProjectStatus
     | DamaiDistributionRefundOrder
+    | DamaiDistributionRefundRule
     | DamaiDistributionTicketItemStatus;
   /**
    * - {@link DamaiTradeTicketStatusPush 大麦票单状态 > 大麦票单状态推送}
@@ -1749,6 +1759,10 @@ declare namespace IncomingMessage {
    * - {@link TaobaoOcTradeTagChanged 交易全链路 > oc订单标签变更}
    */
   type TaobaoOc = TaobaoOcTradeTagChanged;
+  /**
+   * - {@link TaobaoOfnOrderStatusSync 淘宝交易 > 以旧换新回收单状态同步}
+   */
+  type TaobaoOfn = TaobaoOfnOrderStatusSync;
   /**
    * - {@link TaobaoOpenaccountDataSync 导购平台 > openaccount数据同步}
    */
@@ -2365,6 +2379,7 @@ declare namespace IncomingMessage {
    * - {@link TaobaoModifyorder}
    * - {@link TaobaoModifysku}
    * - {@link TaobaoOc}
+   * - {@link TaobaoOfn}
    * - {@link TaobaoOpenaccount}
    * - {@link TaobaoOpencrm}
    * - {@link TaobaoOpenim}
@@ -2417,6 +2432,7 @@ declare namespace IncomingMessage {
     | TaobaoModifyorder
     | TaobaoModifysku
     | TaobaoOc
+    | TaobaoOfn
     | TaobaoOpenaccount
     | TaobaoOpencrm
     | TaobaoOpenim

package/types/taobao.d.ts

@@ -1623,6 +1623,37 @@ declare namespace Taobao.Oc {
   }
 }
 
+/** 淘宝交易 */
+declare namespace Taobao.Ofn {
+  /** 以旧换新回收单状态同步 */
+  interface OrderStatusSync {
+    /** 估价金额，单位 分 */
+    apprize_amount?: string;
+    /** 回收单 ID */
+    biz_order_id: string;
+    /** 渠道 */
+    channel: string;
+    /** 渠道数据，json格式 */
+    channel_data?: string;
+    /** 信用预付金额，单位分 */
+    credit_pay_amount?: string;
+    /** 创单时间 */
+    gmt_create?: string;
+    /** 订单状态 */
+    order_status: string;
+    /** 1 现金支付 / 2 红包支付 */
+    pay_type?: string;
+    /** 估价 ID */
+    quote_id?: string;
+    /** 上门取件时间 */
+    ship_time?: string;
+    /** SPU ID */
+    spu_id: string;
+    /** 回收商 appKey */
+    supplier_id?: string;
+  }
+}
+
 /** 导购平台 */
 declare namespace Taobao.Openaccount {
   /** openaccount数据同步 */