Data Import (Tiny)
Bring your contacts, companies, products, and orders from the ERP Tiny (olist) directly into SprintHub, without typing anything by hand. You can also import from a CSV, XLSX, or XLS spreadsheet. The import follows a guided step-by-step flow: you choose the source, connect the account, review a preview, and import — tracking progress in real time.
Available for administrators only. The Import screen and the integration setup are only shown to users with account administration permission. If you don't see the menu, ask an administrator.
Before you start (Tiny only): to connect Tiny you need to authorize access once in Settings > Integrations. This step is required and is done by an administrator. If you're importing from a spreadsheet (CSV/XLSX), go straight to the section "Importing from a spreadsheet (CSV/XLSX)".
Part 1 — Creating the Application
On the home page, open the sidebar and click “Settings”
As soon as you enter, go to the bottom of the page and click "Applications"
Now we create the Application by clicking "new application"
The redirect URL is shown in the Tiny integration panel on SprintHub from step 2, in blue.
The permissions depend on what will be used in SprintHub.
Ex: Use the Contacts import (check the contacts box)
Part 2 — Connect your Tiny account
The connection to Tiny is made in the integrations area and applies to the entire account: once connected, any administrator can import.
1. Open the Tiny integration
Go to Settings > Integrations and locate the card Tiny (olist). Click it to open the side configuration panel.
The panel opens with the title Tiny (olist) and the description "Connect the Tiny ERP to import contacts, companies, products, and orders".
2. Enter the application credentials
There are two situations. If the "Application credentials" block appears, you need to create an application in Tiny and paste the data here:
In the Tiny panel, create an API v3 application.
Copy the Client ID and the Client Secret generated by Tiny.
In SprintHub, paste the Client ID in the corresponding field and the Client Secret in the field below.
Copy the redirect URL shown in the blue notice ("Register this URL in the Tiny application:") and paste it exactly in that form in your application settings in Tiny.
Click on Save credentials.
If the credentials block does NOT appear, your account already uses the connection managed by SprintHub — you don't need to create any application. The panel shows "The connection is managed by SprintHub: just authorize with your Tiny account login". Go straight to step 3.
Note: the Client Secret is never shown again after being saved. To change it, just fill the field again (the field text says "Fill in only to replace the current secret"). Leave it blank if you only want to update the Client ID.
3. Add (authorize) your account
In the block Connected account, click on Add account. You will be taken to Tiny to log in and authorize access. When you confirm, Tiny automatically brings you back to SprintHub.
When successful, the green banner appears: "Account connected. You can now import the data on the Import screen."
From here you can:
Go to import — opens the import screen directly.
Reconnect account — redoes the authorization (use if the connection expires).
Disconnect account — removes access to the Tiny account. The application credentials remain saved.
Remember: the button Add account is only enabled after the application credentials are saved. Until then, the notice "Save the application credentials to enable the connection" appears.
Part 2 — Import from Tiny
1. Open the Import screen and choose the source
Access the screen Data import. It opens on "Choose the data source". Click the card Tiny (olist).
Note: if the Tiny card appears dimmed with the notice "Account not connected" and a Connectbutton, it means Part 1 has not been completed yet. Click Connect to go to Integrations and authorize the account first.
2. Choose what to import
With the account connected, the green banner "Connected to Tiny (olist)" appears. In "What do you want to import?", check one or more types:
Contacts
Companies
Products
Opportunities (your Tiny orders)
Use Select all to check everything at once (or Clear to uncheck). You can import more than one type at the same time.
If you check Opportunities, choose in "Where should the opportunities go?" the Funnel and the Stage destination stage. Won and canceled orders already come in with the correct status; the rest stay open in the stage you choose.
Click on Preview.
3. Review the preview
SprintHub shows a sample of each type, with the count of records found ("N records"). Click each section to expand and review.
If everything looks right, click Import now.
4. Track the import
The import runs in the background and progress appears in a floating bubble ("Importing..."). You can keep navigating the system while it keeps running.
At the end, you see the summary by type with:
created — new records
updated — records that already existed and were completed
ignored — records that had already been imported before (avoids duplicates)
failed — records that could not be imported
processed — total analyzed
Note: the floating bubble can be dragged around the screen, hidden (it turns into a small ball) and, while it is still running, Cancel the import. After it finishes, use Dismiss to close it or New import to start another one.
What is imported from Tiny
Contacts: all active contacts become contacts in SprintHub (CPF/CNPJ goes into the document field). Contacts that are companies (legal entities) also become a company, and the contact is automatically linked to it by document.
Companies: contacts of the legal entity type.
Products: name, code, SKU, NCM, brand, unit, GTIN/EAN, and the sale price.
Opportunities: each Tiny order becomes an opportunity, with the actual status (invoiced/approved/sent/delivered come in as won; canceled as lost; the rest as open), the original date of the order and the items linked to the products.
Known limits and common errors
Reimporting does not duplicate. SprintHub recognizes what has already been imported (contacts by CPF/CNPJ or email, companies by CNPJ, products by SKU/code) and only updates instead of creating again. Records already imported appear as ignored.
Records deleted in Tiny do not come through. Contacts and products marked as deleted are ignored during import.
Invoices are not imported yet. For now the import covers contacts, companies, products, and opportunities (orders).
Order items depend on a payment plan. For order items to be linked to the opportunity, a payment plan must be set up. Without a plan, the opportunity is imported without the items.
"Your connection to this source has expired. Reconnect to continue." — the Tiny authorization has expired. Go back to Settings > Integrations > Tiny (olist) and click on Reconnect account.
"Failed to connect to the source" — something went wrong when coming back from Tiny. Try Add account again; check whether the redirect URL was entered correctly in the Tiny application.
Some failures in the summary? Failed records are listed at the end of the import. They are usually temporary errors from the Tiny API — just reimport: what has already come in is ignored and only the missing ones are reprocessed.
Large accounts may take longer because of Tiny's request limits. The import keeps running in the background; you don't need to stay on the screen.
Last updated
Was this helpful?