A Shopify POS nyomtatott nyugtáinak kódszerkesztője

A nyomtatott nyugtákat a Shopify adminisztrációs felületén található kódszerkesztővel szabhatja testre. A nyugtákat alkotó fájlok a Liquid nyelvet, a Shopify sablonnyelvét tartalmazzák. A kódszerkesztővel, a HTML, a CSS és a Liquid használatával fejlettebb testreszabásokat hozhat létre, mint a vizuális szerkesztővel.

Módosíthatja a nyugtasablont és a nyomtatott nyugtákon használt szakaszaablonokat. A Nyugták sablonfájljai azok a nyugtatípusok, amelyeket kinyomtathat az üzletében. A Szakaszok a nyugták részei, például a fejléc vagy a lábléc. A szakaszokat több nyugta is újra felhasználhatja.

Ezen az oldalon

Tudnivalók a nyugta kódszerkesztőjének használatáról

Mielőtt használná a nyugta kódszerkesztőjét, tekintse át a következő tudnivalókat:

Hozzáférési korlátozások

A kódszerkesztőt csak asztali gépen, a Shopify adminisztrációs felületéről használhatja.
A kódszerkesztő egyetlen olaszországi POS-helyszín esetében sem érhető el.

Hol érvényesülnek a változtatások

A végrehajtott kódmódosítások csak a kiválasztott helyszínre vonatkoznak.
A kódszerkesztőben végzett testreszabások csak a POS Pro helyszínekre vonatkoznak. Ha használja a kódszerkesztőt, és vannak nem POS Pro-helyszínei is, akkor ezeken a helyszíneken a vizuális szerkesztővel szabhatja testre a fejlécet és a láblécet.
Testreszabhatja azokat a nyomtatott nyugtákat, amelyeknek van sablonja a kódszerkesztőben, például az értékesítési nyugtákat, az ajándéknyugtákat, az ajándékkártya-nyugtákat, valamint a visszavételi és csere nyugtákat.

Kódolási nyelvek

A nyugtákat alkotó fájlok a Liquid nyelvet, a Shopify sablonnyelvét tartalmazzák. További információ a Liquid használatáról.
A sablonok szerkesztéséhez a nyugták kódszerkesztőjében ismernie kell a HTML, a CSS és a Liquid nyelveket. A Shopify-tématámogatás kisebb módosításokban tud segíteni a Shopify Design Policy keretein belül.

A testreszabás korlátozásai

A kódszerkesztőből nem tudja előnézetben megtekinteni a nyugtákat a különböző nyomtatóméretekben. A nyomtatóméret szerinti előnézethez használja a vizuális szerkesztőt.
A termékleírások nem állnak rendelkezésre változóként a nyugtasablonokban, és nem adhatók hozzá a nyomtatott nyugtákhoz.

Sablonkarbantartás

Ha a nyugtakódszerkesztővel szab testre egy nyugtát, előfordulhat, hogy a meglévő sablonból hiányoznak az új tulajdonságok, mint például a selling_plan_name. A legújabb rendelkezésre álló tulajdonságok sablonhoz való hozzáadásához vissza kell állítania a nyugtasablont az alapértelmezett beállításra. A nyugtasablonok alapértelmezettre való visszaállítása eltávolítja a rajtuk végzett összes testreszabást. A visszaállítás előtt jegyezze fel a testreszabott kódot. A sablon visszaállítása után a testreszabásokat manuálisan kell ismételten alkalmaznia.

A kódszerkesztő elérése

A sablonjait a kódszerkesztővel szerkesztheti. Először az alapértelmezett vizuális szerkesztőről kell átváltania a kódszerkesztő használatára, és bármikor visszaválthat a vizuális szerkesztőre.

A szerkesztők közötti váltás lépései kissé eltérnek attól függően, hogy az összes POS-helyszín jogosult-e a kódszerkesztő használatára, vagy csak bizonyos POS-helyszínek (például néhány POS-helyszín nem használja a POS Pro szolgáltatást, vagy Olaszországban, illetve Franciaországban található).

Lépések:

Minden POS Pro-helyszín

