ACCOUNTING_TRANSFER

common/proto/accounting.proto

@@ -57,6 +57,13 @@ service Accounting {
       returns (ListAccountingPeriodsResponse);
   rpc ListPeriodBalances(ListPeriodBalancesRequest) returns (ListPeriodBalancesResponse);
 
+  // Materialize one row per directly transferable source account in a table
+  // containing an ACCOUNTING_TRANSFER definition. Source fields are frozen
+  // accounting facts; target fields start as an unchanged same-path copy and
+  // may then be changed by the table's Steel logic or by the user.
+  rpc GenerateAccountingTransfer(GenerateAccountingTransferRequest)
+      returns (GenerateAccountingTransferResponse);
+
   // Administratively map one account in a predecessor profile to one account
   // in the current profile. Existing activity on the target account is allowed.
   rpc MapOpeningBalanceAccount(MapOpeningBalanceAccountRequest)
@@ -382,8 +389,35 @@ message PeriodBalance {
   string closing_balance = 7;
 }
 
+message PeriodDenominationBalance {
+  int64 period_id = 1;
+  // Exact denominated account. Unlike book balances, this quantity is not
+  // rolled up into parent accounts with a different denomination.
+  repeated string account_segments = 2;
+  string denomination_currency = 3;
+  // Signed nets use debit-positive convention and remain in the denomination
+  // currency without conversion during carry-forward.
+  string opening_quantity = 4;
+  string period_debit_quantity = 5;
+  string period_credit_quantity = 6;
+  string closing_quantity = 7;
+}
+
 message ListPeriodBalancesResponse {
   repeated PeriodBalance balances = 1;
+  repeated PeriodDenominationBalance denomination_balances = 2;
+}
+
+message GenerateAccountingTransferRequest {
+  string profile_name = 1;
+  string table_name = 2;
+  int64 source_period_id = 3;
+  int64 target_period_id = 4;
+}
+
+message GenerateAccountingTransferResponse {
+  int64 table_definition_id = 1;
+  int64 generated_row_count = 2;
 }
 
 message MapOpeningBalanceAccountRequest {
@@ -431,6 +465,11 @@ message OpeningBalanceAccountMapping {
   OpeningBalanceStatus status = 12;
   string created_at = 13;
   string created_by_user_id = 14;
+  string denomination_currency = 15;
+  string denomination_opening_quantity = 16;
+  string denomination_period_debit_quantity = 17;
+  string denomination_period_credit_quantity = 18;
+  string denomination_current_quantity = 19;
 }
 
 // A portion of a predecessor account's value that no mapping carries into the
@@ -448,6 +487,16 @@ message UnmappedSourceBalance {
   OpeningBalanceStatus status = 6;
 }
 
+message UnmappedSourceDenominationBalance {
+  int64 source_period_id = 1;
+  string source_profile_name = 2;
+  repeated string source_account_segments = 3;
+  string denomination_currency = 4;
+  // Exact foreign-currency quantity that no mapping carries forward.
+  string unmapped_quantity = 5;
+  OpeningBalanceStatus status = 6;
+}
+
 message ListOpeningBalanceAccountsResponse {
   repeated OpeningBalanceAccountMapping mappings = 1;
 
@@ -456,4 +505,6 @@ message ListOpeningBalanceAccountsResponse {
   // mapping only, which happens when the predecessor belongs to another
   // profile or when the period has at least one mapping of its own.
   repeated UnmappedSourceBalance unmapped_source_balances = 2;
+  repeated UnmappedSourceDenominationBalance
+      unmapped_source_denomination_balances = 3;
 }

common/proto/table_definition.proto

@@ -174,6 +174,9 @@ message ColumnDefinition {
   //               account always selects a row from the profile's managed accounts table;
   //               name is limited to 10 characters and one stored row contributes
   //               one line to the profile journal)
+  //   ACCOUNTING_TRANSFER (creates automatic source-period/account/book/
+  //               denomination fields and writable target equivalents; one
+  //               table may contain only one accounting transfer definition)
   //   INT
   //   BIGINT
   //   DATE