---
title: "Propose the first document number for a supervision batch"
method: GET
path: "/api/operator-payments/supervision-invoice/next-document-number"
tags: ["operator-payments"]
---

# Propose the first document number for a supervision batch

`GET /api/operator-payments/supervision-invoice/next-document-number`

Highest number already used in the series, plus one. Sales invoices and credit notes share the series and the portal does not refuse a duplicate, so the credit notes are read from Zucchetti; if that read fails no number is proposed.

## Query parameters

- `series` string, required — Sezionale, e.g. 'P'
- `year` integer, required — Competence year of the batch

## Response `200`

Successful Response

- SupervisionNextDocumentNumberResponse — Proposed first document number for a supervision batch, and where it came from. Sales invoices and credit notes share one number series per sezionale.
  - `series` string, required
  - `year` integer, required
  - `next_document_number` integer, nullable
  - `last_invoice_number` integer, nullable — Highest number issued by us for this series/year (local table)
  - `last_credit_note_number` integer, nullable — Highest credit-note number in the portal for this series/year
  - `credit_notes_checked` boolean — False when the portal lookup failed; no number is proposed
  - `detail` string, nullable — Why no number is proposed, when that happens

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/d6ed0fec5d4f/schema)