Saltar al contingut principal
PUT

Actualitzar una rectificativa de venda

Scope:sales:invoices.write
https://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

receiptNoteIdstringobligatori

ID de la rectificativa de venda (ObjectId hexadecimal de 24 caràcters)

Cos de la petició

object
datestring<date>

Data d'emissió en format ISO 8601

due_datestring<date> | null

Data de venciment 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)

design_idstring | null

Identificador de la plantilla de disseny del document

shipping_addressobject | null

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.

typestringrequired

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)

Enum:billinghiddenmanualcontact
namestring | nulloptional

Nom del destinatari de l'enviament (el nom de pila si també s'envia family_name)

family_namestring | nulloptional

Cognoms del destinatari de l'enviament

organizationstring | nulloptional

Empresa o organització del destinatari de l'enviament

address_line_1string | nulloptional

Primera línia de l'adreça d'enviament

address_line_2string | nulloptional

Segona línia de l'adreça d'enviament

citystring | nulloptional

Ciutat d'enviament

postal_codestring | nulloptional

Codi postal d'enviament

provincestring | nulloptional

Província o estat d'enviament

countrystring | nulloptional

País d'enviament

country_codestring | nulloptional

Codi de país ISO 3166-1 alpha-2 per a l'enviament

emailstring | nulloptional

Email de contacte per a l'enviament

phonestring | nulloptional

Telèfon de contacte per a l'enviament

mobilestring | nulloptional

Mòbil de contacte per a l'enviament

contact_address_idstring | nulloptional

Identificador d'una adreça desada al contacte (shipping_id a shipping_addresses del contacte). Obligatori quan type és contact

Petició

python
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

json
{
  "id": "string"
}

Respostes exitoses

200Rectificativa de venda actualitzadaapplication/json
object
idstring

Respostes d'error

400Sol·licitud incorrectaapplication/json
401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
404Rectificativa de venda no trobadaapplication/json
429Límit de sol·licituds exceditapplication/json
500Error intern del servidorapplication/json
object
typestring
titlestring
statusinteger
detailstring