> ## Documentation Index
> Fetch the complete documentation index at: https://gobl-cli-install-gobl-dev.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Charge

Charge represents a surchange applied to the complete document independent from the individual lines.

## Schema ID

`https://gobl.org/draft-0/bill/charge`

## Properties

| Title | Property | Type | Description |
| - | - | - | - |
| UUID | `uuid` | string | Universally Unique Identifier. |
| Index | `i` | integer | Line number inside the list of charges (calculated). |
| Key | `key` | [cbc.Key](/draft-0/cbc/key) | Key for grouping or identifying charges for tax purposes. A suggested list of keys is provided, but these may be extended by the issuer. |
| Code | `code` | [cbc.Code](/draft-0/cbc/code) | Code to used to refer to the this charge by the issuer |
| Reason | `reason` | string | Text description as to why the charge was applied |
| Base | `base` | [num.Amount](/draft-0/num/amount) | Base represents the value used as a base for percent calculations instead of the invoice's sum of lines. |
| Percent | `percent` | [num.Percentage](/draft-0/num/percentage) | Percentage to apply to the sum of all lines |
| Amount | `amount` | [num.Amount](/draft-0/num/amount) | Amount to apply (calculated if percent present) |
| Taxes | `taxes` | [tax.Set](/draft-0/tax/set) | List of taxes to apply to the charge |
| Extensions | `ext` | [tax.Extensions](/draft-0/tax/extensions) | Extension codes that apply to the charge |
| Meta | `meta` | [cbc.Meta](/draft-0/cbc/meta) | Additional semi-structured information. |

## Key Values

| Value | Description |
| - | - |
| `stamp-duty` | Stamp Duty |
| `outlay` | Outlay |
| `tax` | Tax |
| `customs` | Customs |
| `delivery` | Delivery |
| `packing` | Packing |
| `handling` | Handling |
| `insurance` | Insurance |
| `storage` | Storage |
| `admin` | Administration |
| `cleaning` | Cleaning |

## Validation Rules

| Field | Test | Validation Code / Message |
| - | - | - |
| `percent` | <ul class="gobl-test"><li>Base != nil</li><li class="gobl-test-present">Present</li></ul> | `GOBL-BILL-CHARGE-01`<br />Percent is required when base is set |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.