Produktfeed (Prisjakt, Shopello, osv.)

Produktfeeden eksporterer produktkatalogen din i et strukturert format slik at prissammenligningssider og handelsplattformer kan indeksere produktene dine. Når feeden er aktivert, regenereres den automatisk etter en fast tidsplan og kan også oppdateres manuelt.

Støttede plattformer

Produktfeed-modulen støtter fire feed-mål. Hver har sin egen bryter, så du kan aktivere bare de du trenger.

Feed	Plattform	Feed-ID
Prisjakt	Prisjakt Nordic	`pjakt`
Prisguide	Prisguide	`pguide`
Shopello	Shopello	`shopello`
Andre	Generisk / andre integrasjoner	`other`

Aktivere feeden

Modulen har en hovedbryter i tillegg til individuelle brytere per plattform. Begge må være aktive for at en feed skal være tilgjengelig.

Gå til Moduler → Ekstratjenester i kontrollpanelet.
Finn Produktfeed (Prisjakt, Shopello, m.fl.) og installer den hvis den ikke allerede er installert.
I modulinnstillingene setter du Aktiver Produktfeeden til true. Dette er hovedbryteren.
Aktiver de individuelle feedene du trenger: Prisjakt, Prisguide, Shopello og/eller Andre.

Endringene trer i kraft neste gang feeden regenereres.

Feed-URLer

Hver aktivert feed er tilgjengelig på en fast URL:

https://dinbutikk.no/produktfeed.php?id={feed-id}

Plattform	URL-parameter
Prisjakt	`?id=pjakt`
Prisguide	`?id=pguide`
Shopello	`?id=shopello`
Andre	`?id=other`

Eksempel: https://dinbutikk.no/produktfeed.php?id=pjakt

Endepunktet sjekker at den aktuelle feeden er aktivert før det returnerer data. Forespørsler for en deaktivert eller ukjent feed-ID returnerer tom respons.

Feedformat

Feeder leveres som tabulatorseparerte verdier (TSV) med en overskriftsrad. Hver rad er ett produkt eller én produktvariant.

Kolonne	Beskrivelse
`productid`	Intern produkt-ID
`url`	Direktelenke til produktsiden
`manufacturer`	Merke- eller produsentnavn
`title`	Produktnavn (maks 80 tegn, HTML fjernet)
`description`	Produktbeskrivelse (HTML fjernet; `<br>` -tagger beholdes i «Andre»-feeden)
`price`	Pris inkl. MVA, formatert i butikkens standardvaluta
`image`	Absolutt URL til produktbilde
`category`	Full kategoripath, pipe-separert (f.eks. `Klær	Herre	Jakker`)
`quantity`	Lagerantall
`attributes`	Variantkombinavjoner, semikolon-separert (f.eks. `Farge-Rød(199),Størrelse-L(199);` )
`ean`	EAN-strekkode (hvis EAN-modulen er aktiv)
`model`	Produktets modellnummer

Produkter bruker butikkens aktive språk og standardvaluta. Hvis et produkt har en aktiv kampanjepris, brukes den i stedet for ordinær pris.

Slik fungerer regenerering

Feed-filer forhåndsgenereres og mellomlagres. Feed-endepunktet serverer den mellomlagrede versjonen når en eksisterer. Dette holder responstiden lav for prissammenligningssider som poller hyppig.

Feeder regenereres etter en tidsplan av en cron-jobb som kjører på tvers av alle aktive butikker. Den setter et bakgrunnsjobb i kø for hver aktivert feed-type per butikk. Køarbeideren henter jobben, genererer TSV-innholdet og skriver filen til disk.

Typisk regenereringsfrekvens: hvert par timer, men nøyaktig tidsplan avhenger av serverkonfigurasjonen.

Hvis ingen mellomlagret fil finnes (f.eks. rett etter første aktivering), genereres feeden ved forespørsel og loggføres i feed-genereringsloggen.

Lagerhåndtering

Som standard rapporterer feeden lagerantallet direkte fra databasen. To innstillinger lar deg endre denne oppførselen.

Overstyr lagerantall

Når Overstyr lagerantall (PRODUCTFEED_IGNORE_STOCK) er aktivert, rapporterer alle produkter i feeden lagerantall 1 uavhengig av faktisk beholdning. Nyttig hvis du vil at alle produkter i katalogen skal vises som tilgjengelige uten å eksponere faktiske lagertall.

Aktiver dette under Moduler → Ekstratjenester → Produktfeed-innstillinger.

Eksternt lager

⚠️ Oppsett av tag og ekstern lager må gjøres av Mystore. Kontakt support for mer info.

Hvis deler av lagerbeholdningen din spores utenfor Mystore (et tredjeparts lager, et ERP-system eller et manuelt antall), kan du legge til den mengden på hvert produkt via en produkttag. Når feeden genereres, legges tag-verdien til databaseantallet.

Eksempel: et produkt har 10 enheter i Mystore-databasen og en external_stock-tag med verdi 50. Feeden rapporterer 60.

Aktivere eksternt lager

I produktfeed-modulinnstillingene setter du Kombiner eksternt lager til true.
Sett eventuelt Ekstern lager-tag til en egendefinert tag-nøkkel hvis du ikke bruker standarden (external_stock).

Sette lagerverdier på produkter

Legg til en tag på hvert produkt som har ekstern beholdning. Taggen må bruke nøkkelen du konfigurerte (standard: external_stock) og en numerisk verdi.

Dette kan gjøres via produkttag-grensesnittet i kontrollpanelet eller via masseimport.

Krav:

Produkttagger-modulen (PRODUCTS_TAGS_ACTIVE) må være aktivert.
Tagger med products_id = -1 er malrader og ignoreres.

Samspill med «Overstyr lagerantall»

Hvis Overstyr lagerantall også er aktivert, har eksternt lager ingen effekt — alle produkter rapporterer 1 uansett.

Ekskluder produkter fra feeden

Du kan tagge enkeltprodukter slik at de utelates helt fra alle produktfeeder.

Aktivere produktekskludering

I produktfeed-modulinnstillingene setter du Tillat ekskludering av produkter til true.
Dette oppretter en exclude_from_feed-tagmal, som deretter vises i produkttag-grensesnittet.

Ekskludere et produkt

Åpne produktet i kontrollpanelet, finn Tagger-seksjonen og sett exclude_from_feed-taggen til true. Produktet hoppes over neste gang feeden regenereres.

Merk: Ekskludering gjelder alle feed-typer (Prisjakt, Shopello, Andre osv.) samtidig. Det er ikke mulig å ekskludere et produkt fra én feed uten at det gjelder alle.

Krav

Produkttagger-modulen (PRODUCTS_TAGS_ACTIVE) må være aktivert.
Ekskludering trer i kraft etter neste feed-regenerering. Bruk manuell oppdatering hvis endringen må vises umiddelbart.