---
title: "Facturar órdenes de compra o guías"
method: POST
path: "/admin/inventory/stores/{storeId}/purchases/from-documents"
---

# Facturar órdenes de compra o guías

`POST /admin/inventory/stores/{storeId}/purchases/from-documents`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/admin/inventory/stores/{storeId}/purchases/from-documents`
- Auth: none declared

Crea una compra a partir de documentos del mismo local, proveedor y tipo. Requiere órdenes aprobadas o guías disponibles; rechaza documentos ya facturados o con ítems adicionales. Marca los documentos como facturados y conserva la lógica que evita volver a ingresar el stock de guías. Si se informa paidAt, registra el pago contable. Requiere autorización admin y un usuario conectado; un token de integración sin usuario responde userRequired. Se aplican los mismos permisos y validaciones del formulario de inventario.

## Path parameters

- `storeId` string, required

## Request body

- ApiInventoryPurchaseFromDocumentsInput
  - `inventoryTaxDocumentIds` string[], nullable, required: IDs de órdenes aprobadas o guías del mismo proveedor y tipo, sin ítems adicionales ni facturación previa.
  - `externalId` string, nullable, required: Número de la factura que se registra.
  - `date` string, date-time, nullable, required: Fecha de emisión de la factura.
  - `dueDate` string, date-time, nullable: Fecha de vencimiento.
  - `paidAt` string, date-time, nullable: Fecha de pago; si se envía también se registra el pago contable.
  - `comments` string, nullable: Comentarios de la compra.
  - `invoiceFiles` object[]: Archivos previamente cargados, en el mismo formato que el formulario de Tabs.
    - `_id` string, nullable: ID del archivo previamente cargado en Tabs.
    - `name` string, nullable: Nombre del archivo.
    - `type` string, nullable: Tipo MIME del archivo.
    - `size` number, nullable: Tamaño en bytes.
    - `status` string, nullable: Estado del archivo devuelto por la carga.
    - `key` string, nullable: Clave de almacenamiento devuelta por la carga.
    - `bucket` string, nullable: Bucket de almacenamiento devuelto por la carga.
    - `hash` string, nullable: Huella del archivo devuelta por la carga.
    - `externalUrl` string, nullable: URL externa del archivo, si corresponde.
    - `createdBy` string, nullable: Usuario que cargó el archivo.
    - `createdAt` string, date-time, nullable: Fecha de carga.
    - `dimensions` object: Dimensiones de una imagen cargada.
      - `width` number, nullable: Ancho en píxeles.
      - `height` number, nullable: Alto en píxeles.
    - `colorsData` object: Colores de la imagen devueltos por la carga.
      - `background` string, nullable: Color de fondo.
      - `front` string, nullable: Color de primer plano.
      - `blurhash` string, nullable: Representación desenfocada de la imagen.
    - `resizedData` object: Variantes de imagen devueltas por la carga.
      - `extraLargeURL` string, nullable: URL de la variante de imagen generada durante la carga.
      - `largeURL` string, nullable: URL de la variante de imagen generada durante la carga.
      - `mediumURL` string, nullable: URL de la variante de imagen generada durante la carga.
      - `smallURL` string, nullable: URL de la variante de imagen generada durante la carga.
      - `thumbnailURL` string, nullable: URL de la variante de imagen generada durante la carga.

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` object: Registro de inventario con los campos de su operación, como estado, ingredientes, cantidades y costos. Las fechas se devuelven en el formato del servicio Tabs.
    - `_id` string: ID del registro creado, consultado o actualizado.
    - `websiteId` string: Marca propietaria del registro.
    - `storeId` string: Local propietario, para operaciones por local.

## Other responses

- `400`: Errors

## Changes

- **2026-10-31** `4ad06bd631ce`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/admin/inventory/stores/:storeId/purchases/from-documents/post.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)