资金划转 API
机器翻译译自英文（docs.alpaca.markets）本页 24 段已全部译完
Journals API 允许你将现金或证券从一个账户转移到另一个账户。
有关创建和获取 journals 的更多信息，请查看我们的 journals API 参考部分。
最常见的用例是资金归集，这是一种资金模式，你可以将批量电汇发送到你的公司账户，然后将资金转移到每个单独的用户账户。
资金归集资金流
有两种类型的 journals：
JNLC
在账户之间 journal 现金。你可以在沙盒和生产环境中通过在你的预充值归集账户和用户账户之间 journal 资金来模拟即时资金。
你只能从公司账户向用户账户 journal 现金，反之亦然，但不能在客户之间进行。
JNLS
在账户之间 journal 证券。通过将少量股票 journal 到用户投资组合中来奖励注册或推荐他人的用户。
你只能从公司账户向用户账户 journal 证券，反之不行，也不能在客户之间进行。
Journals 状态
journal 最常见的状态流程相当简单：
- 创建后，journal 将处于
queued状态。 - 然后，journal 将变为
sent_to_clearing，表示请求已提交到我们的账簿和记录系统。[对于 JNLC v2，此状态只能通过手动审批流程在达到 journal 限额时到达。] - 如果没有问题，journal 将变为
executed，表示现金或证券已成功转移到接收账户。 - [仅 JNLC v2] 最后，journal 将变为
activity_created，表示非交易活动已成功创建。无需等待此步骤即可使用更新后的购买力；这仅供参考。
不过，还有其他情况会导致 journal 处于 rejected、refused 或需要 Alpaca 出纳团队手动干预。
| 状态 | 描述 |
|---|---|
queued | 这是 journal 仍在队列中等待处理时的初始状态。 |
sent_to_clearing | journal 已发送至 Alpaca 的记账系统进行处理。 |
executed | 交易涉及账户的余额已更新。在少数情况下，如果交易不被允许，Alpaca 的出纳团队可以从此状态反转 journal。 |
activity_created | journal 的非交易活动已创建。在少数情况下，如果交易不被允许，Alpaca 的出纳团队可以从此状态反转 journal。 [仅 JNLC v2 状态] |
pending | journal 等待处理，因为它需要 Alpaca 运营团队的手动批准，例如，这可能由达到 journal 限额 引起。 |
rejected | journal 已被手动拒绝。 |
canceled | journal 已通过 API 请求或由 Alpaca 运营团队取消。 |
refused | journal 从未记入 Alpaca 的账簿，可能是因为某些初步检查失败。常见的例子是短时间内重复的请求，其中第一个请求被执行，而第二个请求未通过余额检查。 |
correct | journal 已被手动更正。先前执行的 journal 被取消，并创建金额正确的新 journal。 |
deleted | journal 已从我们的账簿系统中删除。 |
Journal 状态流程图：JNLS、JNLC v1
Journal 状态流程图：JNLC v2
从 JNLC v1 升级到 v2
只要你的代码准备好接受新的 activity_created 状态，且不依赖接收 queued 或 sent_to_clearing 状态，升级到 v2 无需其他更改。JNLC 版本由 Alpaca 配置；如果你想升级，请与你的客户成功经理联系。
但是，如果你在收到 API 响应时 journal 处于 executed 状态，立即获知用户购买力已更新，可以获得额外的性能提升。在 v1 中，此时 journal 处于 queued 状态，而在 v2 中，如果一切成功，它将已经是 executed。
注意：JNLC v2 目前仅适用于单笔现金 journal 创建。批量现金 journal 仍使用 v1 流程创建。此外，超过每日限额且需要人工审核的 JNLC 目前仍将走 v1 流程；因此，请继续优雅地接受所有可能的状态。（在所有情况下，executed 状态才是与购买力更新相关的状态。）