Vos documents de factures se trouvent dans vos serveurs et vous souhaitez les envoyer dans Clearnox pour les intégrer dans vos relances. Cet article vous expliquera comment mettre en place cette fonctionnalité.
Envoyer les factures en masse via l'API Clearnox
L'API publique Clearnox permet d'envoyer les factures en masse dans Clearnox, elle propose deux appels :
- Le premier permet de récupérer la liste des écritures qui n'ont pas de facture associée, pour envoyer uniquement les factures qui manquent. Il est recommandé d'utiliser la pagination comme détaillé dans la documentation API.
- Le deuxième permet d'envoyer les pdf de factures en masse grâce à une archive zippée qui comporte les documents et un fichier d'association entre ces documents et les écritures concernées.
La documentation API complète est accessible ici elle permet aussi de tester les deux appels susmentionnés.
L'authentification API utilise les mêmes identifiants que le connecteur qui sont accessibles directement depuis le connecteur ou bien depuis l'interface Administrateur Clearnox "Configurer > Accès connecteur".
Mise en place de l'API
L'envoi en masse nécessite le développement d'un module qui exécute les tâches suivantes :
- Premier appel API pour avoir la liste des écritures qui n'ont pas de document de facture dans Clearnox,
- Récupérer les documents de factures depuis vos serveurs et construire une archive,
- Deuxième appel API pour envoyer l'archive de l'étape précédente.
On recommande de planifier l'exécution de ces tâches juste après la synchronisation des données.
Pour réaliser ce développement, il y a plusieurs possibilités selon votre situation : - Développer ce module si vous disposez de développeurs en interne. - Solliciter votre partenaire pour ce développement. - Contacter l'équipe commerciale [email protected] qui peut vous orienter vers un partenaire en mesure de vous aider.
Visualiser vos factures dans Clearnox
Une fois l'envoi en masse réalisé, les documents de factures sont visibles dans la situation de compte de vos clients dans la colonne "Factures". Au clic sur l'icône qui représente un document, vous pouvez la visualiser et la télécharger.
Désormais les factures sont bien présentes dans votre compte Clearnox et vous pouvez les intégrer dans vos relances comme expliqué ici.
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