1. Cloud Printing
  2. Models

Cloud Printing

Models

A print station represents a computer or device running the PackageX Print Station application, which manages one or more physical printers.


object "print_station"
The type identifier for this model.

id string
Unique identifier for the print station, prefixed with prnt_stn_

name string
Unique station name within the organization and location. Maximum 191 characters.

display_name string
Human-readable display name for the station. Maximum 191 characters.

status string
Current status of the station. Can be online or offline.

location_id string
ID of the location where this station is installed.

location object
Details about the location where this station is installed.

Show Details
location.id string
Unique identifier for the location
location.name string
Name of the location
location.code string
Location code

device_token string
Pushy device token used for sending push notifications to the print station app.

allow_all_users boolean
When true, all users with access to the location can use this station. When false, only users in allowed_users can use it.

allowed_users object[]
List of user profile IDs that are allowed to use this station when allow_all_users is false.

configuration object
Station-level configuration options.

Show Details
configuration.pooling_enabled boolean
When enabled, printers of the same model are treated as a single queue

printers Printer[]
Array of printers connected to this station.

created_at DateTime
Time when this station was created.

updated_at DateTime
Time when this station was last updated.

created_by string
ID of the user or API key that created this station.

updated_by string
ID of the user or API key that last updated this station.


Printer Model

A printer represents a physical printer connected to a print station.


id string
Unique identifier for the printer (UUID format).

name string
Unique printer name within the station.

model string
Printer model name (e.g., "HP LaserJet Pro M404dn").

status string
Current printer status. Can be online, offline, busy, or error.

configuration object
Printer configuration settings.

Show Details
configuration.dpi string
Dots per inch resolution
configuration.speed string
Print speed
configuration.color_print boolean
Whether the printer supports color printing
configuration.double_sided boolean
Whether the printer supports duplex (double-sided) printing
configuration.spooling boolean
Whether spooling is enabled
configuration.port integer
Printer port number (default: 9100)
configuration.priority integer
Printer priority for job routing (lower = higher priority)
configuration.type string
Printer type: laser, inkjet, thermal, dot_matrix, or unknown
configuration.orientation_limited_to string
If set, limits printer to portrait or landscape only

page_size object
Supported paper sizes for this printer.

Show Details
page_size.legal boolean
US Legal (8.5" × 14")
page_size.a4 boolean
ISO A-series paper sizes
page_size.label_1x2 boolean
1" × 2" label
page_size.label_2x2 boolean
2" × 2" label
page_size.label_2x4 boolean
2" × 4" label
page_size.label_3x3 boolean
3" × 3" label
page_size.label_4x6 boolean
4" × 6" label

created_at DateTime
Time when this printer was created.

updated_at DateTime
Time when this printer was last updated.

deleted_at DateTime
Time when this printer was soft-deleted, or null if active.


A print job represents a document queued for printing.


object "print_job"
The type identifier for this model.

id string
Unique identifier for the print job, prefixed with prnt_job_

name string
Optional name for the print job. Maximum 191 characters.

status string
Current job status. See Print Job Statuses for details.

reason string
Reason for failure when status is failed. Null otherwise.

data_url string
URL to the document to be printed (stored in PackageX cloud storage).

data_type string
MIME type of the document (e.g., application/pdf).

resource_id string
ID of the linked resource (shipment, fulfillment, item, or asset).

resource_document string
Document type identifier for the linked resource.

print_station object
Summary of the print station handling this job.

Show Details
print_station.id string
Print station ID
print_station.name string
Station name
print_station.display_name string
Station display name

printer object
Summary of the printer handling this job.

Show Details
printer.id string
Printer ID
printer.name string
Printer name
printer.model string
Printer model

options object
Print configuration options.

Show Details
options.paper_size string
Selected paper size
options.copies integer
Number of copies to print
options.total_pages integer
Total pages in the document
options.orientation string
Page orientation: portrait or landscape
options.color_print boolean
Whether to print in color
options.double_sided boolean
Whether to use duplex printing
options.print_all_pages boolean
Whether to print all pages
options.pages_to_print string[]
Specific pages or ranges to print
options.reverse_order boolean
Whether to print pages in reverse order
options.scaling number
Scale factor for the document

created_at DateTime
Time when this job was created.

updated_at DateTime
Time when this job was last updated.

created_by string
ID of the user or API key that created this job.

updated_by string
ID of the user or API key that last updated this job.


Status Description
queued Job is waiting to be processed by the print station
processing Print station is actively printing the document
completed Job finished successfully
failed Job failed (check reason field for details)
canceled Job was canceled by user before printing
aborted Job was aborted by system (e.g., printer was removed)

Status Transitions

        queued → processing → completed
                   → failed
       → canceled
       → aborted (system action)

      

Paper Size Values

When specifying paper size in API requests, use these values:

Value Description
page_size_legal US Legal (8.5" × 14")
page_size_a4 ISO A-series sizes
page_size_label_1x2 1" × 2" label
page_size_label_2x2 2" × 2" label
page_size_label_2x4 2" × 4" label
page_size_label_3x3 3" × 3" label
page_size_label_4x6 4" × 6" label