如何使用C#向Microsoft Dynamics GP上传银行对账文件

一、具体操作步骤 #

1. 前期准备 #

• 确认你的Dynamics GP版本（本地/云部署），确保账号拥有银行对账模块的读写权限
• 对齐本地对账文件格式：GP支持CSV、固定宽度文本等格式，文件必须包含银行账号、交易日期、金额、交易描述等核心字段，格式需匹配GP系统内的设置
• 配置开发环境：根据选择的集成方式，安装对应的GP SDK或添加服务引用

2. 基于GP Web Services的实现 #

这是GP官方推荐的标准集成方式，适合大多数场景：

• 添加服务引用：在C#项目中右键「添加服务引用」，输入GP Web Services的WSDL地址（通常为http://<GP服务器地址>:48620/Dynamics/GPService），生成客户端代理类
• 读取并解析本地文件：用StreamReader读取本地文件，将每一行解析为BankTransaction对象
• 提交数据到GP：通过生成的客户端调用Create方法提交对账记录，示例代码：

// 初始化GP服务客户端
var gpService = new GPClient();
gpService.ClientCredentials.Windows.ClientCredential = System.Net.CredentialCache.DefaultNetworkCredentials;

// 读取本地CSV文件并构建交易列表
var transactions = new List<BankTransaction>();
using (var reader = new StreamReader(@"C:\Bank_Reconciliation.csv"))
{
    string line;
    // 跳过表头
    reader.ReadLine();
    while ((line = reader.ReadLine()) != null)
    {
        var fields = line.Split(',');
        var transaction = new BankTransaction
        {
            BankAccountId = new Key { Id = fields[0] },
            TransactionDate = DateTime.Parse(fields[1]),
            Amount = decimal.Parse(fields[2]),
            Description = fields[3]
        };
        transactions.Add(transaction);
    }
}

// 提交交易记录
gpService.Create(transactions.ToArray());
gpService.Close();

• 验证结果：登录GP系统，进入「银行对账」模块，查看导入的记录是否正确

3. 基于eConnect的批量导入方案 #

如果需要处理大量对账数据，eConnect的性能更优：

• 安装eConnect SDK：下载官方eConnect安装包，安装后在项目中引用Microsoft.Dynamics.GP.eConnect.dll
• 生成符合eConnect Schema的XML：将本地对账数据转换为eConnect要求的XML格式（包含BankTransactionType节点）
• 调用eConnect接口提交数据：

var eConnect = new eConnectMethods();
var connString = "Data Source=<GP_DB_Server>;Initial Catalog=<GP_DB_Name>;Integrated Security=True";

// 自定义方法生成eConnect XML
var xmlPayload = GenerateBankReconciliationXml(@"C:\Bank_Reconciliation.csv");

// 提交数据
eConnect.CreateEntity(connString, xmlPayload);

• 注意：XML格式必须严格遵循eConnect的官方Schema，可参考SDK自带的示例文件

二、官方API/SDK支持情况 #

Microsoft Dynamics GP提供三种官方工具支持C#集成：

• GP Web Services：基于SOAP的标准Web服务，覆盖绝大多数GP业务操作，支持远程/云部署，适合常规集成场景
• eConnect：专注于批量数据集成的组件，通过XML与GP数据库交互，性能出色，适合本地部署的大规模数据导入
• GP REST API：GP 2020及以后版本支持，基于HTTP的REST接口，更适配现代应用的集成需求

所有SDK和官方文档均可在Microsoft Docs平台获取，无需依赖第三方资源。

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