DiscuzNT 商品交易插件设计之[线下交易流程]

在上一篇文章中，大略说明了一个商品的添加编辑和删除操作。本文会继承其支付流程来展示如何购
买商品以及系统设计。

首先打开一个有效的商品，在商品显示页面中单击“立刻购买”按钮，如下：

这样就会跳转到“确认购买信息”页面(buygoods.aspx)，如下：

在这个页面中，系统会执行如下操作：
1.进行商品信息有效性校验（如未通过则显示相应提示信息，从而中止后续操作），如下：

private bool IsConditionsValid()
 {
 if (goodsinfo.Expiration <= DateTime.Now)
 {
 AddErrLine("非常抱歉, 该宝贝不存在或已经结束了！");
 return false;
 }

 if (goodsinfo.Closed == 1)
 {
 AddErrLine("此商品已关闭！");
 return false;
 }

 if (goodsinfo.Selleruid <= 0)
 {
 AddErrLine("商品卖家信息错误！");
 return false;
 }

 if (userid == goodsinfo.Selleruid)
 {
 AddErrLine("买卖双方不能为同一用户！");
 return false;
 }

 if (goodsinfo.Displayorder == -1)
 {
 AddErrLine("此商品已被删除！");
 return false;
 }

 if (goodsinfo.Displayorder == -2)
 {
 AddErrLine("此商品未经审核！");
 return false;
 }

    2.当点击“确认购买”时，进行购买数量校验以及与剩余数量比较判断，如下：

//如果是提交

if (ispost)
{
 //创建商品交易日志
 goodstradelog.Number = DNTRequest.GetInt("number", 0);
 // 商品数不正确
 if (goodstradelog.Number <= 0)
 {
 AddErrLine("请输入正确的商品数, 请返回修改.");
 return;
 }

 if (goodsinfo.Amount < goodstradelog.Number)
 {
 AddErrLine("商品剩余数量不足 (剩余数量为 " + goodsinfo.Amount + ", 而购买数量为 " + goodstradelog.Number + ").");
 return;
 }

｝

3.创建商品交易日志(CreateTradeLog)：

goodstradelog.Baseprice = goodsinfo.Costprice;
goodstradelog.Discount = goodsinfo.Discount;
goodstradelog.Ratestatus = 0;
goodstradelog.Message = "";

int tradelogid = TradeLogs.CreateTradeLog(goodstradelog);

if (tradelogid > 0)
{
 string jumpurl = "";
 if (goodstradelog.Offline == 0)
 {
 jumpurl = "onlinetrade.aspx?goodstradelogid=" + tradelogid;
 }
 else
 {
 jumpurl = "offlinetrade.aspx?goodstradelogid=" + tradelogid;
 }
 SetUrl(jumpurl);
 SetMetaRefresh();
 AddMsgLine("交易单已创建, 现在将转入交易单页面 (<a href=""" + jumpurl + """>如果您的浏览器没有自动跳转, 请点击这里</a>) ");
}
else
{
 SetUrl("buygoods.aspx?goodsid=" + goodsid);
 SetMetaRefresh();
 AddMsgLine("交易单创建错误, 请重新添写交易单 (<a href=""" + "buygoods.aspx?goodsid=" + goodsid + """>如果您的浏览器没有自动跳转, 请点击这里</a>) ");
}

这里的TradeLogs.CreateTradeLog(goodstradelog)方法内容如下：

/// <summary>
/// 创建商品交易日志
/// </summary>
/// <param name="__goodstradelog">要创建的商品交易日志</param>
/// <returns>创建的商品交易日志id</returns>
public static int CreateTradeLog(Goodstradeloginfo __goodstradelog)
{
 //当为支付宝付款方式时,将订单号绑定到tradeno字段
 if (__goodstradelog.Offline == 0)
 {
 __goodstradelog.Tradeno = __goodstradelog.Orderid;
 }

 if (__goodstradelog.Buyermsg.Length > 100)
 {
 __goodstradelog.Buyermsg = __goodstradelog.Buyermsg.Substring(0, 100);
 }

 if (__goodstradelog.Buyercontact.Length > 100)
 {
 __goodstradelog.Buyercontact = __goodstradelog.Buyercontact.Substring(0, 100);
 }

 if (__goodstradelog.Number > 0)
 {
 //更新商品数量和最近交易信息
 Goodsinfo __goodsinfo = Goods.GetGoodsInfo(__goodstradelog.Goodsid);
 if (__goodsinfo != null && __goodsinfo.Goodsid > 0)
 {
 //当商品库存变为0(负)库存时
 if (__goodsinfo.Amount > 0 && (__goodsinfo.Amount - __goodstradelog.Number) <= 0)
 {

DbProvider.GetInstance().UpdateCategoryGoodsCounts(__goodsinfo.Categoryid,

__goodsinfo.Parentcategorylist, -1);

            }

            __goodsinfo.Totalitems = __goodsinfo.Totalitems + __goodstradelog.Number; //累加总交易量
            __goodsinfo.Amount = __goodsinfo.Amount - __goodstradelog.Number; //减少当前商品数量
            __goodsinfo.Tradesum = __goodsinfo.Tradesum + __goodstradelog.Tradesum;  //累加总交易额

            __goodsinfo.Lastbuyer = __goodstradelog.Buyer;
            __goodsinfo.Lasttrade = DateTime.Now;

            Goods.UpdateGoods(__goodsinfo);
        }
    }
    __goodstradelog.Id = DbProvider.GetInstance().CreateGoodsTradeLog(__goodstradelog);

    SendPM(__goodstradelog);

    return __goodstradelog.Id;
}

基本上是对要创建的交易信息进行数据修正，并更新商品表中的相应字段（Totalitems，Amount等）。

当创建交易日志完成之后，上面的SendPM(__goodstradelog);用于向卖家发送短消息。其代码段如下所示：

/// <summary>
/// 根据交易日志的状态发送相应短消息
/// </summary>
/// <param name="__goodstradelog">交易日志信息</param>
/// <returns>是否发送成功</returns>
public static bool SendPM(Goodstradeloginfo __goodstradelog)
{
 string pm_content = "这是由论坛系统自动发送的通知短消息. ";
 string pm_title = "";
 bool issendpm = false;
 int msgtoid = 0;
 string msgto = "";
 string pagename = __goodstradelog.Offline == 1 ? "offlinetrade.aspx" : "onlinetrade.aspx";
 switch ((TradeStatusEnum)__goodstradelog.Status)
 {
 case TradeStatusEnum.UnStart:
 {
 pm_title = "[系统消息] 有买家购买您的商品";
 pm_content = pm_content + string.Format("买家 {0} 购买您的商品 {1}. 但交易尚未生效, 等待您的确认, 请<a href =""" + pagename + "?goodstradelogid={2}"">点击这里</a>查看详情.",
 __goodstradelog.Buyer,
 __goodstradelog.Subject,
 __goodstradelog.Id);
 issendpm = true;
 msgtoid = __goodstradelog.Sellerid;
 msgto = __goodstradelog.Seller;
 break;
 }
 case TradeStatusEnum.WAIT_SELLER_SEND_GOODS:
 {
 pm_title = "[系统消息] 买家已付款, 等待您发货";
 pm_content = pm_content + string.Format("买家 {0} 购买您的商品 {1}. 买家已付款, 等待您发货, 请<a href =""" + pagename + "?goodstradelogid={2}"">点击这里</a>查看详情.",
 __goodstradelog.Buyer,
 __goodstradelog.Subject,
 __goodstradelog.Id);
 issendpm = true;
 msgtoid = __goodstradelog.Sellerid;
 msgto = __goodstradelog.Seller;
 break;
 }
 case TradeStatusEnum.WAIT_BUYER_CONFIRM_GOODS:
 {
 pm_title = "[系统消息] 您购买的商品已经发货";
 pm_content = pm_content + string.Format("您购买的商品 {0} . 卖家 {1} 已发货, 等待您的确认, 请<a href =""" + pagename + "?goodstradelogid={2}"">点击这里</a>查看详情.",
 __goodstradelog.Subject,
 __goodstradelog.Seller,
 __goodstradelog.Id);
 msgtoid = __goodstradelog.Buyerid;
 msgto = __goodstradelog.Buyer;
 issendpm = true;
 issendpm = true; break;
 }
 case TradeStatusEnum.WAIT_SELLER_AGREE:
 {
 pm_title = "[系统消息] 有买家等待你同意退款";
 pm_content = pm_content + string.Format("买家 {0} 等待你同意退款, 请<a href =""" + pagename + "?goodstradelogid={1}"">点击这里</a>查看详情.",
 __goodstradelog.Buyer,
 __goodstradelog.Id);
 issendpm = true;
 msgtoid = __goodstradelog.Sellerid;
 msgto = __goodstradelog.Seller;
 break;
 }
 case TradeStatusEnum.SELLER_REFUSE_BUYER:
 {
 pm_title = "[系统消息] 有卖家拒绝您的条件, 等待您修改条件";
 pm_content = pm_content + string.Format("卖家 {0} 拒绝您的条件, 等待您修改条件, 请<a href =""" + pagename + "?goodstradelogid={1}"">点击这里</a>查看详情.",
 __goodstradelog.Seller,
 __goodstradelog.Id);
 issendpm = true;
 msgtoid = __goodstradelog.Buyerid;
 msgto = __goodstradelog.Buyer;
 break;
 }
 case TradeStatusEnum.WAIT_BUYER_RETURN_GOODS:
 {
 pm_title = "[系统消息] 有卖家同意退款, 等待您退货";
 pm_content = pm_content + string.Format("卖家 {0} 同意退款, 等待您退货, 请<a href =""" + pagename + "?goodstradelogid={1}"">点击这里</a>查看详情.",
 __goodstradelog.Seller,
 __goodstradelog.Id);
 msgtoid = __goodstradelog.Buyerid;
 msgto = __goodstradelog.Buyer;
 issendpm = true;
 break;
 }
 case TradeStatusEnum.WAIT_SELLER_CONFIRM_GOODS:
 {
 pm_title = "[系统消息] 有买家已退货, 等待您收货";
 pm_content = pm_content + string.Format("买家 {0} 已退货, 等待您收货, 请<a href =""" + pagename + "?goodstradelogid={1}"">点击这里</a>查看详情.",
 __goodstradelog.Buyer,
 __goodstradelog.Id);
 msgtoid = __goodstradelog.Sellerid;
 msgto = __goodstradelog.Seller;
 issendpm = true;
 break;
 }
 case TradeStatusEnum.TRADE_FINISHED:
 {
 pm_title = "[系统消息] 商品交易已成功完成";
 pm_content = pm_content + string.Format("商品 {0} 已交易成功, 请<a href =""goodsrate.aspx?goodstradelogid={1}"">点击这里</a>给对方评分.",
 __goodstradelog.Subject,
 __goodstradelog.Id);
 msgtoid = __goodstradelog.Sellerid;
 msgto = __goodstradelog.Seller;
 issendpm = true;
 break;
 }
 case TradeStatusEnum.TRADE_CLOSED:
 {
 pm_title = "[系统消息] 卖家已取消此次交易, 当前交易关闭";
 pm_content = pm_content + string.Format("商品 {0} 交易失败, 卖家取消交易, 请<a href =""goodsrate.aspx?goodstradelogid={1}"">点击这里</a>查看详情.",
 __goodstradelog.Subject,
 __goodstradelog.Id);
 msgtoid = __goodstradelog.Sellerid;
 msgto = __goodstradelog.Seller;
 issendpm = true;
 break;
 }
 case TradeStatusEnum.REFUND_SUCCESS:
 {
 pm_title = "[系统消息] 您购买的商品已成功退款";
 pm_content = pm_content + string.Format("商品 {0} 已退款成功, 请<a href =""goodsrate.aspx?goodstradelogid={1}"">点击这里</a>给对方评分.",
 __goodstradelog.Subject,
 __goodstradelog.Id);
 msgtoid = __goodstradelog.Buyerid;
 msgto = __goodstradelog.Buyer;
 issendpm = true;
 break;
 }
 }

 //发送短消息
 if(issendpm)
 {
 PrivateMessageInfo __privatemessageinfo = new PrivateMessageInfo();

 // 收件箱
 __privatemessageinfo.Message = Utils.HtmlEncode(pm_content.ToString());
 __privatemessageinfo.Subject = Utils.HtmlEncode(pm_title);
 __privatemessageinfo.Msgto = msgto;
 __privatemessageinfo.Msgtoid = msgtoid;
 __privatemessageinfo.Msgfrom = "系统";
 __privatemessageinfo.Msgfromid = 0;
 __privatemessageinfo.New = 1;
 __privatemessageinfo.Postdatetime = Utils.GetDateTime();

 PrivateMessages.CreatePrivateMessage(__privatemessageinfo, 0);
 }
 return true;
}

