> ## 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.
# Kamino as a data source
> Bring data from Kamino to Nekt.
Kamino is a financial management platform that helps businesses manage their receivables, financial movements, and customer data.
## Configuring Kamino as a Source
In the [Sources](https://app.nekt.ai/sources) tab, click on the "Add source" button located on the top right of your screen. Then, select the Kamino option from the list of connectors.
Click **Next** and you'll be prompted to add your access.
### 1. Add account access
You'll need the following information from your Kamino account:
* **App Token**: The App Token to authenticate against the Kamino API service
* **Company Identifier**: The company identifier from your Kamino account (it should be a text such as `mycompany`)
* **User Identifier**: The user identifier associated with the generated credentials
* **User Token**: The user token associated with the generated credentials
* **Hash**: The hash associated with the API credentials
* **API URL**: The URL for the API service
These credentials can be found following the steps on [this page](https://kamino.readme.io/docs/getting-started).
Once you have all the required credentials, fill the required fields and click **Next**.
### 2. Select streams
Choose which data streams you want to sync - you can select all streams or pick specific ones that matter most to you.
> Tip: The stream can be found more easily by typing its name.
Select the streams and click **Next**.
### 3. Configure data streams
Customize how you want your data to appear in your catalog. Select a name for each table (which will contain the fetched data) and the type of sync.
The `financial_movement` stream corresponds to the "Movimentação Financeira com rateio" endpoint.
* **Table name**: we suggest a name, but feel free to customize it. You have the option to add a **prefix** and make this process faster!
* **Sync Type**: you can choose between INCREMENTAL and FULL\_TABLE.
* Incremental: every time the extraction happens, we'll get only the new data - which is good if, for example, you want to keep every record ever fetched.
* Full table: every time the extraction happens, we'll get the current state of the data - which is good if, for example, you don't want to have deleted data in your catalog.
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](https://docs.nekt.com/runs/scheduling-and-triggers), consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times).
Optionally, you can determine when to execute a [full sync](https://docs.nekt.com/get-started/core-concepts/types-of-sync#additional-full-sync). This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.
Once you are ready, click **Next** to finalize the setup.
### 5. Check your new source
You can view your new source on the [Sources](https://app.nekt.ai/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](https://app.nekt.ai/catalog), you need at least one successful source run.
## Streams and Fields
Below you'll find all available data streams from Kamino and their corresponding fields:
Stream for managing people and companies (customers, suppliers, contacts).
**Key Fields:**
* `ID` - Unique identifier for the person
* `Nome` - Name of the person or company
* `NomeExibicao` - Display name
* `CPFCNPJ` - Brazilian tax identification number
* `NomeFantasia` - Trade name (for companies)
* `Cliente` - Whether the person is a customer
* `Fornecedor` - Whether the person is a supplier
* `Ativo` - Whether the person is active
* `Email`, `Telefone`, `Celular` - Contact information
* `Logradouro`, `Nro`, `Bairro`, `CEP`, `Cidade`, `UF` - Address fields
* `AtribFlex1` - Custom flexible attribute
* `AlteradoEm`, `DataHoraInclusao` - Timestamps
Stream for receivables (accounts receivable) with payment details, boleto information, and bank reconciliation.
**Key Fields:**
* `ID` - Unique identifier for the receivable
* `Descri` - Description of the receivable
* `DtaVenc` - Due date
* `VlrVenc` - Amount due
* `VlrBruto` - Gross amount
* `IDPessoa` - Associated person identifier
* `Pessoa` - Associated person details (nested object)
* `DtaPagto`, `VlrPagto` - Payment date and amount
* `SitConta`, `DescricaoSituacao` - Status
* `NomeCentroCusto`, `NomeUnidadeNegocio` - Cost center and business unit
* `ContaPagamento` - Payment account details (nested object)
* `LinkBoleto`, `LinhaDigitavelBoleto` - Boleto payment information
Stream for receivables that have been excluded from the main receivables list. Includes exclusion reason and the original receivable data.
**Key Fields:**
* `ID` - Unique identifier for the exclusion record
* `IDConta` - Identifier of the excluded receivable
* `DataHoraExclusao` - When the record was excluded
* `Motivo` - Reason for exclusion
* `IDUsuario` - User who performed the exclusion
* `Usuario` - User details (nested object)
* `Recebimento` - Full excluded receivable data (nested object)
Stream for financial movements with optional cost allocation (rateio). Corresponds to the "Movimentação Financeira com rateio" endpoint when rateio is enabled.
**Key Fields:**
* `ID` - Unique identifier for the movement
* `Tipo` - Type classification
* `Data`, `DataPagamento`, `DataVencimento`, `DataCompetencia` - Date fields
* `ValorTotal`, `ValorPrevisto`, `ValorRealizado` - Monetary values
* `PercentualRateio` - Allocation percentage for cost splitting
* `Realizado` - Whether the movement has been realized
* `IDContaOrigem`, `NomeContaOrigem` - Source account
* `IDContaDestino`, `NomeContaDestino` - Destination account
* `IDCentroCusto`, `NomeCentroCusto` - Cost center
* `IDPessoa`, `NomePessoa` - Associated person
* `Juros`, `Multa`, `Desconto`, `Taxas` - Interest, penalties, and fees
## Skills for agents
Kamino connector documentation as plain markdown, for use in AI agent contexts.