> 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/esp/tour-del-producto-aplicacion-web/import-precision-agriculture-data/soil-lab-results-csv-excel-smart-import.md).

# Resultados de laboratorio de suelo (CSV/Excel) - importación inteligente

GeoPard Agriculture es la primera plataforma en “resolver” de verdad el caos de formatos de resultados de laboratorio de suelo, con importación inteligente automatizada.

## Descripción general

Los archivos de laboratorios de suelos suelen usar distintas plantillas, idiomas, nombres de columnas y unidades. Smart Import identifica la tabla de resultados y la vincula con los puntos de muestreo para su análisis.

<figure><img src="https://2708050521-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álisis automático de resultados de laboratorios de suelos en CSV/Excel</p></figcaption></figure>

## Archivos compatibles

* CSV (`.csv`)
* Excel (`.xls`, `.xlsx`), incluidos los libros con varias hojas
* Se pueden cargar varios archivos a la vez, de hasta 40 MB cada uno

### Plantillas de Excel para resultados de laboratorios de suelos

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

{% file src="/files/84cb945c03772a033543635f40392dbdd9484c87" %}

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

{% file src="/files/115b3916421ba3fdad7bfcd8a738b818b7f7eda4" %}

Usa estos libros de trabajo para preparar **resultados compuestos por zona de manejo**. Cada fila representa el resultado de una zona. Los valores son ilustrativos y no constituyen recomendaciones de fertilización.

* `geopard-lab-results-zones-plan-id-en.xlsx`: encabezados en inglés; vincula las zonas mediante **ID del plan** y **ID de zona**.
* `geopard-lab-results-zones-plan-id-ua.xlsx`: encabezados en ucraniano; vincula las zonas mediante **ID плану** y **ID зони**.
* `geopard-lab-results-zones-field-name-en.xlsx`: encabezados en inglés; vincula las zonas mediante **Nombre del campo** y **ID de zona**.
* `geopard-lab-results-zones-field-name-ua.xlsx`: encabezados en ucraniano; vincula las zonas mediante **Назва поля** y **ID зони**.

#### Elige la plantilla adecuada

Usa una plantilla de **ID del plan** cuando las muestras procedan de un plan de muestreo de GeoPard. Esta es la opción más fiable. Introduce el identificador del plan y el identificador de la zona o del punto exactamente como aparecen en el plan.

Usa una plantilla de **Nombre del campo** cuando no se disponga de un identificador del plan de GeoPard. Introduce el nombre del campo exactamente como aparece en GeoPard. Los identificadores de zona deben coincidir con los de las zonas de ese campo.

No combines la vinculación por ID del plan y por nombre del campo en un mismo archivo. Mantén los resultados de zonas y los resultados de puntos en archivos separados. No cambies los valores de las columnas clave después de que el laboratorio reciba las muestras.

#### Completa el libro de trabajo

1. Conserva la primera fila como encabezados de columna. No combines celdas de los encabezados.
2. Añade una fila por cada zona o punto muestreado. No combines varias zonas o puntos en una sola fila.
3. Mantén **ID del plan** + **ID de zona**, **ID del plan** + **ID de punto**, o **Nombre del campo** + **ID de zona**, en columnas separadas.
4. Introduce cada resultado en su propia columna de nutrientes o propiedades del suelo. Conserva las unidades informadas en el encabezado de la columna.
5. Mantén los valores de pH, materia orgánica, nitrógeno, fósforo, potasio, azufre, zinc y boro en las columnas correspondientes. Deja en blanco el resultado si el laboratorio no lo informó.
6. Conserva intacta la tabla de resultados del libro de trabajo. No añadas totales, comentarios ni tablas adicionales dentro de ella.

Las plantillas solo contienen valores de ejemplo. Confirma el método de laboratorio, la profundidad de muestreo, los atributos y las unidades antes de utilizar los resultados importados para tomar decisiones agronómicas.

#### Resultados del muestreo de puntos

{% file src="/files/2f0da4689d303cfebb793f9f556f7af5032129d4" %}

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

Usa estos libros de trabajo para **muestras de suelo tomadas con barrena de un plan de muestreo de GeoPard**. Cada fila representa un punto muestreado.

* `geopard-lab-results-points-plan-id-en.xlsx`: encabezados en inglés; relaciona los puntos mediante **ID del plan** y **ID del punto**.
* `geopard-lab-results-points-plan-id-ua.xlsx`: encabezados en ucraniano; relaciona los puntos mediante **ID del plan** y **ID del punto**.

Introduce el ID del punto exactamente como aparece impreso en la etiqueta del punto. Ejemplo:

