Ce service Web a été développé sur la base de la demande de création de projets directement dans Yuki à partir de packages ERP externes. Parce que les fichiers / projets peuvent désormais passer automatiquement du package ERP à Yuki, cela fait gagner du temps à l'entrepreneur pour créer manuellement le projet à deux endroits.
Procédure
Vérifiez d'abord si le module Projets Yuki est activé (à partir de l'abonnement Medium). Si ce n'est pas le cas, le service Web donnera un message d'erreur.
Pour collecter d'abord les projets existants, le service Web AccountingInfo peut être utilisé. Il a une fonction GetProjects qui affiche tous les Projets d'un domaine.
URL
https://api.yukiworks.be/ws/Projects.asmx?WSDL
Description fonctionnelle
Exemple de schéma XML
<project> <Description>Test dossier 1</Description> <Code>TESTDOS</Code> <Company>?</Company> <Manager>?</Manager> <Contact>?</Contact> <Notes>?</Notes> <SecurityLevel>2</SecurityLevel> <AllowOCRMatching>1</AllowOCRMatching> <StartDate>?</StartDate> <EndDate>?</EndDate> <BudgetRevenue>?</BudgetRevenue> <BudgetCosts>?</BudgetCosts> </project>
Champs de description
Tous les champs correspondent aux champs disponibles dans le module Projets Yuki
Projet: Description
Vous entrez ici la description / le nom de votre projet. La description est la balise la plus importante, car tous les autres champs peuvent être mis à jour via cet identifiant après avoir créé un projet. Le champ Description doit toujours être unique par projet. Ce champ est sensible à la lettre majuscule.
Projet: Code
Cela inclut le code avec lequel les documents peuvent être liés au projet. La reconnaissance OCR peut lire ce code dans des documents PDF ou peut être entrée à l'avant de l'objet de l'e-mail avec un hachage / hashtag.
Le code doit comporter au moins 6 caractères lorsque AllowOCRMatching est défini sur True.
Projet: Entreprise
Si votre domaine a plusieurs administrations, vous pouvez saisir ici l'ID d'administration de votre administration.
Projet: Manager
Si vous souhaitez affecter un administrateur spécifique au projet, vous pouvez le faire ici. Un administrateur est un utilisateur du domaine. Utilisez l'adresse e-mail de cet utilisateur dans le XML. Si aucun administrateur n'est affecté, ce sera par défaut «Yuki».
Projet: Contact
Le champ Contact fait référence à une relation spécifique (fournisseur ou client). Vous pouvez ajouter une relation en entrant l'ID de la relation. Vous pouvez récupérer ces ID via l'appel SearchContacts.
Projet: Notes
Ici, vous pouvez ajouter des notes supplémentaires.
Projet: SecurityLevel
Vous pouvez protéger les projets en déterminant l'accès. Il existe quatre niveaux de sécurité:
La sécurité | code | extra info |
Tous les utilisateurs | 1 | tous les utilisateurs y ont accès. |
Tous les employés | 2 | Seuls les utilisateurs qui ont également été créés en tant qu'employés ont accès. |
Direction | 3 | Seul un utilisateur avec le rôle «Management» a accès. |
Administrateur + membres | 4 | Seul l'administrateur (Project: Manager) a accès à ce fichier et aux membres individuels. Les membres devront toujours être assignés manuellement dans Yuki. |
Si aucun niveau de sécurité n'est indiqué lors de la création d'un fichier, il est défini sur "Tous les employés" par défaut.
Projet: AllowOCRMatching
Si vous définissez la valeur de ce champ sur «0», les documents ne seront pas automatiquement attribués via la reconnaissance OCR. La valeur «1» garantit que les documents sont automatiquement affectés au projet. Par défaut, 0 est entré lorsque vous l'omettez.
Projet: Date de début
Date de début du projet. Les documents dont la date de facturation est antérieure à cette date de début ne sont pas automatiquement affectés à ce projet.
Projet: Date de fin
Date de fin du projet. Les documents dont la date de facturation est postérieure à cette date de fin ne sont pas automatiquement affectés à ce projet.
Projet: Budget Vente
Chiffre d'affaires estimé de ce projet.
Projet: Budget Achat
Coût estimé pour ce projet.
Messages d'erreur possibles
Message d'erreur Soap | Cause |
Aucune entreprise valide n'a été trouvée pour cet ID | Aucun ID d'administration valide n'a été transmis en tant que société. |
Aucun utilisateur valide n'a été trouvé pour cette connexion | La connexion dans le champ Manager ne correspond pas à un utilisateur existant du domaine. |
L'ID de contact donné n'est pas un GUID valide | Un ID donné dans le champ Contact n'est pas un GUID valide. |
Aucun contact valide n'a pu être trouvé pour cet ID | Aucune relation existante ne peut être mise en correspondance avec un ID de contact entré. |
Le code doit comporter plus de 6 caractères si AllowOCRMatching est vrai | Si AllowOCRMatching est défini sur 1, le code de projet doit comporter plus de 6 caractères. |
Le domaine n'est pas autorisé pour cette fonctionnalité | Le Projets Yuki n'est pas actif dans ce domaine (à partir de l'abonnement Medium). |