@fleetkeep/cli 0.8.0 → 0.8.1

package/README.md

@@ -193,4 +193,12 @@ retry with the same key returns the original record instead of creating a duplic
 
 The private email-forwarding address requires `tolls:write`, including when reading it: anyone holding that address can submit statements. Read-only integrations do not receive it.
 
-CLI toll statement imports accept CSV files up to 256 KiB, the published API limit. Email forwarding accepts up to five CSV attachments of 512 KiB each. Preview and confirm the exact file digest before a CLI import is applied.
+CLI toll statement imports accept CSV files up to 256 KiB, the published API limit. Email forwarding accepts up to five PDF or CSV attachments of 512 KiB each. PDF charges always wait for approval. Preview and confirm the exact file digest before a CLI import is applied.
+
+### PDF invoices
+
+Forward the original PDF invoice to the account’s private forwarding address, or upload it in Toll Control. PDF charges wait for review before saving. CSV statements remain supported. Text-based GBP PDFs from recognised UK toll providers are supported; scanned, encrypted or ambiguous documents return an actionable error rather than guessed charges.
+
+`fleetkeep api call listTollPdfReviews` lists the signed-in account’s extracted rows and confirmation digests. Check the rows against the original invoice, then use `fleetkeep api call confirmTollPdfReview --data-file reviewed-pdf.json` with `batchId`, `confirmDigest`, `csv` and `confirmed: true`. The CSV is the reviewed structured data, not a file the customer needs to prepare. Keep the digest from the current review. Repeat confirmation is idempotent; a different account cannot read or confirm the invoice.
+
+These operations require a CLI release containing the PDF operation definitions. The backend candidate must be deployed before use.

package/fleetkeep.mjs

@@ -452,7 +452,8 @@ function printImport(payload, jsonOutput) {
 function printTollForwarding(payload, jsonOutput) {
   const lines = [
     `Email forwarding: ${payload.available === false ? 'not available' : payload.enabled ? 'enabled' : 'not enabled'}`,
-    ...(payload.address ? [`Forward CSV statements to: ${payload.address}`] : []),
+    ...(payload.address ? [`Forward PDF invoices or CSV statements to: ${payload.address}`] : []),
+    'PDF charges wait for review: fleetkeep api call listTollPdfReviews',
     `Inbox checked every ${payload.pollIntervalMinutes.toLocaleString('en-GB')} minutes.`,
     ...(payload.enabled || payload.available === false
       ? []

package/operations.mjs

@@ -300,6 +300,8 @@ const definitions = [
     'tolls:write',
     { idempotency: true }
   ],
+  ['listTollPdfReviews', 'GET', '/api/v1/tolls/pdf-reviews', 'tolls:read'],
+  ['confirmTollPdfReview', 'POST', '/api/v1/tolls/pdf-reviews', 'tolls:write'],
   ['getTollForwarding', 'GET', '/api/v1/tolls/forwarding', 'tolls:write'],
   ['enableTollForwarding', 'POST', '/api/v1/tolls/forwarding', 'tolls:write'],
   ['previewTollImport', 'POST', '/api/v1/tolls/imports/preview', 'tolls:read'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fleetkeep/cli",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Operate every published Fleetkeep API workflow with guarded writes and machine-readable output",
   "type": "module",
   "bin": {