Kong · Schema
Workflow tax settings
Tax settings for a billing workflow.
API GatewayAI GatewayAI ConnectivityAgent GatewayEvent GatewayMCP RegistryService MeshLLMKafkaKonnectOpen Source
Properties
| Name | Type | Description |
|---|---|---|
| enabled | boolean | Enable automatic tax calculation when tax is supported by the app. For example, with Stripe Invoicing when enabled, tax is calculated via Stripe Tax. |
| enforced | boolean | Enforce tax calculation when tax is supported by the app. When enabled, the billing system will not allow to create an invoice without tax calculation. Enforcement is different per apps, for example, |
| default_tax_config | object | Default tax configuration to apply to the invoices for line items. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/BillingWorkflowTaxSettings",
"title": "Workflow tax settings",
"description": "Tax settings for a billing workflow.",
"type": "object",
"properties": {
"enabled": {
"description": "Enable automatic tax calculation when tax is supported by the app.\nFor example, with Stripe Invoicing when enabled, tax is calculated via Stripe Tax.",
"type": "boolean",
"default": true
},
"enforced": {
"description": "Enforce tax calculation when tax is supported by the app.\nWhen enabled, the billing system will not allow to create an invoice without tax calculation.\nEnforcement is different per apps, for example, Stripe app requires customer\nto have a tax location when starting a paid subscription.",
"type": "boolean",
"default": false
},
"default_tax_config": {
"description": "Default tax configuration to apply to the invoices for line items.",
"type": "object",
"properties": {
"behavior": {
"description": "Tax behavior.\n\nIf not specified the billing profile is used to determine the tax behavior.\nIf not specified in the billing profile, the provider's default behavior is used.",
"type": "string",
"enum": [
"inclusive",
"exclusive"
],
"title": "Tax behavior",
"x-speakeasy-unknown-values": "allow"
},
"stripe": {
"description": "Stripe tax config.",
"type": "object",
"deprecated": true,
"properties": {
"code": {
"description": "Product [tax code](https://docs.stripe.com/tax/tax-codes).",
"type": "string",
"example": "txcd_10000000",
"pattern": "^txcd_\\d{8}$",
"title": "Tax code"
}
},
"required": [
"code"
],
"title": "Stripe tax config"
},
"external_invoicing": {
"description": "External invoicing tax config.",
"type": "object",
"deprecated": true,
"properties": {
"code": {
"description": "The tax code should be interpreted by the external invoicing provider.",
"type": "string",
"maxLength": 64,
"title": "Tax code"
}
},
"required": [
"code"
],
"title": "External invoicing tax config"
},
"tax_code_id": {
"description": "Tax code ID.",
"type": "string",
"example": "01G65Z755AFWAKHE12NY0CQ9FH",
"deprecated": true,
"pattern": "^[0-7][0-9A-HJKMNP-TV-Z]{25}$",
"title": "Tax code ID"
},
"tax_code": {
"description": "Tax code reference.\n\nWhen both `tax_code` and `tax_code_id` are provided, `tax_code` takes precedence.\nWhen `stripe.code` is also provided, `tax_code` still wins and `stripe.code` is ignored.",
"type": "object",
"properties": {
"id": {
"$ref": "#/components/schemas/ULID"
}
},
"required": [
"id"
],
"title": "Tax code"
}
}
}
}
}