Factuarea APIDevelopers
Contract

Employee seats charged whenever the plan bills

Creating or reactivating an employee charges a seat whenever the plan bills, including past_due and granted plans; trial employees are deactivated when billing starts, a new 503 applies when batches are enabled, and seat offers on an active subscription start at the next renewal. Eight updated operations.

8 October 2026 — Employee seats are now charged on every plan that bills, and seat offers redeemed on an active subscription start at the next renewal. Read Employee seat billing for the whole model.

  • A seat whenever the plan bills — each creation or reactivation that is not already covered charges a seat on a paid plan subscription, also when it is past_due, and on an Esencial, Profesional or Avanzado plan granted by Factuarea without an open subscription. See When a seat is charged.
  • Closed exemptions — only Enterprise and managed companies (billed by contract), an active trial and sandbox never charge a seat.
  • No prior opt-in — without an employee-seats subscription, the first creation or reactivation creates it and bills only the new employees; employees already active start being billed at the next renewal. See The first seat and employees already active.
  • Payment errors — without a payment method the request returns 402 employee_seat_payment_method_required (with error.details.payment_setup_url), and a declined charge returns 402 employee_seat_charge_failed. Nobody is created or reactivated in either case.
  • Trial employees — employees are added at no charge during the trial. When the company starts paying, the employees created during the trial become inactive without any automatic charge, and reactivating each one charges its seat. See Employees created during the trial.
  • New 503 when batches are enabled — if employee batches are enabled for the account, creating or reactivating an employee can return 503 employee_batch_quote_unavailable; nobody was created or charged, so retry the same request. Without batches, the synchronous per-employee charge applies. See Availability.
  • Seat offers on an active subscription — a recurring benefit (a repeating or forever discount, or a negotiated price) redeemed on an active employee-seat or managed-company-seat subscription starts at the next renewal: the quote returns benefit_starts_at equal to next_bill_at, today only the new seats are charged at the current conditions, the current period is not credited and no customer balance is created. See Private billing offers.

Updated operations

No operation, field or scope is added.

OperationEndpointChange
Create an employeePOST /v1/employeesSeat charged whenever the plan bills; new 503 when batches are enabled.
Reactivate an employeePOST /v1/employees/{employee}/reactivateSeat charged whenever the plan bills; new 503 when batches are enabled.
Prepare an employee-seat offer redemptionPOST /v1/employee-seat-offer-redemptionsbenefit_starts_at on an active subscription.
Refresh the quote for an employee-seat offer redemptionPOST /v1/employee-seat-offer-redemptions/{id}/quotebenefit_starts_at on an active subscription.
Confirm an employee-seat offer redemptionPOST /v1/employee-seat-offer-redemptions/{id}/confirmBenefit written from the next renewal.
Prepare a managed-company-seat offer redemptionPOST /v1/gestoria-seat-offer-redemptionsbenefit_starts_at on an active subscription.
Refresh the quote for a managed-company-seat offer redemptionPOST /v1/gestoria-seat-offer-redemptions/{id}/quotebenefit_starts_at on an active subscription.
Confirm a managed-company-seat offer redemptionPOST /v1/gestoria-seat-offer-redemptions/{id}/confirmBenefit written from the next renewal.

An integration that already handles 402 on these operations only needs to add the 503 retry for accounts with employee batches enabled.

On this page

Need a hand?Contact support