Actualizar un albarán
inventory:shipments.writehttps://api.holded.com/api/v2/waybills/{waybillId}Reemplaza todos los campos editables de un albarán existente. Se trata de un reemplazo completo del recurso.
Parámetros
Parámetros de ruta
stringobligatorioID del albarán (ObjectId hexadecimal de 24 caracteres)
Cuerpo de la petición
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)
Si el PDF muestra precios y totales de línea. Omite este campo para mantener el valor guardado
Identificador de la plantilla de diseño del documento
Petición
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())Respuestas
Respuesta
{
"id": "string"
}Respuestas exitosas
200Albarán actualizadoapplication/jsonRespuestas de error
400Solicitud incorrectaapplication/json401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json404Albarán no encontradoapplication/json429Límite de solicitudes excedidoapplication/json