Lotes de empleados y ofertas privadas de asientos
Nuevas operaciones duraderas para lotes de empleados y ofertas de asientos de empleados o empresas gestionadas dirigidas a una empresa.
5 de octubre de 2026
El contrato público añade tres familias con seis operaciones cada una: seis para lotes de empleados, seis para canjes de ofertas de asientos de empleados y seis para canjes de ofertas de asientos de empresas gestionadas. Cada familia permite listar, preparar, consultar, actualizar cotización, confirmar y cancelar.
Preparar y actualizar condiciones no compra nada. Revisa una cotización completa antes de confirmar; conserva el UUID y consulta la misma operación tras una respuesta pendiente, un tiempo de espera o autenticación. Las mutaciones exigen una Idempotency-Key; los reintentos conservan la operación original.
Los lotes admiten hasta 100 altas o reactivaciones concretas. Las ofertas son privadas para una empresa pagadora y un producto. Las ofertas de planes y la gestión por administradores siguen siendo exclusivas de la aplicación; REST y MCP solo exponen los propietarios de asientos, con scopes employees:* o companies:*. Las compras reales no están disponibles en sandbox.
La previsión de plazas de empresas gestionadas declara por qué el importe es cero: prueba, cobertura, contrato Enterprise, precio gratuito acordado o ausencia de cargo inmediato. Un motivo desconocido no implica un contrato Enterprise. Las condiciones adquiridas que no se pueden conservar devuelven 409; una previsión no disponible devuelve 503. El alta y la activación individual o múltiple conservan esos errores sin crear ni activar empresas.
Nuevos endpoints18
| Endpoint | Descripción |
|---|---|
GET/v1/employee-batches | Listar un lote de empleados |
POST/v1/employee-batches | Preparar un lote de empleados |
GET/v1/employee-batches/{id} | Consultar un lote de empleados |
POST/v1/employee-batches/{id}/quote | Recalcular la cotización de un lote de empleados |
POST/v1/employee-batches/{id}/confirm | Confirmar un lote de empleados |
POST/v1/employee-batches/{id}/cancel | Cancelar un lote de empleados |
GET/v1/employee-seat-offer-redemptions | Listar un canje de oferta de plazas de empleados |
POST/v1/employee-seat-offer-redemptions | Preparar un canje de oferta de plazas de empleados |
GET/v1/employee-seat-offer-redemptions/{id} | Consultar un canje de oferta de plazas de empleados |
POST/v1/employee-seat-offer-redemptions/{id}/quote | Recalcular la cotización de un canje de oferta de plazas de empleados |
POST/v1/employee-seat-offer-redemptions/{id}/confirm | Confirmar un canje de oferta de plazas de empleados |
POST/v1/employee-seat-offer-redemptions/{id}/cancel | Cancelar un canje de oferta de plazas de empleados |
GET/v1/gestoria-seat-offer-redemptions | Listar un canje de oferta de plazas de empresas gestionadas |
POST/v1/gestoria-seat-offer-redemptions | Preparar un canje de oferta de plazas de empresas gestionadas |
GET/v1/gestoria-seat-offer-redemptions/{id} | Consultar un canje de oferta de plazas de empresas gestionadas |
POST/v1/gestoria-seat-offer-redemptions/{id}/quote | Recalcular la cotización de un canje de oferta de plazas de empresas gestionadas |
POST/v1/gestoria-seat-offer-redemptions/{id}/confirm | Confirmar un canje de oferta de plazas de empresas gestionadas |
POST/v1/gestoria-seat-offer-redemptions/{id}/cancel | Cancelar un canje de oferta de plazas de empresas gestionadas |
Endpoints actualizados4
| Endpoint | Descripción |
|---|---|
GET/v1/companies/seat-charge-preview | Previsualiza el cargo por asiento de añadir una empresa |
POST/v1/companies | Crear una empresa gestionada |
POST/v1/companies/{company}/activate | Activar una empresa gestionada |
POST/v1/companies/activate | Activar varias empresas gestionadas |