A Shopify adminisztrációs felületén lépjen az Értékesítési pont > Beállítások menüpontra.
A Testreszabás szakaszban kattintson a Nyomtatott nyugták elemre a POS-szerkesztő megnyitásához.
Kattintson a ikonra a bal oldali oldalsávon.
Kattintson a Kód szerkesztése lehetőségre.
A Nyomtatott nyugták kódjának szerkesztése párbeszédpanelen szerkessze a módosítani kívánt kódot.
Kattintson a Mentés gombra.
Opcionális: Ha további Shopify POS oldalakat szeretne szerkeszteni a POS szerkesztővel, lépjen vissza a böngészőablakban.

Lite vagy olaszországi helyszínek esetén

A Shopify adminisztrációs felületén lépjen az Értékesítési pont > Beállítások menüpontra.
A Testreszabás szakaszban kattintson a Nyomtatott nyugták elemre a POS-szerkesztő megnyitásához.
A Nyugta testreszabása oldalon kattintson a Kódszerkesztő lehetőségre.

Egyéni fájlok használata a nyugtasablonban

A nyomtatott nyugták testreszabásához használhat a Shopify adminisztrációs felületére feltöltött fájlokat, például képállományokat.

Mielőtt egy fájlt fel lehetne használni egy nyomtatott nyugtában, fel kell tölteni a Shopify adminisztrációs felületére. További információ a fájlfeltöltésekről.

Lépések:

A Shopify adminisztrációs felületén lépjen a Tartalom > Fájlok menüpontra.
Annak a fájlnak a neve mellett, amelyet szerepeltetni szeretne a nyomtatott nyugta kódjában, kattintson a ikonra a hivatkozás másolásához.
Navigálás a kódszerkesztőhöz.
Illessze be az eszközhivatkozást a sablonjába.

A nyugtasablon visszaállítása alapértelmezettre

A kódszerkesztő segítségével visszaállíthatja a nyugtasablont az alapértelmezett verzióra.

Lépések:

Minden POS Pro-helyszín

A Shopify adminisztrációs felületén lépjen az Értékesítési pont > Beállítások menüpontra.
A Testreszabás szakaszban kattintson a Nyomtatott nyugták elemre a POS-szerkesztő megnyitásához.
Kattintson a Nyugták testreszabása lehetőségre.
Kattintson a Kód szerkesztése lehetőségre.
Kattintson a visszaállítani kívánt kódfájlra.
Kattintson a ikonra.
A Fájl visszaállítása alapértelmezettre párbeszédpanelen kattintson a Visszaállítás gombra.

Lite vagy olaszországi helyszínek esetén

A Shopify adminisztrációs felületén lépjen az Értékesítési pont > Beállítások menüpontra.
A Testreszabás szakaszban kattintson a Nyomtatott nyugták elemre a POS-szerkesztő megnyitásához.
A Nyugta testreszabása oldalon kattintson a Kódszerkesztő lehetőségre.
Kattintson a visszaállítani kívánt kódfájlra.
Kattintson a ikonra.
A Fájl visszaállítása alapértelmezettre párbeszédpanelen kattintson a Visszaállítás gombra.

A nyugta kódszerkesztőjében elérhető Liquid-változók

A Liquid segítségével testreszabhatja a nyomtatott nyugta sablonját és a nyugtatípusokat.

A következő adatobjektumok érhetők el a nyugta kódszerkesztőjében:

Nyugtaobjektumok

A nyugtaadat-objektumok leírása
Objektum	Leírás
shop	Az üzlet adatait tartalmazza, például az üzletnevet.
location	A kiskereskedelmi helyszín adatait tartalmazza, például a címet és a telefonszámot.
order	A rendelés adatait tartalmazza, beleértve a sorelemeket, a kedvezményeket, az adókat és a tranzakciós adatokat.
return	Csak a `return-and-exchange-receipt.liquid` sablonban és a hozzá tartozó részleges sablonokban érhető el. Visszavételi és csereadatokat tartalmaz, beleértve a visszaküldött sorelemeket, az új sorelemeket, a nettó végösszeget és a tranzakciós adatokat.
gift_card	Csak a `gift-card.liquid` sablonban érhető el. Az ajándékkártya adatait tartalmazza, beleértve az egyenleget, az alfanumerikus kódot és a POS-alkalmazással beolvasható QR-kód tartalmát.

