---
title: "Crear Despacho"
method: POST
path: "/despachos"
tags: ["Inventarios"]
---

# Crear Despacho

`POST /despachos`

## Request

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

Permite registrar uno o varios despachos de inventario en el sistema. Cada petición puede contener múltiples despachos, y cada registro será validado individualmente. Cada detalle debe informar los campos de relación 'tipoConsRelacionado', 'consecutivoRelacionado' y 'lineaDocuRelacionado', obligatorios para despachos. El servicio retorna el resultado de la importación con el detalle de las operaciones exitosas y fallidas.

## Request body

- union
  - object: Datos de entrada para la importación de despachos.
    - `control` string, required: Número único que identifica el documento en el proceso
    - `tipoConsecutivo` string, required: Tipo de consecutivo asociado al despacho
    - `consecutivo` string, required: Número consecutivo del documento
    - `division` string, required: Código de la división
    - `tipoDocumento` string, required: Tipo de documento del despacho
    - `bodega` string, required: Código de la bodega del proceso
    - `comentario` string: Comentario del documento
    - `detalles` RecepcionDetalleDespachoDatosEntrada[], required: Lista de detalles del despacho
      - `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
      - `cantidadUMP` number, double, required: Cantidad total en UMP del item a despachar
      - `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, 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). Obligatorio si el lote maneja fecha de elaboración
      - `tipoConsRelacionado` string, required: Tipo de consecutivo del documento relacionado. Obligatorio para despachos
      - `consecutivoRelacionado` string, required: Consecutivo del documento relacionado. Obligatorio para despachos
      - `lineaDocuRelacionado` integer, required: Número de línea del documento relacionado. Obligatorio para despachos
      - `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
  - RecepcionDespachoDatosEntrada[]
    - `control` string, required: Número único que identifica el documento en el proceso
    - `tipoConsecutivo` string, required: Tipo de consecutivo asociado al despacho
    - `consecutivo` string, required: Número consecutivo del documento
    - `division` string, required: Código de la división
    - `tipoDocumento` string, required: Tipo de documento del despacho
    - `bodega` string, required: Código de la bodega del proceso
    - `comentario` string: Comentario del documento
    - `detalles` RecepcionDetalleDespachoDatosEntrada[], required: Lista de detalles del despacho
      - `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
      - `cantidadUMP` number, double, required: Cantidad total en UMP del item a despachar
      - `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, 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). Obligatorio si el lote maneja fecha de elaboración
      - `tipoConsRelacionado` string, required: Tipo de consecutivo del documento relacionado. Obligatorio para despachos
      - `consecutivoRelacionado` string, required: Consecutivo del documento relacionado. Obligatorio para despachos
      - `lineaDocuRelacionado` integer, required: Número de línea del documento relacionado. Obligatorio para despachos
      - `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 despachos 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 despachos 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)