使用QBFC15与VB.Net在Quickbooks Enterprise22中创建销售订单失败

核心结论 #

复用同一个QBSession执行多步操作是QBFC官方支持的标准用法，不是故障原因。代码无报错但单据未生成的核心原因是你开启了roeContinue错误模式后，未对请求响应做解析，所有QB返回的业务错误都被静默吞掉了。

具体故障成因 #

• 未校验请求响应：你设置msgSetRq.Attributes.OnError = ENRqOnError.roeContinue后，QB不会因为单条请求失败抛出COM异常，所有错误信息（包括实体不存在、字段缺失、权限不足、期间关闭等）都会封装在IMsgSetResponse对象中，当前代码直接跳过响应解析，无法感知实际错误。
• 客户作业引用不可靠：你在创建子作业（Job）后未确认作业是否创建成功，直接手动拼接StoreName + ":" + JobName作为销售订单的客户引用，存在作业创建失败（重名、父客户不存在）、拼接格式不符合QB FullName规范（多余空格、特殊字符未转义）导致客户引用无效的可能。
• 销售订单行缺失必填字段：QB Enterprise 22 中默认配置下，所有销售订单行必须传入Quantity（数量）字段，仅传金额、商品、描述会被判定为行信息不合法，直接驳回整张单据创建请求。
• 会话模式/权限问题：你调用BeginSession时传入omDontCare模式，如果此时QB公司文件被其他用户以单用户模式打开、或当前集成账号没有销售订单创建权限、或目标单据日期对应的会计期间已关闭且无跨期写入权限，写入请求会被静默拒绝。

修复步骤 #

1. 首先添加通用响应解析逻辑，所有调用DoRequests后必须遍历响应列表拿到实际执行结果，示例代码：

Private Sub CheckResponse(msgSetRs As IMsgSetResponse)
    Dim respList As IResponseList = msgSetRs.ResponseList
    For i As Integer = 0 To respList.Count - 1
        Dim resp As IResponse = respList.GetAt(i)
        If resp.StatusCode <> 0 Then
            Throw New Exception($"QB请求失败，错误码:{resp.StatusCode}，错误信息:{resp.StatusMessage}")
        End If
    Next
End Sub

在每次sessManager.DoRequests(xxx)之后直接调用CheckResponse(msgSetRs)，即可第一时间拿到具体报错原因。

2. 不要手动拼接客户作业的FullName，在作业创建成功后从响应中提取QB返回的标准FullName供后续销售订单使用：

' 客户创建请求执行完成、校验响应通过后
Dim custAddResp As IResponse = msgSetRs.ResponseList.GetAt(0)
Dim custRet As ICustomerRet = CType(custAddResp.Detail, ICustomerRet)
Dim validJobFullName As String = custRet.FullName.GetValue()
' 后续销售订单的CustomerRef直接赋值这个取到的validJobFullName，不要手动拼接
SalesOrderAddRq.CustomerRef.FullName.SetValue(validJobFullName)

3. 为所有销售订单行补充数量字段：

' 商品行
SalesOrderAddLn.ItemRef.FullName.SetValue("Merchandise")
SalesOrderAddLn.Desc.SetValue("A Product")
SalesOrderAddLn.Amount.SetValue(10.00)
SalesOrderAddLn.Quantity.SetValue(1) ' 按实际业务数量传入，服务类商品若不需要数量需提前在QB商品配置中开启对应选项

' 运费行
SalesOrderAddLn.ItemRef.FullName.SetValue("Shipping")
SalesOrderAddLn.Desc.SetValue("Shipping")
SalesOrderAddLn.Amount.SetValue(12.00)
SalesOrderAddLn.Quantity.SetValue(1)

4. 显式指定会话打开模式为多用户模式，避免单用户锁定导致写入失败：

' 替换原来的omDontCare
sessManager.BeginSession("", ENOpenMode.omMultiUser)

同时提前确认QB公司文件的会计期间覆盖你传入的订单日期、集成用户有销售订单创建权限、对应销售商品项已标记为可用于销售。

内容的提问来源于stack exchange，提问作者Old EEAP