Create a number series
Creates a numbering series for the environment the API key belongs to. The prefix is normalized server-side (whitespace removed, letters uppercased) and must be unique in the environment. A series is immutable once created: to change how invoices are numbered, create a new series and issue on it instead.
Autorizaciones
API key sent as a bearer token in the Authorization header.
Encabezados
Optional key that makes the request safe to retry: 1 to 255 printable ASCII characters. Sending the same key with the same body within 24 hours returns the stored response instead of executing again; such a replay carries an Idempotent-Replayed: true header. Reusing a key with a different body is rejected.
Cuerpo
The number series to create.
The number series to create.
Prefix stamped on every invoice number of the series. Normalized server-side: whitespace is removed and letters are uppercased. After normalization it must be 1-20 characters using only A-Z letters (no accents or "Ñ"), digits, "_", "/", "." or "-", and must be unique in the environment.
"F"
The number the first invoice on this series takes. Defaults to 1.
x >= 11
Zero-padding width of the numeric part of the invoice number (0-12). Defaults to 0, meaning no padding.
0 <= x <= 125
What the series numbers: regular invoices (standard) or rectifying invoices (rectifying). Defaults to standard.
standard, rectifying "standard"
Respuesta
The created number series.
An invoice numbering series as exposed by the public API. Invoice numbers are always assigned by the server: prefix plus a gapless, zero-padded counter. A series is immutable once created.
Opaque, prefixed number series identifier.
"ns_clx123abc456"
Prefix stamped on every invoice number of this series, stored normalized: whitespace removed and letters uppercased.
"F"
What the series numbers: regular invoices (standard) or rectifying invoices (rectifying). This is an extensible enum: new values may be added in the future, so clients must tolerate values not listed here. Known values: standard, rectifying.
"standard"
The number assigned to the first invoice on this series.
1
The number the next invoice on this series will take.
42
Zero-padding width of the numeric part of the invoice number. 0 means no padding.
5
Whether this is the default series of the environment. Read-only: only the series seeded with the environment can be the default.
false
Creation timestamp, RFC 3339 in UTC.
"2026-06-01T09:30:00Z"