Comptabilité commerciale et stock

Cycle des factures, abonnements et remboursements

customer.upserted crée ou synchronise un client propre à la connexion par révisions : nom de facturation, coordonnées, adresse et identité fiscale. Aucun rapprochement automatique avec des clients manuels ou sans lien.
invoice.created, order.created et subscription.renewed créent des factures. invoice.updated et order.updated appliquent les révisions de brouillon prises en charge. Les anciennes sont ignorées, les conflits examinés. Les factures comptabilisées se corrigent par avoir explicite ou ajustement Ledger contrôlé, jamais par écrasement.
Envoyez un identifiant de facture distinct par période mensuelle ou annuelle. Transmettez proratas et changements avec montants réels et période ; MeshDex ne calcule ni échéanciers ni droits. Les événements de création, modification et résiliation d’abonnement actualisent les références avec accountingEffect: NONE. Annuler un renouvellement futur ne rembourse ni n’annule une période payée.
invoice.cancelled et order.cancelled annulent les brouillons impayés et libèrent les réservations non exécutées. Les dossiers comptabilisés, payés ou exécutés nécessitent un avoir, remboursement ou retour explicite.
payment.captured comprend invoiceId, paymentId, currency, amountMinor et paidAt facultatif. Il enregistre l’encaissement confirmé en banque ou transit. Autorisations et échecs restent des références.
credit.issued comprend invoiceId, creditId, currency, amountMinor, taxMinor, reason et creditedAt facultatif. Il réduit produits ou créance sans rendre de trésorerie.
refund.completed comprend invoiceId, refundId, currency, amountMinor, taxMinor, reason et completedAt ; il enregistre remboursement confirmé et avoir associé. Fournissez creditId pour réutiliser un avoir correspondant, utilisable par un seul remboursement identique. Sinon un avoir distinct est créé. Des identifiants répétés ne dupliquent pas les effets. Création et échec de remboursement restent des références.
Plusieurs remboursements partiels sont possibles dans les limites de trésorerie, avoir et taxe restantes. Les retours utilisent return.received avec orderId, returnId, lines et qualityApproved. Un remboursement ne réintègre pas le stock. Les retours attendent l’inspection ; l’approbation source ne vaut qu’après choix administratif d’une politique de confiance.

Règlements, commissions et contestations

Utilisez un compte de transit à l’actif lorsque la passerelle verse ultérieurement le net. settlement.completed identifie settlementId, currency, settlementCurrency, grossMinor, netMinor, feeMinor, feeTaxMinor, bankAccountId, feeAccountId et completedAt. Fournissez des entries RECEIPT ou REFUND avec externalId stable et amountMinor. Chaque encaissement ou remboursement doit correspondre exactement et ne peut appartenir qu’à un règlement. Les dépendances manquantes attendent ; doublons et conflits exigent un examen.

Le brut correspond aux encaissements moins remboursements. Net, commissions et taxe égalent le brut converti. Le change exige settlementExchangeRate, settlementExchangeRateSource et settlementExchangeRateDate ; exchangeRate convertit ensuite en devise de base Ledger. La taxe exige un compte d’actif de taxe déductible feeTaxAccountId et feeTaxReference source. Le règlement libère les valeurs comptables vérifiées du transit et comptabilise dépôt net, frais, taxe et écarts de change explicites.

chargeback.opened comprend chargebackId, paymentId, currency, amountMinor, reason et completedAt. Il inscrit une créance de contestation contre trésorerie ou transit sans annuler la facture. chargeback.reversed comprend chargebackId, currency et completedAt pour récupérer ce même litige ; une récupération en devise fournit taux réel, source et date. Le cumul ne dépasse pas l’encaissement. Corriger ou extourner un paiement déjà réglé exige un rapprochement et ne défait pas silencieusement un reçu.

Identité du catalogue et propriété du stock

Les identifiants produit et variante sont stables ; SKU et nom décrivent sans rapprocher automatiquement. GET /api/integrations/commerce/v1/catalog/ renvoie les correspondances approuvées ; suivez nextCursor. Les événements conservent les références sans écraser les produits Ledger/Supply ni publier du stock.

