https://<company_dns>.kassa.at/api/v1/

Authorization: <api_token>
Content-Type: application/json

{
  "status": 400,
  "error_code": 1000,
  "error": "Parametervalidation failed!",
  "details": [
    {
      "error_code": 1003,
      "error": "Parameter is not set!",
      "error_message": "Parameter 'username' is not set!"
    },
    {
      "error_code": 1004,
      "error": "Parameter is not set!",
      "error_message": "Parameter 'password' is not set!"
    }
  ]
}

{
  "status": 401,
  "error_code": 2009,
  "error": "Unauthorized!",
  "details": [
    {
      "error_code": 2003,
      "error": "Unauthorized!",
      "error_message": "No token given!"
    }
  ]
}

{
  "status": 401,
  "error_code": 2009,
  "error": "Unauthorized!",
  "details": [
    {
      "error_code": 2004,
      "error": "Unauthorized!",
      "error_message": "Token is invalid!"
    }
  ]
}

{
  "status": 401,
  "error_code": 2001,
  "error": "Company missing!",
  "details": [
    {
      "error_code": 2001,
      "error": "Company missing!",
      "error_message": "No company in subdomain!"
    }
  ]
}

curl -X POST https://api.kassa.at/api/v1/authentications/ \
  -H 'Content-Type: application/json' \
  -d '{"company_dns":"meinefirma","username":"admin","password":"meinpasswort","description":"System XY"}'

{"status":200,"data":[{"token":"224ac7a5-d4cc8055a2fe479b","description":"System XY","company":"meinefirma"}]}

curl -X GET https://api.kassa.at/api/v1/authentications/authenticate \
  -H 'authorization: <api_token>'

{
  "status": 200,
  "data": [
    {
      "token": "224ac7a5-d4cc8055a2fe479b",
      "description": "System XY",
      "company": "meinefirma"
    }
  ]
}

curl -X POST https://api.kassa.at/api/v1/companies/ \
  -H 'Content-Type: application/json' \
  -d '{"company":"Meine Firma GmbH","company_dns":"meinefirma","username":"admin","password":"meinpasswort","email":"admin@meinefirma.at"}'

{
  "status": 200,
  "data": [
    {
      "company_dns": "meinefirma",
      "company": "Meine Firma GmbH"
    }
  ]
}

curl -X GET 'https://api.kassa.at/api/v1/companies/determine_dns_name?company=Meine+Firma+GmbH'

{
  "status": 200,
  "data": [
    {
      "company_dns": "meinefirmagmbh"
    }
  ]
}

