Vous trouverez ici un résumé complet des API publiques que vous pouvez utiliser avec Factorial pour créer des intégrations de dépenses, des automatisations, des exportations et des flux en temps réel. Il vous oriente vers les pages de documentation appropriées et recommande les points de terminaison et les fonctionnalités à utiliser pour les scénarios les plus courants.

Ressources API principales que vous utiliserez pour les dépenses

La référence de l'API présente les ressources les plus utiles pour l'automatisation et le rapprochement des dépenses. Les principales ressources sont :

• Dépenses et dépenses (lire et inspecter les dossiers de dépenses)
• Points de terminaison de kilométrage et d'indemnités journalières pour les données programmatiques d'indemnités journalières et de kilométrage
• Documents pour les pièces jointes et les URL de téléchargement
• Points de terminaison bancaires tels que CardPayment et Transaction pour rapprocher l'activité des cartes
• Points de terminaison financiers tels que JournalEntry , FinancialDocument , AccountingSetting , CostCenter pour la publication et le mappage

Vous trouverez la liste complète des ressources dans la référence API. Factorial

Cas d'utilisation pratiques et points finaux recommandés

1. Exportation des dépenses par programmation
   • Utilisez les points de terminaison Dépenses/Dépensables pour extraire les données transactionnelles. Incluez des champs tels que le montant du document, le montant remboursable, la devise, le taux de change, le statut d'approbation, le lien reçu/document, les codes comptables et le projet/centre de coûts. Vérifiez si la ressource prend en charge uniquement la fonction GET ou la création/mise à jour en fonction de la référence.
2. Gestion des pièces jointes et des reçus
   • Utilisez la ressource Documents pour récupérer les URL de téléchargement ou lier des documents à des dépenses. Si vous avez besoin de pièces jointes intégrées pour un ERP, envisagez de demander un extrait SQL/packagé personnalisé via Factorial plutôt que de télécharger à plusieurs reprises des pièces jointes binaires via l'API.
3. Rapprochement des transactions par carte
   • Utilisez les points de terminaison bancaires (CardPayment, Transaction) pour comparer les flux émetteur/carte avec les relevés de dépenses. Incluez card_last4 et les identifiants de transaction dans vos exportations pour une correspondance fiable.
4. Automatisation des indemnités journalières et du kilométrage
   • Tirez les points de terminaison PerDiem et Mileage pour rapprocher les demandes d'indemnités journalières avec les reçus soumis et pour calculer les ajustements de paie si nécessaire.
5. Notifications en temps réel et synchronisations bidirectionnelles
   • Abonnez-vous aux webhooks pour être informé des événements « depense.created », « depense.updated », « card.payment » ou similaires (consultez le guide des webhooks). Utilisez les webhooks pour déclencher des workflows en aval, comme les alertes Slack, la création de factures ou les tâches du planificateur.

Notes de mise en œuvre importantes et meilleures pratiques

• Authentification : utilisez les clés API ou OAuth, comme indiqué dans les guides de démarrage. Effectuez la rotation des clés et respectez les bonnes pratiques de stockage sécurisé. Factorial
• Vérifier les capacités des ressources : certains points de terminaison sont en lecture seule, tandis que d'autres acceptent les requêtes POST/PUT. Confirmer dans la référence avant de coder. Factorial
• Pagination : implémentez toujours la pagination aux extrémités des listes afin d'éviter les dépassements de délai ou les données partielles. Consultez le guide de pagination pour plus de détails. Factorial
• Webhooks : utilisez les abonnements webhook pour les flux en temps réel et implémentez des gestionnaires idempotents. Consultez les politiques et exemples de webhooks dans la documentation. Factorial
• Gestion des versions et journal des modifications : liez les requêtes à une version d'API spécifique et surveillez le journal des modifications pour détecter les changements importants. Consultez régulièrement le journal des modifications pendant le développement et avant les déploiements en production. Factorial
• Champs d'exportation à demander : montant du document, montant remboursable, devise, taux de change, montant de base, URL du reçu, statut d'approbation, code du compte comptable, code du projet, centre de coûts et date de la carte (4 dernières de la carte) pour un rapprochement en aval clair. (Il s'agit de champs recommandés, et non d'exigences API strictes.)

Gestion des erreurs et conseils opérationnels

• Détectez et réconciliez les différences FX en incluant à la fois document_amount et base_amount avec exchange_rate .
• Pour les extraits historiques volumineux, préférez les rapports SQL Analytics planifiés ou l'équipe Données plutôt que les extractions d'API volumineuses et répétées.
• Des limites de débit, des quotas ou des accès spéciaux peuvent s'appliquer. Consultez les guides de démarrage et la référence API pour toute remarque d'utilisation. Factorial

Où trouver les détails et suivre les modifications

• Guides et démarrage rapide pour les développeurs : pages de démarrage. Factorial
• Référence complète des points de terminaison et liste des ressources : Référence API. Factorial
• Historique des versions et journal des modifications : Changelog. Factorial

Besoin d'aide ou souhaitez un extrait personnalisé ?

Si vous avez besoin d'un fichier CSV/XLSX planifié, de pièces jointes intégrées ou d'une jointure complexe entre dépenses et transactions par carte, demandez un rapport SQL Analytics personnalisé via le support. Pour toute question technique concernant l'API, utilisez le formulaire de contact/support technique dans la documentation. Factorial