自定义Acumatica GI在Postman中返回空列表，求排查建议

1. 通用查询（GI）权限配置 #

• 确认API调用的用户账号，拥有该自定义GI的访问权限：进入Acumatica的系统管理 > 权限 > 角色，为对应角色添加该GI的“查看”权限。
• 检查GI的共享设置：在GI设计界面，确保已勾选“共享给所有用户”，或已指定目标用户/角色。

2. GI关联与字段配置 #

• 验证POOrder与POLine的关联逻辑：必须用POOrder.OrderNbr = POLine.OrderNbr + POOrder.Type = POLine.Type作为关联键，确保主从表关联正确。
• 确认GI包含关键字段：比如POOrder的OrderNbr、Type，POLine的LineNbr等，这类字段是API识别实体关系的核心，缺失会导致数据无法正常返回。
• 检查GI的筛选条件：是否误加了过滤规则（如仅筛选特定状态的PO），可先移除所有筛选条件测试数据返回情况。

3. API启用与实体结构设置 #

• 确认GI已开启基于契约的API访问：在GI设计界面的属性面板，勾选“在API中可用”，并指定正确的实体名称（如POOrderDetails）。
• 配置GI的主明细实体结构：将POOrder设为主实体，POLine设为明细实体（在GI的关系标签中，把POLine设为POOrder的子项），这样API才会返回预期的主-明细嵌套结构。

4. API调用参数验证 #

• 确认请求端点URL格式正确：应为{{baseUrl}}/entity/{{tenantName}}/{{endpointVersion}}/{{GIEntityName}}，例如https://你的Acumatica实例地址/entity/Default/23.200.001/POOrderDetails。
• 检查认证信息有效性：确保OAuth2令牌或基本认证账号拥有采购订单数据的访问权限。
• 验证是否添加展开明细的参数：比如$expand=Details（需与GI中明细实体的名称一致），否则API仅返回主实体数据，不会自动展开明细。

5. 数据与状态检查 #

• 确认系统中存在符合GI条件的采购订单数据：在Acumatica界面直接运行该GI，若界面中无数据，API也会返回空列表。
• 检查采购订单的状态权限：比如是否仅允许查看已批准的PO，而测试数据处于未批准状态，导致无数据返回。

内容的提问来源于stack exchange，提问作者Adrián Gaviño