Rendelés objektum

A rendelés objektum leírása
Tulajdonság	Leírás
id	A rendelés azonosítója.
created_at	A rendelés létrehozásának ISO 8601 formátumú dátuma és ideje.
source_identifier	Egyedi POS vagy harmadik féltől származó rendelésazonosító.
change_due	A rendelés visszajárója.
balance_due	A rendelésen fennálló tartozás összege.
name	A rendelés egyedi azonosítója, amely a Shopify adminisztrációs felületén a rendelési oldalon és a rendelésállapot-oldalon jelenik meg. Például: „#1001”, „EN1001” vagy „1001-A”. Ez az érték nem egyedi a különböző üzletekben.
note	A rendeléshez tartozó megjegyzés tartalma.
line_items	A rendelés sorelemeinek listája.
subtotal_price	Az összes sorelem árának összege a kedvezmények után és a visszavételek előtt. Ha a `taxesIncluded` értéke igaz, akkor a részösszeg az adót is tartalmazza.
total_price	A rendelés teljes ára a visszavételek előtt. Ez tartalmazza az adókat és a kedvezményeket.
total_tip_received	A rendeléshez tartozó összes borravaló összege.
discounts	A kedvezmények teljes összege.
transactions	A rendeléshez kapcsolódó tranzakciók listája.
taxes_included	Azt jelzi, hogy az adók szerepelnek-e a rendelés részösszegében.
tax_lines	A rendelés sorelemeire alkalmazott összes adósor listája a visszavételek előtt. Az adósorok árai az összes azonos kulcsú és megnevezésű adósor teljes árát jelentik.
customer	A vásárló, aki leadta a rendelést.
shipping_address	A rendelésen szereplő szállítási cím.
shipping_groups	A rendelés szállítási csoportjainak listája. Minden csoport olyan sorelemeket tartalmaz, amelyek együtt kerülnek teljesítésre.

Visszavételi objektum

A visszavételi objektum leírása
Tulajdonság	Leírás
name	A visszavétel egyedi azonosítója, amely a Shopify adminisztrációs felületén a rendelési oldalon és a rendelésállapot-oldalon jelenik meg. Például: „#1000-R1”. Ez az érték nem egyedi a különböző üzletekben.
created_at	A visszavétel létrehozásának ISO 8601 formátumú dátuma és ideje.
is_unverified	Logikai érték, amely azt jelzi, hogy a visszavétel nem ellenőrzött visszavételként jött-e létre.
is_exchange	Logikai érték, amely jelzi, hogy a visszavétel tartalmaz-e cserét. Ide tartoznak az ajándékkártyára történő visszatérítések is.
exchange_type	A csere típusa, ha a visszavétel cserét is tartalmaz. Lehetséges értékek: `LIKE_FOR_LIKE`, `NET_REFUNDABLE` és `NET_PAYABLE`.
return_discount	A visszatérített rendelési kedvezmények teljes összege.
return_subtotal	Az összes visszavételi sorelem árának összege a kedvezmények előtt. Ha a `taxesIncluded` értéke igaz, akkor a részösszeg az adót is tartalmazza.
return_total	A visszatérítés teljes lehetséges összege. Ez tartalmazza az adókat, kedvezményeket, szállítást és borravalót. Előfordulhat, hogy ez nem a tényleges visszatérített összeg.
exchange_subtotal	A cserében szereplő összes új sorelem árának összege a kedvezmények előtt. Ha a `taxesIncluded` értéke igaz, akkor a részösszeg az adót is tartalmazza.
exchange_total	A cserében szereplő összes új sorelem teljes összege. Ez magában foglalja az adókat és a kedvezményeket.
total_cash_rounding_adjustment	A visszavételre vagy cserére alkalmazott pénztári kerekítési kiigazítás.
total_adjusted_amount	A visszavétel vagy csere teljes összege a pénztári kerekítési kiigazítással módosítva.
net_total	A visszavétel vagy csere során ténylegesen kifizetett vagy visszatérített teljes összeg a pénztári kerekítés előtt.
return_line_items	A visszavett sorelemek.
exchange_line_items	Az új sorelemek a cserében.
return_tax_lines	A visszavételi sorelemek adósorai.
exchange_tax_lines	A cserében szereplő új sorelemek adósorai.
shipping_refund_amount	A visszatérített szállítási díj összege.
tip_refund_amount	A visszatérített borravaló összege.
transactions	A visszavételhez vagy cseréhez kapcsolódó tranzakciók.

