Saltar al contenido principal
PUT

Actualizar un albarán de compra

Scope:inventory:purchase-shipments.write
https://api.holded.com/api/v2/purchase-shipments/{purchaseShipmentId}

Actualiza un albarán de compra existente. Solo los campos incluidos en el cuerpo se modifican.

Parámetros

Parámetros de ruta

purchaseShipmentIdstringobligatorio

ID del albarán de compra (ObjectId hexadecimal de 24 caracteres)

Cuerpo de la petición

object
numberstring | null

Número de documento personalizado (por ejemplo, la referencia de factura del proveedor)

datestring<date>

Fecha de emisión en formato ISO 8601

due_datestring<date> | null

Fecha de vencimiento en formato ISO 8601

items[]object[]

Líneas del documento

namestring

Nombre de la línea

typestring | null

Tipo de línea (product, service o title)

Enum:productshippingtitleroundingrefundecotaxwrappingservice
descriptionstring | null

Descripción de la línea

product_idstring | null

Identificador del producto vinculado

variant_idstring | null

Identificador de la variante del producto vinculado. Requiere product_id

unitsnumber | null

Cantidad de unidades

pricenumber | null

Precio unitario

discountnumber | null

Porcentaje de descuento aplicado a esta línea

taxes[]string[] | null

Lista de identificadores de impuesto a aplicar

skustring | null

Referencia SKU del producto en esta línea

accountstring | null

Código de cuenta contable de la línea

project_idstring | null

Identificador del proyecto vinculado a esta línea

unit_typestring | null

Unidad de medida de la línea (ej. kg, units, litros)

suppliedboolean | null

Si es true, la línea es un suplido (gasto pagado en nombre del cliente, excluido de la base imponible)

Petición

python
import requests

url = "https://api.holded.com/api/v2/purchase-shipments/{purchaseShipmentId}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "number": "string",
    "date": "2026-01-15",
    "due_date": "2026-01-31",
    "items": [
        {
            "name": "string",
            "type": "product",
            "description": "string",
            "product_id": "string",
            "variant_id": "string",
            "units": 0,
            "price": 0,
            "discount": 0,
            "taxes": [
                "s_iva_21"
            ],
            "sku": "string",
            "account": "string",
            "project_id": "string",
            "unit_type": "string",
            "supplied": false
        }
    ]
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())

Respuestas

Respuesta

json
{
  "id": "string"
}

Respuestas exitosas

200Albarán de compra actualizadoapplication/json
object
idstring

Respuestas de error

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