Saltar al contingut principal
POST

Crear un albarà de compra

Scope:inventory:purchase-shipments.write
https://api.holded.com/api/v2/purchase-shipments

Crea un nou albarà de compra (recepció de mercaderia d'un proveïdor).

Cos de la petició

object
contact_idstringrequired

Identificador d'un contacte existent

contact_namestringoptional

Nom del contacte

descriptionstring | nulloptional

Descripció en text lliure

datestring<date>optional

Data d'emissió en format ISO 8601

due_datestring<date> | nulloptional

Data de venciment en format ISO 8601

notesstring | nulloptional

Notes internes visibles només per al teu equip

default_taxesbooleanoptional

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

default: false
languagestring | nulloptional

Codi d'idioma ISO 639-1

currencystring | nulloptional

Codi de moneda ISO 4217

currency_changenumber<float> | nulloptional

Tipus de canvi

items[]object[]required

Línies del document

namestring

Nom de la línia

typestring | null

Tipus de línia (product, service o title)

Enum:producttitleservice
descriptionstring | null

Descripció de la línia

product_idstring | null

Identificador del producte vinculat

variant_idstring | null

Identificador de la variant del producte vinculat. Requereix product_id

service_idstring | null

Identificador del servei vinculat a aquesta línia

unitsnumber | null

Quantitat d'unitats

pricenumber | null

Preu unitari

discountnumber | null

Percentatge de descompte aplicat a aquesta línia

taxes[]string[] | null

Llista d'identificadors d'impostos a aplicar

skustring | null

Referència SKU del producte en aquesta línia

accountstring | null

Codi de compte comptable de la línia

project_idstring | null

Identificador del projecte vinculat a aquesta línia

unit_typestring | null

Unitat de mesura de la línia (p. ex. kg, units, litres)

suppliedboolean | null

Si és true, la línia és un suplert (despesa pagada en nom del client, exclosa de la base imposable)

tags[]string[]optional

Etiquetes per classificar

custom_fields[]object[]optional

Valors de camps personalitzats

fieldstring

Identificador del camp personalitzat

valuestring

Valor emmagatzemat al camp personalitzat

numberstring | nulloptional

Número de document personalitzat (per exemple, la referència de factura del proveïdor)

warehouse_idstring | nulloptional

Identificador del magatzem

discountnumber | nulloptional

Percentatge de descompte global

Petició

python
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

json
{
  "id": "507f1f77bcf86cd799439011"
}

Respostes exitoses

201Albarà de compra creatapplication/json
object
idstring

Respostes d'error

400Sol·licitud incorrectaapplication/json
401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
422Error de validacióapplication/json
429Límit de sol·licituds exceditapplication/json