accounting period

common/proto/accounting.proto

@@ -63,6 +63,22 @@ enum AccountingPeriodStatus {
   ACCOUNTING_PERIOD_STATUS_APPROVED = 3;
 }
 
+// How long one accounting period lasts. MONTH and YEAR span whole months, so
+// the caller states only the start and the end is derived. PARTIAL is the
+// exception for periods real life cut short.
+enum AccountingPeriodType {
+  ACCOUNTING_PERIOD_TYPE_UNSPECIFIED = 0;
+  // One calendar month.
+  ACCOUNTING_PERIOD_TYPE_MONTH = 1;
+  // Twelve consecutive months, aligned to the profile's fiscal year. Starting
+  // in January gives the calendar year; any other start month gives a business
+  // year (hospodársky rok).
+  ACCOUNTING_PERIOD_TYPE_YEAR = 2;
+  // Neither a whole month nor a whole year, because the entity was formed or
+  // terminated part-way through one. The only type carrying an explicit end.
+  ACCOUNTING_PERIOD_TYPE_PARTIAL = 3;
+}
+
 message PostJournalRequest {
   string profile_name = 1;
 
@@ -244,11 +260,16 @@ message Journal {
 
 message ConfigureAccountingPeriodRequest {
   string profile_name = 1;
-  // Inclusive range in YYYY-MM-DD.
+  // First day of the period, YYYY-MM-DD. Must be the first day of a month.
   string period_start = 2;
-  string period_end = 3;
+  reserved 3;
   // Optional link to the preceding period in a carry chain.
   optional int64 previous_period_id = 4;
+  // Required. Decides the length of the period.
+  AccountingPeriodType period_type = 5;
+  // Last day of the period, YYYY-MM-DD. Required for PARTIAL and rejected for
+  // every other type, whose end follows from the start.
+  string period_end = 6;
 }
 
 message CloseAccountingPeriodRequest {
@@ -286,6 +307,7 @@ message AccountingPeriod {
   string closed_by_user_id = 8;
   string approved_at = 9;
   string approved_by_user_id = 10;
+  AccountingPeriodType period_type = 11;
 }
 
 message ListPeriodBalancesRequest {

common/proto/table_definition.proto

@@ -89,6 +89,20 @@ message PostTableDefinitionRequest {
   // Column whose value identifies a row to users in pickers. "id" is always
   // valid; otherwise this must name one of the user-defined columns above.
   string row_display_column = 7;
+
+  // ISO-4217 currency the profile keeps its accounting in. A profile is one
+  // accounting entity and keeps one set of books, so this is required only when
+  // the request creates the profile, and is ignored afterwards. It is unrelated
+  // to base_currency: tables may hold money in any currency, and amounts convert
+  // to this one when they reach the ledger.
+  string accounting_currency = 8;
+
+  // Month the profile's fiscal year begins, 1-12. Like accounting_currency,
+  // this describes the entity rather than the table, so it is required only
+  // when the request creates the profile and ignored afterwards. January means
+  // the calendar year; any other month means a business year (hospodársky
+  // rok), which may be used only after notifying the tax office.
+  uint32 fiscal_year_start_month = 9;
 }
 
 // Defines the input for explicitly creating a table backed by one invoice