=== Asapp Delivery for WooCommerce ===
Contributors: jonandreasasapp
Tags: woocommerce, delivery, shipping, same-day, express
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.14
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Tilby levering på timen direkte i WooCommerce – med Asapp.

== Short Description ==
Offer lightning-fast delivery with Asapp directly in WooCommerce.

== Description ==

**Asapp!** er en norsk leveringstjeneste som leverer varen din rett etter at den er klargjort – ofte innen 60 minutter, uten faste hentetidspunkt. Leveringen utføres av Oslo Taxi sin flåte på over 750 biler.

Med denne pluginen kobler du WooCommerce-butikken din direkte til Asapp sitt leveringsnettverk. Kundene dine ser pris og tilgjengelighet i sanntid i checkout, og du håndterer hele leveringsprosessen direkte fra WooCommerce-admin.

**Hva pluginen gjør:**

* Oppretter automatisk en fraktsone ("ASAPP - Levering per time") ved aktivering, klar til bruk
* Beregner leveringspris i sanntid basert på kundens adresse, avrundet til hele kroner inkl. mva
* Viser Asapp øverst i listen over fraktalternativer i checkout, med forventet leveringstid ("Asapp – få det om ca. 40 min") som inkluderer butikkens klargjøringstid og tiden bilen bruker til butikken
* Viser Asapp kun når butikken er åpen: åpningstider per ukedag, automatisk stengt på norske helligdager, og egne stengte dager
* Pauseknapp i WordPress-menylinjen for å skru av Asapp midlertidig (1 time, 2 timer eller resten av dagen) — slår seg på igjen av seg selv
* SMS til butikken i det en Asapp-ordre kommer inn, slik at pakken klargjøres med en gang
* Registrerer ordren hos Asapp når WooCommerce-ordren settes til "Behandles". Bilen bestilles først når butikken melder at pakken er "klar for henting"
* Genererer fraktetikett med QR-kode for utskrift
* Gir kunden en sporingslenke for leveransen
* Lar deg velge region (Oslo, Bergen, Trondheim, Stavanger eller hele Norge) for å sette opp riktige postnumre på fraktsonen automatisk

**To driftsmoduser:**

* **Basic:** Ordren registreres hos Asapp, og butikken melder "klar for henting" i Asapp sin portal eller i appen Asapp! Butikk. Da bestilles bilen
* **Supreme:** WooCommerce styrer hele prosessen. Når butikken setter ordren til "Fullført", meldes pakken "klar for henting" og bilen bestilles

**Dekningsområde:**

Asapp! leverer i dag i Oslo. Tjenesten valideres grundig før den rulles ut til flere byer.

Vil du at Asapp skal komme til din by? Send oss en e-post på hello@asapp.tech – vi tar det med i planleggingen.

**Krav for å ta pluginen i bruk:**

* Aktiv Asapp-konto med API-nøkkel og Butikk-ID (hver hentestasjon/butikk har sin egen ID)
* Leveringsadresser innenfor Asapp sitt dekningsområde