Szállítási csoport objektum

A szállítási csoport objektum leírása
Tulajdonság	Leírás
destination	A szállított termékek rendeltetési helye.
products	A szállított termékek listája.

Sorelem objektum

A sorelem objektum leírása
Tulajdonság	Leírás
id	A sorelem azonosítója.
name	A termék neve, opcionálisan kiegészítve a változat nevével (ha van).
variant_title	A változat neve a rendelés létrehozásakor.
price	A sorelem egységára a rendelés létrehozásakor. Ez az érték nem tartalmazza a kedvezményeket.
is_gift_card	Azt jelzi, hogy a sorelem ajándékkártya vásárlását jelenti-e.
discount	A kedvezményalkalmazások által a sorelemhez rendelt teljes kedvezmény, beleértve a visszatérített és eltávolított mennyiségekhez rendelt kedvezményeket is.
total_price	Ennek a sorelemnek a végösszege.
selling_plan_name	A sorelemhez rendelt előfizetési csomag neve.
tax_rates	Ennek a sorelemnek az adósorai.
custom_attributes	Olyan jellemzők listája, amelyek egyéni funkciókat vagy különleges kéréseket jelölnek.
variant_title	A változatnév.
variant_id	A változat azonosítója.
variant_metafields	A kereskedő által a változathoz társított egyéni mezők listája.
staff_member_description	A sorelemhez rendelt személyzet tagja.
product_metafields	A kereskedő által a termékhez társított egyéni mezők listája.

Visszavételi sorelem objektum

Tartalmaz mindent, ami a sorelem objektumban található, valamint a következő tulajdonságokat:

A sorelem objektum leírása
Tulajdonság	Leírás
return_reason	A sorelem visszavételének oka.
return_reason_note	A visszavétel okához tartozó opcionális megjegyzés.

A nyugtakód-szerkesztőben elérhető Liquid-szűrők

A Liquid-szűrőkkel módosításokat végezhet a nyugtasablonokban szereplő információkon. Például megváltoztathatja a valuta formátumát vagy egy adott szöveg, például egy adókód nagybetűs írásmódját.

Egy szűrő alkalmazásához adjon hozzá egy | (pipe) karaktert, majd magát a szűrőt a dupla kapcsos zárójelek ({{ }}) közötti Liquid-kódblokkban. A szűrők csak Liquid-kódblokkokra alkalmazhatók.

A következő példában a szűrő a kisbetűs adókódot nagybetűsre módosítja.

{{ tax_line.title | upcase }}

A példa kódblokkban a product az objektum, a title a tulajdonsága, és az upcase az alkalmazott szűrő. Az upcase szűrő a tax_line.title értékét nagybetűsre változtatja. Ha például a tax_line.title értéke Hst, akkor az upcase szűrő HST-re módosítja az értéket.

A Liquid-szűrők használatának részleteiért tekintse meg a Shopify Témák Liquid referenciájának Szűrők szakaszát.

A nyugta kódszerkesztőjében a következő szűrők állnak rendelkezésre:

A nyugtaszűrők leírása
Tulajdonság	Leírás
t	Lefordítja az előre meghatározott címkéket a helyszínéhez rendelt nyelvre.
money	Formázza az árat a helyszín pénznemében.
escape	Escape-eli a speciális HTML-karaktereket, például a `<>`, `'` és `&` karaktereket, és escape-szekvenciákká alakítja őket.
barcode	Létrehoz egy 1D vonalkódú SVG-t.
qrcode	Létrehoz egy 2D vonalkódú SVG-t.

Példa egy nyomtatott nyugtasablon kódjának testreszabására