Approuvez dans Gérer → Catalogue et événements : Ledger seul, exécution externe, Stock Supply ou Vérification Supply. Seul Stock Supply réserve automatiquement. La disponibilité utilise entrepôt, réservations, rappels, disposition et stock de sécurité approuvés. GET /api/integrations/commerce/v1/availability/?productId=your-source-id&variantId=your-variant-id renvoie la tranche ou quantité configurée.

fulfillment.completed consomme une seule fois la réservation complète. Une exécution partielle ou des lignes modifiées exigent un examen. return.received ne dépasse pas les quantités exécutées et utilise le lieu approuvé. La publication Supply vers un canal concerne des connecteurs gérés activés séparément ; ce contrat ne déclare pas Shopify ou WooCommerce disponibles.

Tests, imports historiques et rapprochements

Commencez par une connexion Test distincte. Elle valide données, configuration, correspondances et taxe avec TEST_VALIDATED sans comptabiliser clients, factures, reçus, avoirs ou stock réels.
POST /api/integrations/commerce/v1/batches/ avec events en tableau JSON et dryRun: true valide le lot. historical: true conserve un aperçu avec totaux par devise, points de contrôle et empreinte d’approbation. Il reste un aperçu même avec dryRun: false.
Dans Gérer → Rapprochement et imports, associez d’abord clients et factures manuels. Saisissez identifiants externes et Ledger exacts et motif d’audit. La facture est contrôlée sur client, devise et total initial d’un instantané source version 2. La synchronisation client exige une case distincte explicite.
Vérifiez totaux et tous les points de contrôle. L’application exige administration autorisée, connexion Réel active, empreinte exacte et motif. Chaque action met au plus 25 événements en file ; Reprendre continue au point enregistré. Une file terminée ne signifie pas une comptabilité terminée.
Examinez résultats et rapprochement après traitement. Reprise et répétition réutilisent les reçus. Corrigez dépendances et correspondances avant réessai. Un lot modifié exige un nouvel aperçu ; ne remplacez jamais les valeurs immuables de paiement ou remboursement.

Produits constatés d’avance facultatifs

Pour une connexion SaaS, un comptable peut choisir l’étalement sur la période de service et un compte de passif approuvé dans le routage. Les nouvelles factures utilisent les dates source. Changer la politique ne réécrit ni factures ni échéanciers approuvés.

Seul le produit net est différé ; taxe et trésorerie restent distinctes. La reconnaissance linéaire quotidienne utilise UTC et une date de fin exclusive. Le dernier jour absorbe l’arrondi. Une obligation de service est prise en charge par facture.

Fournissez identité d’abonnement et période mensuelle ou annuelle explicite. Confirmez comptes de produits et de passif avant comptabilisation.
Dans Rapprochement et imports, ouvrez Produits constatés d’avance, choisissez facture et date de service achevée puis prévisualisez montants acquis et différés.
Indiquez un motif et approuvez l’aperçu exact. Effectuez les approbations indépendantes Ledger nécessaires avant comptabilisation du journal préparé.
Actualisez après un avoir ou une modification et vérifiez un nouvel aperçu. Une approbation périmée ne remplace pas l’échéancier ; une répétition retrouve le journal existant.

Les avoirs réduisent parts acquise et différée selon la valeur comptable initiale. Un avoir complet clôt l’échéancier ; l’extourne d’une facture impayée suit le processus contrôlé.
Ne modifiez ni n’annulez un journal de reconnaissance indépendamment de sa facture. Une extourne de facture créditée exige une vérification comptable.
La reconnaissance est initiée par un comptable. Elle ne génère ni renouvellement, ni changement de droits, ni remboursement de passerelle.

Guides associés

Besoin d’aide pour cet espace ?

Demandez les accès à votre administrateur ou contactez le support en précisant la page et un message d’erreur expurgé des données sensibles.

Cycle des factures, abonnements et remboursements

customer.upserted crée ou synchronise un client propre à la connexion par révisions : nom de facturation, coordonnées, adresse et identité fiscale. Aucun rapprochement automatique avec des clients manuels ou sans lien.

invoice.created, order.created et subscription.renewed créent des factures. invoice.updated et order.updated appliquent les révisions de brouillon prises en charge. Les anciennes sont ignorées, les conflits examinés. Les factures comptabilisées se corrigent par avoir explicite ou ajustement Ledger contrôlé, jamais par écrasement.

