: : Méthode creerClient

La méthode creerClient permet de créer un client ou un prospect. Le Code Client sera envoyé en réponse à l'appel de la méthode creerClient.

: : Arguments

Pour créer un client ou prospect, vous devez obligatoirement renseigner codeSociete, nomAppel, prospect et adresse1.

ClientPubliqueWS – méthode CreerClient
Argument Description Valeur
identifiantExterne

Si l’identifiant d’un client dans Akuiteo est différent de celui de votre base de donnée, utilisez ce paramètre.

Grâce à cet identifiant unique, vous pouvez retrouver votre client lors d’une modification par Web Service.

Caractère alphanumérique

100 caractères max.

Ex : CLI_EXTERNE01

codeClient

Code du client.

Ce code n’est pas obligatoire lors de la création, il peut être généré automatiquement.

Caractère alphanumérique

10 caractères max.

Ex : CLI10

codeCommercial Code du commercial associé au client.

Caractère alphanumérique

10 caractères max.

Ex : COMM

codeEtablissement Code de l’établissement en interne s’occupant du client.

Caractère alphanumérique

5 caractères max.

Ex : ETAB

codeRespCompte Code du responsable de compte.

Caractère alphanumérique

10 caractères max.

Ex : COMP

codeSociete [Obligatoire] Code de la société responsable du client.

Caractère alphanumérique

5 caractères max.

Ex : SOC1

statut Code du statut du client paramétré dans Akuiteo dans Outils > Paramétrage > Paramétrage Général > Vente > Statuts des prospects.

Caractère alphanumérique

20 caractères max.

Ex : 01

note Notes concernant le client.

Caractère alphanumérique

Ex : Editeur de logiciel depuis 10 ans, le client XXX fournit des applications de type XYZ.

couleur1 Indicateur de la fiabilité d’un client à travers un code couleur paramétré dans Akuiteo dans Outils > Paramétrage > Paramétrage Général > Vente > Gestion des indicateurs couleur du client.

Caractère alphanumérique

20 caractères max.

Ex : BIEN

couleur2 Indicateur de la fiabilité d’un client à travers un code couleur paramétré dans Akuiteo dans Outils > Paramétrage > Paramétrage Général > Vente > Gestion des indicateurs couleur du client.

Caractère alphanumérique

20 caractères max.

Ex : MOYEN

couleur3 Indicateur de la fiabilité d’un client à travers un code couleur paramétré dans Akuiteo dans Outils > Paramétrage > Paramétrage Général > Vente > Gestion des indicateurs couleur du client.

Caractère alphanumérique

20 caractères max.

Ex : MAUVAIS

dateCloture Indique la date de fermeture de l’établissement.

Format de date

CCYY-MM-DDThh:mm:ss

Ex : 2011-05-28T11:30:00

dateOuverture Indique la date d’ouverture de l’établissement.

Format de date

CCYY-MM-DDThh:mm:ss

Ex : 2009-05-28T17:46:00

email E-mail du client / prospect.

Caractère alphanumérique

100 caractères max.

Ex : client@societe.com

nom1 Dénomination sociale complète du nom du client.

Caractère alphanumérique

100 caractères max.

Ex : SOCIETE

nom2 Permet de compléter la dénomination sociale si le nom est long.

Caractère alphanumérique

100 caractères max.

Ex : SOCIETE AVEC DENOMINATION SOCIALE

nomAppel [Obligatoire] Nom du client utilisé en interne dans votre société.

Caractère alphanumérique

100 caractères max.

Ex : SOCIETE

prospect [Obligatoire] Permet de préciser si vous créez un client ou prospect.

Booléen

0 = client

1 = prospect (par défaut)

siteWeb Site internet du client.

Caractère alphanumérique

100 caractères max.

Ex : www.societe.com

telephone Téléphone du client.

Caractère alphanumérique

20 caractères max.

Ex : 04 04 04 04 04

fax Fax du client.

Caractère alphanumérique

100 caractères max.

Ex : 04 04 04 04 00

adresse1 [Obligatoire] Adresse principale du client.

Caractère alphanumérique

40 caractères max.

Ex : Avenue de l’Opéra

adresse2 Adresse secondaire du client.

Caractère alphanumérique

40 caractères max.

Ex : Bâtiment E

localite Localité du client si nécessaire.

Caractère alphanumérique

40 caractères max.

Ex : NA

cedex Cedex du client.

Caractère alphanumérique

40 caractères max.

Ex : Cedex 01

codePostal

Code postal du client.

Le code postal permet de déterminer le département et la région.

Caractère alphanumérique

10 caractères max.

Ex : 75005

ville Ville du client.

Caractère alphanumérique

30 caractères max.

Ex : Paris

codeDevise Code de la devise utilisée dans des transactions financières.

Caractère alphanumérique

3 caractères max.

Ex : EUR

codeDomaine Code du domaine. Ce code permet de définir des équivalences entre codes TVA pour les clients. En saisie de pièce, le système pourra modifier la TVA du produit vendu par la TVA définie en équivalence.

