Sitoo REST API ger programmatisk åtkomst till Sitoo plattform. Sitoo REST API gör det enkelt att integrera molntjänster eller andra externa system för att utbyta data såsom produkter, ordrar, kontakter, kassajournaler, lagerinformation och mycket mer.
Vänligen kontakta Sitoo för att för att få åtkomst till Sitoo REST API. När ditt konto är aktiverat för Sitoo REST API får du API-ID och lösenord för Backoffice. Du kommer även få en sandbox-miljö för test.
Besök den officiella API-sidan.
Innehåll
Cleverapps
Celeverapps är ett Retail Management verktyg som kan integreras mot Sitoo. Information om produkter, lager och priser skickas från Cleverapps till Sitoo var tionde minut. Det betyder att varken produkter, lager eller priser kan redigeras direkt i Sitoo Backoffice om du har en integration till Cleverapps.
Lägg aldrig till produkter i Sitoo. Om du säljer en produkt som är tillagd i Sitoo kommer Cleverapps system att neka ordern och därefter sluta synka resterande ordrar från Sitoo till Cleverapps.
Cleverapps hämtar per automatik försäljningsdata från Sitoo, samt alla kvitton från din försäljning som i Cleverapps presenteras som ordrar.
Synka personal i Cleverapps & Sitoo
För att lägga till personal ska dessa adderas i både Sitoo och Cleverapps. För att lägga till personal ska du följa dessa steg:
- Logga in i Sitoo Backoffice > Kontakter.
- Lägg till användaren som en kontakt i Sitoo.
- Logga in i Cleverapps > Kontakter > Användare > Sök upp användaren > Användarnamn kassa: xxxx
- Numret som presenteras ska adderas till kontaktkortet i Sitoo.
- Kopiera numret och gå sedan tillbaka till Sitoo Backoffice > Kontakter > Användarens kontaktkort.
- Scrolla ner till raden Personnummer > Klistra in numret i sektionen Personnummer.
Lägg till kund
- Logga in i Sitoo POS.
- Tryck på ikonen Lägg till Kund som du finner i varukorgens överkant.
- En dialogruta visas med ett sökfält > Sök på antingen e-post eller personnummer.
- I detta fält kan du även scanna streckkoden på körkort och där igenom få en uppslagning på personnummer.
- Tryck på Lägga till ny kund.
- Fyll i de uppgifter som visas i dialogen > OK.
- När kunden är adderas visas information om kunden; personnummer, köphistorik samt de erbjudanden och bonusar som kunden har.
Använda bonus eller erbjudanden
När en kund har erbjudanden eller bonusar att använda presenteras dessa på kundens kundkort i Sitoo POS.
Bonus
Om du klickar på att använda en bonus kommer denna automatiskt påverka summan i varukorgen.
Erbjudanden
Om du klickar på att använda ett erbjudande kommer erbjudandet bli markerat som nyttjat när köpet slutförs. Det finns ingen direkt koppling mellan erbjudanden i CRM och nyttjandet av rabatter i kassan. Om en rabattkod avses nyttjas ska denna läggas in manuellt av personalen.
Nyttjande av erbjudande
För att använda en rabattkod ska du följa dessa steg:
- Lägg kundens önskade varor i varukorgen.
- Tryck på Rabatt > Ange rabattkod.
- Skriv in rabattkoden > OK.
- Rabatten har nu registrerats och kommer dras när köpet slutförs.
Vanliga frågor och svar
Varför syns inte min produkt i Sitoo?
Om produkten inte syns i Sitoo ska du först säkerställa att den är aktiv i Sitoo Backoffice.
- Logga in i Sitoo Backoffice > Produkter > Öppna aktuell produkt > Säkerställ att checkboxen "Aktiv - Webshop" och "Aktiv - POS" är markerade.
Om produkten fortfarande inte är synlig kan du testa att redigera produkten i Cleverapps. Med denna åtgärd brukar produktsynken återställas och produkten dyka upp i Sitoo.
- Logga in i Cleverapps > Gå till den aktuella produkten > Gör en ändring ändring i till exempel produktnamnet, såsom att addera en punkt i slutet av namnet.
Hur ändrar jag pris på en produkt så att det blir rätt i Sitoo?
Logga in i Cleverapps > Produkter > Produkt > Utpris. Genom att förändra priset som är angivet under Utpris förändras försäljningspriset i Sitoo.
Vad betyder detta i Cleverapps vs. Sitoo?
Förrpris i Cleverapps kommer in i Rekpris i Sitoo.
Säsongen i Cleverapps kommer in i Egen 3 i Sitoo.
Endast numeriska barcodes i Cleverapps.
Kontaktuppgifter till Cleverapps
Mail till supporten:
support@cleverapps.se
Supporttelefon:
031-760 19 95
CENTRA (SILK)
Integrationen till Centra gör det enkelt att hantera produkter, priser och lagersaldon mellan systemen. Integrationen innehåller två delar; dels ett sätt att importera produkter från Centra till Sitoo och dels en automation av att synkronisera lagersaldo och priser.
Kopplingar mellan en produkt i Centra och i Sitoo ser ut enligt nedan. I Centra finns det fler olika typer av artikelnummer (sku)- Produktens grundartikelnummer, variantens tillägg och storlekens tillägg. Tillsammans bildar de ett unikt artikelnummer som kan användas tillsammans med Sitoo.
Hämta produkter
När du hämtar produkter från Centra skapas de i Sitoo alternativt uppdateras om de redan finns. När man sätter upp integrationen skapar man ofta en marknad i Centra och kopplar produkter till den. På så sätt kan man styra vilka produkter som skall integreras med Sitoo
Har du produkter i Sitoo som inte finns i Centra kommer de inte att påverkas.
När du klickar på “Hämta produkter” så får du först en översikt om vad som kommer att hända. Hur många produkter som kommer att skapas och uppdateras. Finns det fel i produktdata från Centra t ex att artikelnummer saknas, presenteras en fellista sist. Har du fel så avbryt hämtningen och korrigera felen.
Uppdatera lager och priser
Detta är en automatiskt process, men du kan göra en manuell synkronisering också genom att klicka på knappen “Uppdatera lagersaldon och priser”.
Steg för att ställa in integrationen
- Se till att det finns en “Retail”-sektion i Centra. Där hämtas en del produktdata såsom priser, bilder mm.
- Skapa en marknad och koppla produkter som skall ingå i koppling till Sitoo.
- Säkerställ att samma valuta som används i Sitoo finns i Centra och att de kopplade produkterna har pris satt för denna valuta.
- Säkerställ att alla produkter har “sku”, “variant sku” och “size sku”, så att varje produkt blir unik. Om datat eventuellt innehåller mellanslag kommer de inte att accepteras.
- Se till att “cost price” i Centra är inköpskostnad exkl moms.
- Skapa en “Centra API”-plugin för varje lager som skall kopplas (ev. m h a Young & Skilled). I kopplingen anges den skapta marknaden. Du får här en API-nyckel (“secret”) och en url för API. Samma nyckel skall används för alla URL:er (det blir en för varje lager som skall kopplas)
- “Primary Warehouse” ska ställas in på det lager som avses.
- “Virtual Warehouse” ska INTE vara valt.
- “Get Products Returns Cost Price” ska vara satt till “Yes” annars kommer inte “costPrice” ut från API:et.
- “Get Products Returns Tax For Country” ska vara satt till samma marknad som lagret avser. (Sweden) Är denna inte satt så kommer inte “taxPercent” ut från API:et.
Inställningar i Sitoo
- Logga in i Backoffice > Inställningar > Centra. Om du inte ser detta val är inte tillvalet påslaget.
- Ange API-nyckel.
- Ange API (url) för varje lager. Det är här koppling mellan ett lager i Centra och i Sitoo görs.
- Ange eventuellt vilket lager som är centrallagret. Not! använd detta enbart om du har försäljning i Sitoo som skall påverka ett centrallager direkt i Centra. T ex om du har en försäljning direkt från centrallagret.
- Ange vad variantgruppen “Storlek” skall heta i Sitoo. Produkter i Centra som har olika storlekar skapa i Sitoo med en variantgrupp.
- Ange vilka varugrupper i Sitoo som är standard för de olika momssatserna. En produkt i Centra som skapas i Sitoo kommer att få den varugrupp som motsvarar procentsatsen. När produkten sedan är skapad i Sitoo kan du ändra varugruppen för att få mer detaljerade dagsrapporter och bokföringsunderlag.
- Ange att priser skall uppdateras automatiskt
- Ange att lagersaldon skall uppdateras automatiskt
- Klicka på Spara
Information som uppdateras vid "Hämta produkter"
För befintlig artikel
- sku: Uppercase of (sku + variantSku + sizeSku)
- title: name
- barcode: ean
- custom2: collection
- description: description
- descriptionshort: shortDescription
- activepos: active
- moneyprice: Prices/price for correct currency
- moneypricein: Set if same currency
- manufacturerid: lookup(brand)
- defaultcategoryid: lookup(categories[0]) put rest in categories
- offerisenabled: If campaign, this is set to true else set to false
- moneyofferprice: If campaign, this is set to Campaign price
- offerdatestart: If campaign, this is set to null
- offertitle: If campaign, this is set to Campaign
- offerdateend: If campaign, this is set to null
För helt ny artikel
- sku: Uppercase of (sku + variantSku + sizeSku)
- title: name
- barcode: ean
- custom2: collection
- description: description
- descriptionshort: shortDescription
- activepos: active
- moneyprice: Prices/price for correct currency
- moneypricein: Set if same currency
- manufacturerid: lookup(brand)
- defaultcategoryid: lookup(categories[0]) put rest in categories
- offerisenabled: If campaign, this is set to true else set to false
- moneyofferprice: If campaign, this is set to Campaign price
- offerdatestart: If campaign, this is set to null
- offertitle: If campaign, this is set to Campaign
- offerdateend: If campaign, this is set to null
- vatid:
- Variantgrupp: