zinkee 0.1.49 → 0.1.50

package/README.md

@@ -709,14 +709,53 @@ 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`
+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` |
+
+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.
 
 ### Flow wiring
 

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

@@ -3845,6 +3845,19 @@ 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": {}
+  }
 }`
     },
     {
@@ -4361,4 +4374,4 @@ function withResponseEnvelope(example, commandName) {
 export {
   getCommandExamples
 };
-//# sourceMappingURL=examples-4CKJHTGV.js.map
+//# sourceMappingURL=examples-CFZMP2GJ.js.map