Saltar al contenido principal
PUT

Actualizar un albarán

Scope:inventory:shipments.write
https://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

waybillIdstringobligatorio

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

Cuerpo de la petición

object
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)

is_valuedboolean | null

Si el PDF muestra precios y totales de línea. Omite este campo para mantener el valor guardado

design_idstring | null

Identificador de la plantilla de diseño del documento

Petición

python
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

json
{
  "id": "string"
}

Respuestas exitosas

200Albarán actualizadoapplication/json
object
idstring

Respuestas de error

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