Join us at Fortnox App Market today!

Best practice: New Housework Invoice

Best practice: New Housework Invoice

We have released a new validation for Housework invoices and that increases the amount of required fields. The required field is named: “TaxReductionType”.
When creating a housework invoice it’s mandatory to have at least one invoice row marked with HouseWork and HouseWorkType. The rest of the rows on the invoice needs to be marked with at least HouseWorkType.

Housework related fields:

Invoice:

  • TaxReductionType: String that must be “rot”, “rut”, “green” or “none”

InvoiceRow:

  • HouseWorkType: String that has to be connected to the reduction type.
    Example: CONSTRUCTION is rot and CLEANING is rut.
    If TaxRedcutionType is “none” then the HouseWorkType has to be empty.
    To empty a value you can use: “API_BLANK”.
  • HouseWork: Boolean that must be “true” or “false”.
Example: POST /invoices
{
 "Invoice": {
 "CustomerNumber": "1",
 "InvoiceRows": [
 {
  "ArticleNumber": "1",
  "DeliveredQuantity": "10",
  "HouseWork": true,
  "HouseWorkType": "CONSTRUCTION",
 }
 ],
 "TaxReductionType": "rot"
 }
}

If the field TaxReductionType in the Invoice resource is not none then the field HouseWorkType under every InvoiceRow has to be set even if HouseWork is false on the invoice row.

Example: POST /invoices
{
 "Invoice": {
 "CustomerNumber": "1",
 "InvoiceRows": [
 {
  "ArticleNumber": "1",
  "DeliveredQuantity": "10",
  "HouseWork": true,
  "HouseWorkType": "CONSTRUCTION",
 },
 {
  "ArticleNumber": "2",
  "DeliveredQuantity": "10",
  "HouseWork": false,
  "HouseWorkType": "OTHERCOSTS",
 }
 ],
 "TaxReductionType": "rot"
 }
}

Please note that you can not use more than one type of reduction on an invoice which will limit your options of HouseWorkTypes to that specific reduction type.
Example: CONSTRUCTION is ROT and CLEANING is RUT.

Information about the Invoice resource and HouseWorkTypes is linked below:

Invoices

UPDATE!
There is a new HouseWorkType added: “EMPTYHOUSEWORK”.
This is supposed to be used when the InvoiceRow amount is negative.

Houseworktype “EMPTYHOUSEWORK” can be also be used with a positive amount.
Rows with this HouseWorkType will not be included in the application to Skatteverket.

Example /invoices
{
"Invoice": {
 "CustomerNumber": "1",
 "InvoiceRows": [
 {
  "ArticleNumber": "2",
  "DeliveredQuantity": "-10",
  "HouseWork": false,
  "HouseWorkType": "EMPTYHOUSEWORK",
 },
 {
  "ArticleNumber": "1",
  "DeliveredQuantity": "10",
  "HouseWork": true,
  "HouseWorkType": "CONSTRUCTION",
 }
 ],
 "TaxReductionType": "rot"
 }
}

It is not possible to use EMPTYHOUSEWORK in combination with the following houseworktypes TRANSPORTATIONSERVICES and WASHINGANDCAREOFCLOTHING. The reason why is because these houseworktypes are calculated differently than the rest of the houseworktypes. The tax reduction on these services are based on all of the rows on the invoice.

This can only be used when the HouseWorks field on the InvoiceRow is false.