{
  "status": 200,
  "data": [
    {
      "id": 1,
      "line_item_name": "Testartikel",
      "article_number": "ART001",
      "gross_amount_per_item": "9.99",
      "sales_tax_percentage": "20.0",
      "default_quantity": "1.0",
      "unit": "Stk",
      "bar_code": null,
      "bar_code_2": null,
      "favourite": false,
      "food": false,
      "drink": false
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 20
  }
}

{
  "status": 201,
  "data": [
    {
      "id": 42,
      "line_item_name": "Testartikel",
      "article_number": "ART001",
      "gross_amount_per_item": "9.99",
      "sales_tax_percentage": "20.0",
      "default_quantity": "1.0",
      "unit": "Stk"
    }
  ]
}

{"status": 200, "data": []}

{
  "status": 200,
  "data": [
    {
      "id": 42,
      "line_item_name": "Testartikel (aktualisiert)",
      "gross_amount_per_item": "12.99",
      "sales_tax_percentage": "20.0",
      "default_quantity": "1.0"
    }
  ]
}

{
  "status": 200,
  "data": [
    {
      "id": 3,
      "name": "Getränke",
      "color": "#29ABE2"
    }
  ]
}

{
  "status": 200,
  "data": [
    {
      "id": 7,
      "customer_number": "K-0001",
      "company_name": "Musterfirma GmbH",
      "first_name": "Max",
      "last_name": "Mustermann",
      "address": "Musterstraße 1",
      "city": "Wien",
      "zip": "1010",
      "country": "Österreich",
      "phone_number": "+43 1 234567",
      "email": "max@musterfirma.at",
      "deleted": false
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 20
  }
}

{
  "status": 201,
  "data": [
    {
      "id": 7,
      "customer_number": "K-0001",
      "first_name": "Max",
      "last_name": "Mustermann",
      "email": "max@musterfirma.at"
    }
  ]
}

{"status": 200, "data": []}

{"status": 200, "data": []}

{
  "status": 200,
  "data": [
    {
      "id": 7,
      "customer_number": "K-0001",
      "first_name": "Max",
      "last_name": "Mustermann"
    }
  ]
}

{
  "status": 200,
  "data": [
    {
      "address": "Musterstraße 1",
      "city": "Wien",
      "zip": "1010",
      "country": "Österreich"
    }
  ]
}

{
  "status": 200,
  "data": [
    {
      "company_name": "Musterfirma GmbH",
      "first_name": "Max",
      "last_name": "Mustermann",
      "phone_number": "+43 1 234567",
      "email": "max@musterfirma.at",
      "fax_number": null
    }
  ]
}

{
  "status": 200,
  "data": [
    {
      "id": 101,
      "invoiceno": "RE-2024-001",
      "date": "25.06.2024",
      "total": "49.90",
      "payment_method": "cash"
    }
  ],
  "pagination": {
    "total": 1,
    "page": 1,
    "limit": 20
  }
}

{
  "status": 200,
  "data": [
    {
      "id": 1,
      "description": "Standard Lager",
      "deleted": false
    },
    {
      "id": 2,
      "description": "Außenlager",
      "deleted": false
    }
  ]
}

{
  "status": 200,
  "data": [
    {
      "id": 15,
      "article": {
        "id": 2,
        "line_item_name": "Testartikel",
        "article_number": "ART001"
      },
      "warehouse": {
        "id": 1,
        "description": "Standard Lager"
      },
      "active": true,
      "warning_at": 5,
      "stock": "13.42"
    }
  ]
}

curl -X POST https://<company_dns>.kassa.at/api/v1/warehouses/1/inventories/search \
  -H 'Content-Type: application/json' \
  -H 'authorization: <api_token>' \
  -d '{"article_numbers": ["ART001","ART002","ART003"], "inspect_stock": true}'

{
  "status": 200,
  "data": [
    {
      "stock": "13.42"
    }
  ]
}

curl -X POST https://<company_dns>.kassa.at/api/v1/warehouses/1/inventories/15/stock \
  -H 'Content-Type: application/json' \
  -H 'authorization: <api_token>' \
  -d '{"quantity": 13.42, "text": "Lagerstandsprüfung: Mai"}'

{
  "status": 200,
  "data": [
    {
      "inventory": {
        "id": 15,
        "article": {
          "id": 2,
          "line_item_name": "Dies ist ein Testartikel",
          "article_number": null
        },
        "warehouse": {
          "id": 1,
          "description": "Standard Lager"
        },
        "warning_at": 5,
        "created_at": {"format": "DD.MM.YYYY hh:mm:ss", "localized": "05.07.2018 11:25"},
        "updated_at": {"format": "DD.MM.YYYY hh:mm:ss", "localized": "05.07.2018 11:25"}
      },
      "old_stock": "-4.0",
      "new_stock": "13.42"
    }
  ]
}

{
  "status": 400,
  "error_code": 3000,
  "error": "Object not found!",
  "details": [
    {
      "error_code": 3008,
      "error": "Object not found!",
      "error_message": "No warehouse found with given parameter!"
    }
  ]
}

curl -X POST https://<company_dns>.kassa.at/api/v1/warehouses/1/inventories/15/movements \
  -H 'Content-Type: application/json' \
  -H 'authorization: <api_token>' \
  -d '{"quantity": -2, "text": "Ich hatte hunger"}'

{
  "status": 201,
  "data": [
    {
      "id": 3010,
      "inventory": {
        "id": 15,
        "article": {
          "id": 2,
          "line_item_name": "Dies ist ein Testartikel"
        },
        "warehouse": {
          "id": 1,
          "description": "Standard Lager"
        },
        "old_stock": "13.42",
        "new_stock": "11.42"
      },
      "quantity": "-2.0",
      "description": "Ich hatte hunger",
      "created_at": {"format": "DD.MM.YYYY hh:mm:ss", "localized": "11.01.2021 11:49"},
      "updated_at": {"format": "DD.MM.YYYY hh:mm:ss", "localized": "11.01.2021 11:49"}
    }
  ]
}

{
  "status": 400,
  "error_code": 3000,
  "error": "Object not found!",
  "details": [
    {
      "error_code": 3008,
      "error": "Object not found!",
      "error_message": "No warehouse found with given parameter!"
    }
  ]
}

curl -X POST https://<company_dns>.kassa.at/api/v1/manual_receipts \
  -H 'Content-Type: application/json' \
  -H 'authorization: <api_token>' \
  -d '{"invoiceno":"RE-2024-001","date":"25.06.2024","price":"49.90","tax":0,"payment_method":"cash","file_return":"no-file"}'

curl -X POST https://<company_dns>.kassa.at/api/v1/manual_receipts \
  -H 'Content-Type: application/json' \
  -H 'authorization: <api_token>' \
  -d '{"invoiceno":"RE-2024-001","date":"25.06.2024","price":"49.90","tax":0,"payment_method":"cash"}' \
  --output beleg.pdf