Saltar al contingut principal
PUT

Actualitzar un contacte

Scope:contacts:contacts.write
https://api.holded.com/api/v2/contacts/{contactId}

Substitueix tots els camps editables d'un contacte existent. Es tracta d'una substitució completa del recurs.

Paràmetres

Paràmetres de ruta

contactIdstringobligatori

ID del contacte (ObjectId hexadecimal de 24 caràcters)

Cos de la petició

object
namestringrequired

Nom del contacte

codestring | nulloptional

Codi de referència intern

vat_numberstring | nulloptional

Número d'identificació fiscal

trade_namestring | nulloptional

Nom comercial

is_personbooleanoptional

Si el contacte és una persona física (true) o empresa (false)

emailstring | nulloptional

Adreça d'email. Se'n poden enviar diverses separades per comes o punt i coma: la primera és la principal i la resta es retorna a `extra_emails`. Les invàlides s'ignoren (400 si no n'hi ha cap de vàlida)

phonestring | nulloptional

Número de telèfon

mobilestring | nulloptional

Número de mòbil

websitestring | nulloptional

URL del lloc web

typestring | nulloptional

Tipus de contacte

Enum:clientdebtorsuppliercreditorlead
client_recordinteger | nulloptional

Número del compte comptable utilitzat quan aquest contacte actua com a client

supplier_recordinteger | nulloptional

Número del compte comptable utilitzat quan aquest contacte actua com a proveïdor

ibanstring | nulloptional

Número de compte bancari internacional (IBAN)

swiftstring | nulloptional

Codi SWIFT/BIC del banc

sepa_refstring | nulloptional

Referència del mandat SEPA per a domiciliacions bancàries

sepa_datestring<date> | nulloptional

Data de signatura del mandat SEPA per a domiciliacions bancàries

tax_operationstring | nulloptional

Tipus d'operació fiscal del contacte (p. ex. general, intra, receq, exento). Ha de ser una de les operacions definides per l'esquema fiscal del compte. En actualitzar, ometre'l (o enviar null) conserva el valor actual

bill_addressobject | nulloptional

Adreça de facturació

addressstring | null

Carrer i número

citystring | null

Ciutat

postal_codestring | null

Codi postal

provincestring | null

Província o estat

countrystring | null

País

country_codestring | null

Codi de país ISO 3166-1 alpha-2

infostring | null

Informació addicional de l'adreça

tags[]string[] | nulloptional

Etiquetes associades al contacte

contact_persons[]object[]optional

Persones de contacte vinculades (pel seu ID de contacte)

person_idstring

ID de contacte de la persona

custom_fields[]object[] | nulloptional

Camps personalitzats definits per l'usuari

fieldstring

Identificador del camp personalitzat

valueobject

Valor emmagatzemat al camp personalitzat

defaultsobject | nulloptional

Configuració predeterminada del contacte

sales_channelstring | null

Canal de venda predeterminat

expenses_accountstring | null

Compte de despeses predeterminat

due_daysinteger | null

Dies de venciment predeterminats

payment_dayinteger | null

Dia de pagament predeterminat

payment_methodstring | null

Mètode de pagament predeterminat

discountinteger | null

Percentatge de descompte predeterminat

languagestring | null

Idioma predeterminat del contacte

currencystring | null

Moneda predeterminada

sales_tax[]string[] | null

Impost de venda predeterminat

purchases_tax[]string[] | null

Impost de compra predeterminat

numbering_seriesobject | null

ID de sèrie de numeració predeterminada aplicada als nous documents de cada tipus creats per a aquest contacte

Petició

python
import requests

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

payload = {
    "name": "string",
    "code": "string",
    "vat_number": "string",
    "trade_name": "string",
    "is_person": false,
    "email": "string",
    "phone": "string",
    "mobile": "string",
    "website": "string",
    "type": [
        "client",
        "supplier",
        "debtor",
        "creditor",
        "lead"
    ],
    "client_record": 0,
    "supplier_record": 0,
    "iban": "string",
    "swift": "string",
    "sepa_ref": "string",
    "sepa_date": "2024-01-15",
    "tax_operation": "string",
    "bill_address": {
        "address": "string",
        "city": "string",
        "postal_code": "string",
        "province": "string",
        "country": "string",
        "country_code": "ES",
        "info": "string"
    },
    "tags": [
        "string"
    ],
    "contact_persons": [
        {
            "person_id": "string"
        }
    ],
    "custom_fields": [
        {
            "field": "string",
            "value": {}
        }
    ],
    "defaults": {
        "sales_channel": "string",
        "expenses_account": "string",
        "due_days": 0,
        "payment_day": 0,
        "payment_method": "string",
        "discount": 0,
        "language": "string",
        "currency": "EUR",
        "sales_tax": [
            "string"
        ],
        "purchases_tax": [
            "string"
        ],
        "numbering_series": {
            "invoice": "string",
            "receipt": "string",
            "salesorder": "string",
            "estimate": "string",
            "order": "string",
            "proform": "string",
            "waybill": "string"
        }
    }
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())

Respostes

Resposta

json
{
  "status": 1
}

Respostes exitoses

200Contacte actualitzatapplication/json
object
statusintegerrequired

Operation status

Respostes d'error

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