Órdenes de compra

Ver una orden de compra

Devuelve una orden con su proveedor, depósito, moneda, condición, líneas con lo recibido, retenido y pendiente, sus totales con el IVA informativo, sus recepciones y quién la emitió o cerró.

GET/api/v1/purchase-orders/get

Permiso: purchase-orders.view
Empresa: Opera sobre la empresa activa
Tipo: Lectura: no cambia nada
Respuesta: JSON

Encabezados

Cookietextorequerido
La cookie de sesión del usuario de la integración (__Secure-erp.session_token). Cuando esté la clave API, va en Authorization: Bearer. Ver Autenticación.
X-Expected-Companyuuidrequerido
La empresa sobre la que operás. Si no coincide con la de la credencial, responde 409. Ver Empresa activa.

Parámetros de la consulta

purchaseOrderIduuidrequerido

Respuesta

200 con este JSON.

iduuidrequerido
numbertextorequerido
statusopciónrequerido
Valores: draft issued closed discarded
orderTypeopciónrequerido
Valores: domestic import services
documentDatefecharequerido
expectedDatefecharequeridoadmite null
supplierobjetorequerido
Campos (4)
- iduuidrequerido
- codeenterorequerido
- legalNametextorequerido
- cuitcualquierarequerido
currencyCodetextorequerido
netTotaltextorequerido
receivingProgressopciónrequeridoadmite null
Valores: not-received partial received
invoicingProgressopciónrequeridoadmite null
Valores: not-invoiced partial invoiced
withDifferencessí o norequerido
versionenterorequerido
mínimo 1
warehouseobjetorequerido
Campos (4)
- iduuidrequerido
- codetextorequerido
- nametextorequerido
- statusopciónrequerido
  Valores: active inactive
agreedExchangeRatecualquierarequerido
paymentTermobjetorequeridoadmite null
Campos (3)
- iduuidrequerido
- nametextorequerido
- statusopciónrequerido
  Valores: active inactive
paymentPlanlista de objetorequeridoadmite null
Campos de cada elemento (2)
- percentnúmerorequerido
- dueDaysenterorequerido
paymentPlanTexttextorequerido
notescualquierarequerido
lineslista de objetorequerido
Campos de cada elemento (15)
- iduuidrequerido
- itemobjetorequerido
  Campos (7)
  - iduuidrequerido
  - codetextorequerido
  - nametextorequerido
  - statusopciónrequerido
    Valores: active inactive
  - unitCodetextorequerido
  - unitNametextorequerido
  - allowsDecimalssí o norequerido
- isImportedsí o norequerido
- supplierCodecualquierarequerido
- quantitynúmerorequerido
- unitPricecualquierarequerido
- priceSourceopciónrequerido
  Valores: supplier-item manual
- discountPercentnúmerorequerido
- netAmounttextorequerido
- vatRatecualquierarequerido
- receivedQuantitynúmerorequerido
- inReceiptQuantitynúmerorequerido
- pendingQuantitynúmerorequerido
- invoicedQuantitynúmerorequerido
- customsDeclarationslista de textorequerido
totalsobjetorequerido
Campos (3)
- nettextorequerido
- vatlista de objetorequerido
  Campos de cada elemento (3)
  - ratenúmerorequerido
  - basetextorequerido
  - amounttextorequerido
- totaltextorequerido
receiptslista de objetorequerido
Campos de cada elemento (6)
- iduuidrequerido
- numbertextorequerido
- receiptDatefecharequerido
- statusopciónrequerido
  Valores: draft closed discarded
- reversalopciónrequerido
  Valores: none partial total
- supplierDeliveryNotecualquierarequerido
invoiceslista de objetorequerido
Campos de cada elemento (5)
- iduuidrequerido
- numbertextorequerido
- labeltextorequerido
- totalcualquierarequerido
- currencyCodetextorequerido
createdAtfecha y horarequerido
createdByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
issuedAtfecha y horarequeridoadmite null
issuedByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
closedAtfecha y horarequeridoadmite null
closedByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
closeReasoncualquierarequerido
discardedAtfecha y horarequeridoadmite null
discardedByobjetorequeridoadmite null
Campos (2)
- idtextorequerido
- namecualquierarequerido
discardReasoncualquierarequerido

Errores

Un rechazo responde application/problem+json con un code estable. Los más comunes en esta operación:

`401`	Falta la credencial o venció.
`403`	La credencial no tiene el permiso `purchase-orders.view`.
`409`	La empresa activa no es la de `X-Expected-Company`.
`422`	Datos inválidos o una regla de negocio rota, con el detalle por campo.
`503`	Sistema ocupado: reintentá después de `Retry-After` segundos.

La lista completa está en Errores.

curl
TypeScript

curl "$ERP_URL/api/v1/purchase-orders/get?purchaseOrderId=3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA"

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/purchase-orders/get?purchaseOrderId=3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90`, {
  headers: {
    Cookie: process.env.ERP_SESION!,
    "X-Expected-Company": process.env.ERP_EMPRESA!,
  },
});
if (!respuesta.ok) throw new Error((await respuesta.json()).title);
const datos = await respuesta.json();

{
  "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "number": "texto",
  "status": "draft",
  "orderType": "domestic",
  "documentDate": "2026-10-23",
  "expectedDate": "2026-10-23",
  "supplier": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "code": 1,
    "legalName": "texto",
    "cuit": null
  },
  "currencyCode": "texto",
  "netTotal": "texto",
  "receivingProgress": "not-received",
  "invoicingProgress": "not-invoiced",
  "withDifferences": false,
  "version": 1,
  "warehouse": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "code": "texto",
    "name": "texto",
    "status": "active"
  },
  "agreedExchangeRate": null,
  "paymentTerm": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "name": "texto",
    "status": "active"
  },
  "paymentPlan": [
    {
      "percent": 100,
      "dueDays": 1
    }
  ],
  "paymentPlanText": "texto",
  "notes": null,
  "lines": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "item": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": "texto",
        "name": "texto",
        "status": "active",
        "unitCode": "texto",
        "unitName": "texto",
        "allowsDecimals": false
      },
      "isImported": false,
      "supplierCode": null,
      "quantity": 100,
      "unitPrice": null,
      "priceSource": "supplier-item",
      "discountPercent": 100,
      "netAmount": "texto",
      "vatRate": null,
      "receivedQuantity": 100,
      "inReceiptQuantity": 100,
      "pendingQuantity": 100,
      "invoicedQuantity": 100,
      "customsDeclarations": [
        "texto"
      ]
    }
  ],
  "totals": {
    "net": "texto",
    "vat": [
      {
        "rate": 100,
        "base": "texto",
        "amount": "texto"
      }
    ],
    "total": "texto"
  },
  "receipts": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "number": "texto",
      "receiptDate": "2026-10-23",
      "status": "draft",
      "reversal": "none",
      "supplierDeliveryNote": null
    }
  ],
  "invoices": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "number": "texto",
      "label": "texto",
      "total": null,
      "currencyCode": "texto"
    }
  ],
  "createdAt": "2026-10-23T14:30:00.000Z",
  "createdBy": {
    "id": "texto",
    "name": null
  },
  "issuedAt": "2026-10-23T14:30:00.000Z",
  "issuedBy": {
    "id": "texto",
    "name": null
  },
  "closedAt": "2026-10-23T14:30:00.000Z",
  "closedBy": {
    "id": "texto",
    "name": null
  },
  "closeReason": null,
  "discardedAt": "2026-10-23T14:30:00.000Z",
  "discardedBy": {
    "id": "texto",
    "name": null
  },
  "discardReason": null
}