---
title: "List"
method: GET
path: "/purchase-orders"
tags: ["Ordenes de Compra"]
---

# List

`GET /purchase-orders`

Listar ordenes de compra

## Query parameters

- `offset` integer
- `limit` integer

## Headers

- `X-Company-Token` string, required

## Response `200`

Successful Response

- PurchaseOrderResource
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `total_pages` integer, required
  - `current_page` integer, required
  - `docs` PurchaseOrderOut[], required
    - `id` integer, required
    - `serie` string, nullable
    - `number` union
      - integer
      - string
    - `document_type_id` integer, nullable
    - `condicion_pago_id` integer, nullable
    - `proveedor_id` integer, nullable
    - `proveedor` object, nullable
    - `establecimiento_id` integer, nullable
    - `tipo_moneda_id` integer, nullable
    - `tasa_de_cambio` number, nullable
    - `fecha_emision` string, date, nullable
    - `fecha_entrega` string, date, nullable
    - `estado_doc` string, nullable
    - `estado_pago` string, nullable
    - `estado_entrega` string, nullable
    - `taxe` number, nullable
    - `total_gravado` number, nullable
    - `total_igv` number, nullable
    - `total_valor` number, nullable
    - `total` number, nullable
    - `total_descuento` number, nullable
    - `observations` string, nullable
    - `items` PurchaseOrderItemOut[], nullable
      - `id` integer, required
      - `item_id` integer, nullable
      - `quantity` number, required
      - `value` number, nullable
      - `unit_value` number, nullable
      - `price` number, nullable
      - `total` number, required
      - `total_value` number, nullable
      - `total_base_igv` number, nullable
      - `total_igv` number, nullable
      - `total_taxes` number, nullable
      - `total_discount` number, nullable
      - `price_with_taxes` boolean, nullable
      - `item` unknown
      - `taxe` unknown
      - `discount` unknown
    - `pagos` PaymentOut[], nullable
      - `id` integer, required
      - `fecha_emision` string, date, nullable, required — Fecha de emisión
      - `total` string, required
      - `estado` 'active' | 'partial_applied' | 'fully_applied' | 'voided', required
      - `tipo_pago` 'INGRESO' | 'EGRESO'
      - `condicion_pago_id` integer, nullable
      - `metodo_pago_id` integer, nullable
      - `moneda_id` integer, nullable, required
      - `tipo_cambio` string, nullable
      - `referencia` string, nullable
      - `observaciones` string, nullable
      - `serie` string, nullable
      - `numero` integer, nullable
      - `persona_id` integer, nullable
      - `persona` object, nullable
      - `cliente` object, nullable
      - `proveedor` object, nullable
      - `documento_relacionado` string, nullable
      - `adjunto` PaymentAttachmentOutOutput
        - `nombre` string, required
        - `url` string, required
        - `ruta` string, nullable
        - `tamano` integer, nullable
        - `content_type` string, nullable
        - `extension` string, nullable
      - `estado_constancia` 'por_confirmar' | 'confirmado' | 'rechazado' | 'anulado'
      - `items` PaymentItemOut[]
        - `id` integer, required
        - `payment_id` integer, required
        - `orden_compra_id` integer, nullable
        - `compra_id` integer, nullable
        - `venta_id` integer, nullable
        - `orden_id` integer, nullable
        - `payable_id` integer, nullable
        - `payable_type` string, nullable
        - `tipo` 'manual' | 'purchase_order_transfer' | 'purchase_transfer' | 'document_transfer', required
        - `total_a_pagar` string, required
        - `total_pagado` string, required
        - `estado` 'active' | 'partial_applied' | 'fully_applied' | 'voided', required
        - `nota` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/factpro/apis/note-service-api.md) · [All operations](https://skmtc.net/factpro/apis/note-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/factpro/note-service-api/revisions/d88e14b2de42/schema)