Update a numbering series
sales:invoicing-settings.writehttps://api.holded.com/api/v2/numbering-series/{type}/{numberingSeriesId}Updates an existing numbering series. Omitting `last` leaves the counter unchanged. `refund_numbering_series_id` and `verifactu_excluded` are the exception: omit them and the refund series is unlinked, and an excluded series comes back into VeriFactu scope. Read the series first and send back every field you are not changing. Changing the format does not affect previously issued document numbers — only new documents will use the updated format.
Parameters
Path parameters
stringrequiredDocument type for the numbering series
"invoice""salesreceipt""creditnote""estimate""proform""waybill""salesorder""purchase""purchaserefund""order""purchaseshipment""receiptnote""productionorder"stringrequiredNumbering series ID (24-char hex ObjectId)
Request body
Name shown for this series in the invoicing settings.
Pattern the document number is built from. Each `%` is one digit of the counter, so the group length fixes the padding. `[YYYY]` and `[YY]` expand to the year. Changing it never renumbers documents already issued.
Last number already used in this series. The next document takes `last + 1`, so a series whose last invoice was INV-2026-1234 carries `last: 1234`, not 1235.
Id of the credit note series used for refunds of documents in this series. Null when no refund series is linked.
Whether documents in this series stay outside VeriFactu reporting.
Request
import requests
url = "https://api.holded.com/api/v2/numbering-series/{type}/{numberingSeriesId}"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"name": "Factura principal",
"format": "INV-%[YYYY]-%",
"last": 0,
"refund_numbering_series_id": "string",
"verifactu_excluded": false
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())Responses
Response
{
"id": "507f1f77bcf86cd799439011",
"name": "Factura principal",
"format": "INV-%[YYYY]-%",
"last": 150,
"type": "invoice",
"refund_numbering_series_id": null,
"verifactu_excluded": false
}Success responses
200Numbering series updatedapplication/jsonUnique identifier of the numbering series
Display name of the numbering series
Numbering pattern with placeholders such as %[YYYY]% for year
Last number used in the series
Document type this series applies to
Identifier of the linked refund numbering series, if any
Whether this series is excluded from VeriFactu reporting
Error responses
400Bad requestapplication/json401Invalid or missing API keyapplication/json403Insufficient permissionsapplication/json404Numbering series not foundapplication/json422Validation errorapplication/json