Intégration d'images API pour DÉPENSE Chrome River offre un interface de programmation qui vous permet de télécharger des images après avoir exporté les dépenses. Si vous souhaitez utiliser l'interface de programmation avec intégration d'images, veuillez communiquer avec le service d'assistance de Chrome River pour que votre accès soit activé. Cliquez ici pour télécharger l'interface de programmation avec intégration d'images en format de document Word. Remarque : L'interface de programmation d'image de Chrome River exige que l'application du client fournisse un protocole de sécurité TLS 1.2 ou supérieur pour se connecter. Comment accéder au Service <environment_url>/receipts/doitenvironment_url (selon que la requête est envoyée au serveur PROD ou QA) Utilisez l’URL d’AQ ou de production fournie par l’administrateur Chrome River de votre organisation. Arguments POST obligatoires (toujours obligatoires pour chaque méthode d'exécution ci-dessous) un Nom d'utilisateur (utilisateur FTP) pw Mot de passe (mot de passe FTP) méthode méthode d'exécution method=getVoucherInvoices Cette méthode génère une liste de tous les rapports de dépenses exportés pendant une période spécifiée qui comportent des images jointes au rapport ou aux lignes d'élément contenues dans le rapport, selon les dates d'exportation de Chrome River. La plupart des utilisateurs choisissent d'exécuter ce service après minuit pour la journée précédente. Votre entreprise développe un programme qui répète la liste de numéros de rapports et fait appel à la méthode getReceipts pour chacun d'eux. Veuillez prendre note que les caractères non ASCII comme les symboles de devises et les tirets conditionnels ne sont pas entièrement pris en charge actuellement, et peuvent entraîner des problèmes avec cette méthode. Arguments POST obligatoires fromDate Format MM/JJ/AAAA toDate Format MM/JJ/AAAA Remarque : Pour optimiser la requête, la période de dates se limite à 32 jours. Remarque : Les dossiers fournis se limitent aux dates d'exportation comprises dans les 90 derniers jours civils. Si les éléments de dépenses ont été exporté il y a plus de 90 jours, leurs données en format XML ne seront pas fournies. Réussite XML : <list><com.chromeriver.servlet.VoucherInvoiceTO><reportID>0001234567891234</reportID><voucherInvoice>0003698602242029</voucherInvoice><invoiceDate>1236293857500</invoiceDate><invoiceDateString>2016-03-05 22:57:37</invoiceDateString><vendorNumber>1234</vendorNumber><isReceiptUpdatedAfterExport>false</isReceiptUpdatedAfterExport></com.chromeriver.servlet.VoucherInvoiceTO><list/> Erreur XML : <?xml version="1.0" encoding="utf-8"?><com.chromeriver.ws.CrRestHeaderOutput><errorMessage> </errorMessage></com.chromeriver.ws.CrRestHeaderOutput> Remarques concernant les éléments de données voucherInvoice : Numéro de facture du bon créé par le système des finances invoiceDate : Formaté en quelques secondes à partir de 1970 invoiceDateString : Date formatée lisible pour les humains vendorNumber : Valeur Fournisseur 1 ou Fournisseur 2 dans Chrome River method=getReceipts Cette méthode fournit un fichier en format PDF de toutes les images associées à un rapport de dépenses, ou avec les lignes d'élément contenues dans le rapport. Chaque exécution génère un seul fichier en format PDF identifié par le numéro de rapport. Vous pouvez également choisir de fournir le rapport en format PDF associé à un rapport de dépenses et qui sera ajouté au reçu en format PDF. Arguments POST obligatoires Vous pouvez utiliser le numéro de facture du bon OU l'ID du rapport. voucherInvoice Numéro de la facture du bon qui a été fourni à partir de la méthode getVoucherInvoices. IDRapport L'ID du rapport est un numéro à douze chiffres généré par Chrome River et qui commence par 0100. Faites en sorte d'omettre les tirets. Exemple : 010012345678 Arguments POST facultatifs Argument Action Valeurs possibles Valeur par défaut getImage Fournit l'image associée à la dépense true/false true getMileageDetails Fournit la page couverture des détails sur le kilométrage true/false false getPDFReport Fournit le rapport en format PDF complet true/false false getPDFReportWithNotes Fournit le rapport en format PDF complet avec les notes true/false false imageFirst Fournit l'image précédent le rapport en format PDF complet true/false true Renvois En temps normal, l'interface de programmation fournira l'image consolidée et/ou le fichier PDF. Si une erreur survient, l'interface de programmation fournira un fichier XML contenant les données de l'erreur. Remarque : Il n'y a aucune date limite pour exécuter cette fonction. Messages de prise de décision et messages renvoyés en détails S'il n'existe aucune donnée correspondant à l'ID de la facture du bon, le message sera : « Invalid voucherInvoice ». Si les formats PDF et JPG de l'image sont disponibles, les JPG seront récupérés en premier. Si aucun format JPG n'est disponible, le format PDF sera récupéré. Si « getPDFReport » est sélectionné, le PDF original sera récupéré en premier (s'il est disponible). Si aucun format JPG ou PDF n'est associé à cette facture, le message sera : « Les reçus ne peuvent être récupérés. Veuillez renvoyer les reçus pour ce bon. » Si ce rapport de dépenses ne comporte aucune image en pièce jointe, le message sera : « Aucun reçu n'est associé à ce rapport de dépenses. » method=getReceiptsWithCoverPage() Cette méthode fournit un fichier en format PDF de la page couverture ainsi que toutes les images associées à un rapport de dépenses, ou avec les lignes d'élément contenues dans le rapport. Chaque exécution génère un seul fichier en format PDF identifié par le numéro de facture du bon. Vous pouvez également choisir de fournir le rapport en format PDF associé à un rapport de dépenses et qui sera ajouté au reçu en format PDF. Argument POST obligatoire voucherInvoiceFor Pdf Numéro de la facture du bon qui a été fourni à partir de la méthode getVoucherInvoices. reportIDForPdf L'ID du rapport est un numéro à douze chiffres généré par Chrome River et qui commence par 0100. Faites en sorte d'omettre les tirets. Exemple : 010012345678 Renvois En temps normal, l'interface de programmation fournira l'image consolidée et/ou le fichier PDF. Si une erreur survient, l'interface de programmation fournira un fichier XML contenant les données de l'erreur. Remarque : Il n'y a aucune date limite pour exécuter cette fonction. Messages de prise de décision et messages renvoyés en détails S'il n'existe aucune donnée correspondant à l'ID de la facture du bon, le message sera : « Invalid voucherInvoice ». Si les formats PDF et JPG de l'image sont disponibles, les JPG seront récupérés en premier. Si aucun format JPG n'est disponible, le format PDF sera récupéré. Si aucun format JPG ou PDF n'est associé à cette facture, le message sera : « Les reçus ne peuvent être récupérés. Veuillez renvoyer les reçus pour ce bon. » Si ce rapport de dépenses ne comporte aucune image en pièce jointe, le message sera : « Aucun reçu n'est associé à ce rapport de dépenses. » method=getLineItemVoucherInvoices Cette méthode fournit une liste des factures de bons des lignes d'élément, en fonction de la facture du bon remis. SI une ligne d'élément est associée à une image, ALORS ajoutez sa facture de bon de ligne d'élément à la liste fournie. SI certaines images de l'en-tête ne sont associées à aucune ligne d'élément et ne font qu'être disposées sur l'en-tête, ALORS ajoutez l'entrée 00000000 à la liste fournie (qui devrait inclure toutes les images non associées). Format du justificatif de facture de la ligne d'élément : <VoucherInvoice> + "_" + <LineNumber> + <HotelNumber> Argument POST obligatoire lineItemVoucherInvoice Numéro de la facture du bon qui a été fourni à partir de la méthode getVoucherInvoices. Réussite XML : <list><lineItemVoucherInvoice>0860631509020301_00020000</lineItemVoucherInvoice><lineItemVoucherInvoice>0860631509020301_00010000</lineItemVoucherInvoice><lineItemVoucherInvoice>0860631509020301_00000000</lineItemVoucherInvoice></list> method=getLineItemReceipts Cette méthode fournit les reçus des lignes d'élément en format PDF, en fonction de la facture du bon de la ligne d'élément remise. Cela fonctionne également pour fournir toutes les images restantes qui ne sont associées à aucune ligne d'élément (00000000). Format du justificatif de facture de la ligne d'élément : <VoucherInvoice> + "_" + <LineNumber> + <HotelNumber> Argument POST obligatoire voucherInvoiceForReceipt Numéro de facture du bon lié à une ligne d'élément en particulier, fourni à partir de la méthode getLineItemVoucherInvoices. Renvois En temps normal, l'interface de programmation fournira l'image consolidée et/ou le fichier PDF. Ce fichier comportera soit les images liées à cette ligne d'élément en particulier, ou les images restantes du rapport de dépenses non associées à une ligne d'élément (00000000). Si une erreur survient, l'interface de programmation fournira un fichier XML contenant les données de l'erreur. Remarque : Il n'y a aucune date limite pour exécuter cette fonction. method=getLineItemReceiptsWithMileageDetails Si une image de Google Maps est liée à une ligne d'élément devant contenir des images, vous avez la possibilité de fournir une liste en page couverture de toutes les données des dépenses qui y sont associées, y compris d'ID de rapport, le nom du rapport, la personne à rembourser, l'allocation, le taux, la distance et les montants à déduire. Seule la méthode diffère de getLineItemReceipts—tous les autres paramètres sont les mêmes que ceux indiqués ci-dessus pour method=getLineItemReceipts. Remarque : S'il n'y a aucune image de facture associée à la ligne d'élément demandée, un message d'erreur s'affichera—même si des données de kilométrage sont associées à la ligne d'élément. method=getVoucherInvoicesForXML() Cette méthode fournit une liste de tous les rapports de dépenses exportés pendant une période spécifiée comportant des images XML en pièce jointe aux lignes d'élément contenues dans le rapport, selon les dates d'exportation de Chrome River. La plupart des utilisateurs choisissent d'exécuter ce service après minuit pour la journée précédente. Votre entreprise développe un programme qui répète la liste de numéros de rapports et fait appel à la méthode getReceiptsForXML pour chacun d'eux. Arguments POST obligatoires fromDateforXml Format MM/JJ/AAAA toDateforXml Format MM/JJ/AAAA Remarque : Pour optimiser la requête, la période de dates se limite à 32 jours. Remarque : Les dossiers fournis se limitent aux dates d'exportation comprises dans les 90 derniers jours civils. Si les éléments de dépenses ont été exporté il y a plus de 90 jours, leurs données en format XML ne seront pas fournies. Réussite XML : <list><com.chromeriver.servlet.VoucherInvoiceTO><reportID>0001234567891234</reportID><voucherInvoice>0003698602242029</voucherInvoice><invoiceDate>1236293857500</invoiceDate><invoiceDateString>2016-03-05 22:57:37</invoiceDateString><vendorNumber>1234</vendorNumber><isReceiptUpdatedAfterExport>false</isReceiptUpdatedAfterExport></com.chromeriver.servlet.VoucherInvoiceTO><list/> Erreur XML : <?xml version="1.0" encoding="utf-8"?><com.chromeriver.ws.CrRestHeaderOutput><errorMessage> </errorMessage></com.chromeriver.ws.CrRestHeaderOutput> Remarques concernant les éléments de données voucherInvoice : Numéro de facture du bon créé par le système des finances invoiceDate : Formaté en quelques secondes à partir de 1970 invoiceDateString : Date formatée lisible pour les humains vendorNumber : Valeur Fournisseur 1 ou Fournisseur 2 dans Chrome River method=getReceiptsForXML() Cette méthode fournit un fichier en format ZIP de tous les fichiers XML associés à un rapport de dépenses, ou avec les lignes d'élément contenues dans le rapport. Chaque exécution génère un seul fichier en format ZIP identifié par le numéro de rapport. Tous les fichiers XML contenus dans le fichier ZIP seront nommés selon le format suivant : <ReportID>_<UUID>.xml Argument POST obligatoire voucherInvoiceForXml Numéro de facture du bon qui a été fourni à parti de la méthode getVoucherInvoicesForXML. Renvois En temps normal, l'interface de programmation fournira le fichier en format ZIP contenant tous les fichiers XML. Si une erreur survient, l'interface de programmation fournira un fichier XML contenant les données de l'erreur. Remarque : Il n'y a aucune date limite pour exécuter cette fonction. Messages de prise de décision et messages renvoyés en détails Si aucune facture de bon n'est saisie : « VoucherInvoice is required. » S'il n'existe aucune donnée correspondant à l'ID de la facture du bon, le message sera : « Invalid voucherInvoice ». Si ce rapport de dépenses ne comporte aucune image en pièce jointe, le message sera : « Aucun fichier XML n'est associé à ce rapport de dépenses. » Cet article vous a-t-il été utile ? Oui Non