{
  "aid": "rrhh.tramitapp.com:main-1.0.0",
  "name": "API TramitApp",
  "type": "Index",
  "description": "# Introducción\nAquí se describen los recursos que conforman el API de TramitApp. Mediante él, podrás acceder a la información\nque gestiona TramitApp de manera automática, permitiendo coordinar tus sistemas informáticos existentes con nuestra plataforma.\n\nMediante nuestro API, podrás consultar la información relativa a los trámites de tus empleados, como por ejemplo,\nlas ausencias que han tenido, sean por vacaciones, permisos, bajas médicas, o simplemente porque trabajaron desde casa.\n\nTambién podrás acceder la información relativa a los gastos, dietas y kilometrajes que te hayan pasado, así como las imputaciones de horas normales y extras\nque hayan realizado desde TramitApp para poder integrarlo directamente en tus sistemas contables de forma sencilla y evitar procesos manuales\n\nTe proporcionamos además una información detallada de la situación laboral de tus empleados, los tipos de contratos,\nlos saldos de vacaciones, y mucho más.\n\nSi lo deseas, también podrás automatizar las altas y bajas de empleados en nuestro sistema directamente desde nuestro\nAPI, evitando así duplicidades y mejorando tu eficiencia en los procesos de incorporación y salida de la compañía.\n\n# Comenzando a utilizar el API de TramitApp\nPensamos que la mejor forma de aprender a utilizar un API es experimentando un poco, por lo que vamos a darte\nunos ejemplos que te permitan conocer cómo funcionamos y te ayuden a acelerar al máximo tus desarrollos.\n\n## Hola TramitApp!\nLa mejor forma de empezar a familiarizarte con nuestro API es mediante una herramienta sencilla como\n[curl](https://github.com/curl/curl). Por supuesto, puedes otras herramientas como [PostMan](https://www.getpostman.com/)\no directamente utilizar tu lenguaje de programación favorito.\n\nVeamos un ejemplo que nos proporciona la lista de compañías a la que tu usuario tiene acceso:\n\n```curl -H 'auth: YOUR_AUTH_KEY' https://rrhh.tramitapp.com/tramitapi/companies```\n\nLa respuesta será un listado en formato JSON de las empresas parecido a este.\n```\n  [{\n    \"_id\": \"69bdb59e00aa129e8766ec0e\",\n    \"name\": \"Tu empresa\",\n    \"nationalId\": \"B16159433\",\n    \"workplaces\": [{\n      \"_id\": \"592ff42760804fd378e982ca\", \"name\": \"Oficina Central\"\n    }]\n  }]\n\n```\n\n ## Mis empleados\n Para consultar un listado de tus empleados, y en general para todas las operaciones\n excepto para el listado de compañías, nos tendrás que indicar qué empresa quieres consultar.\n\n ```curl -H 'auth: YOUR_AUTH_KEY' https://rrhh.tramitapp.com/tramitapi/{company._id}/employees```\n\nLa respuesta será un listado de los empleados de la empresa, similar al siguiente:\n```\n[{ _id: '5b7fcf3ef9ad0b3f65c4b91f',\n     companies_id: '57bdb59e00aa129e8766ec0e',\n     nationalId: '00000001R',\n     ssn: '281234567840',\n     lastName: 'Arranz',\n     lastName2: 'Perez',\n     firstName: 'Paco',\n     birthday: '1982-04-01',\n     gender: 'man',\n     nationality: 'Spanish',\n     education: null,\n     contract_type: 'temporal_contract',\n     contract_date: '2016-11-19',\n     contract_end_date: null,\n     trial_period: '12',\n     category: 'ppopo',\n     gross_salary: 18000.0,\n     email: 'test0.9794606036734297@domain.com',\n     province: '28',\n     city: 'madrid',\n     address: 'c/ bracamonte',\n     zip_code: '28051',\n     iban: 'ES6398966338433871330966' }]\n\n```\n## Nuevo empleado\n\nPara 'contratar' un empleado en TramitApp bastará con que nos hagas un POST con los datos correspondientes.\nDe nuevo, es necesario especificar el id de la empresa a la que pertenecerá el empleado.\n\n```curl -d \"@employee_example.json\" -H 'auth: YOUR_AUTH_KEY' -X POST https://rrhh.tramitapp.com/tramitapi/{company._id}/employees```\n\nLa respuesta será el empleado ya creado, similar a esta:\n```\n            {_id: '5b7fcf3ef9ad0b3f65c4b91f',\n             companies_id: '57bdb59e00aa129e8766ec0e',\n             nationalId: '00000001R',\n             ssn: '281234567840',\n             lastName: 'Arranz',\n             lastName2: 'Perez',\n             firstName: 'Paco',\n             birthday: '1982-04-01',\n             gender: 'man',\n             nationality: 'Spanish',\n             contract_type: 'temporal_contract',\n             contract_date: '2016-11-19',\n             contract_end_date: null,\n             email: 'test0.9794606036734297@domain.com',\n             iban: 'ES6398966338433871330966' }\n ```\n\n\n\n# Qué necesito para empezar a usar el API?\nComo has podido ver en los ejemplos anteriores, para poder acceder al API de TramitApp\n debes contar con una clave de API, que te proporcionará nuestro equipo de soporte.\nEsta clave lleva asociada tu configuración de seguridad y por tanto deberá viajar en las cabeceras HTTP de todas las peticiones:\n\n```\n> GET /tramitapi/companies HTTP/1.1\n> Host:  rrhh.tramitapp.com\n> Accept: */*\n> auth: YOUR_AUTH_KEY\n```\n",
  "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/rrhh.tramitapp.com/main/1.0.0/apis.json",
  "tags": [
    "rrhh.tramitapp.com",
    "main"
  ],
  "created": "2026-04-01",
  "modified": "2026-04-01",
  "specificationVersion": "0.19",
  "access": "3rd-Party",
  "maintainers": [
    {
      "FN": "Jentic",
      "X-github": "jentic",
      "url": "https://github.com/jentic"
    }
  ],
  "apis": [
    {
      "aid": "rrhh.tramitapp.com:main-1.0.0",
      "name": "API TramitApp",
      "description": "# Introducción\nAquí se describen los recursos que conforman el API de TramitApp. Mediante él, podrás acceder a la información\nque gestiona TramitApp de manera automática, permitiendo coordinar tus sistemas informáticos existentes con nuestra plataforma.\n\nMediante nuestro API, podrás consultar la información relativa a los trámites de tus empleados, como por ejemplo,\nlas ausencias que han tenido, sean por vacaciones, permisos, bajas médicas, o simplemente porque trabajaron desde casa.\n\nTambién podrás acceder la información relativa a los gastos, dietas y kilometrajes que te hayan pasado, así como las imputaciones de horas normales y extras\nque hayan realizado desde TramitApp para poder integrarlo directamente en tus sistemas contables de forma sencilla y evitar procesos manuales\n\nTe proporcionamos además una información detallada de la situación laboral de tus empleados, los tipos de contratos,\nlos saldos de vacaciones, y mucho más.\n\nSi lo deseas, también podrás automatizar las altas y bajas de empleados en nuestro sistema directamente desde nuestro\nAPI, evitando así duplicidades y mejorando tu eficiencia en los procesos de incorporación y salida de la compañía.\n\n# Comenzando a utilizar el API de TramitApp\nPensamos que la mejor forma de aprender a utilizar un API es experimentando un poco, por lo que vamos a darte\nunos ejemplos que te permitan conocer cómo funcionamos y te ayuden a acelerar al máximo tus desarrollos.\n\n## Hola TramitApp!\nLa mejor forma de empezar a familiarizarte con nuestro API es mediante una herramienta sencilla como\n[curl](https://github.com/curl/curl). Por supuesto, puedes otras herramientas como [PostMan](https://www.getpostman.com/)\no directamente utilizar tu lenguaje de programación favorito.\n\nVeamos un ejemplo que nos proporciona la lista de compañías a la que tu usuario tiene acceso:\n\n```curl -H 'auth: YOUR_AUTH_KEY' https://rrhh.tramitapp.com/tramitapi/companies```\n\nLa respuesta será un listado en formato JSON de las empresas parecido a este.\n```\n  [{\n    \"_id\": \"69bdb59e00aa129e8766ec0e\",\n    \"name\": \"Tu empresa\",\n    \"nationalId\": \"B16159433\",\n    \"workplaces\": [{\n      \"_id\": \"592ff42760804fd378e982ca\", \"name\": \"Oficina Central\"\n    }]\n  }]\n\n```\n\n ## Mis empleados\n Para consultar un listado de tus empleados, y en general para todas las operaciones\n excepto para el listado de compañías, nos tendrás que indicar qué empresa quieres consultar.\n\n ```curl -H 'auth: YOUR_AUTH_KEY' https://rrhh.tramitapp.com/tramitapi/{company._id}/employees```\n\nLa respuesta será un listado de los empleados de la empresa, similar al siguiente:\n```\n[{ _id: '5b7fcf3ef9ad0b3f65c4b91f',\n     companies_id: '57bdb59e00aa129e8766ec0e',\n     nationalId: '00000001R',\n     ssn: '281234567840',\n     lastName: 'Arranz',\n     lastName2: 'Perez',\n     firstName: 'Paco',\n     birthday: '1982-04-01',\n     gender: 'man',\n     nationality: 'Spanish',\n     education: null,\n     contract_type: 'temporal_contract',\n     contract_date: '2016-11-19',\n     contract_end_date: null,\n     trial_period: '12',\n     category: 'ppopo',\n     gross_salary: 18000.0,\n     email: 'test0.9794606036734297@domain.com',\n     province: '28',\n     city: 'madrid',\n     address: 'c/ bracamonte',\n     zip_code: '28051',\n     iban: 'ES6398966338433871330966' }]\n\n```\n## Nuevo empleado\n\nPara 'contratar' un empleado en TramitApp bastará con que nos hagas un POST con los datos correspondientes.\nDe nuevo, es necesario especificar el id de la empresa a la que pertenecerá el empleado.\n\n```curl -d \"@employee_example.json\" -H 'auth: YOUR_AUTH_KEY' -X POST https://rrhh.tramitapp.com/tramitapi/{company._id}/employees```\n\nLa respuesta será el empleado ya creado, similar a esta:\n```\n            {_id: '5b7fcf3ef9ad0b3f65c4b91f',\n             companies_id: '57bdb59e00aa129e8766ec0e',\n             nationalId: '00000001R',\n             ssn: '281234567840',\n             lastName: 'Arranz',\n             lastName2: 'Perez',\n             firstName: 'Paco',\n             birthday: '1982-04-01',\n             gender: 'man',\n             nationality: 'Spanish',\n             contract_type: 'temporal_contract',\n             contract_date: '2016-11-19',\n             contract_end_date: null,\n             email: 'test0.9794606036734297@domain.com',\n             iban: 'ES6398966338433871330966' }\n ```\n\n\n\n# Qué necesito para empezar a usar el API?\nComo has podido ver en los ejemplos anteriores, para poder acceder al API de TramitApp\n debes contar con una clave de API, que te proporcionará nuestro equipo de soporte.\nEsta clave lleva asociada tu configuración de seguridad y por tanto deberá viajar en las cabeceras HTTP de todas las peticiones:\n\n```\n> GET /tramitapi/companies HTTP/1.1\n> Host:  rrhh.tramitapp.com\n> Accept: */*\n> auth: YOUR_AUTH_KEY\n```\n",
      "image": "https://www.tramitapp.com/wp-content/uploads/2017/07/flat-icon-web-alt.png",
      "baseURL": "https://rrhh.tramitapp.com/tramitapi",
      "humanURL": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/rrhh.tramitapp.com/main/1.0.0",
      "version": "1.0.0",
      "tags": [
        "rrhh.tramitapp.com",
        "main"
      ],
      "properties": [
        {
          "type": "OpenAPI",
          "name": "OpenAPI definition",
          "url": "https://raw.githubusercontent.com/jentic/jentic-public-apis/refs/heads/main/apis/openapi/rrhh.tramitapp.com/main/1.0.0/openapi.json",
          "mediaType": "application/openapi+json"
        },
        {
          "type": "GitHubRepo",
          "url": "https://github.com/jentic/jentic-public-apis/tree/main/apis/openapi/rrhh.tramitapp.com/main/1.0.0"
        }
      ],
      "contact": [
        {
          "FN": "Equipo TramitApp",
          "email": "devs@tramitapp.com",
          "url": "https://www.tramitapp.com"
        }
      ]
    }
  ]
}