> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gobl.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Scenario

Scenario is used to describe a tax scenario of a document based on the combination of document type and tag used.

## Schema ID

`https://gobl.org/draft-0/tax/scenario`

## Properties

| Title          | Property   | Type                                      | Description                                                                                                                                                                                            |
| -------------- | ---------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Name           | `name`     | [i18n.String](/draft-0/i18n/string)       | Name of the scenario for further information.                                                                                                                                                          |
| Description    | `desc`     | [i18n.String](/draft-0/i18n/string)       | Description of the scenario for documentation purposes.                                                                                                                                                |
| Type           | `type`     | array of [cbc.Key](/draft-0/cbc/key)      | Type of document, if present.                                                                                                                                                                          |
| Tags           | `tags`     | array of [cbc.Key](/draft-0/cbc/key)      | Array of tags that have been applied to the document.                                                                                                                                                  |
| Tax Categories | `cat`      | array of [cbc.Code](/draft-0/cbc/code)    | Categories is an optional list of tax category codes that acts as a filter. When set, at least one of the specified categories must be present in the document's line taxes for the scenario to match. |
| Extension Key  | `ext_key`  | [cbc.Key](/draft-0/cbc/key)               | Extension key that must be present in the document.                                                                                                                                                    |
| Extension Code | `ext_code` | [cbc.Code](/draft-0/cbc/code)             | Extension code that along side the key must be present for a match to happen. This cannot be used without an `cbc.Code`. The value will be copied to the note code if needed.                          |
| Note           | `note`     | [tax.Note](/draft-0/tax/note)             | A note to be added to the document if the scenario is applied.                                                                                                                                         |
| Codes          | `codes`    | [cbc.CodeMap](/draft-0/cbc/code_map)      | Codes is used to define additional codes for regime specific situations.                                                                                                                               |
| Extensions     | `ext`      | [tax.Extensions](/draft-0/tax/extensions) | Ext represents a set of tax extensions that should be applied to the document in the appropriate "tax" context.                                                                                        |