Enumerations Reference

CardFace

evolis.CardFace

Value	Int	Description
`FRONT`	0	Front face of the card
`BACK`	1	Back face of the card

RibbonType

evolis.RibbonType

Value	Int	Description
`UNKNOWN`	-1	Unknown / unreadable
`YMCKO`	0	Standard color+overlay (most common for Primacy)
`YMCKOS`	3	YMCKO with scratch
`YMCKOS13`	5	YMCKO scratch 1/3
`YMCKOK`	4	YMCKO+K double resin
`YMCKOKS13`	9	YMCKOK scratch 1/3
`YMCKOKOS`	10	YMCKO+K+O+S
`YMCKOO`	13	YMCKO double overlay
`KO`	1	Black + overlay
`KBLACK`	100	Black resin only
`KWHITE`	105	White resin
`KRED`	103	Red resin
`KGREEN`	102	Green resin
`KBLUE`	101	Blue resin
`KSCRATCH`	108	Scratch-off
`KMETALSILVER`	107	Silver metallic
`KMETALGOLD`	106	Gold metallic
`KSIGNATURE`	114	Signature panel
`KWAX`	112	Wax black
`KPREMIUM`	115	Premium black
`KRMS`	116	RMS black
`HOLO`	91	Holographic
`SOKO`	12	Silver+overlay
`YMCFK`	1002	Avansia YMCFK
`YMCK`	1000	Avansia YMCK
`YMCKS`	1050	Avansia YMCKS
`YMCKH`	1003	Avansia YMCKH
`YMCKI`	1004	Avansia YMCKI
`YMCKK`	1001	Avansia YMCKK
`YMCKKS`	1051	Avansia YMCKKS
`YMCKKI`	1005	Avansia YMCKKI
`KBLACK_R`	1100	Avansia black resin
`CLEAR`	2000	Clear laminate

ReturnCode

evolis.ReturnCode

Success

Value	Int	Description
`OK`	0	Success

General Errors

Value	Int	Description
`EUNDEFINED`	-1	Undefined error
`EINTERNAL`	-2	Internal logic error
`ECANCELLED`	-3	Operation cancelled
`EDISABLED`	-4	Feature disabled
`EUNSUPPORTED`	-5	Feature not supported
`EPARAMS`	-6	Invalid parameters
`ETIMEOUT`	-7	Timeout

Session Errors

Value	Int	Description
`SESSION_ETIMEOUT`	-10	Session reservation expired
`SESSION_EBUSY`	-11	Printer in use
`SESSION_DISABLED`	-12	Session management is off
`SESSION_FAILED`	-13	Failed to reserve
`SESSION_ENABLED`	-14	Operation not allowed with session management on

Print Errors

Value	Int	Description
`PRINT_EDATA`	-20	Invalid image/settings data
`PRINT_NEEDACTION`	-21	Printer not ready (ribbon, cover, feeder…)
`PRINT_EMECHANICAL`	-22	Mechanical error during printing
`PRINT_WAITCARDINSERT`	-23	Avansia: waiting for card insert
`PRINT_WAITCARDEJECT`	-24	Avansia: waiting for card eject
`PRINT_EUNKNOWNRIBBON`	-25	GRibbonType setting missing
`PRINT_ENOIMAGE`	-26	No image provided
`PRINT_WSETTING`	-27	Driver settings partially failed
`PRINT_EJOB`	-28	Print job not created / expired
`PRINT_ESESSION`	-29	No session available

Laminator Errors

Value	Int	Description
`LAM_ENOCOM`	-40	Laminator missing / no communication
`LAM_EDEVICE`	-41	Device is not a laminator
`LAM_ERROR`	-42	Laminator error
`LAM_EVALUE`	-43	Unexpected laminator value

Magnetic Errors

Value	Int	Description
`MAG_ERROR`	-50	Magnetic read/write error
`MAG_EDATA`	-51	Invalid magnetic data
`MAG_EBLANK`	-52	Magnetic track blank

Printer Communication Errors

Value	Int	Description
`PRINTER_ENOCOM`	-60	Printer offline
`PRINTER_EREPLY`	-61	Printer replied with ERR
`PRINTER_EOTHER`	-62	macOS: USB in use by other software
`PRINTER_EBUSY`	-63	macOS: CUPS is printing
`PRINTER_NOSTATUS`	-64	Statuses disabled on printer
`PRINTER_EMODEL`	-65	Invalid printer model
`PRINTER_NETWORK_ERROR`	-80	Network operation error
`PRINTER_NETWORK_ECERT`	-81	Invalid certificate

Card / Smart / System / User / Service Errors

Range	Description
`-200` to `-201`	Card movement errors
`-300` to `-303`	Smart card errors
`-500` to `-503`	System/OS errors
`-600` to `-604`	User authentication errors
`-700` to `-701`	Sandbox errors
`-10000` to `-10006`	EPS service errors
`-20000` to `-20500`	HTTP errors

OpenMode

evolis.OpenMode

Controls how the SDK connects to the printer.

Value	Description
`AUTO`	Automatic (recommended)
(other values depend on platform)	USB / TCP / supervised

State.Major

evolis.State.Major

Value	Description
`OFF`	Printer offline / not connected
`READY`	Printer ready
`WARNING`	Printer has a non-blocking warning
`ERROR`	Printer has a blocking error

State.Minor

Hundreds of sub-states. Key ones for day-to-day use:

Value	Description
`PRINTER_READY`	Fully ready to print
`DEF_NO_RIBBON`	No ribbon installed
`DEF_FEEDER_EMPTY`	Feeder is empty
`DEF_COVER_OPEN`	Cover is open
`ERR_MECHANICAL`	Mechanical jam
`ERR_RIBBON_ERROR`	Ribbon error
`INF_PRINTING_RUNNING`	Job currently printing
`INF_SLEEP_MODE`	Printer in sleep mode

CardPos

evolis.CardPos

Used with Connection.set_card_pos().

InputTray / OutputTray

evolis.InputTray
evolis.OutputTray

Enumerate available input/output positions (feeder, hopper, manual, bezel, etc.).

ErrorManagement

evolis.ErrorManagement

Value	Description
`PRINTER`	Printer handles errors autonomously
`SOFTWARE`	Your application handles errors
`SUPERVISED`	EPS service handles errors

MagCoercivity

evolis.MagCoercivity

Value	Description
`OFF`	No coercivity
`LOCO`	Low coercivity
`HICO`	High coercivity

MagFormat / MagTrackNumber

evolis.MagFormat
evolis.MagTrackNumber   # TRACK1=0, TRACK2=1, TRACK3=2

BezelBehavior

evolis.BezelBehavior

Controls what happens after the BEZEL delay expires.

Feeder

evolis.Feeder

Used with KC Max printers that have multiple card feeders.

LaminatorIndex / LaminatorMode / LaminatorFilmType

evolis.LaminatorIndex
evolis.LaminatorMode
evolis.LaminatorFilmType

For printers with attached lamination modules.

ScanImage / ScanOption

evolis.ScanImage
evolis.ScanOption

For printers with the WiseCube scanner option.

LogLevel

evolis.LogLevel

Used with Evolis.set_log_level().

ServiceAction

evolis.ServiceAction

Actions to reply to EPS service events (e.g. RETRY, CANCEL, IGNORE).

Model

evolis.Model

Represents every printer model known by the SDK.

RwCardType

evolis.RwCardType

Value	Description
`MBLACK`	Black rewritable card
`MBLUE`	Blue rewritable card
`CUSTOM_FRONT`	Custom front
`CUSTOM_DUPLEX`	Custom duplex

Setting Keys Mag Session