---
title: "Crear Entrada por Devolución de Consumo"
method: POST
path: "/entradaDevolucionConsumo"
tags: ["Inventarios"]
---

# Crear Entrada por Devolución de Consumo

`POST /entradaDevolucionConsumo`

## Request

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

Permite agregar una o varias registros de devolución de consumo a un documento ya existente. El encabezado (control, tipoConsecutivo, consecutivo) identifica el documento. Los campos 'tipoConsDocuOrigen', 'consecutivoDocuOrigen' y 'lineaDocuOrigen' son obligatorios en cada detalle, pues identifican la línea del documento de consumo origen de la devolución. 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
    - `control` string, required: Control del documento de devolución de consumo.
    - `tipoConsecutivo` string, required: Tipo de consecutivo del documento de devolución de consumo.
    - `consecutivo` string, required: Número consecutivo del documento de devolución de consumo.
    - `detalles` RecepcionDetalleDevolucionConsumoDatosEntrada[], required: Lista de detalles de la devolución de consumo.
      - `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: Cantidad en unidad de medida de compra.
      - `cantidadUMP` number, double, required: Cantidad total en UMP del item a devolver.
      - `cantidadUMA` number, double: Cantidad en UMA del item.
      - `lote` string: Lote al que pertenece el item. Obligatorio si el item es controlado por lotes.
      - `comentario` string: Comentario del detalle.
      - `localizacion` string: Localización del item. Obligatorio si el item es controlado por lotes.
      - `fechaExpiracionLote` string: Fecha de expiración del lote (dd/MM/yyyy).
      - `fechaElaboracionLote` string: Fecha de elaboración del lote (dd/MM/yyyy). Obligatorio si el lote maneja fecha de elaboración.
      - `tipoConsDocuOrigen` string, required: Tipo de consecutivo del documento de consumo origen de la devolución.
      - `consecutivoDocuOrigen` string, required: Consecutivo del documento de consumo origen de la devolución.
      - `lineaDocuOrigen` integer, required: Número de línea del documento de consumo origen de la devolución.
      - `series` RecepcionSeriesEntradasCostoDatosEntrada[]: Lista de series del item en el detalle.
        - `serie1` string, required: Número de serie 1 del item. Debe ser único, no puede existir en el sistema
        - `serie2` string: Número de serie 2. Obligatorio si el item maneja 2 o más series
        - `serie3` string: Número de serie 3. Obligatorio si el item maneja 3 o más series
        - `serie4` string: Número de serie 4. Obligatorio si el item maneja 4 series
        - `estado` string: Estado de la serie: AC (Activo), IN (Inactivo), OB (Obsoleto). Por defecto AC
  - RecepcionEntradaDevolucionConsumoDatosEntrada[]
    - `control` string, required: Control del documento de devolución de consumo.
    - `tipoConsecutivo` string, required: Tipo de consecutivo del documento de devolución de consumo.
    - `consecutivo` string, required: Número consecutivo del documento de devolución de consumo.
    - `detalles` RecepcionDetalleDevolucionConsumoDatosEntrada[], required: Lista de detalles de la devolución de consumo.
      - `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: Cantidad en unidad de medida de compra.
      - `cantidadUMP` number, double, required: Cantidad total en UMP del item a devolver.
      - `cantidadUMA` number, double: Cantidad en UMA del item.
      - `lote` string: Lote al que pertenece el item. Obligatorio si el item es controlado por lotes.
      - `comentario` string: Comentario del detalle.
      - `localizacion` string: Localización del item. Obligatorio si el item es controlado por lotes.
      - `fechaExpiracionLote` string: Fecha de expiración del lote (dd/MM/yyyy).
      - `fechaElaboracionLote` string: Fecha de elaboración del lote (dd/MM/yyyy). Obligatorio si el lote maneja fecha de elaboración.
      - `tipoConsDocuOrigen` string, required: Tipo de consecutivo del documento de consumo origen de la devolución.
      - `consecutivoDocuOrigen` string, required: Consecutivo del documento de consumo origen de la devolución.
      - `lineaDocuOrigen` integer, required: Número de línea del documento de consumo origen de la devolución.
      - `series` RecepcionSeriesEntradasCostoDatosEntrada[]: Lista de series del item en el detalle.
        - `serie1` string, required: Número de serie 1 del item. Debe ser único, no puede existir en el sistema
        - `serie2` string: Número de serie 2. Obligatorio si el item maneja 2 o más series
        - `serie3` string: Número de serie 3. Obligatorio si el item maneja 3 o más series
        - `serie4` string: Número de serie 4. Obligatorio si el item maneja 4 series
        - `estado` string: Estado de la serie: AC (Activo), IN (Inactivo), OB (Obsoleto). Por defecto AC

## Response `201`

Todos los detalles de la devolución de consumo 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)