Création d’un contact.
| Paramètres entrants | Description | Type | Expression régulière | Obligatoire |
| is_individual | Type d’utilisateur | Boolean. Valeurs : particulier = 1; organisation = 0. | Oui | |
| firstname | Prénom | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,150} | Oui |
| lastname | Nom | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,150} | Oui |
| orgname | Nom de l’organisation | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,150} | Si le champ is_individual = 0 |
| street | Adresse 1 | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,250} | Oui |
| street2 | Adresse 2 | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,250} | Non |
| city | Ville | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,150} | Oui |
| pc | Code postal | String | [ a-zA-Z0-9._#/-]{1,30} | Oui |
| sp | Province ou état | String | [A-Za-z0-9 \.\-!#$%'()*+,:;=?@[\]//^_`|}{]{0,80} | Non |
| cc | Code du pays | String | [A-Za-z]{2} | Oui |
| voice | Numéro de téléphone | String (format: code téléphone pays + «.» + numéro de téléphone) | \+[0-9]{1,3}\.[0-9]{1,15} | Oui |
| fax | Fax | String (format: code téléphone pays + «.» + numéro de fax) | \+[0-9]{1,3}\.[0-9]{1,15} | Non |
| Adresse email | String | [0-9a-zA-Z_\.-]+@(([0-9]{1,3}\.){3}[0-9]{1,3}|([0-9a-zA-Z][A-Z0-9a-z-]*[0-9a-zA-Z]\.)+[a-zA-Z]{2,7}) | Oui | |
| password | Mot de passe | String (min 8, max 20, at least one letter and one number and a special character from !@#$£%^&*;:()_+-[]= ) | Oui | |
| birthday | Date | Non | ||
| place_of_birth | Si FR : code postal, ville. Si autre : code pays (BE, DE, …) | Non | ||
| number type= »S » | N° SIREN | String | [0-9]{9} | Non |
| number type= »M » | N° marque | String | [0-9]{9} | Non |
| Intracom | N° TVA intracommunautaire | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,50} | Non |
| Paramètres entrants * (uniquement pour .FR) | Description | Type | Expression régulière | Obligatoire |
| duns | Data Universal Numbering System | String | [0-9]{9} | Non |
| localnumber | Numéro identifiant local | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,50} | Non |
| assowaldec | Numéro identifiant association | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,50} | Non |
| assocreationdate | Date création association | Date | Non | |
| assodeclarationdate | Date déclaration préfecture association | Date | Non | |
| assopubannounce | N° annonce journal officiel | short | Non | |
| assopubpage | N° page journal officiel | short | Non |
* Un nom de domaine .fr ne peut être enregistré que par des citoyens européens ou des résidents, ainsi que par toute entrepriseou organisation européenne.
Une des conditions d’admissibilité suivantes doit être remplie :
Personne physique
1. Être citoyen ou résident permanent en Europe (birthday, place_of_birth)
Personne morale
1. Être implanté dans l’un des pays Européen
(Entreprise: N° SIREN ou N°Marque ou N° TVA intracommunautaire ou N° duns ou N° localnumber)
(Association: N° assowaldec ou [assocreationdate et assodeclarationdate et assopubannounce et assopubpage])
| Paramètres entrants * (uniquement pour .US) | Type d’utilisation | Valeur à transmettre | Type |
| nexus_purpose | Commerciale Association Usage personnel Education Gouvernementale |
P1 P2 P3 P4 P5 |
String(2) String(2) String(2) String(2) String(2) |
| nexus_cat | Un résident étranger aux US | C12 | String(3) |
| Vous n’êtes pas américain mais vous avez des relations commerciales aux USA | C32 | String(3) | |
| Vous n’êtes pas américain mais vous avez des bureaux aux USA | C31 | String(3) |
* Un nom de domaine .us ne peut être enregistré que par des citoyens américains ou des résidents américains, ainsi que par toute entreprise ou organisation, fédérale, nationale ou locale, avec une présence locale aux États-Unis.
Une des conditions d’admissibilité suivantes doit être remplie :
Personne physique
1. être citoyen ou résident permanent aux États-Unis d’Amérique, ou dans l’une de ses possessions ou territoires
ou
2. avoir sa résidence principale aux Etats-Unis d’Amérique ou dans l’une de ses possessions
Personne morale
1. être implanté dans l’un des 50 états des États-Unis, ou dans le District de Columbia, ou dans l’une des possessions ou territoires des États-Unis
ou
2. avoir été organisé ou au moins constitué en vertu de la législation d’un État des États-Unis d’Amérique, le District de Columbia, ou une de ses possessions ou territoires
Entité ou organisation
Une entité ou une organisation (y compris du gouvernement fédéral, d’État ou des collectivités locales des États-Unis, ou d’une de ses subdivisions politiques) disposant d’une présence locale aux États-Unis.
| Paramètres entrants * (uniquement pour .IT) | Description | Type | Expression régulière | Obligatoire |
| intracom | N° TVA intracommunautaire | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,50} | Si personne morale |
| passport | Numéro de passeport | String | Si personne physique | |
| identitycard | Numéro identité | String | Si personne physique |
* Un nom de domaine .it ne peut être enregistré que par des citoyens européens.
Une des conditions d’admissibilité suivantes doit être remplie :
Personne physique
1. Disposer d’un numéro d’identité ou d’un numéro de passeport
Personne morale
2. Disposer d’un numéro intracommunautaire
| Paramètres entrants * (uniquement pour .PT) | Description | Type | Expression régulière | Obligatoire |
| intracom | N° TVA intracommunautaire | String | [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,50} | Si personne morale et number non rempli |
| number type= »S » | N° SIREN | String | [0-9]{9} | Si personne morale et intracom non rempli |
| number type= »M » | N° Marque | String | [0-9]{9} | Si personne morale et intracom non rempli |
Une des conditions d’admissibilité suivantes doit être remplie :
Personne morale
1. Disposer d’un numéro de TVA intracommunautaire
2. Disposer d’un numéro SIREN (ou numéro d’enregistrementde société) ou d’un numéro de Marque
| Paramètres sortants | Description | Valeurs possibles |
| contact_id | Identifiant du contact, généré par sa création |
Code Erreurs
| Code d’erreur | Paramètre | Message | Valeur | Commentaire |
| 501 | is_individual | command syntax error | The ‘is_individual’ element has an invalid value according to its data type | Possible values: particulier = 1; organisation = 0. |
| 501 | firstname | command syntax error | The ‘firstname’ element has an invalid value according to its data type | Possible values: [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,150} |
| 501 | lastname | command syntax error | The ‘lastname’ element has an invalid value according to its data type | Possible values: [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,150} |
| 501 | orgname | command syntax error | The ‘orgname’ element has an invalid value according to its data type | Possible values: [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,150} |
| 501 | street | command syntax error | The ‘street’ element has an invalid value according to its data type | Possible values: [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,250} |
| 501 | street2 | command syntax error | The ‘street2’ element has an invalid value according to its data type | Possible values: [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,250} |
| 501 | city | command syntax error | The ‘city’ element has an invalid value according to its data type | Possible values: [A-Za-z0-9 \.!#$%'()*+,:;=\-?@[\]//^_`|}{]{1,150} |
| 501 | pc | command syntax error | The ‘pc’ element has an invalid value according to its data type | Possible values: [ a-zA-Z0-9._#/-]{1,30} |
| 501 | sp | command syntax error | The ‘sp’ element has an invalid value according to its data type | Possible values: [A-Za-z0-9 \.\-!#$%'()*+,:;=?@[\]//^_`|}{]{0,80} |
| 501 | cc | command syntax error | The ‘cc’ element has an invalid value according to its data type | Possible values: [A-Za-z]{2} |
| 501 | cc | Sémantique error | The ‘cc’ element has an invalid semantique value | Valeur inconnue |
| 501 | voice | command syntax error | The ‘voice’ element has an invalid value according to its data type | Possible values:String (format: code téléphone pays + «.» + numéro de téléphone)format international ISO (par exemple +33.103139811)\+[0-9]{1,3}\.[0-9]{1,15} |
| 501 | fax | command syntax error | The ‘fax’ element has an invalid value according to its data type | Possible values:String (format: code téléphone pays + «.» + numéro de fax)\+[0-9]{1,3}\.[0-9]{1,15} |
| 501 | command syntax error | The ’email’ element has an invalid value according to its data type | Possible values:format défini par le RFC2822[0-9a-zA-Z_\.-]+@(([0-9]{1,3}\.){3}[0-9]{1,3}|([0-9a-zA-Z][A-Z0-9a-z-]*[0-9a-zA-Z]\.)+[a-zA-Z]{2,7}) | |
| 501 | password | command syntax error | The ‘password’ element has an invalid value according to its data type | Possible values:String (min 5, max 15) |
| 501 | birthday | command syntax error | The ‘birthday’ element has an invalid value according to its data type | Possible values: Date |
| 501 | place_of_birth | command syntax error | The ‘place_of_birth’ element has an invalid value according to its data type | Possible values:String:si FR : code postal, ville si autre : code pays (BE, DE, …) |
| 501 | number type= »S » | command syntax error | The ‘number’ element has an invalid value according to its data type | Possible values: N° SIREN |
| 540 | orgname | parameter value error | Required parameter missing (orgName: range(1-100) | Le champ OrgName est obligatoire lorsque le champs is_individual= 0 |
| 550 | place_of_birth | parameter value policy error | FR is not allowed, you should specify postal code and city | |
| 550 | place_of_birth | parameter value policy error | Invalid Place of Birth, should be BE or 75, paris or 75008, paris | |
| 550 | cc | parameter value policy error | Invalid code country | |
| 550 | pc, city (cc) | parameter value policy error | Postal code does not match the city | Dans le pays du contact, la ville ne correspond pas au code postal |
Commande
| <api> […] <command> <contact_create> <is_individual>…</is_individual> <firstname>…</firstname> <lastname>…</lastname> <street>…</street> <city>…</city> <pc>…</pc> <cc>…</cc> <voice>…</voice> <email>…</email> <password>…</password> si le client est un particulier <birthday>…</birthday> <place_of_birth>…</place_of_birth> si le client est une société <number type= »S »>…</number> </contact_create> </command> </api> |
Réponse à la commande
| <?xml version= »1.0″ encoding= »utf-8″?> <api> <response> <trID>…</trID> <result code= »… »> <msg>…</msg> </result> </response> <resData> <contact_creData> <contact_id>…</contact_id> </contact_creData> </resData> </api> |