--- title: "Crear Ítem" method: POST path: "/item" tags: ["Inventarios"] --- # Crear Ítem `POST /item` Permite registrar uno o varios ítems en el sistema. Cada petición puede contener múltiples ítems, y cada registro será validado individualmente. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y fallidas. ## Request body - union - object - `control` string, required — Identificador del lote de ítems a importar. Distingue mayúsculas y minúsculas. - `codigoItem` string, required — Código único del ítem definido por el usuario. - `descripcionCorta` string, required — Descripción corta o resumida del ítem, definida por el usuario. - `descripcionLarga` string — Descripción detallada del ítem. - `grupo` string, required — Código del grupo al que pertenece el ítem. Debe existir en la lista de grupos de ítems. - `tipoItem` string, required — Tipo del ítem. Determina clasificación y atributos del ítem. - `unidadPrimaria` string, required — Unidad de medida primaria (UMP) del ítem. - `unidadAlterna` string — Unidad de medida alterna (UMA) del ítem, si aplica. - `ean` string — Código EAN del ítem. Puede ser el mismo código del ítem, pero debe ser único. - `procedencia` 'N' | 'I' — Indica si el ítem es Nacional (N) o Importado (I). - `vendible` 'S' | 'N' — Indica si el ítem es vendible (S) o no vendible (N). - `conceptoCompra` string — Concepto de documento para compras. Debe existir en la lista de conceptos de compra. - `conceptoVenta` string — Concepto de documento para ventas. Obligatorio si el ítem es vendible. - `comprador` string — Código del comprador por defecto asociado al ítem. - `clasificacionABC` 'A' | 'B' | 'C' — Clasificación ABC del ítem (A, B o C). Por defecto 'C'. - `metodoCosto` 'P' | 'E', required — Método de valoración del ítem: P (Promedio) o E (Estándar). - `stockMaximo` number, double — Cantidad máxima permitida en inventario para el ítem, expresada en unidad primaria. - `nivelReorden` number, double — Cantidad mínima en inventario antes de requerir reposición. - `stockMinimo` number, double — Cantidad mínima en inventario permitida antes de quedar agotado. - `atributo1Tipo1` string — Valor del atributo 1 tipo 1, definido en la lista de valores de atributos. - `atributo2Tipo1` string — Valor del atributo 2 tipo 1, definido en la lista de valores de atributos. - `atributo3Tipo1` string — Valor del atributo 3 tipo 1, definido en la lista de valores de atributos. - `atributo4Tipo1` string — Valor del atributo 4 tipo 1, definido en la lista de valores de atributos. - `unidadVenta` string — Unidad de medida de venta (UMV) del ítem. - `consumoDirecto` 'NU' | 'MF' | 'PF' — Frecuencia de consumo directo del ítem: NU (Nunca), MF (Muy frecuente), PF (Poco frecuente). - `vidaUtil` integer — Vida útil del ítem en días. Solo aplica si el ítem maneja fecha de expiración. - `producido` 'S' | 'N' — Indica si el ítem es producido por la compañía (S/N). - `inspeccion` 'S' | 'N' — Indica si el ítem producido requiere inspección (S/N). - `direccionCalculo` 'UMP>UMA' | 'UMA>UMP' — Dirección del cálculo de conversión de unidades. - `conceptoVentaDevolucion` string — Concepto de documento asociado a la devolución en ventas. - `conceptoVentaContado` string — Concepto de documento asociado a las ventas de contado. - `leadTime` number, double — Tiempo en días que demora la compañía en producir el ítem. - `estado` 'AC' | 'IN' | 'OB' — Estado del ítem: AC (Activo), IN (Inactivo), OB (Obsoleto). - `comentario` string — Observaciones o notas asociadas al ítem, hasta 1024 caracteres. - `descripcionXl` string — Descripción extra larga del ítem, hasta 300 caracteres. - `leadTimePdn` number, double — Tiempo en días para producción (solo aplica si el ítem es producido). No permite negativos. - `cantidadBasePdn` number, double — Cantidad base asociada al lead time PDN (solo aplica si el ítem es producido). No permite negativos. - `loteMinimoPdn` number, double — Lote mínimo de producción (solo aplica si el ítem es producido). No permite negativos. - `conceptoDevolucionCompra` string — Concepto de documento para devolución en compra, debe existir en la lista de conceptos de compra. - `leadTimeCompra` number, double — Lead time del ítem en días para compras. No permite negativos. - `atributosExtendidos` AtributosExtendidosDatosEntrada — Atributos extendidos del lote (01 al 20). Cada campo tiene un máximo de 30 caracteres - `atributo01` string — Valor del atributo extendido 1 definido por el usuario - `atributo02` string — Valor del atributo extendido 2 definido por el usuario - `atributo03` string — Valor del atributo extendido 3 definido por el usuario - `atributo04` string — Valor del atributo extendido 4 definido por el usuario - `atributo05` string — Valor del atributo extendido 5 definido por el usuario - `atributo06` string — Valor del atributo extendido 6 definido por el usuario - `atributo07` string — Valor del atributo extendido 7 definido por el usuario - `atributo08` string — Valor del atributo extendido 8 definido por el usuario - `atributo09` string — Valor del atributo extendido 9 definido por el usuario - `atributo10` string — Valor del atributo extendido 10 definido por el usuario - `atributo11` string — Valor del atributo extendido 11 definido por el usuario - `atributo12` string — Valor del atributo extendido 12 definido por el usuario - `atributo13` string — Valor del atributo extendido 13 definido por el usuario - `atributo14` string — Valor del atributo extendido 14 definido por el usuario - `atributo15` string — Valor del atributo extendido 15 definido por el usuario - `atributo16` string — Valor del atributo extendido 16 definido por el usuario - `atributo17` string — Valor del atributo extendido 17 definido por el usuario - `atributo18` string — Valor del atributo extendido 18 definido por el usuario - `atributo19` string — Valor del atributo extendido 19 definido por el usuario - `atributo20` string — Valor del atributo extendido 20 definido por el usuario - `atributo21` string — Valor del atributo extendido 21 definido por el usuario - `atributo22` string — Valor del atributo extendido 22 definido por el usuario - `atributo23` string — Valor del atributo extendido 23 definido por el usuario - `atributo24` string — Valor del atributo extendido 24 definido por el usuario - `atributo25` string — Valor del atributo extendido 25 definido por el usuario - `atributo26` string — Valor del atributo extendido 26 definido por el usuario - `atributo27` string — Valor del atributo extendido 27 definido por el usuario - `atributo28` string — Valor del atributo extendido 28 definido por el usuario - `atributo29` string — Valor del atributo extendido 29 definido por el usuario - `atributo30` string — Valor del atributo extendido 30 definido por el usuario - `atributo31` string — Valor del atributo extendido 31 definido por el usuario - `atributo32` string — Valor del atributo extendido 32 definido por el usuario - `atributo33` string — Valor del atributo extendido 33 definido por el usuario - `atributo34` string — Valor del atributo extendido 34 definido por el usuario - `atributo35` string — Valor del atributo extendido 35 definido por el usuario - `atributo36` string — Valor del atributo extendido 36 definido por el usuario - `atributo37` string — Valor del atributo extendido 37 definido por el usuario - `atributo38` string — Valor del atributo extendido 38 definido por el usuario - `atributo39` string — Valor del atributo extendido 39 definido por el usuario - `atributo40` string — Valor del atributo extendido 40 definido por el usuario - ItemDatosEntrada[] - `control` string, required — Identificador del lote de ítems a importar. Distingue mayúsculas y minúsculas. - `codigoItem` string, required — Código único del ítem definido por el usuario. - `descripcionCorta` string, required — Descripción corta o resumida del ítem, definida por el usuario. - `descripcionLarga` string — Descripción detallada del ítem. - `grupo` string, required — Código del grupo al que pertenece el ítem. Debe existir en la lista de grupos de ítems. - `tipoItem` string, required — Tipo del ítem. Determina clasificación y atributos del ítem. - `unidadPrimaria` string, required — Unidad de medida primaria (UMP) del ítem. - `unidadAlterna` string — Unidad de medida alterna (UMA) del ítem, si aplica. - `ean` string — Código EAN del ítem. Puede ser el mismo código del ítem, pero debe ser único. - `procedencia` 'N' | 'I' — Indica si el ítem es Nacional (N) o Importado (I). - `vendible` 'S' | 'N' — Indica si el ítem es vendible (S) o no vendible (N). - `conceptoCompra` string — Concepto de documento para compras. Debe existir en la lista de conceptos de compra. - `conceptoVenta` string — Concepto de documento para ventas. Obligatorio si el ítem es vendible. - `comprador` string — Código del comprador por defecto asociado al ítem. - `clasificacionABC` 'A' | 'B' | 'C' — Clasificación ABC del ítem (A, B o C). Por defecto 'C'. - `metodoCosto` 'P' | 'E', required — Método de valoración del ítem: P (Promedio) o E (Estándar). - `stockMaximo` number, double — Cantidad máxima permitida en inventario para el ítem, expresada en unidad primaria. - `nivelReorden` number, double — Cantidad mínima en inventario antes de requerir reposición. - `stockMinimo` number, double — Cantidad mínima en inventario permitida antes de quedar agotado. - `atributo1Tipo1` string — Valor del atributo 1 tipo 1, definido en la lista de valores de atributos. - `atributo2Tipo1` string — Valor del atributo 2 tipo 1, definido en la lista de valores de atributos. - `atributo3Tipo1` string — Valor del atributo 3 tipo 1, definido en la lista de valores de atributos. - `atributo4Tipo1` string — Valor del atributo 4 tipo 1, definido en la lista de valores de atributos. - `unidadVenta` string — Unidad de medida de venta (UMV) del ítem. - `consumoDirecto` 'NU' | 'MF' | 'PF' — Frecuencia de consumo directo del ítem: NU (Nunca), MF (Muy frecuente), PF (Poco frecuente). - `vidaUtil` integer — Vida útil del ítem en días. Solo aplica si el ítem maneja fecha de expiración. - `producido` 'S' | 'N' — Indica si el ítem es producido por la compañía (S/N). - `inspeccion` 'S' | 'N' — Indica si el ítem producido requiere inspección (S/N). - `direccionCalculo` 'UMP>UMA' | 'UMA>UMP' — Dirección del cálculo de conversión de unidades. - `conceptoVentaDevolucion` string — Concepto de documento asociado a la devolución en ventas. - `conceptoVentaContado` string — Concepto de documento asociado a las ventas de contado. - `leadTime` number, double — Tiempo en días que demora la compañía en producir el ítem. - `estado` 'AC' | 'IN' | 'OB' — Estado del ítem: AC (Activo), IN (Inactivo), OB (Obsoleto). - `comentario` string — Observaciones o notas asociadas al ítem, hasta 1024 caracteres. - `descripcionXl` string — Descripción extra larga del ítem, hasta 300 caracteres. - `leadTimePdn` number, double — Tiempo en días para producción (solo aplica si el ítem es producido). No permite negativos. - `cantidadBasePdn` number, double — Cantidad base asociada al lead time PDN (solo aplica si el ítem es producido). No permite negativos. - `loteMinimoPdn` number, double — Lote mínimo de producción (solo aplica si el ítem es producido). No permite negativos. - `conceptoDevolucionCompra` string — Concepto de documento para devolución en compra, debe existir en la lista de conceptos de compra. - `leadTimeCompra` number, double — Lead time del ítem en días para compras. No permite negativos. - `atributosExtendidos` AtributosExtendidosDatosEntrada — Atributos extendidos del lote (01 al 20). Cada campo tiene un máximo de 30 caracteres - `atributo01` string — Valor del atributo extendido 1 definido por el usuario - `atributo02` string — Valor del atributo extendido 2 definido por el usuario - `atributo03` string — Valor del atributo extendido 3 definido por el usuario - `atributo04` string — Valor del atributo extendido 4 definido por el usuario - `atributo05` string — Valor del atributo extendido 5 definido por el usuario - `atributo06` string — Valor del atributo extendido 6 definido por el usuario - `atributo07` string — Valor del atributo extendido 7 definido por el usuario - `atributo08` string — Valor del atributo extendido 8 definido por el usuario - `atributo09` string — Valor del atributo extendido 9 definido por el usuario - `atributo10` string — Valor del atributo extendido 10 definido por el usuario - `atributo11` string — Valor del atributo extendido 11 definido por el usuario - `atributo12` string — Valor del atributo extendido 12 definido por el usuario - `atributo13` string — Valor del atributo extendido 13 definido por el usuario - `atributo14` string — Valor del atributo extendido 14 definido por el usuario - `atributo15` string — Valor del atributo extendido 15 definido por el usuario - `atributo16` string — Valor del atributo extendido 16 definido por el usuario - `atributo17` string — Valor del atributo extendido 17 definido por el usuario - `atributo18` string — Valor del atributo extendido 18 definido por el usuario - `atributo19` string — Valor del atributo extendido 19 definido por el usuario - `atributo20` string — Valor del atributo extendido 20 definido por el usuario - `atributo21` string — Valor del atributo extendido 21 definido por el usuario - `atributo22` string — Valor del atributo extendido 22 definido por el usuario - `atributo23` string — Valor del atributo extendido 23 definido por el usuario - `atributo24` string — Valor del atributo extendido 24 definido por el usuario - `atributo25` string — Valor del atributo extendido 25 definido por el usuario - `atributo26` string — Valor del atributo extendido 26 definido por el usuario - `atributo27` string — Valor del atributo extendido 27 definido por el usuario - `atributo28` string — Valor del atributo extendido 28 definido por el usuario - `atributo29` string — Valor del atributo extendido 29 definido por el usuario - `atributo30` string — Valor del atributo extendido 30 definido por el usuario - `atributo31` string — Valor del atributo extendido 31 definido por el usuario - `atributo32` string — Valor del atributo extendido 32 definido por el usuario - `atributo33` string — Valor del atributo extendido 33 definido por el usuario - `atributo34` string — Valor del atributo extendido 34 definido por el usuario - `atributo35` string — Valor del atributo extendido 35 definido por el usuario - `atributo36` string — Valor del atributo extendido 36 definido por el usuario - `atributo37` string — Valor del atributo extendido 37 definido por el usuario - `atributo38` string — Valor del atributo extendido 38 definido por el usuario - `atributo39` string — Valor del atributo extendido 39 definido por el usuario - `atributo40` string — Valor del atributo extendido 40 definido por el usuario ## Response `201` Todos los ítems fueron procesados correctamente - RespuestaImportacion[] - `identificacion` string - `operacionExitosa` boolean - `mensaje` string ## Other responses - `400` — Error en la validación del body o uno o más ítems fallaron en la importación - `404` — Recurso no encontrado - `500` — Error interno inesperado en el servidor --- [API](https://skmtc.net/loggro/apis/documentos-electr-nicos.md) · [All operations](https://skmtc.net/loggro/apis/documentos-electr-nicos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loggro/documentos-electr-nicos/revisions/f390b90daf37/schema)