Artículos

Crear un artículo

Crea un artículo con su tipo, vistas, unidad, alícuota de IVA, niveles de embalaje y, en un kit, sus componentes.

POST/api/v1/items/create

Permiso: items.create
Empresa: Opera sobre la empresa activa
Tipo: Escritura: pide Idempotency-Key
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.
Idempotency-Keytextorequerido
Una clave única por intento, de hasta 255 caracteres. Reintentar con la misma clave y los mismos datos devuelve el mismo resultado sin repetir la operación. Ver Idempotencia.

Cuerpo

JSON con Content-Type: application/json.

itemTypeopciónrequerido
Valores: resale_product finished_product productive_input non_productive_input service kit
isSoldsí o norequerido
isPurchasedsí o norequerido
tracksStocksí o norequerido
codetextorequerido
de 1 a 30 caracteres, formato `^\S+$`
nametextorequerido
de 1 a 120 caracteres
descriptiontextoadmite null
hasta 2000 caracteres
gtincualquiera
ncmCodecualquiera
stockUnitIduuidrequerido
vatRateIduuidrequerido
isImportedsí o no
Por defecto: false
tracksLotAndExpirysí o no
Por defecto: false
requiresQualityControlsí o no
Por defecto: false
netWeightKgnúmeroadmite null
mayor que 0, máximo 999999999
grossWeightKgnúmeroadmite null
mayor que 0, máximo 999999999
palletLayersenteroadmite null
mayor que 0, máximo 999999999
lengthCmnúmeroadmite null
mayor que 0, máximo 99999999.99
widthCmnúmeroadmite null
mayor que 0, máximo 99999999.99
heightCmnúmeroadmite null
mayor que 0, máximo 99999999.99
packagingLevelslista de objeto
hasta 3
Campos de cada elemento (3)
- levelopciónrequerido
  Valores: primary_box secondary_box pallet
- quantitynúmerorequerido
  mayor que 0, máximo 999999999
- barcodecualquiera
componentslista de objeto
Por defecto: []hasta 100
Campos de cada elemento (2)
- componentItemIduuidrequerido
- quantitynúmerorequerido
  mayor que 0, máximo 999999999
brandIduuidadmite null
familyIduuidadmite null
sourceItemIduuidadmite null

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

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.create`.
`409`	La empresa activa no es la de `X-Expected-Company`.
`409`	Otra persona cambió el registro desde que lo leíste (`record.stale`).
`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 -X POST "$ERP_URL/api/v1/items/create" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "itemType": "resale_product",
  "isSold": false,
  "isPurchased": false,
  "tracksStock": false,
  "code": "ARS",
  "name": "texto",
  "stockUnitId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "vatRateId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90"
}'

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/items/create`, {
  method: "POST",
  headers: {
    Cookie: process.env.ERP_SESION!,
    "X-Expected-Company": process.env.ERP_EMPRESA!,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "itemType": "resale_product",
    "isSold": false,
    "isPurchased": false,
    "tracksStock": false,
    "code": "ARS",
    "name": "texto",
    "stockUnitId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "vatRateId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90"
  }),
});
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"
}