Saltar al contingut principal
POST

Crear un contacte

Scope:contacts:contacts.write
https://api.holded.com/api/v2/contacts

Crea 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ó

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

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"
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

json
{
  "id": "507f1f77bcf86cd799439011"
}

Respostes exitoses

201Contacte creatapplication/json
object
idstring

Respostes d'error

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