Print Agents

Print Agents connect a Forkiva branch to a local Qintrix print service. Forkiva uses the agent record to know where the branch print service is running and which API key to use when sending direct print jobs from POS.

Each agent belongs to one branch. The active agent for that branch is used in POS direct-print flows. If you activate another agent for the same branch, it becomes the branch’s active connection instead.

Index Page

The index lists all configured agents with their connection details:

• Name – Friendly label for the agent.
• Branch – The branch this agent serves.
• Host – Hostname or IP address of the local Qintrix service.
• Port – Port used by that local service.
• Activation – Active badge when enabled.
• Created at / Updated at – Audit timestamps.
• Actions – Edit, delete, etc.

Features

• Search box for quick filtering.
• Pagination with entry count selector (Show X entries).
• Fast visibility into which branch endpoint is active.

➕ Create Print Agent

Use this form to connect a branch to its Qintrix service:

• Name – Display name for the connection. This field supports translations.
• Branch – The target branch. This appears for users who are not locked to a branch.
• Active – Enables this agent for direct printing.
• API Key – Qintrix API key used by Forkiva when creating print jobs.
• Host – Qintrix host only. Enter a hostname or IP address without http://, https://, path, or port.
• Port – Qintrix service port.

Forkiva combines the host and port into the base URL used for direct printing.

Edit Print Agent

You can update the agent’s display and connection settings:

• Name – Rename the agent.
• API Key – Replace the Qintrix credential if it changes.
• Host / Port – Point Forkiva to a different Qintrix endpoint.
• Active – Switch which agent is currently active for the branch.

Branch is fixed after creation.

📌 Notes

• The host must be a valid hostname or IP address only.
• Do not include protocol, path, or port in the host field.
• Port must be between 1 and 65535.
• Only one active print agent is kept per branch.
• Direct printing in POS depends on both an active print agent and printers configured with Qintrix printer IDs.