Business Central中通过API向自定义AL字段写入数据失败的问题咨询

这个操作完全是支持的，你遇到的错误核心原因是：自定义字段还没被暴露到Sales Order的API端点里。Business Central的UI页面扩展和API页面扩展是相互独立的，你之前只扩展了UI端的Sales Order页面，但API需要专门配置才能识别到自定义字段。下面是具体的解决步骤：

1. 扩展API版本的Sales Order页面 #

你需要针对API类型的Sales Order页面（系统默认ID为26，PageType=API）做扩展，而不是你之前修改的UI页面（ID 9305）。这样才能把自定义字段暴露给API接口。

修改你的AL代码，新增一个API页面扩展：

// 你的原表扩展保持不变
tableextension 50100 "AddProjectIdToSalesOrder" extends "Sales Header" {
    fields {
        field(50100; "CrmProjectId"; Guid) {
            Caption = 'Crm Project Id';
            DataClassification = OrganizationIdentifiableInformation;
        }
    }
}

// 新增API页面扩展，将自定义字段暴露到Sales Order API
pageextension 50101 "API Sales Order - Crm Project Id" extends "Sales Order" {
    PageType = API;
    fields {
        addlast(General) {
            field("CrmProjectId"; Rec."CrmProjectId") {
                Caption = 'Crm Project Id';
                DataClassification = OrganizationIdentifiableInformation;
            }
        }
    }
}

2. 调整API请求体的字段命名规则 #

Business Central的API默认使用驼峰命名法（小写字母开头），所以你需要把请求体里的CrmProjectId改成crmProjectId。另外要注意传入的GUID必须是有效格式（比如"d290f1ee-6c54-4b01-90e6-d701748f0851"）。修改后的请求体示例：

{ 
    "customerNumber": "10000", 
    "crmProjectId": "d290f1ee-6c54-4b01-90e6-d701748f0851" // 替换为你的有效GUID
}

3. 验证字段是否已成功暴露 #

部署扩展后，你可以通过GET请求访问API元数据端点来确认字段是否已添加：

GET /companies({companyId})/salesOrders/$metadata

在返回的XML中查找salesOrder类型，确认crmProjectId字段存在即可。

额外注意事项 #

• 确保使用的API端点是正确的版本（比如v2.0的/salesOrders，而非旧版本端点）
• 部署扩展后，可能需要等待1-2分钟让Business Central同步API元数据
• 如果是更新现有销售订单，使用PATCH请求时同样要遵循驼峰命名规则

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