Saltar al contenido principal
GET

Listar ítems recibidos de pedido de compra

Scope:inventory:purchase-orders.read
https://api.holded.com/api/v2/purchase-orders/{purchaseOrderId}/received-items

Devuelve la lista de ítems recibidos asociados a un pedido de compra.

Parámetros

Parámetros de ruta

purchaseOrderIdstringobligatorio

ID del pedido de compra (ObjectId hexadecimal de 24 caracteres)

Petición

python
import requests

url = "https://api.holded.com/api/v2/purchase-orders/{purchaseOrderId}/received-items"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Respuestas

Respuesta

json
{
  "items": [
    {
      "sku": "SKU-001",
      "name": "Widget A",
      "total": 10,
      "received": 6,
      "pending": 4
    }
  ]
}

Respuestas exitosas

200Listado de ítems recibidosapplication/json
object
items[]object[]
skustringrequired

Stock Keeping Unit code

namestringrequired

Product name

totalnumberrequired

Total units ordered

receivednumberrequired

Units already received

pendingnumberrequired

Units pending receipt

Respuestas de error

401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
404Pedido de compra no encontradoapplication/json
429Límite de solicitudes excedidoapplication/json