Introduction
Ces Services web vous permettent de télécharger des fichiers directement dans Yuki au départ de votre propre application. Ces Services web fonctionnent par HTTP POST.
Les fichiers peuvent être postés un par un avec le type de contenu multipart/form-data et application/x-www-form-urlencoded.
Pour simplifier le processus de développement, vous trouverez dans le bas de cette page une série de liens vers des applications d'exemple avec lesquelles vous pourrez faire appel à cette méthode de Services web.
Vous trouverez les Services web, une application test, une description des champs et des procédures à l'adresse web indiquée ci-après.
Adresse web
https://api.yukiworks.nl/docs/Upload.aspx
Authentification
Pour les comptables avec un portail
Authentifier les comptables avec portail par la WebserviceAccessKey. Le WebServiceAccessKey peut être créé dans le portail du comptable.
Utilisateurs
Les utilisateurs peuvent s'authentifier moyennant la WebserviceAccessKey ou le nom d'utilisateur et le mot de passe.
Statut de la réponse
Ces Services web offrent deux options pour relier le résultat de l'action POST.
- Par un message XML (méthode de rétroaction)
Le message XML se trouve dans la réponse de ce service web. Il contient le statut du téléchargement et des notifications de validation éventuelles.
- Par une redirection
Avec cette option, vous pouvez mentionner une adresse web qui détermine vers où il convient de rediriger le téléchargement si ce dernier a échoué ou réussi.
Paramètres
Domaine
Le nom du domaine où vous souhaitez livrer vos documents.
UserName
Le nom d'utilisateur avec lequel vous avez accès au domaine dans Yuki. Ce paramètre est obligatoire en l'absence d'authentification avec WebServiceAccessKey.
WebServiceAccessKey
Le WebServiceAccessKey peut être créé dans un domaine ou à travers le portail du comptable. Ce code d'accès peut permettre l'accès aux Services web au niveau de l'administration ou du domaine. Les instructions pour la création d'un code d'accès se trouvent sur cette page.
Administration
L'ID de l'administration vers laquelle vous souhaitez télécharger le document. Les instructions pour la récupération de l'ID d'administration se trouvent sur cette page.
Dossier
Le dossier dans lequel vous souhaitez enregistrer le document. La valeur standard de ce paramètre est « 7 ». Options possibles :
ID de dossier Description
0 | Divers |
1 | Achat |
2 | Vente |
3 | Banque |
4 | HRM |
5 | Impôt |
6 | Assurance |
7 | Chercher dans yuki |
8 | Divers financiers |
100 | A commander soi-même |
101 | Correspondance |
102 | Reunions |
FolderTab
L'onglet de dossier dans lequel vous souhaitez enregistrer le document. La valeur par défaut de ce paramètre est vide.
ProjectID
Il s'agit du HID du Projet auquel vous souhaitez lier le document. La mention de ce paramètre rend le paramètre « ProjectCode » superflu. L'option pour les projets doit correctement être activée dans le contrat.
ProjectCode
Le code du projet auquel vous souhaitez lier le document. Ce paramètre est uniquement utilisé si le paramètre « Project ID » n'est pas affiché. L'option pour les projets doit correctement être activée dans le contrat.
Fichier
Le document à livrer.
ResponseType
Ce paramètre détermine la manière dont ce service web répond à l'action POST. S'il s'agit d'un « XML », le résultat de l'action POST sera en format XML dans le navigateur. S'il s'agit de l'option de « Redirection », une redirection sera effectuée après l'action POST. La valeur par défaut de ce paramètre est XML.
RedirectUrlSuccess
Ce paramètre (string) est uniquement obligatoire en combinaison avec le ResponseType « Redirection » et détermine l'url vers laquelle il convient de rediriger si le téléchargement a réussi. Un paramètre supplémentaire est ajouté à cette url, « DocumentID= » avec pour valeur l'ID (GUID) du document stocké dans Yuki.
RedirectUrlFailed
Ce paramètre est uniquement obligatoire en combinaison avec le ResponseType « Redirection » (rediriger) et détermine l'url vers laquelle il convient de rediriger si le téléchargement a échoué. Un paramètre supplémentaire est ajouté à cette url, « DocumentID= » avec pour valeur l'ID (GUID) du document stocké dans Yuki.
Cet article a-t-il été utile ?
C'est super !
Merci pour votre commentaire
Désolé ! Nous n'avons pas pu vous être utile
Merci pour votre commentaire
Commentaires envoyés
Nous apprécions vos efforts et nous allons corriger l'article