Troubleshooting
Common problems
The issues integrators run into most often, and how to fix them.
Amounts come out 100 times too small
You’re sending major units. "1250" is €12.50, not €1,250. Convert to minor
units before sending. See Amounts and currency.
401 with a key that looks right
Check the key matches the base URL. neno_api_test_ keys only work against
api.neno.build, and neno_api_live_ keys only against api.neno.co.
Requests with X-Workspace-Id fail
The public API works out the workspace from the key. Remove the header.
invoiceNumber is null
The invoice is still a draft. It gets a number when it’s finalized or sent.
Converting a quote returns 409
Only accepted quotes can be converted. Record the customer’s decision with
POST /quotes/{id}/status first.
A new status broke the integration
Status lists can grow. Add a default case that treats unknown values as in progress, and log them so you can handle them properly later.
429 Too many requests
You’ve reached the rate limit. Wait for the number of seconds in
Retry-After before trying again, and run bulk jobs one request at a time
instead of in parallel.