1. 对象识别
| 参数 | 值 |
|---|---|
| 对象类型 | 文档（Документ） |
| 名称 | ПисьмоОбменСБанками |
| 全名 | Документ.ПисьмоОбменСБанками |
| 同义词 | “与银行的信函” |
| 配置 | 哈萨克斯坦会计，3.0 版（版本 3.0.74.2） |
| 过账 | 不过账（见第 5 节） |
| 查找位置（界面） | “电子交互”栏目 → “与银行的信函” |
| 导航链接 | e1cib/list/Документ.ПисьмоОбменСБанками |
用途。 该文档用于在电子交互系统（1С:ДиректБанк 技术）框架内登记和处理组织与银行之间的电子往来函件。通过它可发送和接收消息、通知、请求和答复：自由格式信函、外汇管制文件、附于付款委托书的随附往来函件。会计和财务部门用户每天在收发电子文档时使用该文档。列表中展示收件和发件信函，并可按组织、银行和信函类型进行筛选。
该文档实现的正是函件往来（信函交换），而非资金业务。结算账户上的资金流动（1030 账户“活期银行账户资金”）由付款文档（付款委托书、付款单）生成，而非信函。
2. 表头属性和表格部分
以下为按 1С:ДиректБанк 电子交换文档标准模型的字段用途。属性的具体构成需在具体发行版的配置器中核实。
2.1. 表头属性
| 属性 | 类型（典型） | 用途 |
|---|---|---|
Номер |
字符串 | 信息库中信函文档的编号 |
Дата |
日期 | 信函登记日期 |
Организация |
СправочникСсылка.Организации | 参与交换的组织 |
Банк / БанковскийСчет |
СправочникСсылка.Банки / БанковскиеСчета | 收件/发件银行及相关联的银行账户 |
НастройкаОбмена |
СправочникСсылка.НастройкиОбменаСБанками | 当前用于传输的 1С:ДиректБанк 交换设置 |
ВидПисьма / ТипСообщения |
枚举 | 函件类型（请求、通知、答复、自由格式信函） |
Направление |
枚举（收件/发件） | 信函方向 |
Тема |
字符串 | 消息主题/标题 |
Текст / СодержаниеПисьма |
字符串（多行） | 信函正文 |
ПисьмоОснование |
ДокументСсылка.ПисьмоОбменСБанками | 生成答复时的原始信函（场景 3.3） |
ДокументОснование |
ДокументСсылка | 相关联的文档（例如付款委托书——场景 3.4） |
Статус / СтатусОбмена |
枚举 | 交换状态：已准备、已发送、已送达、错误等 |
Прочитано |
布尔 | 收件信函的已读标志（场景 3.2） |
ИдентификаторДокументаОбмена / GUIDСообщения |
字符串/唯一标识符 | ДиректБанк 服务端的消息标识符 |
Автор / Ответственный |
СправочникСсылка.Пользователи | 编制信函的用户 |
2.2. 表格部分
| 表格部分 | 关键列 | 用途 |
|---|---|---|
Вложения / Файлы |
文件名、数据（值存储）、类型 | 附于信函的文件和电子文档 |
Подписи / ЭП |
证书、所有者、验证状态、时间戳 | 信函的电子签名及其验证结果（场景 3.6） |
属性和表格部分的确切清单具有版本特定性——请与您的发行版中对象的元数据进行核对。
3. 表单
| 表单 | 用途 |
|---|---|
ФормаСписка（Форма.ФормаСписка） |
收件/发件信函的主列表，可按组织和银行筛选。执行 ЗаполнитьСпискиОрганизацийИБанков——挑选支持信函的可用 ДиректБанк 交换设置 |
ПисьмоВБанк（Форма.ПисьмоВБанк） |
发件信函表单。ОформитьШапкуФормы 方法检查新信函是否存在当前有效的交换设置 |
Подписи（Форма.Подписи） |
处理信函的电子签名：查看证书、验证电子签名。ОткрытьСертификат 方法打开列表中选定的证书 |
| 收件信函/查看表单 | 查看收到的信函、标记“已读”、生成答复 |
4. 模块的关键过程
从 evidence 确认了以下代码位置（release 3.0.68.1，消息文本——逐字取自配置）：
| 过程 / 方法 | 位置 | 作用 |
|---|---|---|
ЗаполнитьСпискиОрганизацийИБанков |
Форма.ФормаСписка |
根据 ДиректБанк 交换设置生成可用组织/银行列表。若结果为空（НЕ ТаблицаРезультата.Количество()），则显示：“未找到任何支持发送信函的 1С:ДиректБанк 交换设置。” |
ОформитьШапкуФормы |
Форма.ПисьмоВБанк |
创建新信函时（ЭтоНовый И НЕ ТаблицаРезультата.Количество()）检查当前有效的交换设置；若不存在，则显示：“不存在与储蓄银行的当前有效 1С:ДиректБанк 交换设置。” |
ОткрытьСертификат |
Форма.Подписи |
打开选定的电子签名证书。若未选择（Элементы.ЭП.ТекущиеДанные <> Неопределено），则显示：“请在已安装签名列表中选择证书。” |
典型处理器（按对象类型——不过账的交换文档）
ОбработкаЗаполнения（对象模块）——在基于其他文档（付款委托书、收件信函）录入时填充属性。ОбработкаПроверкиЗаполнения——在记录前检查必填字段（组织、银行、交换设置）。ПередЗаписью/ПриЗаписи（对象模块）——固定交换状态、更新消息标识符。- 表单的客户端处理器：
ПриСозданииНаСервере、ПриОткрытии——根据信函方向和状态初始化元素的可见性和可用性。 - 与 ДиректБанк 集成的过程：发送消息、同步状态和加载收件（场景 3.5）、验证电子签名（场景 3.6）、为技术支持导出数据（场景 3.7）——在与银行交换子系统的通用模块中实现。
5. 过账与登记
该文档不是过账文档。 对象的元数据中不存在 register_records（寄存器登记）部分，模块中也没有 ОбработкаПроведения 过程。因此：
- 该文档不生成会计分录，也不在自身过账框架内于累计/信息寄存器中创建记录。
- 它固定的是与银行往来函件的事实和内容，而非经济业务。
相应地，信函不涉及哈萨克斯坦标准科目表中的以下账户：
| 账户 | 名称 |
|---|---|
| 1030 | 活期银行账户资金 |
| 1210 | 购货方短期应收账款 |
| 3310 | 供货方短期应付账款 |
资金和结算业务（1030 的流动、1210/3310 的往来结算、6010 收入确认、7010 成本、按 16 % 税率的 3130 账户“应缴增值税”的增值税）由专门文档（付款委托书/付款单、销售、入库）以及电子文档 ЭСФ（ИС ЭСФ 系统）和 СНТ 反映。与银行的信函仅以函件形式随附这些业务。
若需审计登记项——应在相关联的财务文档中查找，而非信函中。
6. 相关对象与基于录入
主要操作场景
| № | 场景 | 适用时机 |
|---|---|---|
| 3.1 | 向银行发送新信函 | 典型付款业务之外的自由格式请求/通知/文档 |
| 3.2 | 查看收件信函并标记为已读 | 收到来自银行的新信函 |
| 3.3 | 答复来自银行的信函 | 关联到原始信函的答复（ПисьмоОснование） |
| 3.4 | 基于付款委托书创建信函 | 与具体付款相关的附加信函 |
| 3.5 | 与银行同步并接收新信函 | 加载新信函并更新已发送信函的状态 |
| 3.6 | 验证信函的电子签名 | 验证收件信函的真实性/发件信函的正确性 |
| 3.7 | 为技术支持保存信息 | 交换出错或向技术支持传输数据时 |
相关对象
- 与银行的交换设置（1С:ДиректБанк）——连接参数的必备来源；没有当前有效设置则无法创建/发送信函。
- 目录“组织”“银行”“银行账户”——表头属性。
- 付款委托书——信函的基础文档（场景 3.4，
ДокументОснование）。 - ПисьмоОбменСБанками（自身对自身）——通过
ПисьмоОснование构成“信函 → 答复”链（场景 3.3）。 - 电子签名密钥证书——在“Подписи”表单中用于签署和验证。
基于录入
- 从付款委托书 → “与银行的信函”（场景 3.4）：组织、银行和交换设置的属性从基础文档转移。
- 从收件信函 → 答复信函（场景 3.3）：填充
ПисьмоОснование，主题/收件人被继承。
7. 扩展点
- 配置扩展（表单模块）： 通过
&Вместо/&После拦截ЗаполнитьСпискиОрганизацийИБанков、ОформитьШапкуФормы、ОткрытьСертификат，以自定义交换设置筛选或附加验证。 - 对象模块： 重定义
ОбработкаЗаполнения（基于录入规则）、ОбработкаПроверкиЗаполнения（附加必填字段）、ПриЗаписи（集成钩子、交换日志记录）。 - 事件订阅（文档的
ПередЗаписью/ПриЗаписи）——用于对函件进行外部审计而无需干预对象模块。 - 附加属性和信息（属性机制）——用于标记信函而不更改元数据。
- 交换子系统的通用模块——改进同步逻辑（场景 3.5）和电子签名验证（场景 3.6）的切入点。
由于该文档不过账，通过扩展添加自有登记项（寄存器）虽可行但不典型：反映财务业务请使用专门的过账文档，而将信函保留为函件往来手段。
典型错误（逐字取自代码，release 3.0.68.1）
| 1С 消息 | 出现位置 | 代码中的条件 |
|---|---|---|
| 未找到任何支持发送信函的 1С:ДиректБанк 交换设置。 | Форма.ФормаСписка / ЗаполнитьСпискиОрганизацийИБанков |
НЕ ТаблицаРезультата.Количество() |
| 不存在与储蓄银行的当前有效 1С:ДиректБанк 交换设置。 | Форма.ПисьмоВБанк / ОформитьШапкуФормы |
ЭтоНовый И НЕ ТаблицаРезультата.Количество() |
| 请在已安装签名列表中选择证书。 | Форма.Подписи / ОткрытьСертификат |
Элементы.ЭП.ТекущиеДанные <> Неопределено |
如果看到此类消息——请检查第三列中的条件。消息文本和过程名称在迁移到其他发行版时需要核实——它们具有版本特定性。