Crear un contacte
contacts:contacts.writehttps://api.holded.com/api/v2/contactsCrea un nou contacte al teu compte. Els contactes representen les persones i empreses amb les quals fas negocis: clients, proveïdors, leads, deutors o creditors.
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
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"
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"
],
"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.post(url, headers=headers, json=payload)
print(response.json())Respostes
Resposta
{
"id": "507f1f77bcf86cd799439011"
}Respostes exitoses
201Contacte creatapplication/jsonRespostes d'error
400Sol·licitud incorrectaapplication/json401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json422Error de validacióapplication/json429Límit de sol·licituds exceditapplication/json