Address Book - Aggiungi

Add a contact to the address book

Request

token_key

array

token

text

token_app

text

params

array

nome

varchar (255)

cognome

varchar (255)

ragione_sociale

varchar (255)

partita_iva

varchar (255)

codice_fiscale

varchar (255)

indirizzo_via

text

indirizzo_citta

varchar (255)

indirizzo_cap

varchar (255)

indirizzo_provincia

varchar (255)

indirizzo_nazione

varchar (255)

Use the ISO 3166-1 code:

IT = Italy
FR = France
ES = Spain
GB = United Kingdom
....

indirizzo_extra

text

varchar (255)

email_pec

varchar (255)

telefono

varchar (255)

fax

varchar (255)

cellulare

varchar (255)

note

text

fattura_elettronica_pa

bool

Specifies whether Electronic Invoicing for Public Administration is enabled for this contact. If set to true, you can specify the "codice_pa" parameter, which identifies the recipient code for the public administration.

codice_pa

varchar (255)

Recipient code for the Public Administration

tipo_contatto

tinyint (4)

Contact type. Can take one of the following values:

1 = Customer
2 = Supplier
3 = Member
4 = Affiliate
5 = Lead

data_nascita

date ( Formato Y-m-d : es. 2021-11-27 )

sconto

float (11,4)

codice_destinatario

varchar (255)

nazione_nascita

varchar (255)

Use the ISO 3166-1 code:

IT = Italy
FR = France
ES = Spain
GB = United Kingdom
....

citta_nascita

varchar (255)

numero_cig

varchar (255)

Codice Identificativo di Gara (CIG) is a code used in Italy to identify a public contract

Response

Success

response

char (36)

Returns the id of the inserted contact

Error

error

bool

message

text

Installation

Request

<?php
$url = "https://app.winddoc.com/v1/api_json.php";
$token_app = "XXXXX";
$token = "XXXXXX";

$form_params = array("method"=>"contatti_aggiungi",
              "request"=>array(
                  "token_key"=>array("token"=>$token,"token_app"=>$token_app),
                  "params"=>array(
                        "nome"=>"Mario",
                        "cognome"=>"Rossi",
                        ......
                        )                  
                  )
            );

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => $url,
    CURLOPT_POST => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_FAILONERROR => true,
    CURLOPT_POSTFIELDS => http_build_query($form_params),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,    
    CURLOPT_HTTPHEADER => [
        "Accept: application/json"
    ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
?>

Request