Envoyez un identifiant de facture distinct par période mensuelle ou annuelle. Transmettez proratas et changements avec montants réels et période ; MeshDex ne calcule ni échéanciers ni droits. Les événements de création, modification et résiliation d’abonnement actualisent les références avec accountingEffect: NONE. Annuler un renouvellement futur ne rembourse ni n’annule une période payée.

invoice.cancelled et order.cancelled annulent les brouillons impayés et libèrent les réservations non exécutées. Les dossiers comptabilisés, payés ou exécutés nécessitent un avoir, remboursement ou retour explicite.

payment.captured comprend invoiceId, paymentId, currency, amountMinor et paidAt facultatif. Il enregistre l’encaissement confirmé en banque ou transit. Autorisations et échecs restent des références.

credit.issued comprend invoiceId, creditId, currency, amountMinor, taxMinor, reason et creditedAt facultatif. Il réduit produits ou créance sans rendre de trésorerie.

refund.completed comprend invoiceId, refundId, currency, amountMinor, taxMinor, reason et completedAt ; il enregistre remboursement confirmé et avoir associé. Fournissez creditId pour réutiliser un avoir correspondant, utilisable par un seul remboursement identique. Sinon un avoir distinct est créé. Des identifiants répétés ne dupliquent pas les effets. Création et échec de remboursement restent des références.

Plusieurs remboursements partiels sont possibles dans les limites de trésorerie, avoir et taxe restantes. Les retours utilisent return.received avec orderId, returnId, lines et qualityApproved. Un remboursement ne réintègre pas le stock. Les retours attendent l’inspection ; l’approbation source ne vaut qu’après choix administratif d’une politique de confiance.

Règlements, commissions et contestations

Identité du catalogue et propriété du stock

Tests, imports historiques et rapprochements

Commencez par une connexion Test distincte. Elle valide données, configuration, correspondances et taxe avec TEST_VALIDATED sans comptabiliser clients, factures, reçus, avoirs ou stock réels.

POST /api/integrations/commerce/v1/batches/ avec events en tableau JSON et dryRun: true valide le lot. historical: true conserve un aperçu avec totaux par devise, points de contrôle et empreinte d’approbation. Il reste un aperçu même avec dryRun: false.

Dans Gérer → Rapprochement et imports, associez d’abord clients et factures manuels. Saisissez identifiants externes et Ledger exacts et motif d’audit. La facture est contrôlée sur client, devise et total initial d’un instantané source version 2. La synchronisation client exige une case distincte explicite.

Vérifiez totaux et tous les points de contrôle. L’application exige administration autorisée, connexion Réel active, empreinte exacte et motif. Chaque action met au plus 25 événements en file ; Reprendre continue au point enregistré. Une file terminée ne signifie pas une comptabilité terminée.

Examinez résultats et rapprochement après traitement. Reprise et répétition réutilisent les reçus. Corrigez dépendances et correspondances avant réessai. Un lot modifié exige un nouvel aperçu ; ne remplacez jamais les valeurs immuables de paiement ou remboursement.

Produits constatés d’avance facultatifs

Fournissez identité d’abonnement et période mensuelle ou annuelle explicite. Confirmez comptes de produits et de passif avant comptabilisation.

Dans Rapprochement et imports, ouvrez Produits constatés d’avance, choisissez facture et date de service achevée puis prévisualisez montants acquis et différés.

Indiquez un motif et approuvez l’aperçu exact. Effectuez les approbations indépendantes Ledger nécessaires avant comptabilisation du journal préparé.

Actualisez après un avoir ou une modification et vérifiez un nouvel aperçu. Une approbation périmée ne remplace pas l’échéancier ; une répétition retrouve le journal existant.

Les avoirs réduisent parts acquise et différée selon la valeur comptable initiale. Un avoir complet clôt l’échéancier ; l’extourne d’une facture impayée suit le processus contrôlé.

Ne modifiez ni n’annulez un journal de reconnaissance indépendamment de sa facture. Une extourne de facture créditée exige une vérification comptable.

La reconnaissance est initiée par un comptable. Elle ne génère ni renouvellement, ni changement de droits, ni remboursement de passerelle.