上面的代码主要是根据交易日志的状态，向买卖双方发送相应的短消息。而交易的状态采用了支付宝
文档中所述的17种状态，其说明如下（位于Discuz.Entity项目下的Mall/GoodsrateinfoCollection.cs）：

/// <summary>
/// 交易状态枚举
/// </summary>
public enum TradeStatusEnum
{
 /// <summary>
 /// 未生效的交易
 /// </summary>
 UnStart = 0,
 /// <summary>
 /// 等待买家付款
 /// </summary>
 WAIT_BUYER_PAY = 1,
 /// <summary>
 /// 交易已创建,等待卖家确认
 /// </summary>
 WAIT_SELLER_CONFIRM_TRADE = 2,
 /// <summary>
 /// 确认买家付款中，暂勿发货
 /// </summary>
 WAIT_SYS_CONFIRM_PAY = 3,
 /// <summary>
 /// 买家已付款(或支付宝收到买家付款),请卖家发货
 /// </summary>
 WAIT_SELLER_SEND_GOODS = 4,
 /// <summary>
 /// 卖家已发货，买家确认中
 /// </summary>
 WAIT_BUYER_CONFIRM_GOODS = 5,
 /// <summary>
 /// 买家确认收到货，等待支付宝打款给卖家
 /// </summary>
 WAIT_SYS_PAY_SELLER = 6,
 /// <summary>
 /// 交易成功结束
 /// </summary>
 TRADE_FINISHED = 7,
 /// <summary>
 /// 交易中途关闭(未完成)
 /// </summary>
 TRADE_CLOSED = 8,
 /// <summary>
 /// 等待卖家同意退款
 /// </summary>
 WAIT_SELLER_AGREE = 10,
 /// <summary>
 /// 卖家拒绝买家条件，等待买家修改条件
 /// </summary>
 SELLER_REFUSE_BUYER = 11,
 /// <summary>
 /// 卖家同意退款，等待买家退货
 /// </summary>
 WAIT_BUYER_RETURN_GOODS = 12,
 /// <summary>
 /// 等待卖家收货
 /// </summary>
 WAIT_SELLER_CONFIRM_GOODS = 13,
 /// <summary>
 /// 双方已经一致，等待支付宝退款
 /// </summary>
 WAIT_ALIPAY_REFUND = 14,
 /// <summary>
 /// 支付宝处理中
 /// </summary>
 ALIPAY_CHECK = 15,
 /// <summary>
 /// 结束的退款
 /// </summary>
 OVERED_REFUND = 16,
 /// <summary>
 /// 退款成功(卖家已收到退货)
 /// </summary>
 REFUND_SUCCESS = 17,
 /// <summary>
 /// 退款关闭
 /// </summary>
 REFUND_CLOSED = 18
}

