Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nekt.com/llms.txt

Use this file to discover all available pages before exploring further.

BIU is a Brazilian financial management platform focused on automating invoice issuance (NFe and NFs) for digital product sales. It integrates with major sales platforms like Hotmart, Eduzz, and others, consolidating sales data, fiscal notes, and financial dashboards in one place.

​
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) The earliest date from which records will be synced. If not set, all available data will be extracted.
Once you’re done, click Next.

​
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.
Once you are done configuring, click Next.

​
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.
For you to be able to see it on your Catalog, you need at least one successful source run.

​
Streams and Fields

Below you’ll find all available data streams from BIU and their corresponding fields:
Consolidated financial performance summary including sales totals, fiscal notes (NFe/NFs), and operational alerts for a given competence period.Date Information:
  • competence - Monthly period in YYYY-MM format (primary key)
  • start_date - Start date of the period
  • end_date - End date of the period
  • sales_date_field - Date field used for filtering
Sales Metrics:
  • sales_warning - Sales amount flagged as warning
  • sales_warning_qtt - Number of warning sales
  • sales_pending - Pending sales amount
  • sales_pending_qtt - Number of pending sales
  • sales_canceled - Canceled sales amount
  • sales_canceled_qtt - Number of canceled sales
  • sales_coproducer - Coproducer sales amount
  • sales_coproducer_qtt - Number of coproducer sales
  • sales_processed - Processed sales amount
  • sales_processed_qtt - Number of processed sales
  • sales_dont_issue - Sales marked as “don’t issue” amount
  • sales_dont_issue_qtt - Number of “don’t issue” sales
  • sales_total_qtt - Total number of sales
  • sales_processed_pct - Percentage of processed sales
NFe (Nota Fiscal Eletronica) Metrics:
  • fnp_warning, fnp_warning_qtt - NFe warnings
  • fnp_pending, fnp_pending_qtt - Pending NFe
  • fnp_canceled, fnp_canceled_qtt - Canceled NFe
  • fnp_coproducer, fnp_coproducer_qtt - Coproducer NFe
  • fnp_processed, fnp_processed_qtt - Processed NFe
  • fnp_dont_issue, fnp_dont_issue_qtt - “Don’t issue” NFe
  • fnp_total_qtt - Total NFe count
  • fnp_processed_pct - Percentage of processed NFe
NFs (Nota Fiscal de Servico) Metrics:
  • fns_warning, fns_warning_qtt - NFs warnings
  • fns_pending, fns_pending_qtt - Pending NFs
  • fns_canceled, fns_canceled_qtt - Canceled NFs
  • fns_coproducer, fns_coproducer_qtt - Coproducer NFs
  • fns_processed, fns_processed_qtt - Processed NFs
  • fns_dont_issue, fns_dont_issue_qtt - “Don’t issue” NFs
  • fns_total_qtt - Total NFs count
  • fns_processed_pct - Percentage of processed NFs
Alerts:
  • alerts_pending_products_qtt - Number of pending products
  • alerts_expired_certificates_qtt - Number of expired certificates
  • alerts_is_single_company - Whether the account is a single company
  • alerts_cert_expires - Certificate expiration date
  • alerts_cert_days_left - Days until certificate expires
  • alerts_cert_expired - Whether the certificate is expired
Detailed paginated list of sales with client information, product details, platform data, fiscal notes, and BRL values.Client Information:
  • empresa - Company name
  • cliente - Client name
  • email - Client email
  • tipo_doc_cliente - Client document type
  • doc_cliente - Client document number
  • cep_cliente - Client ZIP code
Product & Sale Details:
  • produto - Product name
  • data_criacao - Record creation date
  • modificado_em - Last modification date
  • data_venda - Sale date
  • data_fim_garantia - Warranty end date
  • plataforma - Sales platform (e.g., HOTMART, EDUZZ)
  • cod_plataforma - Platform transaction code (primary key)
  • resp_emissao - Responsible for invoice issuance
  • status_venda - Sale status (e.g., PROCESSADA, PENDENTE, CANCELADA)
  • motivo_status - Status reason
  • moeda - Currency (BRL)
  • valor_total - Total sale value (formatted BRL string)
NFs (Nota Fiscal de Servico):
  • nfs_numero - NFs invoice number
  • nfs_valor - NFs value
  • nfs_emissao - NFs issue date
  • nfs_modificado_em - NFs last modification date
  • nfs_status - NFs status
NFe (Nota Fiscal Eletronica):
  • nfe_numero - NFe invoice number
  • nfe_valor - NFe value
  • nfe_emissao - NFe issue date
  • nfe_modificado_em - NFe last modification date
  • nfe_status - NFe status

​
API Limits

The BIU API enforces a rate limit of 20 requests per minute per company. The connector handles this automatically with retry logic.