Saltar al contingut principal
PUT

Actualitzar una compra

Scope:accounting:purchases.write
https://api.holded.com/api/v2/purchases/{purchaseId}

Substitueix tots els camps editables d'una factura de compra existent. Es tracta d'una substitució completa del recurs.

Paràmetres

Paràmetres de ruta

purchaseIdstringobligatori

ID de la despesa (ObjectId hexadecimal de 24 caràcters)

Cos de la petició

object
numberstring | null

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

datestring<date>

Data d'emissió en format ISO 8601

due_datestring<date> | null

Data de venciment en format ISO 8601

deduction_datestring<date> | null

Data de deducció fiscal en format ISO 8601

items[]object[]

Línies del document

namestring

Nom de la línia

typestring | null

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

Enum:productshippingtitleroundingrefundecotaxwrappingservice
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

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)

Petició

python
import requests

url = "https://api.holded.com/api/v2/purchases/{purchaseId}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "number": "string",
    "date": "2024-01-15",
    "due_date": "2024-01-15",
    "deduction_date": "2024-01-15",
    "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
        }
    ]
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())

Respostes

Resposta

json
{
  "id": "string"
}

Respostes exitoses

200Compra actualitzadaapplication/json
object
idstring

Respostes d'error

400Sol·licitud incorrectaapplication/json
401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
404Compra no trobadaapplication/json
429Límit de sol·licituds exceditapplication/json