使用QuickBooks API创建子客户失败：含ParentRef参数的问题排查

尝试通过PHP代码调用QuickBooks API创建子客户时执行失败，已知信息：

• 移除代码中的ParentRef部分后，代码可正常运行；
• $parentid存在（当前值为94），是已存在客户的ID；
• 开发参考了QuickBooks官方文档。

代码如下：

$customer = $dataService->Add(Customer::create([
    "DisplayName" => $formvars["fullname"],
    "CompanyName" => $formvars["clientname"],
    "BillAddr" => [
        "Line1" => $formvars["addrh1"],
        "Line2" => $formvars["addrh2"],
        "City" => $formvars["addrc"],
        "CountrySubDivisionCode" => $formvars["addrs"],
        "PostalCode" => $formvars["addrz"],
    ],
    "ShipAddr" => [
        "Line1" => $formvars["addrh1"],
        "Line2" => $formvars["addrh2"],
        "City" => $formvars["addrc"],
        "CountrySubDivisionCode" => $formvars["addrs"],
        "PostalCode" => $formvars["addrz"],
    ],
    "PrimaryEmailAddr" => [
        "Address" => $formvars["email"]
    ],
    "PrimaryPhone" => [
        "FreeFormNumber" => $formvars["phext"],
    ],
    "ParentRef" => [
        "value" => $parentid,
    ]

]));
if ($customer) {
    echo $customer->Id;
    exit;
} else {
    echo "Error creating sub-customer: " . $customer->message;
    exit;
}

请问遗漏了什么内容导致代码失败？

结合你的情况，问题基本出在ParentRef的结构或子客户的必填规则上，以下是几个关键遗漏点：

1. ParentRef必须包含name字段
   QuickBooks API要求ParentRef对象同时提供value（父客户ID）和name（父客户的显示名称），只传value会触发验证错误。补充父客户名称即可：

"ParentRef" => [
    "value" => $parentid,
    "name" => "实际父客户名称" // 替换为ID94对应的客户显示名称
]

2. 子客户DisplayName需保证唯一
   如果$formvars["fullname"]的值和父客户或其他现有客户重复，创建会失败。确认该值唯一，或者改用GivenName+FamilyName的组合来设置名称，避免冲突。

3. 检查父客户状态
   确认ID为94的父客户是活跃状态（未被标记为inactive），部分非活跃客户无法作为父级创建子客户。

4. 捕获完整错误信息
   当前代码只输出$customer->message，但QuickBooks的错误通常包含更详细的细节。修改错误输出逻辑，打印完整错误响应，能快速定位问题：

} else {
    $errors = $dataService->getLastError();
    echo "Error creating sub-customer: " . $errors->getResponseBody();
    exit;
}

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