Actualizar un albarán de compra
inventory:purchase-shipments.writehttps://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
stringobligatorioID del albarán de compra (ObjectId hexadecimal de 24 caracteres)
Cuerpo de la petición
Número de documento personalizado (por ejemplo, la referencia de factura del proveedor)
Fecha de emisión en formato ISO 8601
Fecha de vencimiento en formato ISO 8601
Líneas del documento
Nombre de la línea
Tipo de línea (product, service o title)
productshippingtitleroundingrefundecotaxwrappingserviceDescripción de la línea
Identificador del producto vinculado
Identificador de la variante del producto vinculado. Requiere product_id
Cantidad de unidades
Precio unitario
Porcentaje de descuento aplicado a esta línea
Lista de identificadores de impuesto a aplicar
Referencia SKU del producto en esta línea
Código de cuenta contable de la línea
Identificador del proyecto vinculado a esta línea
Unidad de medida de la línea (ej. kg, units, litros)
Si es true, la línea es un suplido (gasto pagado en nombre del cliente, excluido de la base imponible)
Petición
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
{
"id": "string"
}Respuestas exitosas
200Albarán de compra actualizadoapplication/jsonRespuestas de error
400Solicitud incorrectaapplication/json401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json404Albarán de compra no encontradoapplication/json429Límite de solicitudes excedidoapplication/json