Annexe 14. Requêtes SOAP

TRT peut recevoir des informations comptables en provenance d'autres logiciels. L'annexe 10 en contient les spécifications. TRT peut aussi envoyer des informations à d'autres applications via les Web Services, par des requêtes SOAP. Vous pouvez découvrir les services SOAP de TRT par l'URL suivant:
http://votreAdresseIP:8080/4DWSDL où votreAdresseIP peut être un nom de domaine ou une adresse IP locale sur laquelle est installée TRT et dont les services web sont lancés. TRT utilise par défaut le port 8080. Vous pouvez changer cette adresse lorsque vous cliquez sur la boîte à cocher de démarrage des Web Services.

Ce qui suit est la description des services web présentement disponibles dans TRT. Les paramètres communs à toutes les requêtes:

URL d'accès: http://votreAdresseIP:8080/4DSOAP
Espace de nommage: http://www.4D.com/namespace/default

TRThistoriqueParContactWS

Cette méthode permet de retourner l'historique d'un contact, entre deux dates, concernant les transactions effectuées avec TRT.

SOAP actIon: WebService_TRT#TRThistoriqueParContactWS

Inputs:

  1. DateDebut (laisser à blanc pour afficher tout depuis la première transaction) (date)
  2. DateFin (laisser à blanc pour afficher jusqu'à la transaction la plus récente) (date)
  3. CodeContact: le code contact de la fiche contact désirée dans TRT (texte)
  4. NoCompagnie: TRT étant multi compagnies, le numéro de compagnie dans laquelle faire la recherche (Entier long). Les codes contact de TRT sont uniques à l'intérieur d'une même compagnie seulement (entier long)

Outputs:

  1. NoJournal: tableau texte
  2. DateTransaction: tableau date
  3. NoFacture: tableau texte
  4. NoChèque: tableau texte
  5. MontantIn: montant vendu/acheté: tableau réel
  6. MontantOut: montant reçu/payé: tableau réel
  7. Remarque: tableau texte
  8. Code d'erreur: entier long; 0: aucune erreur; 1: le code contact n'existe pas

TRTminiCompteDuWS

Cette méthode permet de retourner un mini compte dû d'un client. TRT s'en sert dans le journal des ventes et affiche ceci:

SOAP actIon: WebService_TRT#TRTminiCompteDuWS

Inputs:

  1. CodeContact: le code contact du client désiré dans TRT (texte)
  2. NoCompagnie: TRT étant multi compagnies, le numéro de compagnie dans laquelle faire la recherche (Entier long). Les codes contact de TRT sont uniques à l'intérieur d'une même compagnie seulement (entier long)

Outputs:

  1. Resultat1: numérique. Correspond au chiffre vis-à-vis Courant dans l'illustration ci-dessus
  2. Resultat2: numérique. Correspond au chiffre vis-à-vis De 30 à 60 jours dans l'illustration ci-dessus
  3. Resultat3: numérique. Correspond au chiffre vis-à-vis De 60 à 90 jours dans l'illustration ci-dessus
  4. Resultat4: numérique. Correspond au chiffre vis-à-vis Plus de 90 jours dans l'illustration ci-dessus
  5. Borne1: numérique. Correspond à 30 dans l'illustration ci-dessus
  6. Borne2: numérique. Correspond à 60 dans l'illustration ci-dessus
  7. Borne3: numérique. Correspond à 90 dans l'illustration ci-dessus
  8. Code d'erreur: entier long; 0: aucune erreur; 1: le code contact n'existe pas

Contrairement à l'image ci-dessus, le total sous "plus de 90 jours" n'est pas fourni par le WS, à vous de procéder. De plus, le montant correspondant à la marge de crédit n'est pas fourni. C'est également à vous de procéder pour habiller de libellés adéquats une telle image.