> For the complete documentation index, see [llms.txt](https://docs.geopard.tech/geopard-tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geopard.tech/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.md).

# Resultados de laboratório de solo (CSV/Excel) - Importação inteligente

O GeoPard Agriculture é a primeira plataforma a realmente “resolver” o caos dos formatos de resultados de laboratório de solo — com importação inteligente automatizada.

## Visão geral

Os arquivos de laboratórios de análise de solo costumam usar diferentes modelos, idiomas, nomes de colunas e unidades. A Importação Inteligente identifica a tabela de resultados e a associa aos pontos de amostragem para análise.

<figure><img src="https://1397135423-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYICBELdyAXXebKAzfLOR%2Fuploads%2Fq4l9jRvhxTwmgtYiLmLe%2Fsoil_lab_results_import.jpeg?alt=media&amp;token=836b5fde-4943-473d-b13a-321e5b9c1fd6" alt="Automated parsing of csv/excel soil lab results"><figcaption><p>Análise automatizada de resultados de laboratórios de solo em CSV/Excel</p></figcaption></figure>

## Arquivos compatíveis

* CSV (`.csv`)
* Excel (`.xls`, `.xlsx`), incluindo pastas de trabalho com várias planilhas
* Vários arquivos por envio, com até 40 MB por arquivo

### Modelos do Excel para resultados de laboratórios de solo

{% file src="/files/7f8749f339224f2e043fd6d0f417231d39b6855c" %}

{% file src="/files/3c32df7bdf8e782338e35520c5440df2b80998f3" %}

{% file src="/files/204fdfaa5c867fc36462c3ff77cfa528ef11d832" %}

{% file src="/files/8445e86e0e27ed93a79e9a0b69b2e6fa0eb05aaf" %}

Use estas planilhas para preparar **resultados compostos por zona de manejo**. Cada linha representa o resultado de uma zona. Os valores são ilustrativos e não são recomendações de fertilizantes.

* `geopard-lab-results-zones-plan-id-en.xlsx`: cabeçalhos em inglês; associa as zonas por meio de **ID do plano** e **ID da zona**.
* `geopard-lab-results-zones-plan-id-ua.xlsx`: cabeçalhos em ucraniano; associa as zonas por meio de **ID плану** e **ID зони**.
* `geopard-lab-results-zones-field-name-en.xlsx`: cabeçalhos em inglês; associa as zonas por meio de **Nome do campo** e **ID da zona**.
* `geopard-lab-results-zones-field-name-ua.xlsx`: cabeçalhos em ucraniano; associa as zonas por meio de **Назва поля** e **ID зони**.

#### Escolha o modelo adequado

Use um modelo de **ID do plano** quando as amostras vierem de um plano de amostragem do GeoPard. Essa é a opção mais confiável. Informe o identificador do plano e o identificador da zona ou do ponto exatamente como aparecem no plano.

Use um modelo de **Nome do campo** quando não houver um identificador de plano do GeoPard disponível. Informe o nome do campo exatamente como aparece no GeoPard. Os identificadores das zonas devem corresponder às zonas desse campo.

Não misture a correspondência por ID do plano e por Nome do campo no mesmo arquivo. Mantenha os resultados das zonas e os resultados dos pontos em arquivos separados. Não altere os valores das colunas-chave depois que o laboratório receber as amostras.

#### Preencha a planilha

1. Mantenha a primeira linha como cabeçalho das colunas. Não mescle células do cabeçalho.
2. Adicione uma linha para cada zona ou ponto amostrado. Não combine várias zonas ou pontos em uma única linha.
3. Mantenha **ID do plano** + **ID da zona**, **ID do plano** + **ID do ponto**, ou **Nome do campo** + **ID da zona**, em colunas separadas.
4. Insira cada resultado em sua própria coluna de nutriente ou propriedade do solo. Mantenha as unidades informadas no cabeçalho da coluna.
5. Mantenha os valores de pH, matéria orgânica, nitrogênio, fósforo, potássio, enxofre, zinco e boro nas colunas correspondentes. Deixe o resultado em branco se o laboratório não o tiver informado.
6. Mantenha intacta a tabela de resultados da planilha. Não adicione totais, comentários ou tabelas adicionais dentro dela.

Os modelos contêm apenas valores de exemplo. Confirme o método laboratorial, a profundidade de amostragem, os atributos e as unidades antes de usar os resultados importados para tomar uma decisão agronômica.

#### Resultados da amostragem por pontos

{% file src="/files/b2f3328747979b0dbe51c0f5d068873fc70c9ee4" %}

{% file src="/files/38d50aeae8016601c21ed6ab28454f7656d43f47" %}

Use estas planilhas para **amostras de solo coletadas com trado de um plano de amostragem do GeoPard**. Cada linha representa um ponto amostrado.

* `geopard-lab-results-points-plan-id-en.xlsx`: cabeçalhos em inglês; associa os pontos por **ID do plano** e **ID do ponto**.
* `geopard-lab-results-points-plan-id-ua.xlsx`: cabeçalhos em ucraniano; associa os pontos por **ID плану** e **ID точки**.

Insira o ID do ponto exatamente como aparece no rótulo do ponto. Exemplo:

```csv
ID do plano,ID do ponto,pH KCl,Matéria orgânica (%),P2O5 (mg/kg),K2O (mg/kg)
Z7D2F58,1,6.5,3.4,183,148
Z7D2F58,2,6.2,3.4,195,77
Z7D2F58,3,6.4,2.4,149,112
```

Para pontos amostrados sem um plano GeoPard, forneça as colunas `Lon` e `Lat` no lugar. O GeoPard associa cada ponto quando ele está dentro dos limites de um talhão. Revise o mapeamento das coordenadas antes do upload.

{% hint style="warning" %}
Os resultados de solo importados são medições, não recomendações de aplicação. Verifique cada atributo e unidade na prévia da importação.
{% endhint %}

## O que acontece automaticamente

* Localiza a tabela de resultados e seus cabeçalhos, inclusive em layouts fora do padrão.
* Reconhece nomes comuns de atributos laboratoriais em diferentes idiomas.
* Detecta macro e micronutrientes e, em seguida, cria uma prévia editável do mapeamento.
* Detecta e padroniza unidades e sinaliza unidades incomuns ou mistas.
* Associa as amostras usando um plano de amostragem do GeoPard ou dados espaciais do arquivo.

## Prepare um arquivo CSV ou Excel

Mantenha uma linha por resultado laboratorial. Use uma linha de cabeçalho. Coloque cada medição em sua própria coluna.

Em uma pasta de trabalho do Excel, mantenha as tabelas de resultados claramente separadas. O GeoPard é compatível com pastas de trabalho com várias planilhas. Revise os cabeçalhos, mapeamentos e unidades detectados antes do envio.

### Exemplo: amostras compostas por zona

Use esta estrutura quando um laboratório receber um plano criado no GeoPard. `Sampling Plan ID` e `Zone ID` garantem a associação mais confiável.

```csv
Sampling Plan ID,Zone ID,pH,Organic Matter,P,K
Z4B7C21,1,6.4,3.1,18,142
Z4B7C21,2,6.1,2.7,12,118
```

Os valores e atributos acima são exemplos. Mantenha as unidades informadas pelo laboratório. Confirme cada unidade mapeada na prévia.

### Exemplo: amostras de solo coletadas com trado de um plano do GeoPard

Use esta estrutura quando um laboratório receber amostras de solo coletadas com trado a partir de um plano criado no GeoPard. `Sampling Plan ID` e `Point ID` garantem a associação mais confiável. O Point ID é o nome do ponto impresso na etiqueta da amostra.

```csv
Sampling Plan ID,Point ID,pH,Organic Matter,P,K
Z7D2F58,1,6.5,3.4,24,148
Z7D2F58,2,6.2,3.4,27,77
Z7D2F58,3,6.4,2.4,19,112
```

Use uma linha por ponto amostrado. Não combine vários pontos em uma única linha.

### Exemplo: amostras de solo coletadas com trado e coordenadas

Use longitude e latitude para amostras de solo coletadas com trado sem um plano do GeoPard. O GeoPard associa cada ponto quando ele está dentro do limite de um talhão.

```csv
Sample ID,Lon,Lat,pH,Organic Matter
CORE-001,10.123456,50.123456,6.4,3.1
CORE-002,10.124010,50.123780,6.2,2.8
```

Não inverta `Lon` e `Lat`.

### Exemplo: resultados vinculados ao campo

Use `Field Name` ou `Field ID` quando o arquivo do laboratório identificar o campo. Confira se o nome do campo corresponde ao nome do campo no GeoPard.

```csv
Field Name,Sample ID,pH,Organic Matter
North Field,LAB-1001,6.3,3.0
North Field,LAB-1002,6.5,3.2
```

`Field ID` é o UUID do campo no GeoPard. Você pode encontrá-lo no URL da página do campo.

## Como o GeoPard associa os resultados do laboratório aos campos

O GeoPard pode associar os resultados do laboratório ao campo correto de quatro maneiras:

1. **ID do plano de amostragem com ID da zona ou ID do ponto**\
   Use colunas separadas para o ID exclusivo do plano de amostragem e o ID da zona (amostras compostas) ou o ID do ponto (amostras de testemunho). Essa é a opção mais confiável para qualquer plano de amostragem gerado no GeoPard.
2. **Coordenadas do ponto (`Lon` / `Lat`)**\
   Use duas colunas para longitude e latitude. O GeoPard associa o ponto espacialmente quando ele está dentro dos limites de um campo. Use este método para amostras de testemunho coletadas sem um plano do GeoPard.
3. **Geometria WKT**\
   Use uma coluna com geometria WKT. O GeoPard associa espacialmente a geometria aos limites do campo.
4. **Nome do campo / ID do campo**\
   Use uma coluna de texto com o nome do campo ou o ID do campo. O GeoPard compara o nome do campo com o nome do campo `Name`.\
   `Field ID` é o UUID do campo no GeoPard. Você pode encontrá-lo no URL da página do campo.

## Importe o arquivo

1. Abra **Importar dados** → **Carregar arquivos** → **Resultados do laboratório**.
2. Carregue o arquivo CSV, XLS ou XLSX.
3. Selecione um campo ou plano de amostragem, se disponível. Adicione as datas pertinentes.
4. Revise a tabela detectada, o mapeamento dos atributos e as unidades.
5. Corrija qualquer mapeamento ou unidade que não corresponda ao relatório do laboratório.
6. Selecione **Carregar**.

{% hint style="warning" %}
Não trate os valores importados como recomendações de aplicação. Revise os atributos mapeados, as unidades, a profundidade de amostragem e o método laboratorial antes de tomar uma decisão agronômica.
{% endhint %}

## Conecte aos planos de amostragem

Para amostras compostas por zona, crie o plano em [Amostragem de Solo - Planejamento Automatizado](https://docs.geopard.tech/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/soil-sampling-automated-planning.md) e mantenha os identificadores do plano e da zona no arquivo do laboratório. Para amostras de testemunho, mantenha os identificadores do plano e do ponto ou inclua as coordenadas.

Isso preserva o vínculo entre o resultado do laboratório, a localização no campo e as futuras análises de tendências do solo.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.geopard.tech/geopard-tutorials/pt-br/tour-do-produto-aplicativo-web/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
