---
title: "Crea un item"
method: POST
path: "/v2/items"
tags: ["Items"]
---

# Crea un item

`POST /v2/items`

## Request

- Base URL: `https://erp.duxsoftware.com.ar/WSERP/rest/services`
- URL: `https://erp.duxsoftware.com.ar/WSERP/rest/services/v2/items`
- Auth: HTTP bearer

Crea un item en el catálogo. id_empresa es opcional si el Dux del token tiene una sola empresa.

## Query parameters

- `id_empresa` integer

## Request body

- V2GuardarItemRequest: Body de POST/PUT /v2/items. En PUT, cod_item del body debe coincidir con cod_item del path (si no coincide, devuelve 400). id_empresa se envía como parámetro de consulta, no en este cuerpo.
  - `id_personal` integer, required
  - `tipo_producto` string, required: Clasificación de negocio del item (p.ej. SIMPLE, COMPUESTO, PRODUCCION, NO_STOCKEABLE).
  - `cod_item` string, required
  - `item` string, required
  - `cod_barra` string
  - `id_rubro` integer
  - `id_sub_rubro` integer
  - `cod_marca` string
  - `id_proveedor` integer
  - `disponible_para` string: Si se omite, se asigna TODOS.
  - `id_moneda` integer, required
  - `porc_iva` number, double, required
  - `impuesto_interno` number, double
  - `costo_compra` number, double, required
  - `pesable` boolean
  - `indica_peso_cod_barra` boolean
  - `fecha_vencimiento` string
  - `compuesto_con_decimales` boolean
  - `codigo_producto_sat` string
  - `costos_adicionales` ItemV2CostoAdicionalRequest[]
    - `id_tipo_costo_adicional` integer
    - `costo` number, double
    - `tipo_calculo` string
  - `precios` ItemV2PrecioRequest[]
    - `id_lista_precio` integer
    - `id_moneda` integer
    - `tipo_valor` string
    - `valor` number, double
  - `precio_modificable` boolean
  - `ctd_unidades_por_bulto` number, double
  - `embalaje` string
  - `id_unidad_medida` integer, required
  - `descripcion` string
  - `observaciones_presupuesto` string
  - `codigo_externo` string
  - `item_cod_barra` ItemV2ItemCodBarraRequest[]
    - `cod_barra` string
  - `sucursales_habilitadas` V2ItemSucursalHabilitadaRequest[], required
    - `id_sucursal` integer
  - `variantes` ItemV2VarianteRequest[]
    - `talle` string
    - `color` string
    - `cod_barra` string
    - `stock` ItemV2StockRequest[]
      - `id_deposito` integer
      - `ctd_disponible` number, double
      - `ctd_minima` number, double
      - `ctd_ideal` number, double
      - `ctd_inicial` number, double
  - `stock` ItemV2StockRequest[]
    - `id_deposito` integer
    - `ctd_disponible` number, double
    - `ctd_minima` number, double
    - `ctd_ideal` number, double
    - `ctd_inicial` number, double
  - `kit_item` ItemV2KitItemRequest[]
    - `cod_kit` string
    - `ctd` number, double
  - `trazables` ItemV2TrazableRequest[]
    - `nro_identificacion_trazable` string
    - `id_deposito` integer
    - `fecha_vto` string
    - `descripcion_trazable` string
    - `lote_trazable` string
    - `salida_manual` boolean
  - `acepta_stock_negativo` boolean
  - `es_gasto_servicio` boolean
  - `imagen_url` string

## Response `201`

Creado

- ApiResponseV2ItemCrearResponse
  - `datos` V2ItemCrearResponse: Respuesta común de POST/PUT /v2/items y POST/PUT /v2/gastos-servicios.
    - `cod_item` string
    - `item` string
  - `paginacion` Paginacion
    - `total` integer
    - `offset` integer
    - `limit` integer
    - `hay_mas` boolean
  - `id_solicitud` string

## Other responses

- `400`: Validación
- `401`: No autorizado
- `403`: Prohibido
- `429`: Límite de peticiones
- `500`: Error interno

---

[API](https://skmtc.dev/duxsoftware/apis/dux-api-v2-base-de-datos.md) - [All operations](https://skmtc.dev/duxsoftware/apis/dux-api-v2-base-de-datos/llms.txt) - [OpenAPI document](https://skmtc.dev/duxsoftware/apis/dux-api-v2-base-de-datos/revisions/2cd294bb7540?raw)