{ "variable": [ { "id": "baseUrl", "key": "baseUrl", "type": "string", "name": "string", "value": "https:\/\/apicompanies.intratime.es" } ], "info": { "name": "Intratime Company Apps API", "_postman_id": "87b5d43d-a816-4a19-8256-fab54812fcec", "description": "Public API reference for the Intratime Company Apps V2 integration.", "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json" }, "item": [ { "name": "Clients", "description": "", "item": [ { "name": "List all clients.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/client", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/client" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns all clients belonging to the authenticated company as a JSON array." }, "response": [ { "header": [], "code": 200, "body": "[\n {\n \"CLIENT_ID\": 10,\n \"CLIENT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"CLIENT_NAME\": \"Beta Solutions Ltd.\",\n \"CLIENT_COUNTRY\": \"ES\",\n \"CLIENT_REGION\": \"Catalonia\",\n \"CLIENT_CITY\": \"Barcelona\",\n \"CLIENT_ADDRESS\": \"Passeig de Gracia 100\",\n \"CLIENT_CP\": \"08008\",\n \"CLIENT_COORDINATES\": \"41.396041,2.161047\",\n \"CID_OLD\": null\n },\n {\n \"CLIENT_ID\": 11,\n \"CLIENT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"CLIENT_NAME\": \"Gamma Industries S.A.\",\n \"CLIENT_COUNTRY\": \"ES\",\n \"CLIENT_REGION\": \"Valencia\",\n \"CLIENT_CITY\": \"Valencia\",\n \"CLIENT_ADDRESS\": \"Avinguda del Regne de Valencia 25\",\n \"CLIENT_CP\": \"46005\",\n \"CLIENT_COORDINATES\": \"39.469903,-0.376288\",\n \"CID_OLD\": null\n }\n]\n", "name": "" } ] }, { "name": "Create a new client.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/client", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/client" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Delta Corp\",\"country\":\"ES\",\"region\":\"Andalusia\",\"city\":\"Seville\",\"address\":\"Calle Sierpes 5\",\"cp\":\"41004\",\"coordinates\":\"37.388050,-5.982409\"}" }, "description": "All address fields are required. Returns the created client on success." }, "response": [ { "header": [], "code": 201, "body": "{\n \"CLIENT_ID\": 12,\n \"CLIENT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"CLIENT_NAME\": \"Delta Corp\",\n \"CLIENT_COUNTRY\": \"ES\",\n \"CLIENT_REGION\": \"Andalusia\",\n \"CLIENT_CITY\": \"Seville\",\n \"CLIENT_ADDRESS\": \"Calle Sierpes 5\",\n \"CLIENT_CP\": \"41004\",\n \"CLIENT_COORDINATES\": \"37.388050,-5.982409\",\n \"CID_OLD\": null\n}\n", "name": "" } ] }, { "name": "Get a single client.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/client\/:CLIENT_ID", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/client\/:CLIENT_ID", "variable": [ { "id": "CLIENT_ID", "key": "CLIENT_ID", "value": 16, "description": "" }, { "id": "client", "key": "client", "value": 10, "description": "The client's ID." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\n \"CLIENT_ID\": 10,\n \"CLIENT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"CLIENT_NAME\": \"Beta Solutions Ltd.\",\n \"CLIENT_COUNTRY\": \"ES\",\n \"CLIENT_REGION\": \"Catalonia\",\n \"CLIENT_CITY\": \"Barcelona\",\n \"CLIENT_ADDRESS\": \"Passeig de Gracia 100\",\n \"CLIENT_CP\": \"08008\",\n \"CLIENT_COORDINATES\": \"41.396041,2.161047\",\n \"CID_OLD\": null,\n \"company\": null\n}\n", "name": "" } ] }, { "name": "Update a client.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/client\/:CLIENT_ID", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/client\/:CLIENT_ID", "variable": [ { "id": "CLIENT_ID", "key": "CLIENT_ID", "value": 16, "description": "" }, { "id": "client", "key": "client", "value": 10, "description": "The client's ID." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Beta Solutions Ltd. (Updated)\",\"country\":\"ES\",\"region\":\"Catalonia\",\"city\":\"Barcelona\",\"address\":\"Passeig de Gracia 200\",\"cp\":\"08008\",\"coordinates\":\"41.396041,2.161047\"}" }, "description": "All address fields are required. Returns the updated client on success." }, "response": [ { "header": [], "code": 200, "body": "{\n \"CLIENT_ID\": 10,\n \"CLIENT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"CLIENT_NAME\": \"Beta Solutions Ltd. (Updated)\",\n \"CLIENT_COUNTRY\": \"ES\",\n \"CLIENT_REGION\": \"Catalonia\",\n \"CLIENT_CITY\": \"Barcelona\",\n \"CLIENT_ADDRESS\": \"Passeig de Gracia 200\",\n \"CLIENT_CP\": \"08008\",\n \"CLIENT_COORDINATES\": \"41.396041,2.161047\",\n \"CID_OLD\": null\n}\n", "name": "" } ] }, { "name": "Delete a client.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/client\/:client_CLIENT_ID", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/client\/:client_CLIENT_ID", "variable": [ { "id": "client_CLIENT_ID", "key": "client_CLIENT_ID", "value": 16, "description": "" }, { "id": "client", "key": "client", "value": 10, "description": "The client's ID." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Soft-deletes the client record. Returns an empty 204 response on success." }, "response": [ { "header": [], "code": 204, "body": "", "name": "Client deleted" } ] } ] }, { "name": "Clocking Requests", "description": "", "item": [ { "name": "List clocking requests for an employee.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user\/:employee_USER_ID\/clocking_requests", "query": [ { "key": "year", "value": "2024", "description": "optional 4-digit year filter for `CLOCKING_REQUESTS_DT_START`. Defaults to the current year.", "disabled": false } ], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user\/:employee_USER_ID\/clocking_requests?year=2024", "variable": [ { "id": "employee_USER_ID", "key": "employee_USER_ID", "value": 16, "description": "" }, { "id": "employee", "key": "employee", "value": 101, "description": "The employee's ID." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"year\":\"9775\"}" }, "description": "Returns a `{\"clocking_requests\": [...]}` wrapper containing all time-correction\nrequests for the specified employee within the given year (defaults to the\ncurrent year when omitted).\n\nThe route-bound `{employee}` is company-fenced by model binding \u2014 a cross-tenant\nemployee resolves to 404 before this action runs." }, "response": [ { "header": [], "code": 200, "body": "{\n \"clocking_requests\": [\n {\n \"CLOCKING_REQUESTS_ID\": 55,\n \"CLOCKING_REQUESTS_USER_ID\": 101,\n \"CLOCKING_REQUESTS_TYPE\": 1,\n \"CLOCKING_REQUESTS_STATUS\": 0,\n \"CLOCKING_REQUESTS_DT_START\": \"2024-03-10 09:00:00\",\n \"CLOCKING_REQUESTS_DT_END\": \"2024-03-10 10:00:00\",\n \"CLOCKING_REQUESTS_COMMENTS\": \"Forgot to clock in\",\n \"CLOCKING_REQUESTS_TARGET_CLOCKING_ID\": null,\n \"CLOCKING_REQUESTS_AMEND_PROJECT_ID\": null,\n \"CLOCKING_REQUESTS_COMPANY_ID\": 42\n },\n {\n \"CLOCKING_REQUESTS_ID\": 56,\n \"CLOCKING_REQUESTS_USER_ID\": 101,\n \"CLOCKING_REQUESTS_TYPE\": 2,\n \"CLOCKING_REQUESTS_STATUS\": 1,\n \"CLOCKING_REQUESTS_DT_START\": \"2024-03-12 14:00:00\",\n \"CLOCKING_REQUESTS_DT_END\": \"2024-03-12 14:30:00\",\n \"CLOCKING_REQUESTS_COMMENTS\": \"Time correction\",\n \"CLOCKING_REQUESTS_TARGET_CLOCKING_ID\": 8840,\n \"CLOCKING_REQUESTS_AMEND_PROJECT_ID\": null,\n \"CLOCKING_REQUESTS_COMPANY_ID\": 42\n }\n ]\n}\n", "name": "" } ] } ] }, { "name": "Clockings", "description": "", "item": [ { "name": "Record a new clocking.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user\/:employee_USER_ID\/clocking", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user\/:employee_USER_ID\/clocking", "variable": [ { "id": "employee_USER_ID", "key": "employee_USER_ID", "value": 16, "description": "" }, { "id": "employee", "key": "employee", "value": 101, "description": "The employee's ID." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart\/form-data" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "formdata", "formdata": [ { "key": "user_action", "value": "0", "type": "text", "description": "Clocking type: `0` = Check-in, `1` = Check-out, `2` = Break start, `3` = Break end." }, { "key": "user_timestamp", "value": "2024-03-15 09:02:45", "type": "text", "description": "Clocking datetime in `Y-m-d H:i:s` format (device local time unless `user_use_server_time` is `true`)." }, { "key": "user_gps_coordinates", "value": "40.416775,-3.703790", "type": "text", "description": "optional Latitude and longitude pair separated by a comma." }, { "key": "user_project", "value": "7", "type": "text", "description": "optional The project ID to associate with this clocking (must belong to the authenticated company)." }, { "key": "user_expense", "value": "2", "type": "text", "description": "optional The expense-type ID to associate with this clocking (must belong to the authenticated company)." }, { "key": "inout_device_uid", "value": "device-uuid-abc123", "type": "text", "description": "optional Unique identifier of the originating device." }, { "key": "user_use_server_time", "value": "", "type": "text", "description": "optional When `true`, the server's current time is used instead of `user_timestamp`." }, { "key": "expense_amount", "value": "15.5", "type": "text", "description": "optional Monetary amount for the associated expense type." }, { "key": "user_file", "src": [], "type": "file" } ] }, "description": "Creates a clocking event for the specified employee. The response is a\n**flat** `INOUT_*` object \u2014 NOT the legacy `{\"success\":true,\"clocking\":{...}}` wrapper.\nIf the optional `user_file` image is included, send the request as\n`multipart\/form-data`." }, "response": [ { "header": [], "code": 201, "body": "{\n \"INOUT_ID\": 8841,\n \"INOUT_USER_ID\": 101,\n \"INOUT_TYPE\": 0,\n \"INOUT_DATE\": \"2024-03-15 09:02:47\",\n \"INOUT_END_DATE\": null,\n \"INOUT_PROJECT_ID\": 7,\n \"INOUT_COMMENTS\": null,\n \"INOUT_COORDINATES\": \"40.416775,-3.703790\",\n \"INOUT_SOURCE\": 2,\n \"INOUT_DEVICE_UID\": \"device-uuid-abc123\",\n \"INOUT_DEVICE_DATE\": \"2024-03-15 09:02:45\",\n \"INOUT_USE_SERVER_TIME\": false,\n \"INOUT_TELECOMMUTING\": false\n}\n", "name": "" } ] }, { "name": "List clockings for an employee.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user\/:employee_USER_ID\/clockings", "query": [ { "key": "last", "value": "1", "description": "optional When `true`, results are ordered most-recent first; default is oldest first.", "disabled": false }, { "key": "maxResult", "value": "50", "description": "optional Maximum number of records to return (server cap always applies).", "disabled": false }, { "key": "from", "value": "2024-03-01 00:00:00", "description": "optional Filter by start datetime (`Y-m-d H:i:s`).", "disabled": false }, { "key": "to", "value": "2024-03-31 23:59:59", "description": "optional Filter by end datetime (`Y-m-d H:i:s`); must be \u2265 `from`.", "disabled": false }, { "key": "type", "value": "0,1", "description": "optional Comma-separated clocking type filter. Allowed values: `0`, `1`, `2`, `3`.", "disabled": false } ], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user\/:employee_USER_ID\/clockings?last=1&maxResult=50&from=2024-03-01%2000%3A00%3A00&to=2024-03-31%2023%3A59%3A59&type=0%2C1", "variable": [ { "id": "employee_USER_ID", "key": "employee_USER_ID", "value": 16, "description": "" }, { "id": "employee", "key": "employee", "value": 101, "description": "The employee's ID." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"last\":\"1\",\"maxResult\":16,\"from\":\"2026-07-16 16:42:12\",\"to\":\"2052-08-08\",\"type\":\"1,3,1,2,2,3,2\"}" }, "description": "Returns a flat JSON array of clocking records for the specified employee.\nA hard server-side cap (`LoginLogout::COMPANY_APPS_MAX_RESULTS`) is always\napplied \u2014 `maxResult` may further restrict but cannot exceed the cap.\n\nClocking types map to: `0` = Check-in, `1` = Check-out, `2` = Break start, `3` = Break end." }, "response": [ { "header": [], "code": 200, "body": "[\n {\n \"INOUT_ID\": 8840,\n \"INOUT_USER_ID\": 101,\n \"INOUT_TYPE\": 0,\n \"INOUT_DATE\": \"2024-03-14 08:58:10\",\n \"INOUT_END_DATE\": null,\n \"INOUT_PROJECT_ID\": null,\n \"INOUT_COMMENTS\": null,\n \"INOUT_COORDINATES\": null,\n \"INOUT_SOURCE\": 2,\n \"INOUT_DEVICE_UID\": null,\n \"INOUT_DEVICE_DATE\": \"2024-03-14 08:58:10\",\n \"INOUT_USE_SERVER_TIME\": true,\n \"INOUT_TELECOMMUTING\": false\n },\n {\n \"INOUT_ID\": 8841,\n \"INOUT_USER_ID\": 101,\n \"INOUT_TYPE\": 1,\n \"INOUT_DATE\": \"2024-03-14 17:03:22\",\n \"INOUT_END_DATE\": null,\n \"INOUT_PROJECT_ID\": null,\n \"INOUT_COMMENTS\": null,\n \"INOUT_COORDINATES\": null,\n \"INOUT_SOURCE\": 2,\n \"INOUT_DEVICE_UID\": null,\n \"INOUT_DEVICE_DATE\": \"2024-03-14 17:03:22\",\n \"INOUT_USE_SERVER_TIME\": true,\n \"INOUT_TELECOMMUTING\": false\n }\n]\n", "name": "" } ] } ] }, { "name": "Companies", "description": "", "item": [ { "name": "Get the authenticated company's profile.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/companies\/current", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/companies\/current" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns the full company object including all employees with their\nassociated projects, clients, and work centres." }, "response": [ { "header": [], "code": 200, "body": "{\n \"COMPANY_ID\": 42,\n \"COMPANY_UNIQUE_ID\": \"abc12345-1234-1234-1234-abc123456789\",\n \"COMPANY_NAME\": \"Acme Corp S.L.\",\n \"COMPANY_CIF\": \"B12345678\",\n \"COMPANY_CCC\": \"1234567890\",\n \"COMPANY_ADDRESS\": \"Calle Gran Via 1\",\n \"COMPANY_COUNTRY\": \"ES\",\n \"COMPANY_LOCATION\": \"Madrid\",\n \"COMPANY_CP\": \"28013\",\n \"COMPANY_COORDINATES\": \"40.416775,-3.703790\",\n \"COMPANY_MAIL\": \"admin@acme.example\",\n \"COMPANY_PASSWORD\": \"\",\n \"COMPANY_PRO\": 1,\n \"COMPANY_RATE\": 2,\n \"COMPANY_DELETION_DATE\": null,\n \"COMPANY_HAS_ADS\": 0,\n \"COMPANIES_TOKEN\": \"\",\n \"COMPANY_LOGO\": \"https:\/\/cdn.example.com\/logos\/acme.png\",\n \"COMPANY_SIGNATURE\": null,\n \"COMPANY_CONTINUOUS_WORKDAYS\": 0,\n \"COMPANY_USE_SERVER_TIME\": 1,\n \"COMPANY_FORCE_LOCATION\": 0,\n \"COMPANY_CALENDAR_DAYS\": 0,\n \"COMPANY_SHOW_CLIENT\": 1,\n \"COMPANY_SHOW_CLIENT_SELECT\": 0,\n \"COMPANY_EMAIL_UPDATES\": 1,\n \"COMPANY_API_COMMENTS\": 0,\n \"COMPANY_TIMEZONE\": \"Europe\/Madrid\",\n \"users\": [\n {\n \"USER_ID\": 101,\n \"USER_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"USER_NAME\": \"Jane Smith\",\n \"USER_EMAIL\": \"jane.smith@acme.example\",\n \"USER_TOKEN\": \"\",\n \"USER_IMAGE\": null,\n \"USER_NIF\": null,\n \"USER_AFFILIATION\": null,\n \"USER_WORKING_TIME\": null,\n \"USER_USERNAME\": \"jane.smith@acme.example\",\n \"USER_PASWORD\": \"\",\n \"projects\": [],\n \"workcenters\": []\n }\n ]\n}\n", "name": "" } ] }, { "name": "Company login (deprecated \u2014 410 Gone).", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/companies\/login", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/companies\/login" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "This endpoint has been retired. API access must now be granted formally\nby Intratime. Contact support to request a Bearer token." }, "response": [ { "header": [], "code": 410, "body": "{\"error\":{\"code\":\"ENDPOINT_GONE\",\"message\":\"This login endpoint is no longer available. Access must now be requested formally.\",\"contact\":\"support@intratime.es\"}}", "name": "" } ] } ] }, { "name": "Employees", "description": "", "item": [ { "name": "List all employees.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns all active employees of the authenticated company, each with\ntheir associated projects, clients, and work centres." }, "response": [ { "header": [], "code": 200, "body": "[\n {\n \"USER_ID\": 101,\n \"USER_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"USER_NAME\": \"Jane Smith\",\n \"USER_EMAIL\": \"jane.smith@acme.example\",\n \"USER_TOKEN\": \"\",\n \"USER_IMAGE\": null,\n \"USER_NIF\": null,\n \"USER_AFFILIATION\": null,\n \"USER_WORKING_TIME\": null,\n \"USER_USERNAME\": \"jane.smith@acme.example\",\n \"USER_PASWORD\": \"\",\n \"projects\": [\n {\n \"PROJECT_ID\": 7,\n \"PROJECT_NAME\": \"Alpha Project\",\n \"PROJECT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"PID_OLD\": null,\n \"client\": null,\n \"users\": []\n }\n ],\n \"workcenters\": [\n {\n \"WORKCENTER_ID\": 3,\n \"WORKCENTER_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"WORKCENTER_NAME\": \"Main Office\",\n \"WORKCENTER_COUNTRY\": \"ES\",\n \"WORKCENTER_REGION\": \"Madrid\",\n \"WORKCENTER_CITY\": \"Madrid\",\n \"WORKCENTER_ADDRESS\": \"Calle Gran Via 1\",\n \"WORKCENTER_CP\": \"28013\",\n \"WORKCENTER_COORDINATES\": \"40.416775,-3.703790\",\n \"WORKCENTER_CREATION_DATE\": \"2023-01-15 09:00:00\",\n \"WCID_OLD\": null\n }\n ]\n },\n {\n \"USER_ID\": 102,\n \"USER_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"USER_NAME\": \"John Doe\",\n \"USER_EMAIL\": \"john.doe@acme.example\",\n \"USER_TOKEN\": \"\",\n \"USER_IMAGE\": null,\n \"USER_NIF\": null,\n \"USER_AFFILIATION\": null,\n \"USER_WORKING_TIME\": null,\n \"USER_USERNAME\": \"john.doe@acme.example\",\n \"USER_PASWORD\": \"\",\n \"projects\": [],\n \"workcenters\": []\n }\n]\n", "name": "" } ] }, { "name": "Create a new employee.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart\/form-data" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "formdata", "formdata": [ { "key": "user_email", "value": "alice@acme.example", "type": "text", "description": "The employee's unique email address." }, { "key": "user_pin", "value": "1234", "type": "text", "description": "The employee's PIN code." }, { "key": "user_name", "value": "Alice Doe", "type": "text", "description": "The employee's full name." }, { "key": "user_file", "src": [], "type": "file" } ] }, "description": "Creates an employee record under the authenticated company. Optionally\naccepts a profile picture via multipart form upload." }, "response": [ { "header": [], "code": 201, "body": "{\n \"USER_ID\": 103,\n \"USER_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"USER_NAME\": \"Alice Doe\",\n \"USER_EMAIL\": \"alice.doe@acme.example\",\n \"USER_TOKEN\": \"\",\n \"USER_IMAGE\": null,\n \"USER_NIF\": null,\n \"USER_AFFILIATION\": null,\n \"USER_WORKING_TIME\": null,\n \"USER_USERNAME\": \"alice.doe@acme.example\",\n \"USER_PASWORD\": \"\",\n \"projects\": [],\n \"workcenters\": []\n}\n", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"Validation failed\",\n \"errors\": {\n \"user_email\": [\n \"The user email field is required.\",\n \"The user email has already been taken.\"\n ],\n \"user_pin\": [\n \"The user pin field is required.\"\n ],\n \"user_name\": [\n \"The user name field is required.\"\n ]\n }\n}\n", "name": "" } ] }, { "name": "Employee login (deprecated \u2014 410 Gone).", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user\/login", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user\/login" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "This endpoint has been retired. Use Bearer token authentication instead.\nContact Intratime to obtain an API token." }, "response": [ { "header": [], "code": 410, "body": "{\"error\":{\"code\":\"ENDPOINT_GONE\",\"message\":\"This login endpoint is no longer available. Access must now be requested formally.\",\"contact\":\"support@intratime.es\"}}", "name": "" } ] }, { "name": "Get my profile (deprecated \u2014 410 Gone).", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user\/my-profile", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user\/my-profile" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "This endpoint has been retired. Use `GET \/company-apps\/api\/v2\/user\/{employee}` instead." }, "response": [ { "header": [], "code": 410, "body": "{\"error\":{\"code\":\"ENDPOINT_GONE\",\"message\":\"The 'my-profile' endpoint has been retired. Please refer to the new alternative.\",\"alternative_01\":\"https:\/\/example.com\/company-apps\/api\/v2\/user\/{employee_id}\",\"alternative_02\":\"https:\/\/old.example.com\/api\/user\/{employee_id}\",\"documentation\":\"https:\/\/docs.example.com\",\"contact\":\"support@intratime.es\"}}", "name": "" } ] }, { "name": "Get my projects (deprecated \u2014 410 Gone).", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user\/my-project", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user\/my-project" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "This endpoint has been retired. Use `GET \/company-apps\/api\/v2\/user\/{employee}` instead\n(the employee object includes their assigned projects)." }, "response": [ { "header": [], "code": 410, "body": "{\"error\":{\"code\":\"ENDPOINT_GONE\",\"message\":\"The 'my-project' endpoint has been retired. Please refer to the new alternative.\",\"alternative_01\":\"https:\/\/example.com\/company-apps\/api\/v2\/user\/{employee_id}\",\"alternative_02\":\"https:\/\/old.example.com\/api\/user\/{employee_id}\",\"documentation\":\"https:\/\/docs.example.com\",\"contact\":\"support@intratime.es\"}}", "name": "" } ] }, { "name": "Get a single employee.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user\/:employee_USER_ID", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user\/:employee_USER_ID", "variable": [ { "id": "employee_USER_ID", "key": "employee_USER_ID", "value": 16, "description": "" }, { "id": "employee", "key": "employee", "value": 101, "description": "The employee's ID." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\n \"USER_ID\": 101,\n \"USER_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"USER_NAME\": \"Jane Smith\",\n \"USER_EMAIL\": \"jane.smith@acme.example\",\n \"USER_TOKEN\": \"\",\n \"USER_IMAGE\": null,\n \"USER_NIF\": null,\n \"USER_AFFILIATION\": null,\n \"USER_WORKING_TIME\": null,\n \"USER_USERNAME\": \"jane.smith@acme.example\",\n \"USER_PASWORD\": \"\",\n \"projects\": [\n {\n \"PROJECT_ID\": 7,\n \"PROJECT_NAME\": \"Alpha Project\",\n \"PROJECT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"PID_OLD\": null,\n \"client\": null,\n \"users\": []\n }\n ],\n \"workcenters\": [\n {\n \"WORKCENTER_ID\": 3,\n \"WORKCENTER_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"WORKCENTER_NAME\": \"Main Office\",\n \"WORKCENTER_COUNTRY\": \"ES\",\n \"WORKCENTER_REGION\": \"Madrid\",\n \"WORKCENTER_CITY\": \"Madrid\",\n \"WORKCENTER_ADDRESS\": \"Calle Gran Via 1\",\n \"WORKCENTER_CP\": \"28013\",\n \"WORKCENTER_COORDINATES\": \"40.416775,-3.703790\",\n \"WORKCENTER_CREATION_DATE\": \"2023-01-15 09:00:00\",\n \"WCID_OLD\": null\n }\n ]\n}\n", "name": "" } ] }, { "name": "Update an employee.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user\/:employee_USER_ID", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user\/:employee_USER_ID", "variable": [ { "id": "employee_USER_ID", "key": "employee_USER_ID", "value": 16, "description": "" }, { "id": "employee", "key": "employee", "value": 101, "description": "The employee's ID." } ] }, "method": "POST", "header": [ { "key": "Content-Type", "value": "multipart\/form-data" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "formdata", "formdata": [ { "key": "user_email", "value": "alice@acme.example", "type": "text", "description": "The employee's email address (must be unique, may be unchanged)." }, { "key": "user_pin", "value": "5678", "type": "text", "description": "optional New PIN code. Omit to keep the existing PIN." }, { "key": "user_name", "value": "Alice Smith", "type": "text", "description": "The employee's full name." }, { "key": "user_file", "src": [], "type": "file" }, { "key": "_method", "value": "PUT", "type": "text" } ] }, "description": "Updates an employee's profile. All fields are required except `user_pin`\nand `user_file`. Providing `user_file` replaces any existing profile picture." }, "response": [ { "header": [], "code": 200, "body": "{\n \"USER_ID\": 101,\n \"USER_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"USER_NAME\": \"Jane Smith Updated\",\n \"USER_EMAIL\": \"jane.updated@acme.example\",\n \"USER_TOKEN\": \"\",\n \"USER_IMAGE\": null,\n \"USER_NIF\": null,\n \"USER_AFFILIATION\": null,\n \"USER_WORKING_TIME\": null,\n \"USER_USERNAME\": \"jane.updated@acme.example\",\n \"USER_PASWORD\": \"\",\n \"projects\": [],\n \"workcenters\": []\n}\n", "name": "" }, { "header": [], "code": 422, "body": "{\n \"message\": \"Validation failed\",\n \"errors\": {\n \"user_email\": [\n \"The user email field is required.\",\n \"The user email has already been taken.\"\n ],\n \"user_pin\": [\n \"The user pin field is required.\"\n ],\n \"user_name\": [\n \"The user name field is required.\"\n ]\n }\n}\n", "name": "" } ] }, { "name": "Delete an employee.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/user\/:employee_USER_ID", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/user\/:employee_USER_ID", "variable": [ { "id": "employee_USER_ID", "key": "employee_USER_ID", "value": 16, "description": "" }, { "id": "employee", "key": "employee", "value": 101, "description": "The employee's ID." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Soft-deletes the employee record. Returns an empty 204 response on success." }, "response": [ { "header": [], "code": 204, "body": "", "name": "Employee deleted" } ] } ] }, { "name": "Expenses", "description": "", "item": [ { "name": "List expense types.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/expenses", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/expenses" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns the expense-type catalogue for the authenticated company as a flat\nJSON array. There are no filters \u2014 all active expense types are returned.\n\nEach entry includes an `EXPENSE_ICON` URL (may be an empty string when no\nicon has been configured)." }, "response": [ { "header": [], "code": 200, "body": "[\n {\n \"EXPENSE_ID\": 1,\n \"EXPENSE_NAME\": \"Travel\",\n \"EXPENSE_ICON\": \"https:\/\/cdn.example.com\/expenses\/travel.png\",\n \"EXPENSE_CC\": \"TRV\"\n },\n {\n \"EXPENSE_ID\": 2,\n \"EXPENSE_NAME\": \"Meal\",\n \"EXPENSE_ICON\": \"https:\/\/cdn.example.com\/expenses\/meal.png\",\n \"EXPENSE_CC\": \"MLT\"\n },\n {\n \"EXPENSE_ID\": 3,\n \"EXPENSE_NAME\": \"Accommodation\",\n \"EXPENSE_ICON\": \"\",\n \"EXPENSE_CC\": \"ACC\"\n }\n]\n", "name": "" } ] } ] }, { "name": "Projects", "description": "", "item": [ { "name": "List all projects.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/project", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/project" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Returns all projects belonging to the authenticated company, each with\ntheir associated client and assigned employees." }, "response": [ { "header": [], "code": 200, "body": "[\n {\n \"PROJECT_ID\": 7,\n \"PROJECT_NAME\": \"Alpha Project\",\n \"PROJECT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"PID_OLD\": null,\n \"client\": {\n \"CLIENT_ID\": 10,\n \"CLIENT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"CLIENT_NAME\": \"Beta Solutions Ltd.\",\n \"CLIENT_COUNTRY\": \"ES\",\n \"CLIENT_REGION\": \"Catalonia\",\n \"CLIENT_CITY\": \"Barcelona\",\n \"CLIENT_ADDRESS\": \"Passeig de Gracia 100\",\n \"CLIENT_CP\": \"08008\",\n \"CLIENT_COORDINATES\": \"41.396041,2.161047\",\n \"CID_OLD\": null\n },\n \"users\": [\n {\n \"USER_ID\": 101,\n \"USER_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"USER_NAME\": \"Jane Smith\",\n \"USER_EMAIL\": \"jane.smith@acme.example\",\n \"USER_TOKEN\": \"\",\n \"USER_IMAGE\": null,\n \"USER_NIF\": null,\n \"USER_AFFILIATION\": null,\n \"USER_WORKING_TIME\": null,\n \"USER_USERNAME\": \"jane.smith@acme.example\",\n \"USER_PASWORD\": \"\",\n \"projects\": [],\n \"workcenters\": []\n }\n ]\n }\n]\n", "name": "" } ] }, { "name": "Create a new project.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/project", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/project" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Beta Project\",\"client\":11,\"user_ids\":\"101,102\"}" }, "description": "Creates a project under the authenticated company and optionally assigns\nemployees. Returns the created project with its client and assigned users." }, "response": [ { "header": [], "code": 201, "body": "{\n \"PROJECT_ID\": 8,\n \"PROJECT_NAME\": \"Beta Project\",\n \"PROJECT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"PID_OLD\": null,\n \"client\": {\n \"CLIENT_ID\": 11,\n \"CLIENT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"CLIENT_NAME\": \"Gamma Industries S.A.\",\n \"CLIENT_COUNTRY\": \"ES\",\n \"CLIENT_REGION\": \"Valencia\",\n \"CLIENT_CITY\": \"Valencia\",\n \"CLIENT_ADDRESS\": \"Avinguda del Regne de Valencia 25\",\n \"CLIENT_CP\": \"46005\",\n \"CLIENT_COORDINATES\": \"39.469903,-0.376288\",\n \"CID_OLD\": null\n },\n \"users\": []\n}\n", "name": "" } ] }, { "name": "Get a single project.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/project\/:PROJECT_ID", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/project\/:PROJECT_ID", "variable": [ { "id": "PROJECT_ID", "key": "PROJECT_ID", "value": 16, "description": "" }, { "id": "project", "key": "project", "value": 7, "description": "The project's ID." } ] }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "" }, "response": [ { "header": [], "code": 200, "body": "{\n \"PROJECT_ID\": 7,\n \"PROJECT_NAME\": \"Alpha Project\",\n \"PROJECT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"PID_OLD\": null,\n \"client\": {\n \"CLIENT_ID\": 10,\n \"CLIENT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"CLIENT_NAME\": \"Beta Solutions Ltd.\",\n \"CLIENT_COUNTRY\": \"ES\",\n \"CLIENT_REGION\": \"Catalonia\",\n \"CLIENT_CITY\": \"Barcelona\",\n \"CLIENT_ADDRESS\": \"Passeig de Gracia 100\",\n \"CLIENT_CP\": \"08008\",\n \"CLIENT_COORDINATES\": \"41.396041,2.161047\",\n \"CID_OLD\": null\n },\n \"users\": [\n {\n \"USER_ID\": 101,\n \"USER_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"USER_NAME\": \"Jane Smith\",\n \"USER_EMAIL\": \"jane.smith@acme.example\",\n \"USER_TOKEN\": \"\",\n \"USER_IMAGE\": null,\n \"USER_NIF\": null,\n \"USER_AFFILIATION\": null,\n \"USER_WORKING_TIME\": null,\n \"USER_USERNAME\": \"jane.smith@acme.example\",\n \"USER_PASWORD\": \"\",\n \"projects\": [],\n \"workcenters\": []\n }\n ]\n}\n", "name": "" } ] }, { "name": "Update a project.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/project\/:PROJECT_ID", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/project\/:PROJECT_ID", "variable": [ { "id": "PROJECT_ID", "key": "PROJECT_ID", "value": 16, "description": "" }, { "id": "project", "key": "project", "value": 7, "description": "The project's ID." } ] }, "method": "PUT", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Alpha Project Updated\",\"client\":10,\"user_ids\":\"101\"}" }, "description": "Updates the project name, client association, and employee assignments.\nProviding `user_ids` **replaces** the existing employee list entirely." }, "response": [ { "header": [], "code": 200, "body": "{\n \"PROJECT_ID\": 7,\n \"PROJECT_NAME\": \"Alpha Project Updated\",\n \"PROJECT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"PID_OLD\": null,\n \"client\": {\n \"CLIENT_ID\": 10,\n \"CLIENT_COMPANY\": \"abc12345-1234-1234-1234-abc123456789\",\n \"CLIENT_NAME\": \"Beta Solutions Ltd.\",\n \"CLIENT_COUNTRY\": \"ES\",\n \"CLIENT_REGION\": \"Catalonia\",\n \"CLIENT_CITY\": \"Barcelona\",\n \"CLIENT_ADDRESS\": \"Passeig de Gracia 100\",\n \"CLIENT_CP\": \"08008\",\n \"CLIENT_COORDINATES\": \"41.396041,2.161047\",\n \"CID_OLD\": null\n },\n \"users\": []\n}\n", "name": "" } ] }, { "name": "Delete a project.", "request": { "url": { "host": "{{baseUrl}}", "path": "company-apps\/api\/v2\/project\/:project_PROJECT_ID", "query": [], "raw": "{{baseUrl}}\/company-apps\/api\/v2\/project\/:project_PROJECT_ID", "variable": [ { "id": "project_PROJECT_ID", "key": "project_PROJECT_ID", "value": 16, "description": "" }, { "id": "project", "key": "project", "value": 7, "description": "The project's ID." } ] }, "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "Soft-deletes the project record. Returns an empty 204 response on success." }, "response": [ { "header": [], "code": 204, "body": "", "name": "Project deleted" } ] } ] } ], "auth": { "type": "bearer", "bearer": [ { "key": "Authorization", "type": "string" } ] } }