Træleborgodden 2, 3112 Tønsberg

31 00 46 00

Man – Fre 08:00-16:00

Webservice dokumentasjon

1.Teknisk spesifikasjon #

Webservicen knytter PCK sammen med WooCommerce. PCK benytter SOAP service inn til en sentral server som oversetter data til JSON som så sendes til WooCommerce via WooCommerce sin innebyggede API.

Beskrivelsen under gjelder standard funksjonalitet.
Det tilbys en alternativ webservice hvor en del funksjoner er slått av, slik at produkter kan behandles manuelt i WooCommerce.

  • Det sendes et “skall” produkt som inneholder varenavn, sku, pris og lager (antall og status).
  • Alle andre felter kan endres direkte i WooCommerce.
  • Dersom normal webservice velges, er det PCK som styrer alle felter og vil overskrive alle endringer gjort direkte i WooCommerce.

Krav til WooCommerce

Installasjonen må kunne håndtere API kall. Enkelte webservere krever en tilpassning i .htaccess for å tillate API kall. Windows servere vil fungere uten tilpassninger. Installasjonen må også ha aktivert “pretty links”, som er et oppsett av Permalenker for å tillate API operasjoner.

Ordrer i PCK må benytte standard status. Ordrer som er betalte skal ha status “Behandler”. PCK vil aktivt lytte etter ordrer som har status behandler, og kun denne statusen. PCK vil endre status for ferdigmeldte ordrer til status Fullført, som også antar at betalingsløsningen mottar videre singal fra WooCommerce etter endret status for å trekke det reserverte beløpet.

Produkter

Webservicen mottar følgende produktdata fra PCK som sendes som ett objekt til WooCommerce. Dvs at hele produktobjektet overskrives ved hver oppdatering. Oppslaget gjøres med produkt ID fra PCK som samsvarer med SKU i WooCommerce.

Ved salg eller annen endring i PCK, trigges updateStock eller SendArticle, avhengig av graden av endring.

Felter som sendes

  • Varenavn
  • Pris
  • Tilbudspris og dato
  • Hovedbilde (ett stk)
    • Ekstrabilder kan sendes ved å bruke fargeid = 0. Overskrives hver gang.
  • Produkt type (Simple eller variabel)
    • Om variabel: Sendes farge og størrelse, med alle paramatere som for simple.
    • Et variabelt produkt arver alle egenskaper fra hovedvaren
  • Varekattegorier. 3 Nivåer fra PCK
    • Varekattegorier sendes med kattegorinavn som slug og navn.
  • Lager i antall
  • Lager status (Restordre tillates (true/false) som styres av om vare er markert som skjul når tom på lager
    • Dersom “synlig på nett” fjernes i PCK, vil varen endre status til Privat. Når valget aktiveres, vil varen opprettes dersom ingen sku blir funnet som matcher ID i pck. Dersom den blir funnet, men er satt som privat, vil status endres til offentlig.
  • Fraktklasse Kun henting (meta data). Dette krever at modul er aktivert i webservicen.
  • Subtitle fra PCK. Dersom skrevet inn metervare, vil varen i tillegg få kattegorien Metervare.
  • Brand fra PCK. Sendes som Meta data Key: Brand Value: {Brand name}

Ordre

PCK starter kommunikasjonen for å se etter ordre. Dersom det finnes nye ordrer i WooCommerce, sendes disse tilbake til PCK.

Ordredata som hentes fra WooCommerce:

  • Ordreid
  • Kundenavn
  • Kunde leveringsdetaljer
  • Fraktmetode
  • Totalpris
  • Ordrelinjer
  • Betalingsmetode
    • Transasksjonsid, metode og totaler.
  • Ordrestatus

Når en ordre fullføres i PCK sender PCK en oppdatering til WooCommerce:

  • OrdreID
  • Status fullført dersom ordren er full levert
  • Status behandler dersom ordren er del-levert.
    • Dersom del-levert ordre, og valget slett restlinjer er satt, er ordren ferdig i PCK, men må korrigeres i WooCommerce slik at antall ordrelinjer matcher, før ordren manuelt fullføres. Her kommer det automatikk.
Help Guide Powered by Documentor
Suggest Edit