Can't create a bill with api

[seabusch]

Hello,
I couldn't find a post with a similar issue. So I think i create one here.

I try to create bills with a csv file and wasn't able to create even one.

I installed OCS API Viewer who shows you the cospend 0.0.1 OAS 3.0 API

For a bill creation it displays the following:
rewuest body:
{
"date": null,
"what": null,
"payer": null,
"payedFor": null,
"amount": null,
"repeat": null,
"paymentMode": null,
"paymentModeId": null,
"categoryId": null,
"repeatAllActive": 0,
"repeatUntil": null,
"timestamp": null,
"comment": null,
"repeatFreq": null
}

I tired to fill it several times and always get a 400 error. I was never able to solve it. after using chatgpt and gemini i'm guessing the api description is somewhere wrong?

if someone can check and let me know if this because i make a mistake or is the api still working. I would be glad if there could be an example of bill creating that works. i will know how to tranfer to my needs.

thans a lot

[OvOwl]

First - thanks for the awesome project!

I have to agree with @seabusch . The OCS API Viewer, even with default null values answers with 400. And even with dummy values*, I always get the 400 / bad request error.

Additionally the response is always empty and does not point to any specific error

{
  "ocs": {
    "meta": {
      "status": "failure",
      "statuscode": 400,
      "message": ""
    },
    "data": []
  }
}

*dummy values

{
  "date": "22.10.2025",
  "what": "Test",
  "payer": 2,
  "payedFor": "1:1,2:1",
  "amount": 38,
  "repeat": "",
  "paymentMode": "",
  "paymentModeId": 1,
  "categoryId": 1,
  "repeatAllActive": 0,
  "repeatUntil": "",
  "timestamp": 1761723660000,
  "comment": "Test",
  "repeatFreq": 0
} 

I'm not sure if the environment is causing problems, but then theoretically the OCS Viewer should work?
The environment is docker (on ubuntu) with traefik as reverse proxy and the trusted domain value is set in the config. So not shure where to look at. Unfortunately, the dev documentation also doesn't help public-api .

Any advice on where I could look would be very welcome.

[adrien-n]

I've used the documentation from #205 as a basis.

For bills, I'm getting away with only setting date, what, payer, payed_for, amount (and comment). I don't know if it's minimal or not (probably not).

My dates are formatted as YYYY-MM-DD rather than dot-separated. I use payed_for and not payedFor and I have simpler rules. All of payer, payed_for and amount are strings in the JSON for the request.

I can't guarantee everything is correct but it works well in practice.