Actualitzar un albarà
inventory:shipments.writehttps://api.holded.com/api/v2/waybills/{waybillId}Substitueix tots els camps editables d'un albarà existent. Es tracta d'una substitució completa del recurs.
Paràmetres
Paràmetres de ruta
stringobligatoriID de l'albarà (ObjectId hexadecimal de 24 caràcters)
Cos de la petició
Data d'emissió en format ISO 8601
Data de venciment en format ISO 8601
Línies del document
Nom de la línia
Tipus de línia (product, service o title)
productshippingtitleroundingrefundecotaxwrappingserviceDescripció de la línia
Identificador del producte vinculat
Identificador de la variant del producte vinculat. Requereix product_id
Quantitat d'unitats
Preu unitari
Percentatge de descompte aplicat a aquesta línia
Llista d'identificadors d'impostos a aplicar
Referència SKU del producte en aquesta línia
Codi de compte comptable de la línia
Identificador del projecte vinculat a aquesta línia
Unitat de mesura de la línia (p. ex. kg, units, litres)
Si és true, la línia és un suplert (despesa pagada en nom del client, exclosa de la base imposable)
Si el PDF mostra preus i totals de línia. Omet aquest camp per mantenir el valor guardat
Identificador de la plantilla de disseny del document
Petició
import requests
url = "https://api.holded.com/api/v2/waybills/{waybillId}"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"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
}
],
"is_valued": false,
"design_id": "string"
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())Respostes
Resposta
{
"id": "string"
}Respostes exitoses
200Albarà actualitzatapplication/jsonRespostes d'error
400Sol·licitud incorrectaapplication/json401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json404Albarà no trobatapplication/json429Límit de sol·licituds exceditapplication/json