PrestaShop API创建订单时自定义参考值无法设置的问题求助

1. 先检查后台配置 #

首先确认PrestaShop后台是否允许自定义订单参考值：

• 进入后台「首选项」→「订单」
• 找到「订单参考」板块，检查是否开启了手动设置订单参考的选项，或者是否存在强制自动生成的规则（比如固定前缀、自动递增格式）。如果后台配置为自动生成，API设置会被覆盖。

2. 创建订单时的参数修正 #

部分PrestaShop API客户端库（如prestapyt）要求订单参数嵌套在order键下，而非直接平级传递。调整你的orderJ结构：

orderJ = {
    'order': {
        'reference': 'test',
        'id_currency': 1,
        'id_carrier': 1,
        'id_lang': 1,
        'current_state': 'PS_OS_PAYMENT_ACCEPTED',
        'module': 'ps_checkpayment',
        'payment': 'ps_checkpayment',
        'total_paid': order["base_subtotal"],
        'total_paid_real': order["base_shipping_amount"],
        'total_products': order["base_shipping_incl_tax"],
        'total_products_wt': '13.120000',
        'conversion_rate': order["total_incl_tax"],
    }
}

response = ord.createOrder(userJ, addressJ, billadressJ, cartJ, itemJ, orderJ)

如果使用的是低版本PrestaShop（1.7.x以前），可能需要确保reference字段在创建订单时被正确传入，部分旧版本API默认忽略该字段，需通过后台开启允许自定义。

3. 编辑订单的正确姿势 #

如果创建时无法设置，尝试编辑订单时避免覆盖自动生成的关键字段（如date_add、date_upd），只传递需要修改的字段：

# 获取订单ID
ord_id = response['prestashop']['order']['id']
# 获取订单完整数据
order_data = prestashop.get('orders', ord_id)

# 仅修改reference字段，保留其他原有数据
order_data['order']['reference'] = 'test'

# 执行编辑操作
edit_response = prestashop.edit('orders', ord_id, order_data)
print(edit_response)

注意：部分PrestaShop版本中，订单状态为已支付后可能限制修改reference，可先将订单状态改为草稿，修改后再改回原状态。

4. 直接调用API端点（绕过客户端库） #

如果客户端库存在兼容性问题，直接用requests库发送请求：

import requests

API_URL = "https://your-prestashop-domain/api"
API_KEY = "your-api-key"

# 创建订单时设置reference
create_payload = """
<prestashop>
  <order>
    <reference><![CDATA[test]]></reference>
    <id_currency>1</id_currency>
    <id_carrier>1</id_carrier>
    <id_lang>1</id_lang>
    <current_state>PS_OS_PAYMENT_ACCEPTED</current_state>
    <module>ps_checkpayment</module>
    <payment>ps_checkpayment</payment>
    <total_paid>{}</total_paid>
    <total_paid_real>{}</total_paid_real>
    <total_products>{}</total_products>
    <total_products_wt>13.120000</total_products_wt>
    <conversion_rate>{}</conversion_rate>
  </order>
</prestashop>
""".format(order["base_subtotal"], order["base_shipping_amount"], order["base_shipping_incl_tax"], order["total_incl_tax"])

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/xml"
}

# 发送创建订单请求
create_response = requests.post(f"{API_URL}/orders", data=create_payload, headers=headers)

# 编辑订单参考值
edit_payload = """
<prestashop>
  <order>
    <id>{}</id>
    <reference><![CDATA[test]]></reference>
  </order>
</prestashop>
""".format(ord_id)

edit_response = requests.put(f"{API_URL}/orders/{ord_id}", data=edit_payload, headers=headers)

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