Statut « ouverte » vs « envoyée » dans Zoho Books France : ce qui change dans vos automatisations

Si vous avez construit des automatisations autour de Zoho Books — export comptable, notification interne, synchronisation CRM — il y a de fortes chances qu'elles reposent sur un déclencheur simple : le passage d'une facture au statut « envoyée ». Dans l'édition France de Zoho Books, ce déclencheur n'existe plus de la même façon, et c'est probablement le point le plus sous-estimé de la migration NF525.

Nous avions identifié ce point dans notre article sur la migration NF525 de Zoho Books. Cet article va plus loin techniquement, avec des exemples concrets pour adapter vos automatisations.

Le changement en une phrase

Dans la version globale, une facture passait de brouillon à envoyée, et ce second statut servait souvent de déclencheur unique pour toute la suite du processus. Dans l'édition France, un nouveau statut intermédiaire s'intercale : ouverte. C'est à ce moment précis — pas avant, pas à l'envoi — que la facture reçoit son numéro définitif, est validée sur ses champs obligatoires, signée numériquement et figée en PDF fiscalisé.

Concrètement, Marquer comme ouverte devient l'équivalent fonctionnel de l'ancien Marquer comme envoyée, mais avec une différence de taille : cette étape doit intervenir avant toute émission conforme, et non plus au moment de l'envoi au client.

Pourquoi ce changement existe

Cette séparation entre création et émission répond directement aux principes d'inaltérabilité de la norme NF525 : tant qu'une facture est en brouillon, elle n'a pas de valeur fiscale figée et peut encore être modifiée librement. Une fois « ouverte », elle devient une pièce fiscale verrouillée. C'est cette bascule, et non l'envoi au client, qui doit désormais déclencher tout ce qui dépend d'une facture réellement émise.

Ce qui dépendait auparavant du statut « envoyée »

Avant d'adapter quoi que ce soit, il faut lister ce qui, dans votre organisation, se déclenche aujourd'hui sur ce statut. Les cas les plus fréquents :

• l'export automatique vers votre outil comptable ou votre ERP ;
• la notification interne (Slack, email) confirmant qu'une facture est partie ;
• la mise à jour d'un deal ou d'une opportunité dans votre CRM ;
• le calcul de commissions ou d'indicateurs commerciaux basés sur les factures émises ;
• tout script ou intégration qui lit le numéro de facture comme référence stable.

Si l'un de ces flux existe chez vous, il utilise très probablement aujourd'hui un critère du type status == "sent" quelque part — dans une règle de workflow Zoho Books, un Zoho Flow, ou un script Deluge personnalisé.

Adapter vos règles d'automatisation

Le changement technique est simple à énoncer, moins simple à retrouver dans tous les recoins de votre configuration. Voici le principe, illustré en Deluge.

Avant — déclenchement sur l'envoi (obsolète en édition France) :

// Ancienne logique — à ne plus utiliser comme déclencheur principal
if(invoiceRecord.get("status") == "sent")
{
    // export comptable, notification, mise à jour CRM...
}

Après — déclenchement sur le passage en « ouverte » :

// Nouvelle logique — le vrai moment d'émission fiscale
if(invoiceRecord.get("status") == "open")
{
    // même traitement, mais déclenché au bon moment du cycle
}

Si votre intégration interroge l'API Zoho Books directement plutôt que de réagir à un workflow interne, le principe reste identique — c'est le champ status renvoyé par l'API qu'il faut vérifier :

response = invokeurl
[
    url: "https://www.zohoapis.eu/books/v3/invoices/" + invoiceId + "?organization_id=" + orgId
    type: GET
    connection: "zoho_books_eu"
];

respStr = response.toString();
if(respStr.contains("status"))
{
    invStatus = response.get("invoice").get("status");
    if(invStatus == "open")
    {
        // la facture est désormais définitive : numéro attribué, PDF figé
        invoiceNumber = response.get("invoice").get("invoice_number");
    }
}

Le piège du numéro de facture en brouillon

Un point technique mérite une attention particulière : dans l'édition France, une facture en brouillon n'a pas de numéro définitif. Si une de vos intégrations lit et stocke ce numéro dès la création du brouillon — par exemple pour le communiquer à un système tiers ou générer une référence de paiement — elle capture une valeur qui peut ne plus correspondre au numéro final une fois la facture « ouverte ».

if(invStatus == "draft")
{
    // Ne pas exploiter le numéro ici : il n'est pas encore définitif
    info "Facture en brouillon — numéro non stabilisé, traitement différé";
}
else if(invStatus == "open")
{
    // Le numéro est désormais fiable pour toute référence externe
    invoiceNumber = response.get("invoice").get("invoice_number");
}

La règle pratique : tout traitement qui a besoin d'un numéro de facture stable doit attendre le statut open, jamais le statut draft.

Comment tester vos automatisations avant la migration

Avant de basculer votre organisation vers l'édition France, quatre vérifications simples permettent d'éviter la majorité des mauvaises surprises :

1. Inventoriez tous les workflows Zoho Books, Zoho Flow et scripts personnalisés qui référencent le statut d'une facture.
2. Recherchez les critères status == "sent" (ou équivalents dans vos workflows visuels) et identifiez-les comme candidats au changement.
3. Vérifiez si un traitement quelconque lit le numéro de facture avant le passage en open.
4. Testez, si possible dans un environnement de test Zoho Books, le nouveau cycle draft → open → envoi avec vos automatisations adaptées, avant de migrer votre organisation en production.

Zoho a été clair sur ce point : les intégrations existantes ne devraient pas être cassées dans leur principe, mais les séquences métier doivent être réévaluées une par une — ce n'est pas un correctif automatique.

FAQ — Statut ouverte Zoho Books

Le statut « ouverte » remplace-t-il complètement le statut « envoyée » ?
Non, les deux statuts coexistent, mais leur ordre et leur rôle changent. « Ouverte » devient le moment de finalisation fiscale ; l'envoi reste une étape distincte qui peut suivre.

Mes automatisations vont-elles s'arrêter de fonctionner du jour au lendemain après migration ?
Pas nécessairement dans leur mécanique technique, mais elles risquent de se déclencher au mauvais moment — trop tôt, sur un brouillon, ou jamais si elles attendaient un statut qui n'est plus utilisé de la même façon.

Comment savoir si un de mes workflows Zoho Books utilise encore l'ancien critère ?
Passez en revue chaque règle de workflow associée au module Factures, et recherchez toute condition basée sur le statut « envoyée ».

Faut-il réécrire tous mes scripts Deluge liés à la facturation ?
Pas tous — seuls ceux qui utilisent le statut ou le numéro de facture comme déclencheur ou référence sont concernés.

Prochaine étape

Ce point technique est rarement visible tant qu'on n'a pas testé le nouveau cycle en conditions réelles — c'est pourquoi nous recommandons de le traiter en priorité, avant la bascule, plutôt qu'en réaction après un blocage. Notre guide complet sur la migration NF525 de Zoho Books couvre l'ensemble des autres points à vérifier (données, modèles PDF, champs légaux).

Basée à Paris et en Belgique, l'équipe Amadeus Concept peut auditer vos automatisations Zoho Books existantes avant votre migration. Contactez-nous pour un point technique sur vos workflows.