zinkee 0.1.50 → 0.1.51

package/README.md

@@ -720,7 +720,7 @@ Valid action types: `create_record`, `update_record`, `search_records`, `send_me
 
 ### Native invoicing
 
-Use action type `invoicing` with `--operation prepare|issue|refund|cancel|create_correction`
+Use action type `invoicing` with `--operation prepare|issue|refund|cancel|create_correction|prepare_fiscal_correction|execute_fiscal_correction`
 and `--schema <source-schema-uuid>`. Preparation and issuance run in separate automations.
 Existing plugin automations remain unchanged; replace them manually during activation.
 
@@ -743,6 +743,8 @@ objects as record mappings (`--input-json name=json`):
 | `refund` | `seriesSchemaId`, `seriesId`, `cause`, `reason` |
 | `cancel` | `cause`, `reason` |
 | `create_correction` | `draftSchemaId`, `seriesSchemaId`, `seriesId`, `cause`, `reason` |
+| `prepare_fiscal_correction` | `correctionSchemaId` (normal destination table) |
+| `execute_fiscal_correction` | `reason` (`--schema` is the correction requests table) |
 
 All operations accept `recordId`; omitting it uses the trigger record only when
 its schema matches. `invoiceNumber` is an optional override for `issue` and `refund`;
@@ -757,6 +759,23 @@ Correction returns `draftSchemaId` / `draftId` for the editable draft. Issuance
 continues only after the invoice projection and PDF are ready; AEAT delivery has
 its own state. Retrying recovers the same invoice and finishes pending work.
 
+Fiscal corrections use two separate steps: prepare from the visible invoice, review the
+request in a normal table, then execute from that request. `recipientNifConfirmed`
+is optional on execution and accepts `true`/`false` (or the template option IDs
+`1`/`2`). Confirm only a checked, correct NIF for the diagnosed uncensused recipient case.
+No input exposes AEAT flags, XML or hashes.
+
+Outputs include `requestId` (durable request), `correctionSchemaId` / `correctionId`
+(visible request), `sourceRecordId` (record being corrected), `recordId` (resulting
+fiscal record, when generated), `state`, `resolution`, `diagnosisCode` and `diagnosis`.
+The request UUID currently equals its visible record UUID. `invoiceId` and
+`originalInvoiceId` are internal; `projectedInvoiceSchemaId` / `projectedInvoiceId`
+refer to the visible original invoice. Preparation does not generate a fiscal record.
+Execution continues after persisting the operation and its visible row, before AEAT
+acceptance. Repeating an executed request recovers the stored operation and ignores
+later edits to its inputs; another correction needs a new request. An UNKNOWN result
+must be reconciled before another fiscal operation can be generated.
+
 ### Flow wiring
 
 Actions are NOT auto-wired. Connect them explicitly:

package/dist/{examples-CFZMP2GJ.js → examples-V3PR2VTY.js}

@@ -3858,6 +3858,46 @@ var specificExamples = {
     "schemaId": "68d2c7be-4392-42de-b5ae-625ad79cfc3c",
     "inputs": {}
   }
+}`
+    },
+    {
+      description: "Prepare a request from the visible invoice; review it in the normal corrections table before execution.",
+      command: 'zinkee --json automations actions add automation-1 --type invoicing --name "Prepare fiscal correction" --operation prepare_fiscal_correction --schema 68d2c7be-4392-42de-b5ae-625ad79cfc3c --input correctionSchemaId=35443450-0000-4000-8000-000000000001',
+      raw: `{
+  "type": "invoicing",
+  "name": "Prepare fiscal correction",
+  "config": {
+    "operation": "prepare_fiscal_correction",
+    "schemaId": "68d2c7be-4392-42de-b5ae-625ad79cfc3c",
+    "inputs": {
+      "correctionSchemaId": {
+        "rawValue": "35443450-0000-4000-8000-000000000001",
+        "source": null
+      }
+    }
+  }
+}`
+    },
+    {
+      description: "Execute the reviewed request from its own trigger row. Returning PENDING confirms durable work, not AEAT acceptance. Repeating the request recovers it.",
+      command: 'zinkee --json automations actions add automation-1 --type invoicing --name "Execute fiscal correction" --operation execute_fiscal_correction --schema 35443450-0000-4000-8000-000000000001 --input reason="Correct the fiscal registration" --input recipientNifConfirmed=false',
+      raw: `{
+  "type": "invoicing",
+  "name": "Execute fiscal correction",
+  "config": {
+    "operation": "execute_fiscal_correction",
+    "schemaId": "35443450-0000-4000-8000-000000000001",
+    "inputs": {
+      "reason": {
+        "rawValue": "Correct the fiscal registration",
+        "source": null
+      },
+      "recipientNifConfirmed": {
+        "rawValue": "false",
+        "source": null
+      }
+    }
+  }
 }`
     },
     {
@@ -4374,4 +4414,4 @@ function withResponseEnvelope(example, commandName) {
 export {
   getCommandExamples
 };
-//# sourceMappingURL=examples-CFZMP2GJ.js.map
+//# sourceMappingURL=examples-V3PR2VTY.js.map