Contracted seats, offer packages and the trial

31 October 2026 — The invoice of the employee seats and of the additional tax ID seats is now the invoice of the contracted seats. Creating, activating or reactivating takes a free seat and never charges on its own; only buying seats charges. Deactivating frees a seat without lowering the bill, and a reduction takes effect at renewal, with no credit, choosing who is deactivated when you go below the occupied seats. Buying or creating what a reduction was going to remove cancels it.

Offer packages, up to three lines under one code that is redeemed from the application or by support, keep their agreed price while their minimums hold and the subscription is paid, and end as a whole, with every line back at the catalogue price, if not. No operation is removed.

Operations in this release

The operations that only adjust their schema are in the table at the bottom and in the schema section.

Contracted seats

The seats block of the status publishes contracted, occupied, free, agreed_minimum, agreed_minimum_ends_at, reducible_to, pending_reduction and enforced. reducible_to is always 0 because a reduction has no floor.

PATCH /v1/accounts/{account}/employee-seats and PATCH /v1/accounts/{account}/additional-nif-seats take {"contracted_seats": N}. A larger number buys seats with a prorated charge with the card of the account, and Idempotency-Key is required. A smaller number is a reduction. The preview takes the same parameter and shows today's amount, the quantity of the next invoice and whether it cancels a pending reduction. See employee seats and additional tax ID seats.

Buying employee seats now needs time tracking: on a plan without it, PATCH /v1/accounts/{account}/employee-seats, POST /v1/accounts/{account}/employee-seats/subscribe and POST /v1/accounts/{account}/employee-seats/change-quantity answer the new 403 employee_seats_not_in_plan before any charge, while lowering or keeping the seats stays allowed. See the error.

Automatic purchase

Without a free seat, the application answers 422 contracted_seats_exhausted and asks you to buy first. The REST API and MCP do not: creating, activating, reactivating and accepting a tax ID transfer buy the missing seats with a prorated charge and then create, with the same 402 errors as before. A retry does not charge twice and the bought seat stays. Send Idempotency-Key on every creation: without it, a retry after a creation that did go through creates another entity. See automatic purchase.

Reduction

A reduction can go down to 0 and takes effect at renewal, with no credit. It is stored as a pending_reduction and the seats stay available until then.

• Below the occupied seats. deactivate is a list of exactly occupied - contracted active entities. Otherwise the answer is 422 contracted_seats_selection_required.
• Notice and renewal. A few days before, the owner receives the names. At renewal the task deactivates the chosen ones and sets the quantity.
• It is cancelled by a purchase, or by a creation, activation, reactivation, batch or transfer that takes what the reduction was going to remove, and by a PATCH to the current quantity. A smaller PATCH replaces it.
• To 0. It requires choosing all the occupied and cancels the add-on at the end of the period. cancel is a reduction to 0 and, without deactivate, deactivates every active employee.

See reduction.

Offer packages

A package groups up to three lines (plan, employee seats and additional tax ID seats) under one code. It is redeemed from the application or by support; in REST and MCP its code answers 422 customer_offer_not_eligible with details.reason product.

• apply_to_existing applies a seat offer to the seats the account already has and creates nothing. The quote publishes target_quantity and minimum_quantity.
• Conditions. The package keeps its prices while the contracted seats of each line stay at or above its minimum and the subscription is paid. Deactivating does not break it; reducing does.
• The agreed price applies to every contracted seat, including those bought later, also by the automatic purchase.
• End. It ends as a whole, with every line at the catalogue price from the next renewal and no credit, for reduction_below_minimum, subscription_ended_unpaid, subscription_cancelled, revoked_by_support or duration_elapsed.
• Confirmation. A reduction that would break a package is previewed with offer_package_loss, and the write needs accept_offer_package_loss: true: without it, 422 offer_package_loss_unconfirmed.

See offer packages and agreed minimum.

The trial

During the trial nothing is charged and employees or tax IDs do not take seats. You can already choose the contracted seats with no charge. A seat or tax ID redemption during the trial answers 422 customer_offer_not_eligible with details.reason trial_active, instead of the previous 409 of the employee batches and of active_population. When the account starts paying, the oldest entities occupy the contracted seats and the ones that do not fit become inactive, with no charge; with no contracted seats, all of them. See the trial of employee seats and the trial rule of tax ID seats.

Errors

• customer_offer_not_eligible with reason product answers 422 where it answered 403.
• contracted_seats_selection_required: param deactivate, with details product, requested, occupied, required, selected and invalid. In cancel it is only emitted with a list that does not fit.
• offer_package_loss_unconfirmed: param accept_offer_package_loss, with details product, package_id, name, effective_at and lines.
• contracted_seats_exhausted is only emitted by the web application. The REST API and MCP buy instead.
• contracted_seats_below_minimum is retired: it was never emitted.

The three codes are subcodes of business_rule_violation. See the error reference.

Events

account.seats_updated announces every change of the contracted seats. Its pending_reduction carries the deactivations, and the cause reduction_superseded marks a reduction cancelled by a purchase or an entry. account.offer_package_ended announces the end of a package, with its reason and the concepts of its lines, without amounts. Both go to the account endpoints. See account webhooks.

Schema adjustments and what to do

Several operations only change in the published schema, with nothing different on the wire: those that used not now describe the same rule differently, and nested required fields are now documented. Nothing to do about those.

A series created without number_format now gets {code}-{YYYY}-{0000}, four digits instead of three. Existing series keep their format.

As an integrator:

1. Send Idempotency-Key on creations, activations, reactivations and transfers, which can now buy seats.
2. Accept included_in_seats in the zero_reason enum of the previews.
3. Treat already_covered as always false.
4. If you cancelled the add-on with active employees, send deactivate: without it all of them are deactivated at renewal.
5. Expect a purchase or a creation to cancel a pending reduction.
6. Confirm with accept_offer_package_loss a reduction that would break a package.

The table below lists the operations of this release.