Optima REST APIInstall

Summary

Update KSeF header data of a document identified primarily by 'Numer Pełny' for sales or 'Numer Obcy' (with optional NIP) for purchases, sending only non-empty fields to the Optima REST API via a PUT request.

Inputs

• Numer Pełny — Our full document number for sales (unique in company), taking precedence over Numer Obcy.
• Numer Obcy — Supplier's external document number for purchases; must be used with NIP. For sales, use Numer Pełny.
• NIP (Sprzedawcy) — Supplier's NIP to complement Numer Obcy; optional but recommended for uniqueness within supplier.
• Numer KSeF — KSeF document number; empty string means no change.
• Numer Sesji — Reference session number for KSeF; empty string means no change.
• Data Przyjęcia — Date of acceptance in KSeF format yyyy-MM-dd; empty string means no change.
• Forma Płatności — KSeF payment form mapped to an API code; empty string means no change.
• Środowisko — KSeF environment selection; empty string means no change.
• Link Weryfikacyjny — KSeF verification link (QR code); empty string means no change.
• Operator Wysyłający — Name of sending operator; empty string means no change.
• Operator Odbierający — Name of receiving operator of UPO; empty string means no change.
• Data Wysłania — Date sent to KSeF in yyyy-MM-dd; empty string means no change.
• Data Odebrania — Date UPO received in yyyy-MM-dd; empty string means no change.

Output shape

a single item containing the API response JSON confirming the update

Only non-empty input fields are sent to update the document's KSeF header data. If the input includes binary data, it is preserved in the output. Errors can be optionally caught if 'Continue On Fail' is enabled.

Links

• n8n community nodes installation guide