Lots d’empleats i ofertes privades de seients
Noves operacions duradores per a lots d’empleats i ofertes de seients d’empleats o empreses gestionades dirigides a una empresa.
5 d’octubre de 2026
El contracte públic afegeix tres famílies amb sis operacions cadascuna: sis per a lots d’empleats, sis per a bescanvis d’ofertes de seients d’empleats i sis per a bescanvis d’ofertes de seients d’empreses gestionades. Cada família permet llistar, preparar, consultar, actualitzar cotització, confirmar i cancel·lar.
Preparar i actualitzar condicions no compra res. Revisa una cotització completa abans de confirmar; conserva l’UUID i consulta la mateixa operació després d’una resposta pendent, un temps d’espera o autenticació. Les mutacions exigeixen una Idempotency-Key; els reintents conserven l’operació original.
Els lots admeten fins a 100 altes o reactivacions concretes. Les ofertes són privades per a una empresa pagadora i un producte. Les ofertes de plans i la gestió per administradors continuen sent exclusives de l’aplicació; REST i MCP només exposen els propietaris de seients, amb scopes employees:* o companies:*. Les compres reals no estan disponibles en sandbox.
La previsió de places d’empreses gestionades declara per què l’import és zero: prova, cobertura, contracte Enterprise, preu gratuït acordat o absència de càrrec immediat. Un motiu desconegut no implica un contracte Enterprise. Les condicions adquirides que no es poden conservar retornen 409; una previsió no disponible retorna 503. L’alta i l’activació individual o múltiple conserven aquests errors sense crear ni activar empreses.
Nous endpoints18
| Endpoint | Descripció |
|---|---|
GET/v1/employee-batches | Llistar un lot d’empleats |
POST/v1/employee-batches | Preparar un lot d’empleats |
GET/v1/employee-batches/{id} | Consultar un lot d’empleats |
POST/v1/employee-batches/{id}/quote | Recalcular la cotització d’un lot d’empleats |
POST/v1/employee-batches/{id}/confirm | Confirmar un lot d’empleats |
POST/v1/employee-batches/{id}/cancel | Cancel·lar un lot d’empleats |
GET/v1/employee-seat-offer-redemptions | Llistar un bescanvi d’oferta de places d’empleats |
POST/v1/employee-seat-offer-redemptions | Preparar un bescanvi d’oferta de places d’empleats |
GET/v1/employee-seat-offer-redemptions/{id} | Consultar un bescanvi d’oferta de places d’empleats |
POST/v1/employee-seat-offer-redemptions/{id}/quote | Recalcular la cotització d’un bescanvi d’oferta de places d’empleats |
POST/v1/employee-seat-offer-redemptions/{id}/confirm | Confirmar un bescanvi d’oferta de places d’empleats |
POST/v1/employee-seat-offer-redemptions/{id}/cancel | Cancel·lar un bescanvi d’oferta de places d’empleats |
GET/v1/gestoria-seat-offer-redemptions | Llistar un bescanvi d’oferta de places d’empreses gestionades |
POST/v1/gestoria-seat-offer-redemptions | Preparar un bescanvi d’oferta de places d’empreses gestionades |
GET/v1/gestoria-seat-offer-redemptions/{id} | Consultar un bescanvi d’oferta de places d’empreses gestionades |
POST/v1/gestoria-seat-offer-redemptions/{id}/quote | Recalcular la cotització d’un bescanvi d’oferta de places d’empreses gestionades |
POST/v1/gestoria-seat-offer-redemptions/{id}/confirm | Confirmar un bescanvi d’oferta de places d’empreses gestionades |
POST/v1/gestoria-seat-offer-redemptions/{id}/cancel | Cancel·lar un bescanvi d’oferta de places d’empreses gestionades |
Endpoints actualitzats4
| Endpoint | Descripció |
|---|---|
GET/v1/companies/seat-charge-preview | Previsualitza el càrrec per plaça d'afegir una empresa |
POST/v1/companies | Crear una empresa gestionada |
POST/v1/companies/{company}/activate | Activar una empresa gestionada |
POST/v1/companies/activate | Activar diverses empreses gestionades |