Actualitzar un contacte
contacts:contacts.writehttps://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
stringobligatoriID del contacte (ObjectId hexadecimal de 24 caràcters)
Cos de la petició
Nom del contacte
Codi de referència intern
Número d'identificació fiscal
Nom comercial
Si el contacte és una persona física (true) o empresa (false)
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)
Número de telèfon
Número de mòbil
URL del lloc web
Tipus de contacte
clientdebtorsuppliercreditorleadNúmero del compte comptable utilitzat quan aquest contacte actua com a client
Número del compte comptable utilitzat quan aquest contacte actua com a proveïdor
Número de compte bancari internacional (IBAN)
Codi SWIFT/BIC del banc
Referència del mandat SEPA per a domiciliacions bancàries
Data de signatura del mandat SEPA per a domiciliacions bancàries
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
Adreça de facturació
Carrer i número
Ciutat
Codi postal
Província o estat
País
Codi de país ISO 3166-1 alpha-2
Informació addicional de l'adreça
Etiquetes associades al contacte
Persones de contacte vinculades (pel seu ID de contacte)
ID de contacte de la persona
Camps personalitzats definits per l'usuari
Identificador del camp personalitzat
Valor emmagatzemat al camp personalitzat
Configuració predeterminada del contacte
Canal de venda predeterminat
Compte de despeses predeterminat
Dies de venciment predeterminats
Dia de pagament predeterminat
Mètode de pagament predeterminat
Percentatge de descompte predeterminat
Idioma predeterminat del contacte
Moneda predeterminada
Impost de venda predeterminat
Impost de compra predeterminat
ID de sèrie de numeració predeterminada aplicada als nous documents de cada tipus creats per a aquest contacte
Petició
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
{
"status": 1
}Respostes exitoses
200Contacte actualitzatapplication/jsonOperation status
Respostes d'error
400Sol·licitud incorrectaapplication/json401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json404Contacte no trobatapplication/json422Error de validacióapplication/json429Límit de sol·licituds exceditapplication/json