---
title: "Crear Entrada de Inventario por Orden de Compra"
method: POST
path: "/entradasOC"
tags: ["Inventarios"]
---

# Crear Entrada de Inventario por Orden de Compra

`POST /entradasOC`

## Request

- Base URL: `https://api.loggro.com/apik/loggro-enterprise`
- URL: `https://api.loggro.com/apik/loggro-enterprise/entradasOC`
- Auth: HTTP bearer

Permite registrar una entrada de inventario referenciando una orden de compra. El encabezado identifica el documento de entrada mediante tipoConsecutivo y consecutivo. Cada detalle debe referenciar la línea de la OC origen mediante tipoConsDocuOrigen, consecutivoDocuOrigen y lineaDocuOrigen. Se permite enviar **un único documento** o **varios en un array**. Si alguno falla, el sistema continúa con los demás e informa los errores individualmente.

## Request body

- union
  - object
    - `tipoConsecutivo` string, required: Tipo de consecutivo de la entrada por OC.
    - `consecutivo` string, required: Número consecutivo del documento de entrada.
    - `control` string, required: Control del documento de entrada.
    - `detalles` RecepcionDetalleOCEntradasDatosEntrada[], required: Lista de detalles de la entrada por orden de compra.
      - `codigoItem` string, required: Código del item.
      - `atributo1` string: Atributo 1 del item.
      - `atributo2` string: Atributo 2 del item.
      - `atributo3` string: Atributo 3 del item.
      - `atributo4` string: Atributo 4 del item.
      - `cantidadUMC` number, double, required: Cantidad en unidad de medida de compra.
      - `cantidadUMP` number, double, required: Cantidad total en UMP del item a recibir.
      - `cantidadUMA` number, double: Cantidad en UMA del item.
      - `lote` string: Lote al que pertenece el item. Obligatorio si el item es controlado por lotes.
      - `porcentajeDescuento` number, double: Porcentaje de descuento del detalle.
      - `valorTotal` number, double: Valor total del detalle.
      - `comentario` string: Comentario del detalle.
      - `localizacion` string: Localización del item.
      - `fechaExpiracionLote` string, dd/MM/yyyy: Fecha de expiración del lote (dd/MM/yyyy).
      - `fechaElaboracionLote` string, dd/MM/yyyy: Fecha de elaboración del lote (dd/MM/yyyy).
      - `fechaCompromisoEntrega` string, dd/MM/yyyy, required: Fecha de compromiso de entrega acordada en la OC (dd/MM/yyyy). Obligatoria.
      - `codigoEAN` string: Código EAN del item.
      - `tipoConsDocuOrigen` string, required: Tipo de consecutivo de la orden de compra origen.
      - `consecutivoDocuOrigen` string, required: Consecutivo de la orden de compra origen.
      - `lineaDocuOrigen` integer, required: Número de línea de la orden de compra origen.
  - RecepcionEntradasOCDatosEntrada[]
    - `tipoConsecutivo` string, required: Tipo de consecutivo de la entrada por OC.
    - `consecutivo` string, required: Número consecutivo del documento de entrada.
    - `control` string, required: Control del documento de entrada.
    - `detalles` RecepcionDetalleOCEntradasDatosEntrada[], required: Lista de detalles de la entrada por orden de compra.
      - `codigoItem` string, required: Código del item.
      - `atributo1` string: Atributo 1 del item.
      - `atributo2` string: Atributo 2 del item.
      - `atributo3` string: Atributo 3 del item.
      - `atributo4` string: Atributo 4 del item.
      - `cantidadUMC` number, double, required: Cantidad en unidad de medida de compra.
      - `cantidadUMP` number, double, required: Cantidad total en UMP del item a recibir.
      - `cantidadUMA` number, double: Cantidad en UMA del item.
      - `lote` string: Lote al que pertenece el item. Obligatorio si el item es controlado por lotes.
      - `porcentajeDescuento` number, double: Porcentaje de descuento del detalle.
      - `valorTotal` number, double: Valor total del detalle.
      - `comentario` string: Comentario del detalle.
      - `localizacion` string: Localización del item.
      - `fechaExpiracionLote` string, dd/MM/yyyy: Fecha de expiración del lote (dd/MM/yyyy).
      - `fechaElaboracionLote` string, dd/MM/yyyy: Fecha de elaboración del lote (dd/MM/yyyy).
      - `fechaCompromisoEntrega` string, dd/MM/yyyy, required: Fecha de compromiso de entrega acordada en la OC (dd/MM/yyyy). Obligatoria.
      - `codigoEAN` string: Código EAN del item.
      - `tipoConsDocuOrigen` string, required: Tipo de consecutivo de la orden de compra origen.
      - `consecutivoDocuOrigen` string, required: Consecutivo de la orden de compra origen.
      - `lineaDocuOrigen` integer, required: Número de línea de la orden de compra origen.

## Response `201`

Todos los detalles de la OC 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 detalles fallaron en la importación
- `404`: Recurso no encontrado
- `500`: Error interno inesperado en el servidor

---

[API](https://skmtc.dev/loggro/apis/enterprise-api-s.md) - [All operations](https://skmtc.dev/loggro/apis/enterprise-api-s/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/enterprise-api-s/revisions/933dac40ea9c?raw)