Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Clarify Amount calculation #323

Merged
merged 6 commits into from
May 27, 2024
Merged

Clarify Amount calculation #323

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
e0b2324
Update data-structures.md
forsthug Apr 26, 2024
603a35b
Update data-structures.md
forsthug Apr 26, 2024
2682b87
Update doc/middleware-de-kassensichv/data-structures/data-structures.md
forsthug Apr 29, 2024
9db7050
Update doc/middleware-de-kassensichv/data-structures/data-structures.md
forsthug Apr 29, 2024
14c9fc7
Merge branch 'master' into clarify-Amount-calculation
forsthug May 27, 2024
d665c51
Link detection seems to require lowecase
TSchmiedlechner May 27, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
14 changes: 13 additions & 1 deletion doc/middleware-de-kassensichv/data-structures/data-structures.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,12 +92,24 @@ The following table highlights fields of the charge item that need special handl
| `ProductNumber` | `string (50)` | mandatory if available | Article number | 1.3 |
| `ProductBarcode` | `string (50)` | mandatory if applicable | Use to send the Global Trade Item Number (GTIN) if the charge item represents an article. | 1.3 |
| `ProductGroup` | `string (50)` | mandatory if available | Name of the product group. | 1.3 |
| `Quantity` | `decimal (3)` | mandatory if available | Quantity | 1.3 |
| `Quantity` | `decimal (3)` | mandatory if available | Quantity [Payload and Export Amount Calculation](#payload-and-export-amount-calculation) | 1.3 |
| `Amount` | `decimal (5)` | 0.0 <br/> mandatory | Gross total price of service(s) [see general part](../../general/data-structures/data-structures.md) and [Payload and Export Amount Calculation](#payload-and-export-amount-calculation) | 1.3 |
| `UnitQuantity` | `decimal (3)` | mandatory if available | Quantity of the product of a single receipt entry (ChargeItem), displayed in indicated units, e.g. a big beer, Unit: "liter" UnitQuantity: 0.5 | 1.3 |
| `Unit` | `string` | mandatory if available | Unit of measurement, e.g. kg, litres or pieces | 1.3 |
| `UnitPrice` | `decimal (5)` | mandatory if available | Price per unit incl. VAT | 1.3 |
| `VATAmount` | `decimal (5)` | mandatory for special cases | In some special cases of taxation (e.g. car spare part in the car repair shop), the VAT is not a percentage of the net-price (NETTO) or the gross-price. For these cases, the field `VATAmount` is mandatory and a `ftChargeItemCase` that maps to DSFinV-K UST_SCHLUESSEL 7 should be used. The value of the field `VATRate` should be set to `0.0`. | 1.3 |

### Payload and Export Amount Calculation
To get a positive Amount: Amount and Quantity have to be positive. This is relevant e.g. for credit notes including a discount, which must be positive.

| **Calculated Amount** | **Receipt Amount** | **Receipt Quantity** |
| -------- | ------- | ------- |
| + | + | + |
| - | - | + |
| - | + | - |
| - | - | - |


### Pay Items Entry

In the general description, the field `ftPayItemCaseData` is described as optional. However, for the German market, the content of this field is not always optional.
Expand Down