Connecting Ticketing Data.mov

1. For JIRA, first follow these instructions in JIRA to create an API token with the necessary permissions.
   1. The API token inherits the permissions of the user account, so many companies set up a specific Service Account Admin for this. That way you can give the API token access to all necessary Projects and exclude any work that is completely irrelevant to R&D.
   2. Confirm the API token has access to:
      1. ALL projects that are potentially relevant.
      2. User names AND email addresses
         1. Use the /rest/api/3/users/search endpoint to confirm
2. Then go to app.neo.tax and navigate to “Projects” page
3. Click “Connect Project Management”
4. Select ticketing provider
5. Connect ticketing by following the directions in the modal
   1. JIRA: This is where you will paste in the token created in step 1.
   2. Linear: You will create the token at this step. You can also create a service token for Linear if you like.
6. Fill out “Company Information” section
7. Click “Start Analysis”

• Note: Projects can take a few hours to a week to generate depending on the amount of data. We will send you an email when your projects are ready

FAQs

1. Question What data and permissions does the JIRA integration request?

   Answer:

   The JIRA integration gives NeoTax read-only access to fields for these objects and fields.

   Set up a JIRA service account to limit this to the correct JIRA Projects and exclude non-R&D projects.

   Tickets	Users	Teams	Collections
   *Assignees
   Collections
   Completed Timestamp
   Creator
   Description
   Due Date
   Name
   Parent Ticket
   Priority
   Project
   Remote Created Timestamp
   Remote Updated Timestamp
   Status
   Ticket Type
   Ticket URL*	*Avatar
   Email Address
   Is Active
   Name
   Teams*	Name	*Collection Type
   Description
   Name*

2. Question: Does my JIRA need to be set up in a particular way to be used with NeoTax? Answer: No - NeoTax is built to ingest any JIRA setup, no matter how messy. The integration ingests ticket level data, then enriches that with any available hierarchy data like Projects, Epics, etc. Then NeoTax organizes the data into higher-level groupings using AI.

3. Question: What version of JIRA do I need?

   Answer:

   NeoTax supports all versions of JIRA Cloud.

   JIRA Data Center is also supported-reach out to discuss integration.

4. Question: What data and permissions do the Linear integration request?

   Answer:

   The Linear integration gives NeoTax read-only access to fields for these objects and fields. Set up a Linear service account with access to the correct universe of Linear Teams (you can exclude any Teams that are completely unrelated to R&D/Software capitalization).

   Tickets	Users	Teams	Collections
   Due Date
   Completed At
   Collaborators
   Name
   Parent Ticket
   Status
   Priority
   Project
   Description
   Assignees
   Ticket Url	Avatar
   Teams
   Is Active
   Name
   Email Address	Name
   Description	Name
   Description
   Access Level

5. Question: Do I have to connect ticketing data?

   Answer: No. You can skip the ticketing connection step by clicking the “Skip Auto-Connect” in the top right corner.

6. ‘Question: What if I don’t use any of the ticketing providers?

   Answer: No worries! Click “Skip Auto-Connect” and upload your ticketing data via CSV from the “Data Sources” page. Feel free to check out the guide to ticketing data in CSV form here.