- Wanneer gebruik je dit?
- Normale werking
- Split-werking
- Instellen in Printsyncer
- Voorbeeld
- Belangrijke regels
- Controle voor livegang
- Problemen oplossen
Design-link pagina's splitsen naar losse PrintAPI-producten
Design links worden gebruikt door personalisatie-apps zoals TeeInBlue en Customily. Een Shopify orderregel kan daardoor meerdere design-link pagina's bevatten, bijvoorbeeld een poster en een kaart, een tegel en een kaart, of twee posters in verschillende formaten.
Standaard maakt Printsyncer van meerdere design-link pagina's een multi-page PDF en stuurt die als een PrintAPI order item door. Met de split-instelling kun je dat veranderen: elke design-link pagina wordt dan een eigen PrintAPI item, eventueel met een eigen Print variant, formaat en configuratie.
Wanneer gebruik je dit?
Gebruik deze instelling als een Shopify product uit meerdere fysieke PrintAPI producten bestaat.
Voorbeelden:
- Een TeeInBlue product met pagina 1 als poster en pagina 2 als kaart.
- Een Customily product met pagina 1 als tegel en pagina 2 als kaart.
- Een product met twee posters in verschillende formaten, bijvoorbeeld A3 en A4.
- Een set waarbij elke gepersonaliseerde pagina een eigen printformaat heeft.
- Een productbundle waarbij de klant een design maakt, maar PrintAPI meerdere losse items moet produceren.
- Een combinatie van een normale print en een gegraveerd product, bijvoorbeeld pagina 1 als poster en pagina 2 als gravure.
Gebruik deze instelling niet als PrintAPI juist een multi-page PDF verwacht voor hetzelfde fysieke product, zoals een boekje, kalender of product met meerdere pagina's binnen een bestand.
Normale werking
Zonder split-instelling bundelt Printsyncer alle design-link pagina's in een multi-page PDF.
Shopify orderregel
|
|-- design link pagina 1
|-- design link pagina 2
|-- design link pagina 3
v
Printsyncer genereert 1 multi-page PDF
v
PrintAPI item
- productId: Print variant van de orderregel
- quantity: aantal besteld
- file: multi-page PDF
Dit blijft de standaard. Bestaande producten veranderen dus niet zolang de split-instelling uit staat.
Split-werking
Met split-instelling aan maakt Printsyncer per design-link pagina een apart PrintAPI item.
Shopify orderregel
|
|-- design link pagina 1 --> PrintAPI item 1 --> Print variant A
|-- design link pagina 2 --> PrintAPI item 2 --> Print variant B
|-- design link pagina 3 --> PrintAPI item 3 --> Print variant C
De Print variant bepaalt vervolgens welke PrintAPI product ID, bestandsspecificaties en configuratie-opties gebruikt worden.
Instellen in Printsyncer
1. Maak de Print varianten aan
Maak eerst de Print varianten aan die je per pagina wilt gebruiken. Elke Print variant moet gekoppeld zijn aan het juiste PrintAPI product en de juiste PrintAPI account.
Voorbeeld:
Print variant A: Poster A3 mat
Print variant B: Kaart A6 glans
Print variant C: Sticker rond 50mm
2. Koppel de Shopify variant zoals normaal
De Shopify SKU blijft gekoppeld aan een Product Variant in Printsyncer. Die Product Variant heeft zelf al een Print variant. Dat is de standaard Print variant die Printsyncer gebruikt als een design-link pagina geen eigen mapping heeft.
Shopify SKU: BUNDLE-SUNSET-001
v
Product Variant in Printsyncer
v
Standaard Print variant: Poster A3 mat
3. Zet split aan op het Product
Ga naar het Product in Printsyncer en open de geavanceerde instellingen.
Zet Design-link pagina's splitsen naar PrintAPI producten aan.
4. Voeg de pagina mappings toe
Voeg per design-link pagina toe welke Print variant gebruikt moet worden.
Pagina 1 -> Poster A3 mat
Pagina 2 -> Kaart A6 glans
Pagina 3 -> Sticker rond 50mm
Pagina's die je niet invult, gebruiken automatisch de Print variant die al op de gekoppelde Product Variant staat. In het voorbeeld hierboven is dat Poster A3 mat.
Voorbeeld
Een klant bestelt 2 stuks van een bundle met 3 design-link pagina's.
Mapping:
Pagina 1 -> Poster A3
Pagina 2 -> Kaart A6
Pagina 3 -> Sticker
Aantal besteld: 2
Printsyncer maakt dan deze PrintAPI items:
Item 1: Poster A3, pagina 1, quantity 2
Item 2: Kaart A6, pagina 2, quantity 2
Item 3: Sticker, pagina 3, quantity 2
Als er DTP upsells op de orderregel zitten, kan Printsyncer de items per besteld stuk opsplitsen zodat upsells per stuk correct worden toegewezen.
Aantal besteld: 2
Pagina's: 3
Unit 1:
Item 1: pagina 1, quantity 1, met DTP upsell
Item 2: pagina 2, quantity 1
Item 3: pagina 3, quantity 1
Unit 2:
Item 4: pagina 1, quantity 1, met DTP upsell
Item 5: pagina 2, quantity 1
Item 6: pagina 3, quantity 1
Belangrijke regels
Design-link pagina's bepalen het aantal items
Printsyncer kijkt naar de design links op de orderregel. Elke gevonden pagina kan een apart PrintAPI item worden.
_tib_design_link_1 -> pagina 1
_tib_design_link_2 -> pagina 2
_tib_design_link_3 -> pagina 3
Als er geen design links zijn, gebruikt Printsyncer de normale orderregel-verwerking.
Niet-gemapte pagina's gebruiken de standaard Print variant
Je hoeft niet elke pagina te mappen. Een pagina zonder mapping gebruikt de Print variant van de Product Variant die via de Shopify SKU is gevonden.
Pagina 1 -> eigen mapping
Pagina 2 -> geen mapping -> standaard Print variant van de SKU-koppeling
Pagina 3 -> eigen mapping
Print varianten moeten bij dezelfde PrintAPI account horen
Een pagina mapping wordt alleen gebruikt als de gekozen Print variant bij dezelfde PrintAPI account hoort als de oorspronkelijke orderregel.
Dit voorkomt dat Printsyncer een productId meestuurt dat de actieve PrintAPI account niet kent.
Geuploade bestanden hebben voorrang
Als er al een geupload orderbestand bestaat voor dezelfde bestandspositie, gebruikt Printsyncer de normale orderregel-verwerking en wordt de orderregel niet gesplitst.
Voorbeeld:
Product gebruikt design links als content
Orderregel heeft al een geupload content bestand
v
Printsyncer gebruikt het geuploade bestand
Split wordt overgeslagen
Dit voorkomt dat hetzelfde geuploade bestand per ongeluk naar alle split-items wordt gestuurd.
Content of cover hangt af van het product
Meestal wordt een design-link PDF als content naar PrintAPI gestuurd. Als de Product Variant is ingesteld om externe bestanden als cover te gebruiken, wordt de gegenereerde PDF als cover meegestuurd.
Normaal product: design-link PDF -> content
Cover product: design-link PDF -> cover
Engraving en spot-color werken per pagina
Elke gemapte Print variant gebruikt zijn eigen verwerkingspad, precies zoals bij normale orderregels:
Pagina 1 -> Poster A3 (normale verwerking)
Pagina 2 -> Gravure plankje (engraving verwerking)
Pagina 3 -> Witte inkt kaart (spot-color verwerking)
Een pagina die naar een Print variant met engraving wijst, wordt via de engraving-pipeline verwerkt (inclusief inversie en positionering). Een pagina met spot-color gaat door de witte-inkt conversie. Zo kun je bijvoorbeeld een TeeInBlue product verkopen waarbij pagina 1 een poster is en pagina 2 een gegraveerd product.
Let op: engraving gebruikt altijd het content-bestand, ook als het Product is ingesteld om externe bestanden als cover te gebruiken. Dit is hetzelfde gedrag als bij normale orderregels.
Controle voor livegang
Gebruik deze checklist voordat je een product live zet:
- De Shopify SKU koppelt aan de juiste Product Variant.
- De standaard Print variant op de gekoppelde Product Variant is correct ingesteld.
- De split-instelling staat aan op het Product.
- Elke pagina die een afwijkend fysiek product nodig heeft, heeft een mapping.
- Alle gemapte Print varianten horen bij dezelfde PrintAPI account.
- De PrintAPI configuratie-opties van elke Print variant kloppen.
- Je hebt een testorder gecontroleerd in de PrintAPI payload.
Problemen oplossen
Er wordt nog steeds 1 multi-page PDF gestuurd
Waarschijnlijke oorzaak: split staat uit, er zijn geen design links, of er is een geupload bestand voor dezelfde bestandspositie.
Oplossing: controleer de productinstelling, orderregel en orderbestanden.
Een pagina gebruikt de verkeerde Print variant
Waarschijnlijke oorzaak: de pagina heeft geen mapping of de mapping wordt genegeerd door een PrintAPI account mismatch.
Oplossing: controleer de pagina mapping en de PrintAPI account van de gekozen Print variant.
PrintAPI herkent het product ID niet
Waarschijnlijke oorzaak: de Print variant hoort mogelijk bij een andere PrintAPI account.
Oplossing: gebruik een Print variant van dezelfde PrintAPI account als de orderregel.
Een pagina geeft een 404 PDF URL
Waarschijnlijke oorzaak: de gevraagde pagina bestaat niet in de design links.
Oplossing: controleer de design-link velden op de Shopify orderregel.
Een gravure- of spot-color pagina ziet er verkeerd uit
Waarschijnlijke oorzaak: de engraving- of spot-color configuratie van de gemapte Print variant klopt niet, of de pagina wijst naar de verkeerde Print variant.
Oplossing: controleer de engraving/spot-color instellingen op de gemapte Print variant en test de pagina via een testorder.