Synopsis
gln [global-options] standing-orders add --file <path>
Options
| Argument or flag | Type | Required | Default | Description |
|---|
--file | path | yes | - | JSON payload describing the new standing order to create. |
Request file fields
| Field | Type | Required | Description |
|---|
source_iban | string | yes | IBAN of the account the standing order is debited from. |
source_bic | string | yes | BIC of the source account institution. |
source_name | string | yes | Account holder name as it should appear on the order. |
recipient_iban | string | yes | IBAN of the recipient account. |
recipient_bic | string | yes | BIC of the recipient account institution. |
recipient_name | string | yes | Recipient name as it should appear on the order. |
amount | string | yes | Decimal amount (e.g. "1.00"). |
currency | string | yes | ISO 4217 currency code (e.g. "EUR"). |
purpose | string | yes | Free-text purpose / remittance line. |
first_execution | string | yes | First execution date in YYYYMMDD. |
interval | string | yes | Execution interval. FinTS uses "M" (monthly), "W" (weekly), "Q", "Y". |
execution_day | string | yes | Day-of-period the order runs on. |
end_to_end_reference | string | no | End-to-end reference string. Omit or leave empty if unused. |
last_execution | string | no | Last execution date in YYYYMMDD. Omit or leave empty for open-ended. |
All fields must be JSON strings. currency and interval are required; the C API defaults of "EUR" / "M" are deliberately not honored by the CLI so the request is fully explicit.
Description
Wires gln_add_standing_order to the FinTS backend resolved via the active profile. The CLI parses the request file, opens the backend with the PIN/secret material from the profile, and submits the standing order. If the backend signals that a TAN is required, the continuation is saved to disk and the response describes how to resume.
Status and exit codes
| Status | Exit | Meaning | Continuation |
|---|
ok | 0 | Standing order accepted by the bank. | - |
action_required | 10 | Bank requires a TAN. The response envelope includes a resume_file path. | Saved at resume_file. |
error | 1 | Validation, transport, or backend error. | - |
See also
