POST /api/v1/intents/{id}/cancel

curl -X POST "https://api.procure-core.com/api/v1/intents/intent_67890/cancel" \
  -H "X-App-Id: dev_app_local" \
  -H "X-Timestamp: 1708851000000" \
  -H "X-Signature: abc123..."

import { ProcureClient } from '@procure-core/sdk';
 
const client = new ProcureClient({
  appId: 'your_app_id',
  appSecret: 'your_app_secret',
  baseURL: 'https://api.procure-core.com'
});
 
// 取消采购意图
await client.intents.cancel('intent_67890');
console.log('采购意图已取消');

from procure_core import ProcureClient
 
client = ProcureClient(
    app_id='your_app_id',
    app_secret='your_app_secret',
    base_url='https://api.procure-core.com'
)
 
# 取消采购意图
client.intents.cancel('intent_67890')
print('采购意图已取消')

{
  "code": 0,
  "message": "操作成功",
  "data": {
    "id": "intent_67890",
    "status": "CANCELLED",
    "updatedAt": "2026-02-25T11:30:00.000Z",
    "cancelledAt": "2026-02-25T11:30:00.000Z"
  }
}

{
  "code": 40401,
  "message": "采购意图不存在",
  "data": null
}

{
  "code": 40003,
  "message": "当前状态不允许取消",
  "data": {
    "currentStatus": "COMPLETED",
    "reason": "已完成的订单不能取消"
  }
}

{
  "code": 50003,
  "message": "取消操作失败",
  "data": {
    "reason": "电商平台订单已发货，无法取消"
  }
}

// 用户取消订单
async function userCancelIntent(intentId: string) {
  try {
    const result = await client.intents.cancel(intentId);
    console.log('订单已成功取消');
    return result;
  } catch (error) {
    if (error.code === 40003) {
      console.error('订单状态不允许取消');
    } else if (error.code === 50003) {
      console.error('系统取消失败，请联系客服');
    }
    throw error;
  }
}

// 取消前确认当前状态
async function safeCancelIntent(intentId: string) {
  // 先查询当前状态
  const intent = await client.intents.get(intentId);
  
  // 检查是否可以取消
  if (!['SUBMITTED', 'PROCESSING'].includes(intent.status)) {
    throw new Error(`当前状态 ${intent.status} 不允许取消`);
  }
  
  // 执行取消
  return await client.intents.cancel(intentId);
}

// 批量取消多个意图
async function batchCancel(intentIds: string[]) {
  const results = [];
  
  for (const intentId of intentIds) {
    try {
      const result = await client.intents.cancel(intentId);
      results.push({ intentId, success: true, data: result });
    } catch (error) {
      results.push({ intentId, success: false, error: error.message });
    }
  }
  
  return results;
}

// 超过一定时间未处理，自动取消
async function autoCancelExpired() {
  const intents = await client.intents.list({
    status: 'SUBMITTED',
    sortBy: 'createdAt',
    order: 'asc'
  });
  
  const now = Date.now();
  const expiredThreshold = 24 * 60 * 60 * 1000; // 24小时
  
  for (const intent of intents.data.items) {
    const createdTime = new Date(intent.createdAt).getTime();
    
    if (now - createdTime > expiredThreshold) {
      try {
        await client.intents.cancel(intent.id);
        console.log(`已自动取消超时意图: ${intent.id}`);
      } catch (error) {
        console.error(`取消失败: ${intent.id}`, error);
      }
    }
  }
}