Productores

Resumen

Un Farmer (Productor) es la entidad de primer nivel en la jerarquía de SIMA. Cada establecimiento pertenece a un productor, y cada productor a una sociedad. Necesitás el farmer_id para crear establecimientos.

Society
  └── Farmer (Productor)
        └── Establishment
              └── Plot → Campaign → Work Order

En v3 los productores tienen CRUD (listar, detalle, alta, edición, activar/desactivar y baja). v2 queda solo como lectura legacy. Para integraciones nuevas usá /api/v3/third_party/farmers.

Endpoints (v3 — recomendado)

Método	Ruta	Descripción
GET	`/api/v3/third_party/farmers`	Listado paginado
GET	`/api/v3/third_party/farmers/{id}`	Detalle
POST	`/api/v3/third_party/farmers`	Alta (`201`)
PATCH	`/api/v3/third_party/farmers/{id}`	Edición
PATCH	`/api/v3/third_party/farmers/{id}/active`	Activar / desactivar
DELETE	`/api/v3/third_party/farmers/{id}`	Baja (`204`)

Listar

GET /api/v3/third_party/farmers

Filtros:

Parámetro	Tipo	Descripción
`id`	int	ID de productor
`name`	string	Nombre
`last_name`	string	Apellido
`area_from` / `area_to`	int	Superficie en hectáreas
`modified_at_from` / `modified_at_to`	datetime	Detección de cambios (ISO8601)
`created_at_from` / `created_at_to`	datetime	Fecha de alta
`deleted_at_from` / `deleted_at_to`	datetime	Bajas lógicas
`page` / `size`	int	Paginación

El listado v3 de productores usa modified_at_from, no updated_at_from. El campo de respuesta de última modificación es modified_at.

Response (ítem de ejemplo):

{
  "id": 40,
  "name": "Juan",
  "lastname": "Rodríguez",
  "cuit": "20123456789",
  "email": "juan@example.com",
  "phone_number": "011-1234-5678",
  "area": 850,
  "observations": null,
  "external_code": "ERP-PROD-001",
  "created_at": "2015-06-20T16:45:46-03:00",
  "modified_at": "2024-01-15T10:30:00-03:00",
  "deleted_at": null,
  "active": true
}

La lista viene envuelta en items + metadatos de paginación (current_page, next_page, total_pages, total_items).

Detalle

GET /api/v3/third_party/farmers/{id}

Mismos campos que un ítem del listado.

Crear

POST /api/v3/third_party/farmers

{
  "name": "Juan",
  "lastname": "Rodríguez",
  "cuit": "20123456789",
  "email": "juan@example.com",
  "phone_number": "011-1234-5678",
  "area": 850,
  "observations": null,
  "external_code": "ERP-PROD-001"
}

name es obligatorio (máx. 100 caracteres). El resto es opcional. La sociedad se toma del token; no envíes society_id. Respuesta 201 con el recurso completo.

Actualizar

PATCH /api/v3/third_party/farmers/{id}

El body usa los mismos campos que el alta. name sigue siendo obligatorio en el PATCH.

Activar o desactivar

PATCH /api/v3/third_party/farmers/{id}/active

{ "active": false }

Respuesta: { "active": false }.

Eliminar

DELETE /api/v3/third_party/farmers/{id}

204 si el productor no tiene establecimientos asociados.
409 si todavía tiene establecimientos: primero hay que dar de baja o reasignar esos establecimientos.

Cómo obtener el farmer_id

Al onboarding de un cliente:

Listá productores: GET /api/v3/third_party/farmers
Matcheá por name + lastname, cuit o external_code
Guardá el id para usarlo como farmer_id al crear establecimientos

Si el productor no existe, crealo con POST o pedí que lo den de alta en SIMA.

Mapeo con tu ERP

Guardá el ID de tu sistema en external_code al crear o editar. Después podés resolver el productor sin depender del nombre. v3 no filtra el listado por external_code como query param; filtrá en cliente o usá id / nombre / CUIT. Si necesitás setear códigos en masa sobre productores ya existentes, contactá soporte@sima.ag.

v2 (legacy)

GET /api/v2/third_party/farmers
GET /api/v2/third_party/farmers/{id}

Solo lectura. Los timestamps salen como date_created / date_modified. No uses v2 en integraciones nuevas.

Próximos pasos

Jerarquía

Usá farmer_id para crear establecimientos y lotes

Lotes externos

Asociá parcelas de tu ERP con lotes SIMA

Empezar

Guías de Integración

Resumen

Endpoints (v3 — recomendado)

Listar

Detalle

Crear

Actualizar

Activar o desactivar

Eliminar

Cómo obtener el farmer_id

Mapeo con tu ERP

v2 (legacy)

Próximos pasos

Jerarquía

Lotes externos

​Resumen

​Endpoints (v3 — recomendado)

​Listar

​Detalle

​Crear

​Actualizar

​Activar o desactivar

​Eliminar

​Cómo obtener el farmer_id

​Mapeo con tu ERP

​v2 (legacy)

​Próximos pasos

Jerarquía

Lotes externos

Resumen

Endpoints (v3 — recomendado)

Listar

Detalle

Crear

Actualizar

Activar o desactivar

Eliminar

Cómo obtener el farmer_id

Mapeo con tu ERP

v2 (legacy)

Próximos pasos