Actualitzar una rectificativa de venda
sales:invoices.writehttps://api.holded.com/api/v2/receipt-notes/{receiptNoteId}Substitueix tots els camps editables d'una rectificativa de venda existent. Es tracta d'una substitució completa del recurs.
Paràmetres
Paràmetres de ruta
stringobligatoriID de la rectificativa de venda (ObjectId hexadecimal de 24 caràcters)
Cos de la petició
Data d'emissió en format ISO 8601
Data de venciment en format ISO 8601
Línies del document
Nom de la línia
Tipus de línia (product, service o title)
productshippingtitleroundingrefundecotaxwrappingserviceDescripció de la línia
Identificador del producte vinculat
Identificador de la variant del producte vinculat. Requereix product_id
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)
Identificador de la plantilla de disseny del document
Adreça d'enviament estructurada. Ometre o enviar null per no modificar-la (update) o deixar-la buida (create). Usar type=contact amb contact_address_id per apuntar a una adreça desada al contacte. Els camps d'adreça només s'usen amb type=manual; amb billing, hidden o contact s'ignoren.
Mode d'adreça d'enviament: manual (usa els camps d'adreça), billing (l'adreça de facturació del contacte), hidden (sense adreça) o contact (adreça desada al contacte, requereix contact_address_id)
billinghiddenmanualcontactNom del destinatari de l'enviament (el nom de pila si també s'envia family_name)
Cognoms del destinatari de l'enviament
Empresa o organització del destinatari de l'enviament
Primera línia de l'adreça d'enviament
Segona línia de l'adreça d'enviament
Ciutat d'enviament
Codi postal d'enviament
Província o estat d'enviament
País d'enviament
Codi de país ISO 3166-1 alpha-2 per a l'enviament
Email de contacte per a l'enviament
Telèfon de contacte per a l'enviament
Mòbil de contacte per a l'enviament
Identificador d'una adreça desada al contacte (shipping_id a shipping_addresses del contacte). Obligatori quan type és contact
Petició
import requests
url = "https://api.holded.com/api/v2/receipt-notes/{receiptNoteId}"
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
}
],
"design_id": "string",
"shipping_address": {
"type": "manual",
"name": "string",
"family_name": "string",
"organization": "string",
"address_line_1": "string",
"address_line_2": "string",
"city": "string",
"postal_code": "string",
"province": "string",
"country": "string",
"country_code": "ES",
"email": "string",
"phone": "string",
"mobile": "string",
"contact_address_id": "string"
}
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())Respostes
Resposta
{
"id": "string"
}Respostes exitoses
200Rectificativa de venda actualitzadaapplication/jsonRespostes d'error
400Sol·licitud incorrectaapplication/json401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json404Rectificativa de venda no trobadaapplication/json429Límit de sol·licituds exceditapplication/json500Error intern del servidorapplication/json