Datos Maestros

Resumen

Master data are the shared catalogs that Work Orders reference — agrochemical products (formulateds), applicators, machines, units, and labour types. You must sync these before creating any Work Order, since each supply and labour line requires valid IDs from these catalogs.

La mayoría de los datos maestros son solo lectura desde la API de Terceros. Los aplicadores son la excepción: soportan CRUD completo, pero solo en v2 (/api/v2/third_party/applicators). En v3, aplicadores y máquinas son solo lectura.

Mapa de datos maestros

Entity	CRUD	Scope	Required for
Formulateds	Read only	Global + society	Supply lines in OTs
Active Ingredients	Read only	Global	Formulated metadata
Units	Read only	Global	Formulated quantities
Applicators	Full CRUD (v2) / Read (v3)	Society	Labour lines in OTs
Machines	Read only	Society	Labour lines in OTs
Work Order Labour Types	Read only	Global	Labour type classification
Work Order Labour Type Categories	Read only	Global	Labour type grouping

Formulateds

Formulateds are agrochemical products (herbicides, fertilizers, fungicides, etc.). The catalog includes both SIMA’s global products and your society’s own records.

List

GET /api/v3/third_party/formulateds

Key filters:

Parameter	Type	Description
`name`	string	Search by commercial brand name
`use_id`	int	Filter by formulate use (herbicide, fungicide, etc.)
`active`	bool	Active records only
`updated_at_from`	datetime	Detect catalog changes

Response:

{
  "items": [
    {
      "id": 8844,
      "commercial_brand": "Glifosato 48 SL",
      "formulation_type_id": 195,
      "formulated_use_id": 15,
      "formulated_unit_id": 3,
      "active_ingredients": [
        { "active_ingredient_id": 15, "concentration": "48.000" }
      ],
      "external_code": null,
      "active": true
    }
  ],
  "current_page": 1,
  "next_page": 2,
  "total_pages": 6061,
  "total_items": 36364
}

The formulateds catalog is large (30,000+ records). Always filter by active=true and use updated_at_from on subsequent syncs rather than pulling the full catalog every time.

Matching with your system’s products

If your ERP has its own product catalog, use external_code or external_reference to store your product ID on the SIMA record. This allows reliable lookups without name-matching.

Endpoints relacionados (v2)

GET /api/v2/third_party/active_ingredients — catálogo de ingredientes activos
GET /api/v2/third_party/formulated_uses — categorías de uso (herbicida, fungicida, etc.)
GET /api/v2/third_party/formulation_types — tipos de formulación (SC, WG, EC, etc.)

Applicators

Los aplicadores son personas o empresas contratistas que ejecutan operaciones de campo. Son scoped por sociedad. La escritura (crear, actualizar, eliminar) está disponible solo en v2.

Listar (v3 — recomendado)

GET /api/v3/third_party/applicators

Filtros v3: name, active, updated_at_from, page, size.

Listar (v2 — legacy)

GET /api/v2/third_party/applicators

Response:

{
  "items": [
    {
      "id": 596,
      "name": "Sanchez Ricardo",
      "address": "Colón 56",
      "phone_number": "03444-15501565",
      "email": null,
      "machines": [640, 1081],
      "own": false,
      "external_code": null,
      "active": true
    }
  ]
}

Note: machines is an array of machine IDs associated to this applicator.

Crear (v2)

POST /api/v2/third_party/applicators

{
  "name": "Juan Rodríguez",
  "address": "Av. San Martín 123",
  "phone_number": "03492-123456",
  "email": "juan@example.com",
  "external_code": "YOUR-ERP-APPLICATOR-ID"
}

Actualizar (v2)

PUT /api/v2/third_party/applicators/{id}

Eliminar (v2)

DELETE /api/v2/third_party/applicators/{id}

Machines

Machines represent equipment used in field operations (sprayers, tractors, etc.). They are society-scoped and can be associated to applicators.

List

GET /api/v3/third_party/machines

Key filters: name, active, updated_at_from

Units

Units are measurement units used in formulated quantities (liters, kilograms, etc.).

List

GET /api/v3/third_party/units

Units are a global catalog — query once and cache locally. They rarely change.

Work Order Labour Types

Labour types classify the kind of work in a labour line (spraying, seeding, harvest, etc.).

List (v3 — recommended)

GET /api/v3/third_party/application_order_labour_types

Key filters: active, updated_at_from

List (v2 — legacy)

GET /api/v2/third_party/application_order_labour_types

Los tipos de labor tienen un campo wo_labour_type_category_id que los agrupa. Consultá GET /api/v2/third_party/work_order_labour_type_categories para el listado de categorías (solo v2).

Estrategia de sincronización recomendada

For initial setup and ongoing maintenance:

Initial full sync

Pull the full catalog once for each entity. For large catalogs like formulateds, paginate through all pages. Store id values mapped to your own product IDs using external_code.

Incremental sync

On subsequent runs, use updated_at_from set to your last sync timestamp. Only pull records that changed since then.

Detect deletions

Use deleted_at_from with your last sync timestamp to find soft-deleted records and mark them inactive in your system.

For the full details on audit filters, see the Sync Strategy guide.

Próximos pasos

Work Orders

Now that master data is ready, create your first Work Order

Sync Strategy

How to efficiently keep master data up to date

Empezar

Guías de Integración

Resumen

Mapa de datos maestros

Formulateds

List

Matching with your system’s products

Endpoints relacionados (v2)

Applicators

Listar (v3 — recomendado)

Listar (v2 — legacy)

Crear (v2)

Actualizar (v2)

Eliminar (v2)

Machines

List

Units

List

Work Order Labour Types

List (v3 — recommended)

List (v2 — legacy)

Estrategia de sincronización recomendada

Próximos pasos

Work Orders

Sync Strategy

​Resumen

​Mapa de datos maestros

​Formulateds

​List

​Matching with your system’s products

​Endpoints relacionados (v2)

​Applicators

​Listar (v3 — recomendado)

​Listar (v2 — legacy)

​Crear (v2)

​Actualizar (v2)

​Eliminar (v2)

​Machines

​List

​Units

​List

​Work Order Labour Types

​List (v3 — recommended)

​List (v2 — legacy)

​Estrategia de sincronización recomendada

​Próximos pasos

Work Orders

Sync Strategy

Resumen

Mapa de datos maestros

Formulateds

List

Matching with your system’s products

Endpoints relacionados (v2)

Applicators

Listar (v3 — recomendado)

Listar (v2 — legacy)

Crear (v2)

Actualizar (v2)

Eliminar (v2)

Machines

List

Units

List

Work Order Labour Types

List (v3 — recommended)

List (v2 — legacy)

Estrategia de sincronización recomendada

Próximos pasos