Resumen
La API de Terceros de SIMA expone endpoints en tres generaciones (v1, v2, v3). Para integraciones nuevas, usá siempre la versión más reciente disponible para cada operación. Esta página indica cuál es la ruta recomendada hoy.
Regla general
Rutas recomendadas por dominio
Por qué OTs usa dos versiones
updated_at_from, paginación, estados) optimizados para sincronización. La capa /integration/api/v1/ es el motor de escritura heredado que acepta la estructura completa (header + supplies + labours) necesaria para crear y modificar OTs.
Flujo recomendado para updates:
GET /api/v3/third_party/work_orders— obtener la OT actual con todos los campos- Modificar los campos necesarios en tu sistema
PATCH /integration/api/v1/workOrders/{localId}— enviar la estructura completa actualizada
Nunca adivines la forma del payload de escritura. Siempre obtené la OT con GET antes de un PATCH. Ver la guía de Órdenes de Trabajo.
Diferencias v2 vs v3 en parámetros
Los endpoints v3 usan nombres de parámetros con sufijo_at:
Si estás migrando desde v2, revisá cada endpoint en la referencia interactiva — los nombres no son intercambiables.
Endpoints legacy (evitar en integraciones nuevas)
Los endpoints bajo/api/v2/third_party/ y /api/v1/ siguen activos por compatibilidad con integraciones existentes. No los uses en proyectos nuevos salvo que no exista equivalente v3 (por ejemplo, catálogos solo v2 como adversity_kinds, CRUD de aplicadores, listado de lotes, o importación de campañas).
Próximos pasos
Referencia de API
Explorá la referencia interactiva con playground
Órdenes de Trabajo
Guía completa con ejemplos de request y response
Estrategia de Sincronización
Filtros de auditoría y detección de cambios
Errores y límites
Códigos HTTP y manejo de errores