Caractère alphanumérique

5 caractères max.

Ex : TES

jourReglement Jour de règlement.

Caractère alphanumérique

3 caractères max.

Ex : 15

modeReglement

Code des conditions de règlement :

  • AU = Autres
  • CB = Carte bancaire
  • CH = Chèque
  • ES = Espèces
  • LC = Lettre chèque
  • PR = Prélèvement
  • TR = Traite
  • VD = Virement devise
  • VI = Virement

Caractère alphanumérique

20 caractères max.

Ex : VI

moisReglement

Mois de règlement.

  • 1 = Fin de mois
  • 2 = Début de mois
  • 3 = Fixe

Caractère alphanumérique

20 caractères max.

Ex : 1

collectifPrincipal Compte comptable général de rattachement du compte de tiers.

Caractère alphanumérique

12 caractères max.

Ex : 411000

exonereTva Indique si le client est exonéré de TVA.

Booléen

0 = Non

1 = Oui

groupe Indicateur du groupe.

Booléen

0 = Non

1 = Oui

interne Indicateur Externe/Interne

Booléen

0 = Non

1 = Oui

nonComptabilise Indicateur client à comptabiliser.

Booléen

0 = Non

1 = Oui

zoneTva

Code de la zone de gestion de la TVA.

  • 0 : France
  • 1 : CE
  • 2 : HORS CE
  • 3 : MONACO
  • 4 : ALELE

Caractère numérique

Ex : 0

numJourReglement

Code du numéro du jour de règlement.

  • 000 = 0 jour
  • 005 = 5 jours
  • 010 = 10 jours
  • 015 = 15 jours
  • 030 = 30 jours
  • 040 = 40 jours
  • 045 = 45 jours
  • 050 = 50 jours
  • 060 = 60 jours
  • 070 = 70 jours
  • 080 = 80 jours
  • 090 = 90 jours
  • 100 = 100 jours
  • 110 = 110 jours
  • 120 = 120 jours

Caractère numérique

20 caractères max.

Ex : 005

journal Journal de banque utilisé.

Caractère alphanumérique

20 caractères max.

Ex : BQ

numeroTva Numéro de TVA intra-communautaire.

Caractère alphanumérique

25 caractères max.

Ex : FR 12123456789

codeExercice Code de l’exercice.

Caractère alphanumérique

20 caractères max.

Ex : 12

caUnit Chiffre d’Affaire unitaire.

Caractère alphanumérique

10 caractères max.

Ex : 100

codeCategorieProf Catégorie professionnelle du client.

Caractère alphanumérique

20 caractères max.

Ex : 732Z

exclusion Codes/Mots clés (séparateur au choix) permettant par la suite d´exclure le prospect de certains états de suivi et d’analyse.

Caractère alphanumérique

100 caractères max.

Ex : EXCLU

codeFamille Code de la famille du client.

Caractère alphanumérique

20 caractères max.

Ex : SERVICES

codeLangue Code de la langue du client.

Caractère alphanumérique

10 caractères max.

Ex : fr

codeProfession Profession du client.

Caractère alphanumérique

20 caractères max.

Ex : SSII

codeSecteur Secteur géographique auquel est rattaché le prospect.

Caractère alphanumérique

20 caractères max.

Ex : Sud Est

codeSsFamille Code de la sous famille.

Caractère alphanumérique

20 caractères max.

Ex : INFORMATIQUE

caValeur Valeur du Chiffre d’Affaire.

Caractère numérique.

Ex : 100000

capital Valeur du capital social.

Caractère numérique.

Ex : 70000

effectif Nombre d’employés dans la société cliente.

Caractère numérique.

Ex : 50

formeJuridique Forme juridique de la société.

Caractère alphanumérique

20 caractères max.

Ex : SARL

numeroApe Code APE de la NAF.

Caractère alphanumérique

10 caractères max.

Ex : 72.2Z

siren Numéro SIREN.

Caractère alphanumérique

11 caractères max.

Ex : 732 829 320

siret Numéro SIRET.

Caractère alphanumérique

17 caractères max.

Ex : 732 829 320 00074

regroupement1 Code de regroupement 1.

Caractère alphanumérique

30 caractères max.

Ex : Middle Market

regroupement2 Code de regroupement 2.

Caractère alphanumérique

30 caractères max.

Ex : Middle Market 2

motsCles Mots clés pour réaliser une recherche.

Caractère alphanumérique

40 caractères max.

Ex : POLETECHNO

Référence

Pour ajouter des Données personnalisées à votre création de client ou prospect ou mettre en place des Déclencheurs, consultez les sections correspondantes.

: : Contrôles généraux

Si le client existe déjà, Akuiteo ne crée pas de nouveaux clients. Il se base, dans l’ordre, sur les éléments suivants pour en vérifier l’existence :

  1. code client + code société
  2. identifiant externe s’il est renseigné
  3. numéro SIRET s’il est renseigné