pennylane-client 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 94653df77c6a2fc7f58347338d0591fe5af9fb27567d55a50fddb4249b4f5bd9
-  data.tar.gz: e55bfa20edd8f782e88b95a4409e8a18ab13ee90eaeac9da94a7c3a275b4cb3b
+  metadata.gz: 20da1547f714650d441632ef8e0484ed02cbcbfb7d7c2c7c96f1b7aab0a9667d
+  data.tar.gz: 21e6c36c9b7f0fa4edf1d9a53bb595c55af9914a0afd4b8b6bcf07fb50aca979
 SHA512:
-  metadata.gz: f385797cce13228dd684878e630b746fa2e5e2baf30bcc56ff88bdc63bb2c74c4e22fc5aa863abbd08c4a49cf5f8c4ee14ebcaf8309a89a5ec741c2b20bf9cc1
-  data.tar.gz: 217e0c3ee07cf1f95afe8a8110bd81639eeb38a7a80aca2dfbd6ad01458c6218fef9954fd93f84be3c0509c170a0fcd5e40417e4fc96b565e61931359e5820f7
+  metadata.gz: dff99f4f2e536e4c938e510d0b95bc32cb2c516d6dc7ff0bc9779d7a26e5e7063a956ee7eb0227ce11e35a99b977b9cfc61623e9afd7252a4d7ce67e707e0f83
+  data.tar.gz: 78aef7a7c0ea2424ae9f90b0c1e9676a664bf7129236b1f9099355fdbe7d9b22d4c6d2c70a8d2d1a817256338f647bac89b58a7f181d2672a12e766f61ab54a0

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+### Ajouté
+- `CustomerInvoices#mark_as_paid` marque une facture payée, sans date ni montant : Pennylane
+  importe un Factur-X acquitté comme non payé. Le marquage doit attendre que Pennylane ait lu le
+  fichier, sinon la fin de la lecture l'efface.
+
 
 ## 0.2.0
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    pennylane-client (0.2.0)
+    pennylane-client (0.2.1)
       faraday (>= 0.9, < 3.0)
 
 GEM

data/README.md

@@ -103,8 +103,9 @@ end
 
 `import` accepte un chemin ou un IO ; un IO sans chemin demande `filename:`. `customer_id`,
 facultatif, rattache la facture à un client Pennylane ; Pennylane le reprend une fois le fichier lu.
-Sans lui, Pennylane décide seul du rattachement, d'après le Factur-X — un cas pas encore mesuré en
-sandbox.
+Sans lui, Pennylane crée le client à partir de l'acheteur du Factur-X : nom, SIREN, numéro de TVA et
+adresse, avec une référence externe qu'il génère. Mesuré en sandbox pour un acheteur inconnu ; pour
+un acheteur déjà client, rien ne dit encore s'il est retrouvé ou créé une seconde fois.
 
 Pennylane refuse un fichier déjà déposé et donne l'identifiant de la facture existante : un dépôt
 interrompu avant sa réponse peut donc être rejoué sans risque. Mais il ne reconnaît le doublon qu'au
@@ -175,9 +176,9 @@ Deux cas méritent l'attention de l'application hôte :
 - **`consistent?` faux.** Le montant d'une transaction rapprochée est celui de la transaction
   entière : un virement qui règle plusieurs factures apparaît sur chacune pour son montant total. La
   somme des paiements dépasse alors le montant encaissé, qui reste juste.
-- **`marked_paid?` vrai.** « Marquer comme payée », dans Pennylane, déclare la facture payée sans
-  enregistrer de paiement ni toucher au reste à payer. Aucune date ni aucun montant n'existe pour ce
-  reliquat.
+- **`marked_paid?` vrai.** « Marquer comme payée », dans Pennylane ou par `mark_as_paid`, déclare la
+  facture payée sans enregistrer de paiement ni toucher au reste à payer. Aucune date ni aucun
+  montant n'existe pour ce reliquat.
 
 `settlement` lit la facture si on lui passe un identifiant, puis ses transactions : un ou deux
 appels. Après `find_many`, passez-lui les factures déjà lues.
@@ -185,6 +186,26 @@ appels. Après `find_many`, passez-lui les factures déjà lues.
 `invoices.payments(id)` liste à part les paiements passés par les moyens de paiement de Pennylane
 (Qonto, Stripe, GoCardless, lien de paiement).
 
+## Marquer une facture payée
+
+Pennylane importe un Factur-X comme non payé, même acquitté : il ignore le cadre de facturation
+(BT-23 `B2`, `S2` ou `M2`), le montant déjà payé et le net à payer. Une facture réglée hors de
+Pennylane, en ligne par carte par exemple, se marque payée après son dépôt :
+
+```ruby
+invoice = invoices.find(invoice_id)
+invoices.mark_as_paid(invoice) unless invoice.schematron_validation_status == "pending" || invoice.paid?
+```
+
+Attendez que Pennylane ait fini de lire le fichier, ce que signale `schematron_validation_status`
+en quittant `"pending"`. Mesuré en sandbox, un marquage fait plus tôt est accepté sans erreur, puis
+effacé par la fin de la lecture : la facture repasse non payée. Le passage de suivi qui suit le
+dépôt est le bon moment.
+
+Le marquage n'enregistre ni date, ni montant, ni paiement : `paid?` devient vrai, le reste à payer
+ne bouge pas, et `settlement.marked_paid?` devient vrai. `status` peut rester `"incomplete"`. Marquer
+une facture déjà payée est sans effet.
+
 ## Rechercher
 
 ```ruby

data/lib/pennylane/resources/base.rb

@@ -23,6 +23,10 @@ module Pennylane
         connection.post(path, body).body
       end
 
+      def put(path, body = nil)
+        connection.put(path, body).body
+      end
+
       def post_multipart(path, multipart)
         response = connection.post(path) do |request|
           request.headers["Content-Type"] = multipart.content_type

data/lib/pennylane/resources/customer_invoices.rb

@@ -84,6 +84,13 @@ module Pennylane
         Entities::Settlement.new(invoice, matched_transactions(invoice.id))
       end
 
+      # Pennylane n'enregistre ni date, ni montant, ni paiement : le reste à payer est inchangé, et
+      # `settlement(...).marked_paid?` devient vrai.
+      def mark_as_paid(invoice_id)
+        put("customer_invoices/#{normalize_id(invoice_id)}/mark_as_paid")
+        nil
+      end
+
       # Journal des créations, modifications et suppressions, du plus ancien au plus récent.
       # L'API ne le conserve que quatre semaines : un `since` plus ancien est refusé en 422.
       def changes(since: nil, limit: MAX_CHANGES_LIMIT)

data/lib/pennylane/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pennylane
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pennylane-client
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Hôtentic
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-22 00:00:00.000000000 Z
+date: 2026-11-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday