Para desarrolladores
Conecta tu HRIS y tu ATS con Paritir
La API de integración permite que tus sistemas envíen a Paritir, de forma periódica, los datos de empleados y de ofertas de empleo. Así el análisis de la brecha retributiva trabaja con datos actuales, sin importar CSV a mano. Está pensada para quien hace la integración: una consultora, el equipo de TI del cliente o los ingenieros de Paritir.
Qué hace
Tres tareas, una API
Empleados por lotes
Envía los datos de empleados por lotes. Paritir vincula cada registro por tu ID externo, o si no por el email, actualiza lo que ha cambiado y deduce de ahí el historial salarial y de puestos. Nunca tienes que enviar el historial.
Mapea tus campos una vez
Envía unas filas de ejemplo y Paritir propone cómo encajan los campos de tu HRIS con los suyos. Una persona confirma el mapeo una vez y se guarda como perfil de origen. Las sincronizaciones siguientes lo aplican tal cual y retienen un lote si cambia la estructura de tu origen.
Entran ofertas, sale el cumplimiento
Envía las ofertas de empleo de tu ATS. Paritir revisa cada una según las normas de transparencia retributiva del país de tu sede, y puedes consultar el resultado de cada oferta.
Acceso
OAuth 2.0, limitado a una organización
Client credentials
Tu sistema intercambia un client ID y un secret por un token de acceso. Los tokens duran 15 minutos; cuando caducan, pides otro. No hay claves de API estáticas.
Una organización por credencial
Un token solo lee y escribe en la organización que emitió su credencial. La organización sale de la credencial, nunca de la petición.
Solo los scopes concedidos
Cada credencial lleva los scopes elegidos al crearla, como escribir empleados o leer ofertas. Una llamada fuera de ellos se rechaza.
Se crean y revocan en la aplicación
El Owner o un Admin de la organización crea las credenciales en Ajustes → Integraciones. El secret se muestra una sola vez y solo se guarda como hash. Revocar una credencial bloquea sus tokens al instante.
Obtén un token y envía un lote
POST https://app.paritir.com/v1/oauth/token
Content-Type: application/json
{ "grant_type": "client_credentials",
"client_id": "ptir_…", "client_secret": "…" }
→ { "access_token": "…", "token_type": "Bearer",
"expires_in": 900, "scope": "workforce:write" }POST https://app.paritir.com/v1/employees:batch
Authorization: Bearer …
Idempotency-Key: …
Content-Type: application/json
{ "employees": [
{ "external_id": "E-1042", "full_name": "…", "email": "…" }
] }
→ { "sync_run_id": "…", "inserted": 1, "updated": 0,
"unchanged": 0, "errors": 0, … }Referencia
Los endpoints activos hoy
Peticiones y respuestas van en JSON. Cada llamada queda registrada para tu organización.
URL base https://app.paritir.com/v1
| Método | Ruta | Scope | Para qué sirve |
|---|---|---|---|
| POST | /oauth/token | — | Intercambiar las client credentials por un token de acceso de 15 minutos. |
| POST | /employees:batch | workforce:write | Crear o actualizar empleados en un lote. |
| POST | /employees:map-preview | workforce:write | Proponer un mapeo de campos a partir de filas de ejemplo. No escribe nada. |
| POST | /postings:batch | postings:write | Crear o actualizar ofertas de empleo en un lote. |
| GET | /postings | postings:read | Listar las ofertas con su resultado de cumplimiento, las más recientes primero. |
| GET | /postings/{posting_reference} | postings:read | Leer una oferta por tu propia referencia. |
Reenvío sin riesgo
Envía una cabecera Idempotency-Key con cada lote. La misma clave devuelve el primer resultado sin volver a escribir; si el proceso sigue en curso, la respuesta es HTTP 409.
Paginación y filtros
La lista de ofertas se pagina con limit y un cursor opaco, y se filtra por status y por updated_since.
Errores y límites
Los errores llegan en JSON con un mensaje. La validación nombra los campos con problemas y nunca repite los valores enviados. Las llamadas tienen un límite por organización; si se supera, la respuesta es HTTP 429.
Estado
Lo que la API aún no hace
La API lleva datos hacia dentro y ofertas de empleo hacia fuera. Los resultados de brecha retributiva, los informes y las evaluaciones retributivas conjuntas siguen, por ahora, en la aplicación. Todavía no hay webhooks ni entorno sandbox, así que una integración nueva se configura sobre una organización real, con nuestra ayuda.
El acceso a la API viene con una cuenta
Paritir funciona solo por invitación mientras trabajamos con nuestros primeros clientes y consultoras. Cuando tu organización esté configurada, su Owner o un Admin puede crear credenciales de API.