Ta kontakt på hello@asapp.tech eller besøk [asapp.tech](https://asapp.tech) for å komme i gang.

== Installation ==

1. Last opp og aktiver pluginen. En egen fraktsone ("ASAPP - Levering per time") opprettes automatisk.
2. Gå til WooCommerce → Innstillinger → Frakt, og åpne fraktsonen som ble opprettet (eller velg en eksisterende sone og klikk "Legg til fraktmetode").
3. Velg "Asapp Delivery" som fraktmetode, og åpne innstillingene.
4. Fyll inn API-nøkkel og Butikk-ID fra din Asapp-konto.
5. Velg region for å få riktige postnumre foreslått på sonen, og juster ved behov under WooCommerce → Frakt → Soner.
6. Velg driftsmodus (Basic eller Supreme).
7. Under "Åpningstider": huk av for "Vis Asapp kun når butikken er åpen", fyll inn åpningstid for hver dag (f.eks. `11:00-18:00`, tomt felt = stengt), og legg eventuelt inn andre stengte dager (f.eks. `24.12, 31.12`). Norske helligdager er stengt automatisk.
8. Lagre.

== Frequently Asked Questions ==

= Trenger jeg en Asapp-konto? =
Ja, du trenger en aktiv konto med API-nøkkel og Butikk-ID fra Asapp. Ta kontakt på hello@asapp.tech.

= Hvilke områder dekker Asapp? =
Asapp leverer i dag i Oslo. Vi utvider fortløpende – send en e-post til hello@asapp.tech hvis du ønsker Asapp i din by.

= Hva er forskjellen på Basic og Supreme modus? =
I begge moduser registreres ordren hos Asapp når den settes til "Behandles", og bilen bestilles først når pakken er klar for henting. I Basic-modus melder butikken "klar for henting" i Asapp sin portal eller i appen Asapp! Butikk. I Supreme-modus styrer WooCommerce hele prosessen selv, inkludert å markere pakken som klar for henting når WooCommerce-ordren settes til "Fullført".

= Hvordan unngår jeg at kunder bestiller Asapp når butikken er stengt? =
Slå på "Vis Asapp kun når butikken er åpen" i fraktinnstillingene og fyll inn åpningstidene. Asapp slutter å vises et valgfritt antall minutter før stengetid (standard 30), slik at dere rekker å klargjøre pakken. Norske helligdager (røde dager) er stengt automatisk, og dere kan legge inn egne stengte dager som julaften.

= Kan jeg skru av Asapp midlertidig, f.eks. på en markedsdag? =
Ja. Når du er innlogget i WordPress vises "● Asapp aktiv" i menylinjen øverst (også på mobil). Velg "Pause 1 time", "Pause 2 timer" eller "Pause resten av dagen". Asapp forsvinner fra checkout med en gang, og kommer tilbake av seg selv når pausen er over. Velg "Slå på igjen nå" for å avslutte pausen tidligere.

= Hvorfor er prisen avrundet? =
Asapp beregner prisen ut fra faktisk kjørelengde. Pluginen runder prisen kunden ser (inkl. mva) av til nærmeste hele krone, slik at det står f.eks. 189,00 kr i stedet for 189,20 kr.

= Får butikken beskjed når det kommer en Asapp-ordre? =
Ja, på to måter: WooCommerce sin vanlige e-post "Ny ordre" (WooCommerce → Innstillinger → E-poster), og fra 1.0.10 en SMS fra Asapp i det ordren kommer inn. Telefonnumrene for SMS registreres av Asapp — send oss nummeret på hello@asapp.tech.

= Hva skjer hvis Asapp ikke er tilgjengelig for en adresse? =
Fraktmetoden vises ikke i checkout for adresser utenfor dekningsområdet, og systemet faller tilbake på en konfigurerbar standardpris dersom API-kallet ikke skulle svare.

= Hvilke data sendes til Asapp? =
Kun det som trengs for å utføre leveransen: mottakers navn, leveringsadresse, telefonnummer, e-post og ordre-ID/referanse. Se "External Services" under for detaljer.

= Er pluginen gratis? =
Selve pluginen er gratis å installere. Du betaler kun for faktiske leveranser via din Asapp-konto. Ta kontakt på hello@asapp.tech for informasjon om oppstart og priser.

== External Services ==

Denne pluginen kobler WooCommerce-butikken din til Asapp sitt leverings-API (api.asapp.tech), som driftes av Asapp! AS. Dette er nødvendig for at pluginen skal fungere, og skjer i disse tilfellene:

* **Ved beregning av frakt i checkout:** kundens leveringsadresse sendes til Asapp for å sjekke tilgjengelighet og beregne pris.
* **Når en ordre settes til "Behandles":** mottakers navn, adresse, telefonnummer, e-post og ordre-ID sendes til Asapp for å registrere leveransen. Ingen bil bestilles ennå.
* **Når en pakke markeres "klar for henting":** en referanse til ordren sendes til Asapp, og Asapp bestiller bilen.

Ingen betalings- eller kortopplysninger sendes gjennom denne pluginen. Kommunikasjonen er autentisert med en API-nøkkel som kun du har tilgang til.

Tjeneste: [asapp.tech](https://asapp.tech)
Personvernpolicy: [asapp.tech/personvern](https://asapp.tech/personvern)

== Upgrade Notice ==

= 1.0.14 =
Viktig feilretting: pluginen kunne krasje når Asapp avviste en ordre. Knappene «Mark ready for pickup» og «Print» virker nå. Ny, kortere tekst i kassen: «Asapp – få det om ca. 40 min». Anbefales for alle.

= 1.0.13 =
For butikker med appen Asapp! Butikk: variant og produktbilde vises på hver varelinje.

= 1.0.12 =
Testet med WordPress 7.1. Asapp skjules nå når tjenesten ikke svarer, i stedet for å vise en feilmelding og reservepris. Ordremerknader er på norsk.

= 1.0.11 =
Viktig feilretting: Asapp-API-et nås nå på riktig adresse, og sporingslenkene virker. Anbefales for alle butikker. Inkluderer alt fra 1.0.8–1.0.10.

= 1.0.10 =
Nytt: SMS til butikken når en Asapp-ordre kommer inn. Inkluderer alt fra 1.0.8 og 1.0.9 (åpningstider, røde dager, pauseknapp, hele kroner). Kontakt hello@asapp.tech for å registrere telefonnummer.

= 1.0.9 =
Nytt: åpningstider, automatisk stengt på røde dager, pauseknapp og priser i hele kroner. Inkluderer også 1.0.8 (Asapp øverst i checkout, leveringstid inkl. klargjøring). Innstillingene deres beholdes. Slå på åpningstider i fraktinnstillingene etter oppdatering.

= 1.0.8 =
Asapp vises øverst i checkout, og leveringstiden inkluderer nå butikkens klargjøringstid.

== Changelog ==
= 1.0.14 =
* Fiks (viktig): Når Asapp avviste en ordre, kunne pluginen krasje i stedet for å skrive ordremerknaden. Nå skrives merknaden «Ordren ble ikke opprettet hos Asapp» med feilmeldingen fra Asapp, slik at butikken ser at ordren må følges opp. Feilen kom i 1.0.12.
* Fiks: Knappen «Mark ready for pickup» i Asapp-boksen på ordren virker nå.
* Fiks: Knappene «Print» og «Close» på fraktlappen virker nå.
* Endring: Ny tekst i kassen. Fraktvalget heter nå «Asapp – få det om ca. 40 min», der minuttene er klargjøring + tiden bilen bruker til butikken + kjøring, rundet opp til nærmeste 5 minutter. Over 55 minutter, eller når tiden ikke kan beregnes, står det «Asapp – få det innen 1 time». Under fraktvalget står «Levert på døren · Følg bilen live». Alle tekstene kan endres under «Tekst i kassen».
* Fiks: Asapp-logoen kunne vises flere ganger foran fraktvalget.

= 1.0.13 =
* Nytt: For butikker som bruker appen Asapp! Butikk, sendes nå variant (f.eks. «M · Blå») og produktbilde med hver varelinje, så den ansatte ser nøyaktig hva som skal plukkes. Pris sendes fortsatt aldri.

= 1.0.12 =
* Testet med WordPress 7.1 og WooCommerce 11.1, både i den nye blokk-kassen og i ordreflyten (Basic og Supreme).
* Endring: Når Asapp ikke svarer, skjules Asapp i kassen som standard, så ingen kjøper levering innen timen som kanskje ikke kan leveres. Butikken kan velge å vise en reservepris i stedet («Når Asapp ikke svarer»). Kunden ser aldri lenger en feiltekst.
* Endring: Asapp vises ikke før pluginen er satt opp med API-nøkkel og butikk-ID.
* Forbedring: Årsaken til at Asapp ikke vises, logges under WooCommerce → Status → Logger (asapp-delivery).
* Forbedring: Ordremerknader er på norsk, og viser feilmeldingen fra Asapp når en ordre ikke kunne opprettes.
* Fiks: Adressen som sendes til Asapp inneholder ikke lenger tomme felt når adresselinje 2 er tom.

= 1.0.11 =
* Fiks: Standardadressen til Asapp-API-et (api.asapp.tech) svarte ikke. Pluginen bruker nå adressen som virker, og butikker som har lagret den gamle standardadressen, rettes automatisk. Egne adresser endres ikke.
* Fiks: Sporingslenken på ordren peker nå til en sporingsside som virker.
* Nytt: Butikker som bruker appen Asapp! Butikk, får nye Asapp-ordre direkte i appen, med varer og mottakernavn. Pris, telefon, e-post og adresse sendes ikke.

= 1.0.10 =
* Nytt: Butikken får SMS i det en Asapp-ordre kommer inn (når ordren går til "Behandles"), med beskjed om å klargjøre pakken innen 20 min. Får også SMS hvis ordren ikke kom fram til Asapp. Telefonnumre registreres av Asapp — ta kontakt på hello@asapp.tech. SMS-varsling stopper aldri selve ordren.

= 1.0.9 =
* Nytt: Åpningstider per ukedag i fraktinnstillingene. Når "Begrens til åpningstid" er slått på, vises Asapp kun når butikken er åpen — og slutter å vises et valgfritt antall minutter før stengetid (standard 30), slik at butikken rekker å klargjøre pakken. Av som standard, så eksisterende butikker påvirkes ikke før de slår det på.
* Nytt: Asapp er automatisk stengt på norske helligdager (røde dager), beregnet for hvert år — kan slås av. I tillegg kan butikken legge inn egne stengte dager, f.eks. "24.12, 31.12".
* Nytt: Pauseknapp i WordPress-menylinjen øverst ("● Asapp aktiv"). Butikken kan pause Asapp i 1 time, 2 timer eller resten av dagen, f.eks. på markedsdager. Pausen oppheves automatisk, så den kan ikke glemmes på.
* Endring: Fraktprisen rundes nå av til hele kroner inkl. mva (f.eks. 189,00 i stedet for 189,20).
* Forbedring: Fraktalternativene beregnes på nytt minst hvert 10. minutt, slik at Asapp forsvinner ved stengetid også for kunder som allerede står i kassen.

= 1.0.8 =
* Fiks: Leveringsestimatet i checkout viser transportleverandørens navn — vises nå kun som "Levering om ~X min", uten å nevne underleverandøren.
* Endring: Leveringsestimatet inkluderer nå butikkens kontraktsfestede klargjøringstid (25 min) i tillegg til kjøretid, for et mer realistisk og transparent anslag overfor kunden.
* Nytt: Asapp vises nå alltid øverst i listen over fraktalternativer i checkout, uavhengig av hvordan den enkelte butikk har satt opp rekkefølgen i egen fraktsone.

= 1.0.7 =
* Nytt: Fraktsonen "ASAPP - Levering per time" opprettes automatisk ved aktivering (hele Norge som standard, kan justeres).
* Nytt: Region-nedtrekksmeny i innstillingene (Oslo, Bergen, Trondheim, Stavanger, Hele Norge) med forslag til postnumre.
* Forbedring: API-endepunktene er nå forhåndsutfylt med riktig api.asapp.tech-adresse — ingen manuell utfylling nødvendig.
* Fiks: Sporingslenken genereres ikke lenger avhengig av innholdet i endepunkt-feltet for ordre.
* Fiks: Fjernet en feilaktig BOM-byte i etikett-malen som i enkelte oppsett kunne gi "headers already sent"-advarsler.

= 1.0.6 =
* Fiks: Norske spesialtegn (å, ø, æ) vises nå riktig i innstillingene for fraktmetoden.

= 1.0.5 =
* Opprydding i readme-metadata og PluginCheck-advarsler.

= 1.0.4 =
* Justert slug/text-domain til asapp-delivery-for-woocommerce; forbedret prefixing.

= 1.0.3 =
* WP.org-compliance-fikser.

= 1.0.2 =
* WP.org-compliance-fikser.

= 1.0.1 =
* Vedlikeholdsoppdatering (metadata og encoding-fikser).

= 1.0.0 =
* Første versjon.
