---
title: "Crear Orden de Compra"
method: POST
path: "/ordenCompra"
tags: ["Inventarios"]
---

# Crear Orden de Compra

`POST /ordenCompra`

## Request

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

Recibe uno o varios documentos de orden de compra para su importación al ERP. 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: Identificador del lote de importación.
    - `tipoConsecutivo` string, required: Tipo de consecutivo de la orden de compra.
    - `consecutivo` string, required: Número consecutivo de la orden de compra.
    - `tipoDocumento` string: Tipo de documento. Obligatorio para ingreso.
    - `proveedor` string, required: Código del proveedor. Obligatorio para ingreso.
    - `establecimiento` string, required: Establecimiento del proveedor. Obligatorio para ingreso.
    - `bodega` string, required: Bodega asociada a la orden. Obligatorio para ingreso.
    - `comprador` string: Código del comprador.
    - `formaPago` string: **Código de la forma de pago del proveedor.** Si no se informa, se hereda del proveedor. Este valor puede ser consultado en el endpoint → [/consultarFormaPago](https://developer.loggro.com/reference/consultarFormaPago#/)
    - `monedaNegociacion` string: Moneda de negociación. Si no se informa, se hereda del proveedor.
    - `tasaCambio` number, double: Tasa de cambio. Si la moneda es local, se asigna 1.000.
    - `porcDescPiePagina` number, double: Porcentaje de descuento pié de página.
    - `fob` 'OR' | 'DE' | 'NA': Condición de entrega. OR: Origen, DE: Destino, NA: No aplica.
    - `comentarioLargo` string: Comentario largo de la orden.
    - `fechaRequerida` string, dd/MM/yyyy: Fecha requerida de entrega (dd/MM/yyyy).
    - `fechaCompromiso` string, dd/MM/yyyy: Fecha compromiso de entrega (dd/MM/yyyy).
    - `razonCierre` string: Razón de cierre de la orden.
    - `detallesOrden` RecepcionDetalleOrdenCompraDatosEntrada[], required
      - `codigoItem` string, required: Código del ítem a ordenar.
      - `atributo1` string: Atributo 1 del ítem (obligatoriedad depende del ítem).
      - `atributo2` string: Atributo 2 del ítem.
      - `atributo3` string: Atributo 3 del ítem.
      - `atributo4` string: Atributo 4 del ítem.
      - `lote` string: Lote que maneja el ítem.
      - `umc` string: Unidad de medida de compra.
      - `cantidadPedido` number, double: Cantidad pedida en UMC.
      - `valorUnitario` number, double: Precio unitario del ítem.
      - `porcDescuento` number, double: Porcentaje de descuento por artículo.
      - `fechaRequerida` string: Fecha requerida del detalle (dd/MM/yyyy). Si no se informa, hereda del encabezado.
      - `fechaCompromiso` string: Fecha compromiso del detalle (dd/MM/yyyy). Si no se informa, hereda del encabezado.
      - `comentario` string: Observaciones del detalle.
      - `consumoDirecto` 'S' | 'N': Indica si el ítem permite consumo directo.
      - `divisionContable` string: División contable del detalle.
      - `centro` string: Centro de costo asociado al detalle.
      - `concepto` string: Concepto contable del detalle.
      - `estado` string: Estado del detalle. CE: cierre.
  - RecepcionOrdenCompraDatosEntrada[]
    - `control` string, required: Identificador del lote de importación.
    - `tipoConsecutivo` string, required: Tipo de consecutivo de la orden de compra.
    - `consecutivo` string, required: Número consecutivo de la orden de compra.
    - `tipoDocumento` string: Tipo de documento. Obligatorio para ingreso.
    - `proveedor` string, required: Código del proveedor. Obligatorio para ingreso.
    - `establecimiento` string, required: Establecimiento del proveedor. Obligatorio para ingreso.
    - `bodega` string, required: Bodega asociada a la orden. Obligatorio para ingreso.
    - `comprador` string: Código del comprador.
    - `formaPago` string: **Código de la forma de pago del proveedor.** Si no se informa, se hereda del proveedor. Este valor puede ser consultado en el endpoint → [/consultarFormaPago](https://developer.loggro.com/reference/consultarFormaPago#/)
    - `monedaNegociacion` string: Moneda de negociación. Si no se informa, se hereda del proveedor.
    - `tasaCambio` number, double: Tasa de cambio. Si la moneda es local, se asigna 1.000.
    - `porcDescPiePagina` number, double: Porcentaje de descuento pié de página.
    - `fob` 'OR' | 'DE' | 'NA': Condición de entrega. OR: Origen, DE: Destino, NA: No aplica.
    - `comentarioLargo` string: Comentario largo de la orden.
    - `fechaRequerida` string, dd/MM/yyyy: Fecha requerida de entrega (dd/MM/yyyy).
    - `fechaCompromiso` string, dd/MM/yyyy: Fecha compromiso de entrega (dd/MM/yyyy).
    - `razonCierre` string: Razón de cierre de la orden.
    - `detallesOrden` RecepcionDetalleOrdenCompraDatosEntrada[], required
      - `codigoItem` string, required: Código del ítem a ordenar.
      - `atributo1` string: Atributo 1 del ítem (obligatoriedad depende del ítem).
      - `atributo2` string: Atributo 2 del ítem.
      - `atributo3` string: Atributo 3 del ítem.
      - `atributo4` string: Atributo 4 del ítem.
      - `lote` string: Lote que maneja el ítem.
      - `umc` string: Unidad de medida de compra.
      - `cantidadPedido` number, double: Cantidad pedida en UMC.
      - `valorUnitario` number, double: Precio unitario del ítem.
      - `porcDescuento` number, double: Porcentaje de descuento por artículo.
      - `fechaRequerida` string: Fecha requerida del detalle (dd/MM/yyyy). Si no se informa, hereda del encabezado.
      - `fechaCompromiso` string: Fecha compromiso del detalle (dd/MM/yyyy). Si no se informa, hereda del encabezado.
      - `comentario` string: Observaciones del detalle.
      - `consumoDirecto` 'S' | 'N': Indica si el ítem permite consumo directo.
      - `divisionContable` string: División contable del detalle.
      - `centro` string: Centro de costo asociado al detalle.
      - `concepto` string: Concepto contable del detalle.
      - `estado` string: Estado del detalle. CE: cierre.

## Response `201`

Todas las órdenes fueron creadas correctamente

- RespuestaImportacion[]
  - `identificacion` string
  - `operacionExitosa` boolean
  - `mensaje` string

## Other responses

- `400`: Error en validación o al menos una orden falló
- `404`: Not Found
- `500`: Error interno inesperado

---

[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)