Saltar al contingut principal
GET

Llistar sèries de numeració per tipus de document

Scope:sales:invoicing-settings.read
https://api.holded.com/api/v2/numbering-series/{type}

Retorna la llista de totes les sèries de numeració configurades en el teu compte per al tipus de document especificat.

Paràmetres

Paràmetres de ruta

typestringobligatori

Tipus de recurs

"invoice""salesreceipt""creditnote""estimate""proform""waybill""salesorder""purchase""purchaserefund""order""purchaseshipment""receiptnote""productionorder"

Petició

python
import requests

url = "https://api.holded.com/api/v2/numbering-series/{type}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Respostes

Resposta

json
{
  "items": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Factura principal",
      "format": "INV-%[YYYY]-%",
      "last": 150,
      "type": "invoice",
      "refund_numbering_series_id": null,
      "verifactu_excluded": false
    }
  ]
}

Respostes exitoses

200Llistat de sèries de numeracióapplication/json
object
items[]object[]
idstring

Unique identifier of the numbering series

namestring

Display name of the numbering series

formatstring

Numbering pattern with placeholders such as %[YYYY]% for year

lastinteger

Last number used in the series

typestring

Document type this series applies to

refund_numbering_series_idstring | null

Identifier of the linked refund numbering series, if any

verifactu_excludedboolean

Whether this series is excluded from VeriFactu reporting

Respostes d'error

400Sol·licitud incorrectaapplication/json
401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json