---
title: "Crear Pedido"
method: POST
path: "/pedidos"
tags: ["Inventarios"]
---

# Crear Pedido

`POST /pedidos`

Permite registrar uno o varios pedidos (comerciales o de consumo) en el sistema. Cada petición puede contener múltiples pedidos, 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 importación
    - `tipoDocumento` string, required — Clase de documento: PEVE (pedido venta) o PECO (pedido consumo)
    - `tipoConsecutivo` string, required — Tipo de consecutivo asociado al tipo de documento
    - `consecutivo` string, required — Número consecutivo del pedido
    - `fechaElaboracion` string, dd/MM/yyyy, required — Fecha de elaboración del pedido (formato dd/MM/yyyy)
    - `bodega` string, required — Código de bodega; de la bodega se hereda la división para el pedido
    - `ordenCompra` string — Orden de compra (opcional)
    - `fechaOrdenCompra` string, dd/MM/yyyy — Fecha de la orden de compra (formato dd/MM/yyyy)
    - `centroCostos` string — Centro de costos (se hereda de la bodega informada; si la bodega no tiene centro de costos asociado este se exige)
    - `cliente` string — Código del cliente (obligatorio en transacción manual si el ítem es vendible)
    - `establecimiento` string — Código del establecimiento (obligatorio en transacción manual si el ítem es vendible)
    - `vendedor` string — Código del vendedor (obligatorio si la compañía maneja vendedores)
    - `moneda` string — Código de moneda de negocio
    - `tasaCambio` number, double — Tasa de cambio (requerida si el pedido es en moneda extranjera y no se envía la tasa)
    - `formaPago` string — **Código de la forma de pago del cliente.** Se hereda de cliente-establecimiento si no se informa. Este valor puede ser consultado en el endpoint → [/consultarFormaPago](https://developer.loggro.com/reference/consultarFormaPago#/)
    - `listaPrecio` string — Lista de precio (se hereda de cliente-establecimiento si no se informa)
    - `descuentoPiePagina` number, double — Porcentaje de descuento pie de página (se hereda de cliente-establecimiento si no se informa)
    - `comentario` string — Comentario adicional del pedido
    - `fechaPrecioDescuento` string, dd/MM/yyyy — Fecha precio/descuento (formato dd/MM/yyyy); se hereda la fecha de la orden de compra en caso de existir, si no existe se toma la fecha de elaboración+1
    - `fechaRequerida` string, dd/MM/yyyy — Fecha requerida del pedido; si no se informa se toma la fecha de elaboración +1, debe ser mayor o igual que la fecha del sistema (formato dd/MM/yyyy)
    - `fechaMasTempDespacho` string, dd/MM/yyyy — Fecha más temprana de despacho (formato dd/MM/yyyy); si no se informa se toma la misma fecha requerida
    - `conceptoOrigen` string — Concepto origen (se asigna 0 si no se informa en pedido comercial; opcional en pedido de consumo)
    - `divisionDestino` string — División destino (si no se informa se hereda la división de la bodega)
    - `centroDestino` string — Centro de costos destino (se hereda de la bodega informada; si la bodega no tiene centro de costos asociado este se exige)
    - `conceptoDestino` string — Concepto destino (si no se informa se asigna el concepto origen)
    - `monedaFacturacion` string — Moneda de facturación del pedido; si no se envía se asigna la moneda del pedido comercial
    - `incoterms` string — Código de incoterms; solo se utiliza cuando es factura extranjera, de lo contrario no se libera el pedido
    - `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
    - `detalles` RecepcionDetallePedidosDatosEntrada[], required — Lista de detalles del pedido
      - `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
      - `cantidadPedidaUMP` number, double — Cantidad pedida en UMP; en pedido comercial puede informarse la UMV en lugar de la UMP
      - `fechaRequerida` string, dd/MM/yyyy — Fecha requerida del detalle (formato dd/MM/yyyy); si no se informa se asigna la fecha requerida del encabezado
      - `precioUnitario` number, double — Precio unitario; si no se informa se hereda, para ello ver transacción manual (obligatorio en pedido comercial)
      - `descuentoArticulo` number, double — Porcentaje de descuento por artículo (se hereda el % de descuento asociado a la lista de descuento asociada al cliente-establecimiento)
      - `lineaImpuesto` string — Línea de impuesto; si no se informa este dato y el ítem es vendible se hereda la línea de impuesto asociada al concepto de documento de venta
      - `establecimiento` string — Despachar a establecimiento; si no se informa se hereda el establecimiento del encabezado (obligatorio en pedido comercial)
      - `observaciones` string — Observaciones del detalle
      - `fechaMasTempDespacho` string, dd/MM/yyyy — Fecha más temprana de despacho del detalle (formato dd/MM/yyyy); si no se informa se toma la fecha más temprana despacho del encabezado
      - `codigoUMV` string — Código unidad de medida de venta UMV (opcional en pedido comercial)
      - `cantidadPedidaUMV` number, double — Cantidad pedida en UMV (opcional en pedido comercial)
      - `direccionDespacho` string — Código de dirección de despacho; debe estar definido para el cliente y el despachar a del detalle
      - `divisionDestino` string — División destino del detalle; si no se informa se hereda la división destino del encabezado
      - `centroDestino` string — Centro de costos destino del detalle; si no se informa se hereda el centro destino del encabezado
      - `conceptoDestino` string — Concepto destino del detalle; si no se informa se hereda el concepto destino del encabezado
      - `agrupador` string — Agrupador de ítems para venta en pedido comercial (opcional)
      - `cantidadAgrupacion` number, double — Cantidad de agrupación; si se informa agrupador debe diligenciarse mayor a cero en pedido comercial
  - RecepcionPedidosDatosEntrada[]
    - `control` string, required — Identificador del lote de importación
    - `tipoDocumento` string, required — Clase de documento: PEVE (pedido venta) o PECO (pedido consumo)
    - `tipoConsecutivo` string, required — Tipo de consecutivo asociado al tipo de documento
    - `consecutivo` string, required — Número consecutivo del pedido
    - `fechaElaboracion` string, dd/MM/yyyy, required — Fecha de elaboración del pedido (formato dd/MM/yyyy)
    - `bodega` string, required — Código de bodega; de la bodega se hereda la división para el pedido
    - `ordenCompra` string — Orden de compra (opcional)
    - `fechaOrdenCompra` string, dd/MM/yyyy — Fecha de la orden de compra (formato dd/MM/yyyy)
    - `centroCostos` string — Centro de costos (se hereda de la bodega informada; si la bodega no tiene centro de costos asociado este se exige)
    - `cliente` string — Código del cliente (obligatorio en transacción manual si el ítem es vendible)
    - `establecimiento` string — Código del establecimiento (obligatorio en transacción manual si el ítem es vendible)
    - `vendedor` string — Código del vendedor (obligatorio si la compañía maneja vendedores)
    - `moneda` string — Código de moneda de negocio
    - `tasaCambio` number, double — Tasa de cambio (requerida si el pedido es en moneda extranjera y no se envía la tasa)
    - `formaPago` string — **Código de la forma de pago del cliente.** Se hereda de cliente-establecimiento si no se informa. Este valor puede ser consultado en el endpoint → [/consultarFormaPago](https://developer.loggro.com/reference/consultarFormaPago#/)
    - `listaPrecio` string — Lista de precio (se hereda de cliente-establecimiento si no se informa)
    - `descuentoPiePagina` number, double — Porcentaje de descuento pie de página (se hereda de cliente-establecimiento si no se informa)
    - `comentario` string — Comentario adicional del pedido
    - `fechaPrecioDescuento` string, dd/MM/yyyy — Fecha precio/descuento (formato dd/MM/yyyy); se hereda la fecha de la orden de compra en caso de existir, si no existe se toma la fecha de elaboración+1
    - `fechaRequerida` string, dd/MM/yyyy — Fecha requerida del pedido; si no se informa se toma la fecha de elaboración +1, debe ser mayor o igual que la fecha del sistema (formato dd/MM/yyyy)
    - `fechaMasTempDespacho` string, dd/MM/yyyy — Fecha más temprana de despacho (formato dd/MM/yyyy); si no se informa se toma la misma fecha requerida
    - `conceptoOrigen` string — Concepto origen (se asigna 0 si no se informa en pedido comercial; opcional en pedido de consumo)
    - `divisionDestino` string — División destino (si no se informa se hereda la división de la bodega)
    - `centroDestino` string — Centro de costos destino (se hereda de la bodega informada; si la bodega no tiene centro de costos asociado este se exige)
    - `conceptoDestino` string — Concepto destino (si no se informa se asigna el concepto origen)
    - `monedaFacturacion` string — Moneda de facturación del pedido; si no se envía se asigna la moneda del pedido comercial
    - `incoterms` string — Código de incoterms; solo se utiliza cuando es factura extranjera, de lo contrario no se libera el pedido
    - `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
    - `detalles` RecepcionDetallePedidosDatosEntrada[], required — Lista de detalles del pedido
      - `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
      - `cantidadPedidaUMP` number, double — Cantidad pedida en UMP; en pedido comercial puede informarse la UMV en lugar de la UMP
      - `fechaRequerida` string, dd/MM/yyyy — Fecha requerida del detalle (formato dd/MM/yyyy); si no se informa se asigna la fecha requerida del encabezado
      - `precioUnitario` number, double — Precio unitario; si no se informa se hereda, para ello ver transacción manual (obligatorio en pedido comercial)
      - `descuentoArticulo` number, double — Porcentaje de descuento por artículo (se hereda el % de descuento asociado a la lista de descuento asociada al cliente-establecimiento)
      - `lineaImpuesto` string — Línea de impuesto; si no se informa este dato y el ítem es vendible se hereda la línea de impuesto asociada al concepto de documento de venta
      - `establecimiento` string — Despachar a establecimiento; si no se informa se hereda el establecimiento del encabezado (obligatorio en pedido comercial)
      - `observaciones` string — Observaciones del detalle
      - `fechaMasTempDespacho` string, dd/MM/yyyy — Fecha más temprana de despacho del detalle (formato dd/MM/yyyy); si no se informa se toma la fecha más temprana despacho del encabezado
      - `codigoUMV` string — Código unidad de medida de venta UMV (opcional en pedido comercial)
      - `cantidadPedidaUMV` number, double — Cantidad pedida en UMV (opcional en pedido comercial)
      - `direccionDespacho` string — Código de dirección de despacho; debe estar definido para el cliente y el despachar a del detalle
      - `divisionDestino` string — División destino del detalle; si no se informa se hereda la división destino del encabezado
      - `centroDestino` string — Centro de costos destino del detalle; si no se informa se hereda el centro destino del encabezado
      - `conceptoDestino` string — Concepto destino del detalle; si no se informa se hereda el concepto destino del encabezado
      - `agrupador` string — Agrupador de ítems para venta en pedido comercial (opcional)
      - `cantidadAgrupacion` number, double — Cantidad de agrupación; si se informa agrupador debe diligenciarse mayor a cero en pedido comercial

## Response `201`

Todos los pedidos 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 pedidos 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)