```csv
ID del plan,ID del punto,pH KCl,Materia 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 los puntos muestreados sin un plan de GeoPard, proporciona las columnas `Lon` y `Lat` en su lugar. GeoPard relaciona cada punto cuando se encuentra dentro del límite de un campo. Revisa la asignación de coordenadas antes de cargar el archivo.

{% hint style="warning" %}
Los resultados de suelo importados son mediciones, no recomendaciones de aplicación. Verifica cada atributo y unidad en la vista previa de importación.
{% endhint %}

## Qué sucede automáticamente

* Encuentra la tabla de resultados y sus encabezados, incluso en diseños no convencionales.
* Reconoce nombres de atributos de laboratorio habituales en distintos idiomas.
* Detecta macro y micronutrientes y, luego, crea una vista previa editable de la asignación.
* Detecta y normaliza las unidades y señala las inusuales o mezcladas.
* Vincula las muestras mediante un plan de muestreo de GeoPard o los datos espaciales del archivo.

## Preparar un archivo CSV o Excel

Use una fila por resultado de laboratorio. Incluya una fila de encabezados. Coloque cada medición en su propia columna.

En los libros de Excel, mantenga las tablas de resultados claramente separadas. GeoPard admite libros con varias hojas. Revise los encabezados, las asignaciones y las unidades detectados antes de cargar el archivo.

### Ejemplo: muestras compuestas por zonas

Use esta estructura cuando el laboratorio reciba un plan creado en GeoPard. `Sampling Plan ID` y `Zone ID` ofrecen la correspondencia más fiable.

```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
```

Los valores y atributos anteriores son ejemplos. Mantenga las unidades indicadas por el laboratorio. Confirme cada unidad asignada en la vista previa.

### Ejemplo: muestras de núcleo de un plan de GeoPard

Use esta estructura cuando el laboratorio reciba muestras de núcleo de un plan creado en GeoPard. `Sampling Plan ID` y `Point ID` ofrecen la correspondencia más fiable. El Point ID es el nombre del punto impreso en la etiqueta de la muestra.

```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 una fila por punto muestreado. No combine varios puntos en una misma fila.

### Ejemplo: muestras de núcleo con coordenadas

Use la longitud y la latitud para las muestras de núcleo tomadas sin un plan de GeoPard. GeoPard vincula cada punto si se encuentra dentro del límite del lote.

```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
```

No intercambie `Lon` y `Lat`.

### Ejemplo: resultados por campo

Use `Field Name` o `Field ID` cuando el archivo del laboratorio identifica el campo. Compruebe que el nombre del campo coincida con el nombre del campo en 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` es el UUID del campo en GeoPard. Puede encontrarlo en la URL de la página del campo.

## Cómo GeoPard vincula los resultados del laboratorio con los campos

GeoPard puede vincular los resultados del laboratorio con el campo correcto de cuatro maneras:

1. **ID del plan de muestreo con ID de zona o ID de punto**\
   Use columnas separadas para el ID único del plan de muestreo y el ID de zona (muestras compuestas) o el ID de punto (muestras de núcleos). Esta es la opción más fiable para cualquier plan de muestreo generado en GeoPard.
2. **Coordenadas del punto (`Lon` / `Lat`)**\
   Use dos columnas para la longitud y la latitud. GeoPard vincula el punto espacialmente cuando este se encuentra dentro de los límites de un campo. Use este método para muestras de núcleos tomadas sin un plan de GeoPard.
3. **Geometría WKT**\
   Use una columna con geometría WKT. GeoPard vincula espacialmente la geometría con los límites del campo.
4. **Nombre del campo / ID del campo**\
   Use una columna de texto con el nombre o el ID del campo. GeoPard compara el nombre del campo con el campo `Name`.\
   `Field ID` es el UUID del campo en GeoPard. Puede encontrarlo en la URL de la página del campo.

## Importe el archivo

1. Abra **Importar datos** → **Cargar archivos** → **Resultados del laboratorio**.
2. Cargue el archivo CSV, XLS o XLSX.
3. Seleccione un campo o un plan de muestreo, si está disponible. Añada las fechas correspondientes.
4. Revise la tabla detectada, la asignación de atributos y las unidades.
5. Corrija cualquier asignación o unidad que no coincida con el informe del laboratorio.
6. Seleccione **Cargar**.

{% hint style="warning" %}
No considere los valores importados como recomendaciones de aplicación. Revise los atributos asignados, las unidades, la profundidad de muestreo y el método de análisis del laboratorio antes de tomar una decisión agronómica.
{% endhint %}

## Conectar con los planes de muestreo

Para las muestras compuestas por zonas, cree el plan en [Muestreo de suelo - planificación automatizada](https://docs.geopard.tech/geopard-tutorials/esp/tour-del-producto-aplicacion-web/soil-sampling-automated-planning.md) y conserve sus identificadores de plan y de zona en el archivo del laboratorio. Para las muestras de núcleos, conserve los identificadores de plan y de punto, o incluya las coordenadas.

Esto conserva el vínculo entre el resultado del laboratorio, la ubicación en el campo y el futuro análisis de tendencias del suelo.


---

# 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/esp/tour-del-producto-aplicacion-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.
