Esta guía muestra qué cambia al pasar de la API v1 a la v2. Con la v2 obtenés paginación explícita (hay_mas), errores con código y mensaje, y más recursos disponibles.

Usamos items como ejemplo: los mismos cambios (URL, autenticación, nombres en snake_case, datos/paginacion, errores y números) aplican a todos los recursos de la v2.

Por qué migrar

Más recursos y operaciones. La v2 suma recursos de consulta y de alta que no están en la v1. La lista completa está en la sección Dux API v2 de esta referencia.
Errores con detalle. Cada error incluye un código, un mensaje que indica qué corregir y un id_solicitud para identificar el pedido si necesitás ayuda de soporte.
Paginación explícita. La respuesta indica con hay_mas si quedan más registros.
Tipos de datos estándar. Los números se devuelven como números, las fechas en formato yyyy-MM-dd y los valores sí/no como true/false.
Límite de pedidos visible. Cada respuesta informa en los headers X-RateLimit-* cuántos pedidos te quedan y, si alcanzás el límite, cuánto esperar para reintentar.

Cambios generales

Aspecto	v1	v2
URL base	`https://erp.duxsoftware.com.ar/WSERP/rest/services/`	`https://erp.duxsoftware.com.ar/WSERP/rest/services/v2/`
Autenticación	Header `authorization` con el token	Header `Authorization: Bearer <token>`
Parámetros de consulta	camelCase (`idListaPrecio`)	snake_case (`id_lista_precio`)
Lista de resultados	`results`	`datos`
Paginación	`paging` con `total`, `offset`, `limit`	`paginacion` con `total`, `offset`, `limit` y `hay_mas`
Identificador de la solicitud	No incluido	`id_solicitud` en respuestas y errores
Errores	Cuerpo sin estructura documentada	Objeto `error` con `codigo`, `mensaje`, `detalle` e `id_solicitud`
Valores numéricos	Texto (`"200000.0"`)	Número (`800.0`)

Usás el mismo token en ambas versiones. Si todavía no lo generaste, revisá Primeros Pasos.

Ejemplo: consultar items

Items es solo un ejemplo; la estructura de cambios es la misma para el resto de los recursos.

Request v1

curl -X GET "https://erp.duxsoftware.com.ar/WSERP/rest/services/items?limit=20&offset=0&idListaPrecio=1&habilitado=SI" \
  -H "authorization: TU_TOKEN"

Request v2

curl -X GET "https://erp.duxsoftware.com.ar/WSERP/rest/services/v2/items?limit=20&offset=0&id_lista_precio=1&habilitado=true" \
  -H "Authorization: Bearer TU_TOKEN"

Respuesta v1 (recortada)

{
  "paging": { "total": 350, "offset": 0, "limit": 20 },
  "results": [
    {
      "cod_item": "PROD-001",
      "item": "Producto de ejemplo",
      "costo": "800.0",
      "porc_iva": "21.0",
      "precios": [{ "id": 1, "nombre": "Lista general", "precio": "1000.0" }],
      "stock": [{ "id": 1, "nombre": "Depósito central", "ctd_disponible": "110.0", "stock_real": "120.0", "stock_disponible": "110.0" }],
      "fecha_creacion": "Sep 18, 2025 7:17:22 PM"
    }
  ]
}

Respuesta v2 (recortada)

{
  "datos": [
    {
      "cod_item": "PROD-001",
      "item": "Producto de ejemplo",
      "costo": 800.0,
      "porc_iva": 21.0,
      "precios": [{ "id": 1, "nombre": "Lista general", "precio": 1000.0 }],
      "stock": [{ "id": 1, "nombre": "Depósito central", "stock_real": 120.0, "stock_disponible": 110.0 }],
      "fecha_creacion": "2025-09-18"
    }
  ],
  "paginacion": { "total": 350, "offset": 0, "limit": 20, "hay_mas": true },
  "id_solicitud": "req_a1b2c3d4e5f6"
}

Equivalencias de parámetros y campos

Los campos del item son los mismos en ambas versiones (cod_item, codigo_externo, codigos_barra, costo, ctd_unidades_por_bulto, fecha_creacion, habilitado, imagen_url, item, marca, porc_iva, precios, proveedor, rubro, stock, sub_rubro). Cambian estos:

Concepto	v1	v2
Lista de precios	`idListaPrecio`	`id_lista_precio`
Depósito	`idDeposito`	`id_deposito`
Rubro	`idRubro`	`id_rubro`
Proveedor	`idProveedor`	`id_proveedor`
Código de item	`codigoItem`	`cod_item`
Habilitados	`habilitado` = `SI`, `NO` o `TODOS`	`habilitado` = `true` o `false`; sin enviarlo devuelve solo habilitados
Filtro por fecha	`fecha` (formato `ddMMyyyy HH:ss`)	`fecha_ult_actualizacion` (formato `yyyy-MM-dd`)
Paginación	`offset`, `limit`	`offset`, `limit` (igual: por defecto 20, máximo 50)
Fecha de creación en la respuesta	`Sep 18, 2025 7:17:22 PM`	`2025-09-18`
Stock disponible	`stock[].ctd_disponible`	No se incluye; usá `stock[].stock_disponible`

Filtros nuevos en v2: codigo_marca, id_sub_rubro y tipo_item (SIMPLE, COMPUESTO o PRODUCCION). Detalle completo en la referencia de Items v2.

Qué sigue

Revisá la referencia completa de la API v2 en este sitio, en la sección Dux API v2.