feat(api): add organization tax config (#4280)

Author: borbelyr-kong

api/spec/packages/aip/src/defaults/index.tsp

@@ -0,0 +1,2 @@
+import "./taxcodes.tsp";
+import "./operations.tsp";

api/spec/packages/aip/src/defaults/operations.tsp

@@ -0,0 +1,33 @@
+import "@typespec/http";
+import "@typespec/rest";
+import "@typespec/openapi";
+import "@typespec/openapi3";
+import "../common/error.tsp";
+import "../shared/index.tsp";
+import "./taxcodes.tsp";
+
+using TypeSpec.Http;
+using TypeSpec.OpenAPI;
+
+namespace Defaults;
+
+interface OrganizationDefaultTaxCodesOperations {
+  @get
+  @operationId("get-organization-default-tax-codes")
+  @summary("Get organization default tax codes")
+  @extension(Shared.PrivateExtension, true)
+  @extension(Shared.UnstableExtension, true)
+  @extension(Shared.InternalExtension, true)
+  get(
+  ): Shared.GetResponse<OrganizationDefaultTaxCodes> | Common.NotFound | Common.ErrorResponses;
+
+  @put
+  @operationId("update-organization-default-tax-codes")
+  @summary("Update organization default tax codes")
+  @extension(Shared.PrivateExtension, true)
+  @extension(Shared.UnstableExtension, true)
+  @extension(Shared.InternalExtension, true)
+  update(
+    @body body: Shared.UpdateRequest<OrganizationDefaultTaxCodes>,
+  ): Shared.UpsertResponse<OrganizationDefaultTaxCodes> | Common.NotFound | Common.ErrorResponses;
+}

api/spec/packages/aip/src/defaults/taxcodes.tsp

@@ -0,0 +1,37 @@
+import "../shared/index.tsp";
+import "../tax/codes.tsp";
+
+namespace Defaults;
+
+/**
+ * Organization-level default tax code references.
+ *
+ * Stores the default tax codes applied to specific billing contexts for this
+ * organization. Provisioned automatically when the organization is created.
+ */
+@friendlyName("OrganizationDefaultTaxCodes")
+model OrganizationDefaultTaxCodes {
+  /**
+   * Default tax code for invoicing.
+   */
+  @summary("Invoicing tax code")
+  invoicing_tax_code: Shared.ResourceReference<Tax.TaxCode>;
+
+  /**
+   * Default tax code for credit grants.
+   */
+  @summary("Credit grant tax code")
+  credit_grant_tax_code: Shared.ResourceReference<Tax.TaxCode>;
+
+  /**
+   * Timestamp of creation.
+   */
+  @visibility(Lifecycle.Read)
+  created_at: Shared.DateTime;
+
+  /**
+   * Timestamp of last update.
+   */
+  @visibility(Lifecycle.Read)
+  updated_at: Shared.DateTime;
+}

api/spec/packages/aip/src/konnect.tsp

@@ -12,6 +12,7 @@ import "./subscriptions/index.tsp";
 import "./apps/index.tsp";
 import "./billing/index.tsp";
 import "./tax/index.tsp";
+import "./defaults/index.tsp";
 
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
@@ -52,6 +53,7 @@ using TypeSpec.OpenAPI;
   Shared.ProductCatalogTag,
   #{ description: Shared.ProductCatalogDescription }
 )
+@tagMetadata(Shared.DefaultsTag, #{ description: Shared.DefaultsDescription })
 @useAuth(systemAccountAccessToken | personalAccessToken | konnectAccessToken)
 namespace MeteringAndBilling;
 
@@ -176,6 +178,11 @@ interface AddonsEndpoints extends ProductCatalog.AddonOperations {}
 @tag(Shared.ProductCatalogTag)
 interface PlanAddonEndpoints extends ProductCatalog.PlanAddonOperations {}
 
+@route("/openmeter/defaults/tax-codes")
+@tag(Shared.DefaultsTag)
+interface OrganizationDefaultTaxCodesEndpoints
+  extends Defaults.OrganizationDefaultTaxCodesOperations {}
+
 /**
  * The system account access token is meant for automations and integrations that are not directly associated with a human identity.
  */

api/spec/packages/aip/src/openmeter.tsp

@@ -13,6 +13,7 @@ import "./currencies/index.tsp";
 import "./features/index.tsp";
 import "./llmcost/index.tsp";
 import "./productcatalog/index.tsp";
+import "./defaults/index.tsp";
 
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
@@ -58,6 +59,7 @@ using TypeSpec.OpenAPI;
   Shared.ProductCatalogTag,
   #{ description: Shared.ProductCatalogDescription }
 )
+@tagMetadata(Shared.DefaultsTag, #{ description: Shared.DefaultsDescription })
 namespace OpenMeter;
 
 @route("/openmeter/events")
@@ -180,3 +182,8 @@ interface AddonsEndpoints extends ProductCatalog.AddonOperations {}
 @route("/openmeter/plans/{planId}/addons")
 @tag(Shared.ProductCatalogTag)
 interface PlanAddonEndpoints extends ProductCatalog.PlanAddonOperations {}
+
+@route("/openmeter/defaults/tax-codes")
+@tag(Shared.DefaultsTag)
+interface OrganizationDefaultTaxCodesEndpoints
+  extends Defaults.OrganizationDefaultTaxCodesOperations {}

api/spec/packages/aip/src/shared/consts.tsp

@@ -35,6 +35,9 @@ const FeaturesDescription = "Features represent product capabilities backed by m
 const ProductCatalogTag = "OpenMeter Product Catalog";
 const ProductCatalogDescription = "Product catalog manages plans, add-ons, and their associations for subscription-based billing.";
 
+const DefaultsTag = "OpenMeter Defaults";
+const DefaultsDescription = "Organization-level default configuration.";
+
 const UnstableExtension = "x-unstable";
 const InternalExtension = "x-internal";
 const PrivateExtension = "x-private";