WooCommerce REST API问题：同步订单时税务信息未生效求助

问题 #

正在搭建Zoho Inventory与WooCommerce的集成，将Zoho中手动录入的销售订单同步至WooCommerce。目前订单可成功创建，但请求中的税务信息被WooCommerce忽略，订单无税务显示。已在JSON请求中包含税务相关字段，期望达到WooCommerce内建订单的税务展示效果，但实际无税务显示，请问JSON Payload是否存在内容缺失？

发送的JSON Payload #

{
  "customer_id":"2589",
  "billing":{
    "first_name":"Suzanne",
    "last_name":"Kirkland",
    "company":"OBH Enterprises",
    "address_1":"1442 Pottstown Pike 200",
    "address_2":"",
    "city":"West Chester",
    "state":"Pennsylvania",
    "postcode":"19380",
    "country":"United States",
    "email":"suzanne@sample.com",
    "phone":""
  },
  "shipping":{
    "first_name":"Suzanne",
    "last_name":"Kirkland",
    "company":"OBH Enterprises",
    "address_1":"3375 Chastain Gardens Drive",
    "address_2":"Suite 150",
    "city":"Kennesaw",
    "state":"Georgia",
    "postcode":"30144",
    "country":""
  },
  "payment_method":"cheque",
  "payment_method_title":"Pay Later - Send me an invoice to pay later",
  "set_paid":false,
  "status":"unpaid",
  "shipping_total":"25.0",
  "shipping_tax":"1.5",
  "discount_tax":"1.8",
  "discount_total":"30.0",
  "total_tax":11.64,
  "cart_tax":"10.14",
  "tax_lines":[
    {
      "rate_code":"GA Tax",
      "rate_id":280,
      "label":"Tax",
      "compound":false,
      "tax_total":"10.14",
      "shipping_tax_total":"1.5",
      "rate_percent":6.0
    }
  ],
  "line_items":[
    {
      "product_id":"3968",
      "name":"NoltrexVet - USA",
      "quantity":1.0,
      "price":"169.0",
      "sub_total":"169.00",
      "total":"169.00",
      "subtotal_tax":"10.14",
      "total_tax":"10.14",
      "taxes":[
        {"id":280,"total":"10.14","subtotal":"10.14"}
      ]
    }
  ],
  "shipping_lines":[
    {
      "method_id":"flat_rate",
      "method_title":"Ground",
      "total":"25.0",
      "total_tax":"1.5",
      "taxes":[
        {"id":280,"total":"1.5"}
      ],
      "tax_status":"taxable",
      "meta_data":[
        {"key":"Items","value":"NoltrexVet - USA x 1"}
      ]
    }
  ],
  "meta_data":[
    {"key":"vxc_zoho_order","value":"2019273000099061139"},
    {"key":"zoho_contact_id","value":"2019273000008033333"},
    {"key":"_wc_shipment_tracking_items","value":[{"tracking_provider":"UPS","tracking_number":"9876543"}]}
  ]
}

分析与解决建议 #

检查Payload后，发现几个核心问题导致税务信息未显示：

• 收货地址国家字段为空：WooCommerce税务计算依赖收货地址的国家信息，当前shipping对象的country是空字符串，系统无法匹配对应税率规则，直接忽略税务信息，需补充正确的国家代码（如US）。
• 商品字段名不匹配API规范：line_items中的sub_total是错误字段名，WooCommerce API标准字段为subtotal（无下划线），字段名错误会导致税务计算逻辑异常，需修正。
• 税率百分比格式问题：tax_lines中的rate_percent当前是数字类型，部分场景下WooCommerce API更兼容字符串格式，建议改为"6.0"。

修正后的关键字段示例 #

"shipping": {
  // ... 其他字段不变
  "country": "US"
},
"line_items": [
  {
    // ... 其他字段不变
    "subtotal": "169.00", // 替换原sub_total字段
    // ... 其他字段不变
  }
],
"tax_lines": [
  {
    // ... 其他字段不变
    "rate_percent": "6.0" // 改为字符串格式
  }
]

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