关于Cost Management API的两项技术疑问咨询

1. 通过数值型companyId获取对应公司信息 #

你遇到的数值型ID（如23845621）是传统遗留公司ID（legacy company ID），而BIM 360 Companies API通用列表端点返回的是GUID格式ID。要通过这个数值ID获取公司信息，需使用专门的遗留公司ID查询接口：

• 调用GET /hq/v1/companies/{legacy_company_id}接口，将数值ID替换为路径参数
• 请求需携带有效的Forge OAuth2令牌，且令牌需具备BIM 360 Account Admin或Project Admin权限
• 接口返回结果将包含对应GUID格式公司ID、公司名称、税务编号等完整信息，可与通用Companies API返回的数据关联

2. 获取/编辑支付相关税务信息 #

目前Forge/ACC Cost API没有单独的税务信息专属端点，可通过以下方式处理：

获取税务信息 #

• 若税务数据存储在支付自定义字段中：调用GET /cost/v1/projects/{project_id}/payments/{payment_id}接口，从返回的customFields字段提取配置好的税务相关值
• 若税务信息属于供应商公司属性：通过遗留公司ID查询接口或通用Companies API，从公司信息的tax_id等字段获取

编辑税务信息 #

• 更新支付关联的税务数据：调用PUT /cost/v1/projects/{project_id}/payments/{payment_id}接口，在请求体的customFields中传入更新后的税务值（需确保项目已提前配置对应税务自定义字段）
• 更新供应商公司的税务属性：调用PATCH /hq/v1/companies/{company_id}接口，修改公司的tax_id等税务相关字段（需具备公司编辑权限）

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