到这里，确认交易页面介绍的差不多了，当然上面所帖的图中“交易方式”选择“下同之后，则进入到offlinetrade.aspx中。

如下所示：

在这里，当前的交易状态为"未生效的交易"(即：UnStart = 0）

当用户点击“我已付款，等待卖家发货”按钮时，会显示“买家已付款,等待卖家发货”的提示信息如下图：

如果这时卖家（登陆后）进入到当前交易页面时，会显示如下信息：

这里如果卖家确认买家并点击“我已发货”按钮后，当前交易状态会成“卖家已发货，买家确认中（即：
WAIT_BUYER_CONFIRM_GOODS = 5）。

这时当买家（登陆后）进入到当前交易页面时，会显示如下信息：

当买家最终确认并收货之后，点击“我收到货，交易成功结束”按钮，当前交易状态会变成“交易成功结束”

（RADE_FINISHED = 7）。如下所示：

    这样本次交易流程基本上就结束了，当然最后买卖双方还要互评，以便为“信用机制”提供有效信息。如下
图(点击上图中的“评价”按钮)：

当买卖双方评价完成后，交易变成了“双方已评”

这时，当我们点击“商品显示页面”中的“信用链接”（如下图）：

系统会进入到“信用页面（eccredit.aspx）”, 如下图：

在这里，我们就可以看到当前商品的卖家和买家信用，以及按时间（最近一周，一个月，六个月等）所获
得的“好，中，差”评的次数以及相应的评价内容。此外还包括"好评率”，“给他人评价”等信息。

这样，我们基本上完成了一个交易流程（线下交易,注：退货退款等交易中止流程本文未进行说明，大家可

安装之后一用便知）。

当然，我们这里在处理交易的页面中，只是在买卖双方的推动下，不断更新交易状态的过程，因为下面简要
介绍一下Discuz.Mall/Pages/offlinetrade.cs（线下交易页面）的代码：

首先是IsConditionsValid方法，该方法用户校验买家或卖家身份以及交易和商品的信息有效性，如下：

private bool IsConditionsValid()
{
 if (goodstradelog.Offline == 0)
 {
 AddErrLine("当前交易为在线交易!");
 return false;
 }

 //当前用户为买家时
 if (goodstradelog.Buyerid == userid)
 {
 isbuyer = true;
 }

 //当前用户为卖家时
 if (goodstradelog.Sellerid == userid)
 {
 isseller = true;
 }

 //当前用户既不是买家也不是卖家
 if (!isbuyer && !isseller)
 {
 AddErrLine("当前用户身份既不是买家也不是卖家!");
 return false;
 }

 if (goodstradelog.Buyerid <= 0)
 {
 AddErrLine("商品买家信息错误!");
 return false;
 }

 if (goodstradelog.Sellerid <= 0)
 {
 AddErrLine("商品卖家信息错误!");
 return false;
 }

 int goodsid = goodstradelog.Goodsid;
 // 如果商品ID无效
 if (goodsid <= 0)
 {
 AddErrLine("无效的商品ID");
 return false;
 }

 goodsinfo = Goods.GetGoodsInfo(goodsid);

 if (goodsinfo.Displayorder == -1)
 {
 AddErrLine("此商品已被删除!");
 return false;
 }

 if (goodsinfo.Displayorder == -2)
 {
 AddErrLine("此商品未经审核!");
 return false;
 }

 if (goodsinfo.Expiration <= DateTime.Now)
 {
 AddErrLine("非常抱歉, 该商品不存在或已经到期!");
 return false;
 }

 return true;
}

当通过上面方法的校验并实例化相应的交易信息后，则进行更新当前交易状态的操作，其调用代码如下
（Discuz.Mall/Pages/offlinetrade.cs）：

if (TradeLogs.UpdateTradeLog(goodstradelog, oldstatus, true))
{
 SetUrl("offlinetrade.aspx?goodstradelogid=" + goodstradelogid);
 SetMetaRefresh();
 AddMsgLine("交易单已更新, 现在转入交易单页面 (<a href=""" + "offlinetrade.aspx?goodstradelogid=" + goodstradelogid + """>如果您的浏览器没有自动跳转, 请点击这里</a>) ");
}

下面介绍一下TradeLogs.UpdateTradeLog方法，该方法执行更新交易状态的操作(相关内容见注释)：

/// <summary>
/// 更新交易信息
/// </summary>
/// <param name="__goodstradelog">要更新的交易信息</param>
/// <param name="oldstatus">更新之前的状态</param>
/// <param name="issendpm">更新交易信息成功后, 是否发送短消息</param>
/// <returns>是否更新成功</returns>
public static bool UpdateTradeLog(Goodstradeloginfo __goodstradelog, int oldstatus, bool issendpm)
{
 bool result = UpdateTradeLog(__goodstradelog, oldstatus); //调用重载方法
 if (result && issendpm)
 {
 SendPM(__goodstradelog);
 }

 return result;
}

/// <summary>
/// 更新交易信息
/// </summary>
/// <param name="__goodstradelog">要更新的交易信息</param>
/// <param name="oldstatus">本次更新之前的状态</param>
/// <returns>是否更新成功</returns>
public static bool UpdateTradeLog(Goodstradeloginfo __goodstradelog, int oldstatus)
{
 if (__goodstradelog.Buyermsg.Length > 100)
 {
 __goodstradelog.Buyermsg = __goodstradelog.Buyermsg.Substring(0, 100);
 }

 if (__goodstradelog.Buyercontact.Length > 100)
 {
 __goodstradelog.Buyercontact = __goodstradelog.Buyercontact.Substring(0, 100);
 }

__goodstradelog.Tradesum = __goodstradelog.Number * __goodstradelog.Price +

(__goodstradelog.Transportpay == 2 ? __goodstradelog.Transportfee : 0);

//当交易状态发生变化时
 if (__goodstradelog.Status != oldstatus)
 {
 if (__goodstradelog.Number > 0)
 {
 //获取当前交易的商品信息
 Goodsinfo __goodsinfo = Goods.GetGoodsInfo(__goodstradelog.Goodsid);

 //当交易从中途关闭(未完成)状态变为生效(Status: 1为生效, 4为买家已付款等待卖家发货)时更新商品数量)
 if (oldstatus == 8 && (__goodstradelog.Status == 1 || __goodstradelog.Status == 4))
 {
 //当商品库存变为0(负)库存时
 if (__goodsinfo.Amount > 0 && (__goodsinfo.Amount - __goodstradelog.Number) <= 0)
 {

DbProvider.GetInstance().UpdateCategoryGoodsCounts(__goodsinfo.Categoryid, __goodsinfo.Parentcategorylist, -1);

}

 __goodsinfo.Totalitems = __goodsinfo.Totalitems + __goodstradelog.Number; //累加总交易量
 __goodsinfo.Amount = __goodsinfo.Amount - __goodstradelog.Number; //减少当前商品数量
 __goodsinfo.Tradesum = __goodsinfo.Tradesum + __goodstradelog.Tradesum; //累加总交易额
 }

 //当退款成功后(Status = 17, 表示此次交易无效,同时更新商品信息并还原商品数目)
 //或交易中途关闭,未完成(Status = 8, 更新商品数量)
 if (__goodstradelog.Status == 17 || __goodstradelog.Status == 8)
 {
 //当商品库存从0(负)库存变为有效库存时
 if (__goodsinfo.Amount <= 0 && (__goodsinfo.Amount + __goodstradelog.Number) > 0)
 {

DbProvider.GetInstance().UpdateCategoryGoodsCounts(__goodsinfo.Categoryid,

__goodsinfo.Parentcategorylist, 1);

}

                __goodsinfo.Totalitems = __goodsinfo.Totalitems - __goodstradelog.Number; //减少总交易量
                __goodsinfo.Amount = __goodsinfo.Amount + __goodstradelog.Number; //还原当前商品数量
                __goodsinfo.Tradesum = __goodsinfo.Tradesum - __goodstradelog.Tradesum;//减少总交易额
            }

            __goodsinfo.Lastbuyer = __goodstradelog.Buyer;
            __goodsinfo.Lasttrade = DateTime.Now;

            Goods.UpdateGoods(__goodsinfo);
        }
    }

    return DbProvider.GetInstance().UpdateGoodsTradeLog(__goodstradelog);
}

当前在交易状态更新完成后，会最终发送短消息给买家或卖家，其方法在本文前面已介绍后，这里就不再

多说了。当然这里还有双方互评时的页面逻辑和方法没有介绍，这部分留到以后的“商品交易插件信用机制”一

文中再详加说明。

    好了，今天的内容就先到这里了，因为一些细节暂未详细描述，只是粗略的浏览了一遍，如果大家感兴趣
欢迎在回复中讨论。

    tag : discuznt, mall, 交易, trade
    作者: 代震军, daizhj
    原帖链接: http://www.cnblogs.com/daizhj/archive/2008/08/12/1265648.html