Configuring BIU as a Source
In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the BIU option from the list of connectors. Click Next and you’ll be prompted to add your access.1. Add account access
You’ll need to provide your BIU API token to authenticate. You can generate a token at https://app.somosbiu.com/api-token. The following configurations are available:- API Token: Your BIU API bearer token for authentication.
- Start Date: (Optional) Earliest date to sync data from. If not set, all available data will be extracted.
2. Select streams
Choose which data streams you want to sync. For faster extractions, select only the streams that are relevant to your analysis. Select the streams and click Next.3. Configure data streams
Customize how you want your data to appear in your catalog. Select the desired layer where the data will be placed, a folder to organize it inside the layer, a name for each table and the type of sync.- Layer: choose between the existing layers on your catalog.
- Folder: a folder can be created inside the selected layer to group all tables being created from this new data source.
- Table name: you can customize the name or add a prefix to all tables at once.
- Sync Type: choose between INCREMENTAL and FULL_TABLE.
4. Configure data source
Describe your data source for easy identification within your organization, not exceeding 140 characters. To define your Trigger, consider how often you want data to be extracted from this source. Once you are ready, click Next to finalize the setup.5. Check your new source
You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.Streams and Fields
Below you’ll find all available data streams from BIU and their corresponding fields:Dashboard
Dashboard
Consolidated financial performance summary including sales totals, fiscal notes (NFe/NFs), and operational alerts for a given competence period.Key fields:
Notes:
- Replication: The stream uses
competenceas the replication key. Incremental syncs request data starting from the last replicated month. - Pagination: The connector iterates one month at a time from the configured
start_date(or the last saved state) up to the current month to fetch all records seamlessly.
API Limits
The BIU API enforces a rate limit of 20 requests per minute per company. Exceeding it blocks the company for 1 hour. The connector automatically handles this by restricting calls to 15 requests per 60 seconds to stay safely under the limit.Skills for agents
Download BIU skills file
BIU connector documentation as plain markdown, for use in AI agent contexts.