Crear un albarà de compra
inventory:purchase-shipments.writehttps://api.holded.com/api/v2/purchase-shipmentsCrea un nou albarà de compra (recepció de mercaderia d'un proveïdor).
Cos de la petició
Identificador d'un contacte existent
Nom del contacte
Descripció en text lliure
Data d'emissió en format ISO 8601
Data de venciment en format ISO 8601
Notes internes visibles només per al teu equip
Si és true, una línia sense impostos propis, no vinculada a un producte o servei del catàleg, d'un contacte sense impostos per defecte, pren els impostos per defecte del compte: els de venda en un document de venda i els de compra en un de compra. Si és false o s'omet, aquesta línia es crea sense impostos
falseCodi d'idioma ISO 639-1
Codi de moneda ISO 4217
Tipus de canvi
Línies del document
Nom de la línia
Tipus de línia (product, service o title)
producttitleserviceDescripció de la línia
Identificador del producte vinculat
Identificador de la variant del producte vinculat. Requereix product_id
Identificador del servei vinculat a aquesta línia
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)
Etiquetes per classificar
Valors de camps personalitzats
Identificador del camp personalitzat
Valor emmagatzemat al camp personalitzat
Número de document personalitzat (per exemple, la referència de factura del proveïdor)
Identificador del magatzem
Percentatge de descompte global
Petició
import requests
url = "https://api.holded.com/api/v2/purchase-shipments"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"contact_id": "string",
"contact_name": "string",
"description": "string",
"date": "2026-01-15",
"due_date": "2026-01-31",
"notes": "string",
"default_taxes": false,
"language": "es",
"currency": "EUR",
"currency_change": 0,
"items": [
{
"name": "string",
"type": "product",
"description": "string",
"product_id": "string",
"variant_id": "string",
"service_id": "string",
"units": 0,
"price": 0,
"discount": 0,
"taxes": [
"s_iva_21"
],
"sku": "string",
"account": "string",
"project_id": "string",
"unit_type": "string",
"supplied": false
}
],
"tags": [
"string"
],
"custom_fields": [
{
"field": "string",
"value": "string"
}
],
"number": "string",
"warehouse_id": "string",
"discount": 0
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())Respostes
Resposta
{
"id": "507f1f77bcf86cd799439011"
}Respostes exitoses
201Albarà de compra creatapplication/jsonRespostes d'error
400Sol·licitud incorrectaapplication/json401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json422Error de validacióapplication/json429Límit de sol·licituds exceditapplication/json