Artículos

Ver un artículo

Devuelve un artículo con sus niveles de embalaje, sus componentes de kit, los kits que lo usan y sus proveedores.

GET/api/v1/items/get

Permiso: items.view
Empresa: Opera sobre la empresa activa
Tipo: Lectura: no cambia nada
Respuesta: JSON

Encabezados

Cookietextorequerido
La cookie de sesión del usuario de la integración (__Secure-erp.session_token). Cuando esté la clave API, va en Authorization: Bearer. Ver Autenticación.
X-Expected-Companyuuidrequerido
La empresa sobre la que operás. Si no coincide con la de la credencial, responde 409. Ver Empresa activa.

Parámetros de la consulta

itemIduuidrequerido

Respuesta

200 con este JSON.

iduuidrequerido
codetextorequerido
nametextorequerido
descriptioncualquierarequerido
itemTypeopciónrequerido
Valores: resale_product finished_product productive_input non_productive_input service kit
isSoldsí o norequerido
isPurchasedsí o norequerido
tracksStocksí o norequerido
gtincualquierarequerido
ncmCodecualquierarequerido
arbaCategorycualquierarequerido
stockUnitIduuidrequerido
vatRateIduuidrequerido
isImportedsí o norequerido
tracksLotAndExpirysí o norequerido
requiresQualityControlsí o norequerido
netWeightKgcualquierarequerido
grossWeightKgcualquierarequerido
palletLayersenterorequeridoadmite null
lengthCmcualquierarequerido
widthCmcualquierarequerido
heightCmcualquierarequerido
brandIduuidrequeridoadmite null
familyIduuidrequeridoadmite null
statusopciónrequerido
Valores: active inactive
versionenterorequerido
mínimo 1
createdAtfecha y horarequerido
packagingLevelslista de objetorequerido
Campos de cada elemento (4)
- levelopciónrequerido
  Valores: primary_box secondary_box pallet
- quantitynúmerorequerido
- barcodecualquierarequerido
- totalStockUnitsnúmerorequerido
componentslista de objetorequerido
Campos de cada elemento (8)
- componentItemIduuidrequerido
- codetextorequerido
- nametextorequerido
- quantitynúmerorequerido
- statusopciónrequerido
  Valores: active inactive
- itemTypeopciónrequerido
  Valores: resale_product finished_product productive_input non_productive_input service kit
- tracksStocksí o norequerido
- stockUnitIduuidrequerido
usedInKitslista de objetorequerido
Campos de cada elemento (3)
- iduuidrequerido
- codetextorequerido
- nametextorequerido
supplierItemslista de objetorequerido
Campos de cada elemento (12)
- iduuidrequerido
- supplierIduuidrequerido
- supplierobjetorequerido
  Campos (3)
  - nametextorequerido
  - codeenterorequerido
  - statusopciónrequerido
    Valores: active inactive
- supplierCodecualquierarequerido
- supplierDescriptioncualquierarequerido
- purchaseLevelopciónrequerido
  Valores: unit primary_box secondary_box pallet
- lastPricecualquierarequerido
- currencyCodecualquierarequerido
- lastPriceDatefecharequeridoadmite null
- leadTimeDaysenterorequeridoadmite null
- retiredAtfecha y horarequeridoadmite null
- versionenterorequerido
  mínimo 1
enabledCurrencieslista de textorequerido
vatRateExpiredsí o norequerido
brandNamecualquierarequerido
familyPathcualquierarequerido

Errores

Un rechazo responde application/problem+json con un code estable. Los más comunes en esta operación:

`401`	Falta la credencial o venció.
`403`	La credencial no tiene el permiso `items.view`.
`409`	La empresa activa no es la de `X-Expected-Company`.
`422`	Datos inválidos o una regla de negocio rota, con el detalle por campo.
`503`	Sistema ocupado: reintentá después de `Retry-After` segundos.

La lista completa está en Errores.

curl
TypeScript

curl "$ERP_URL/api/v1/items/get?itemId=3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA"

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/items/get?itemId=3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90`, {
  headers: {
    Cookie: process.env.ERP_SESION!,
    "X-Expected-Company": process.env.ERP_EMPRESA!,
  },
});
if (!respuesta.ok) throw new Error((await respuesta.json()).title);
const datos = await respuesta.json();

{
  "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "code": "texto",
  "name": "texto",
  "description": null,
  "itemType": "resale_product",
  "isSold": false,
  "isPurchased": false,
  "tracksStock": false,
  "gtin": null,
  "ncmCode": null,
  "arbaCategory": null,
  "stockUnitId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "vatRateId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "isImported": false,
  "tracksLotAndExpiry": false,
  "requiresQualityControl": false,
  "netWeightKg": null,
  "grossWeightKg": null,
  "palletLayers": 1,
  "lengthCm": null,
  "widthCm": null,
  "heightCm": null,
  "brandId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "familyId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "status": "active",
  "version": 1,
  "createdAt": "2026-10-23T14:30:00.000Z",
  "packagingLevels": [
    {
      "level": "primary_box",
      "quantity": 100,
      "barcode": null,
      "totalStockUnits": 100
    }
  ],
  "components": [
    {
      "componentItemId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "code": "texto",
      "name": "texto",
      "quantity": 100,
      "status": "active",
      "itemType": "resale_product",
      "tracksStock": false,
      "stockUnitId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90"
    }
  ],
  "usedInKits": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "code": "texto",
      "name": "texto"
    }
  ],
  "supplierItems": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "supplierId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "supplier": {
        "name": "texto",
        "code": 1,
        "status": "active"
      },
      "supplierCode": null,
      "supplierDescription": null,
      "purchaseLevel": "unit",
      "lastPrice": null,
      "currencyCode": null,
      "lastPriceDate": "2026-10-23",
      "leadTimeDays": 1,
      "retiredAt": "2026-10-23T14:30:00.000Z",
      "version": 1
    }
  ],
  "enabledCurrencies": [
    "tex"
  ],
  "vatRateExpired": false,
  "brandName": null,
  "familyPath": null
}