zinkee 0.1.49 → 0.1.51

package/README.md

@@ -709,14 +709,72 @@ zinkee --json automations actions add <automation-uuid> \
   --arg mode=safe
 ```
 
-Valid action types: `create_record`, `update_record`, `search_records`, `send_message`, `http_request`, `execute_plugin`.
+Valid action types: `create_record`, `update_record`, `search_records`, `send_message`, `send_email`, `http_request`, `execute_plugin`, `generate_document`, `invoicing`.
 
 ### Field mapping format
 
 - `--map field=value` → `{"rawValue":"value","source":null}` (literal)
 - `--map-json field='{"rawValue":null,"source":{"type":"TRIGGER","id":"<field-uuid>"}}'` (from trigger)
 - `source.type` values: `TRIGGER`, `PREVIOUS_ACTION`
-- `source.id` must be a field UUID — slugs are not resolved here
+- `source.id` is a field UUID or a named output of the preceding action; slugs are not resolved here. Use `source.actionId` to select the preceding action explicitly.
+
+### Native invoicing
+
+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.
+
+```bash
+zinkee --json automations actions add <automation-uuid> \
+  --type invoicing --name "Issue invoice" --operation issue --schema <draft-schema-uuid>
+
+zinkee --json automations actions add <automation-uuid> \
+  --type invoicing --name "Cancel invoice" --operation cancel --schema <invoice-schema-uuid> \
+  --input cause=DUPLICATE_INVOICE --input reason="Duplicate invoice" \
+  --input-json 'recordId={"source":{"type":"PREVIOUS_ACTION","id":"projectedInvoiceId","actionId":"<preceding-action-uuid>"}}'
+```
+
+Inputs accept fixed values (`--input name=value`) or the same `{rawValue, source}`
+objects as record mappings (`--input-json name=json`):
+
+| Operation | Required inputs |
+| --- | --- |
+| `prepare`, `issue` | None when the trigger record belongs to the configured schema |
+| `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`;
+otherwise the fiscal service assigns the next number in the series.
+
+Invoicing outputs can be selected by `source.type=PREVIOUS_ACTION`, `source.actionId`
+and a named `source.id`. Fiscal `invoiceId`, `recordId` and `operationId` are distinct
+from the visible `projectedInvoiceSchemaId` / `projectedInvoiceId`; use the latter
+for record actions. `file` is the FileField value and `fileId` identifies its PDF;
+`fileName`, `mediaType` and `sha256` describe that stored PDF.
+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
 

package/dist/{examples-4CKJHTGV.js → examples-V3PR2VTY.js}

@@ -3845,6 +3845,59 @@ var specificExamples = {
     "authMode": "STORED",
     "connectionId": "connection-1"
   }
+}`
+    },
+    {
+      description: "Issue a previously prepared draft using native invoicing. The trigger record belongs to schemaId; the configured series assigns the invoice number.",
+      command: 'zinkee --json automations actions add automation-1 --type invoicing --name "Issue invoice" --operation issue --schema 68d2c7be-4392-42de-b5ae-625ad79cfc3c',
+      raw: `{
+  "type": "invoicing",
+  "name": "Issue invoice",
+  "config": {
+    "operation": "issue",
+    "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
+      }
+    }
+  }
 }`
     },
     {
@@ -4361,4 +4414,4 @@ function withResponseEnvelope(example, commandName) {
 export {
   getCommandExamples
 };
-//# sourceMappingURL=examples-4CKJHTGV.js.map
+//# sourceMappingURL=examples-V3PR2VTY.js.map