A Liquid segítségével feltételes üzeneteket adhat hozzá. Ez a funkció hasonló ahhoz, mint amikor egyetlen helyszínre ment a vizuális szerkesztő használatával. Például ha a vállalkozása egyetlen helyszínnel indult, és most már több új helyszíne van, és szeretné kiemelni az eredeti üzletét a nyomtatott nyugtákon.

A kódszerkesztő Sections mappájában található header.liquid sablonhoz egyéni üzenetet adhat hozzá, és a Liquid használatával az üzenetet csak a kiemelt helyszín esetében jelenítheti meg.

A következő kód ellenőrzi a helyszín nevét, ebben az esetben az eredeti, „Home” nevű helyszínét, és ha a helyszín neve megegyezik, a „Welcome to our original store, opened in 1972.” üzenetet jeleníti meg. A többi helyszínről nyomtatott nyugtákon ehelyett a „Welcome to our store.” üzenet látható.

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

A kódmódosítások előnézete a kódszerkesztőben

A nyomtatott nyugták módosításainak előnézetét a Shopify adminisztrációs felületén, a POS kódszerkesztőben tekintheti meg.

A kiválasztott Liquid-fájltól függően az előnézeti ablak kiemeli a nyugta fájl által érintett dizájnját vagy szakaszát. Alapértelmezés szerint az előnézeti ablak a legutóbbi POS-rendelés tartalmát jeleníti meg. A gift-card.liquid fájl kivételével minden Liquid-fájl esetében kiválaszthat egy adott rendelést, amelynek tartalmát nyugtaként jeleníti meg az előnézeti ablak. A gift-card.liquid fájl csak a különböző helyszíneket jeleníti meg választható előnézeti lehetőségként.

Lépések:

Minden POS Pro-helyszín

A Shopify adminisztrációs felületén lépjen az Értékesítési pont > Beállítások menüpontra.
A Testreszabás szakaszban kattintson a Nyomtatott nyugták elemre a POS-szerkesztő megnyitásához.
Kattintson a Nyugták testreszabása lehetőségre.
Kattintson a Kód szerkesztése lehetőségre.
Kattintson arra a kódfájlra, amelynek előnézetét meg szeretné tekinteni. A nyugta a szerkesztő jobb oldali ablakában jelenik meg.
Választható: Ha egy adott rendelést szeretne kiválasztani nyugtatartalomként az előnézeti ablakban, végezze el az alábbi lépéseket:
1. Kattintson a ikonra.
2. Az Értékesítési pont csatornáról származó, összes helyszínen történt értékesítés megjelenik a Choose order to preview párbeszédpanelen. Válasszon ki egy rendelést a listából, vagy keressen adott rendelésekre és helyszínekre a keresősáv segítségével.
3. Kattintson a Confirm gombra.
Választható: Ha a gift-card.liquid fájl előnézetét tekinti meg, kattintson a ikonra, és válassza ki azt a helyszínt, amelyhez meg szeretné tekinteni a sablon előnézetét.

Lite vagy olaszországi helyszínek esetén

A Shopify adminisztrációs felületén lépjen az Értékesítési pont > Beállítások menüpontra.
A Testreszabás szakaszban kattintson a Nyomtatott nyugták elemre a POS-szerkesztő megnyitásához.
A Nyugta testreszabása oldalon kattintson a Kódszerkesztő lehetőségre.
Kattintson arra a kódfájlra, amelynek előnézetét meg szeretné tekinteni. A nyugta a szerkesztő jobb oldali ablakában jelenik meg.
Választható: Ha egy adott rendelést szeretne kiválasztani nyugtatartalomként az előnézeti ablakban, végezze el az alábbi lépéseket:
1. Kattintson a ikonra.
2. Az Értékesítési pont csatornáról származó, összes helyszínen történt értékesítés megjelenik a Choose order to preview párbeszédpanelen. Válasszon ki egy rendelést a listából, vagy keressen adott rendelésekre és helyszínekre a keresősáv segítségével.
3. Kattintson a Confirm gombra.
Választható: Ha a gift-card.liquid fájl előnézetét tekinti meg, kattintson a ikonra, és válassza ki azt a helyszínt, amelyhez meg szeretné tekinteni a sablon előnézetét.