---
title: "Crear orden de compra"
method: POST
path: "/ordenCompra"
tags: ["Inventarios"]
---

# Crear orden de compra

`POST /ordenCompra`

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