Det här dokumentet beskriver hur en grossist kan koppla sina system till Mowin. Det riktar sig till utvecklare, integrationspartners och IT-ansvariga hos grossisten, inte till Mowins användare. Kopplingen ger:

Är du Mowin-användare och vill koppla en grossist i ditt eget konto hittar du det i Grossister och Hantera EDI.

De tre delarna tar olika vägar in i Mowin.

Prisfilen och rabattbrevet är alltså inte filer ni skickar till Mowin, och orderbekräftelserna är de enda ni laddar upp själva.

Vilken nivå ni kan nå beror på vilka tekniska möjligheter ni har.

Nivå 1 – Full integration (rekommenderad)

Det ger full funktionalitet i Mowin.

Nivå 2 – Delvis integration

Orderbekräftelser hanteras då inte via EDI. Kunden lägger i stället till inköpen på arbetsordern själv.

Nivå 3 – Nettoprislista

Kan ni inte leverera prisfil och rabattbrev kan ni skicka en nettoprislista direkt till kunden. Kunden importerar den själv i Mowin, se avsnittet Nettoprislista nedan.

Prisfilen innehåller grossistens artikelregister och grundpriser. Mowin hämtar den varje natt och uppdaterar artikelregistret.

Filformat

Mowin känner av teckenkodningen själv. UTF-8 ger minst risk för att å, ä och ö blir fel.

Fält

Så här behandlas filen:

Rabatter gäller normalt rabattgrupper kopplade till en specifik kund. När kunden laddar upp rabattbrevet kopplas rabatterna till just den kunden, så att Mowin kan räkna fram kundens inköpspris automatiskt.

Mowin kan läsa två slags rabattrader:

Så hänger det ihop med prisfilen:

Mowin läser varje grossists rabattbrev i det format grossisten redan skickar till sina kunder, och det finns ingen gemensam filstruktur som alla grossister kan använda. Använder ni ett format som Mowin inte redan stöder bygger Mowin stödet. Skicka ett exempel på rabattbrevet först, se avsnittet Support.

När kunden handlar hos er skickar ni en orderbekräftelse till Mowin. Mowin läser av den och lägger inköpet hos kunden under Hantera inköp. Har kunden angett sitt Mowin-arbetsordernummer som märkning vid köpet kopplas inköpet till rätt arbetsorder automatiskt. Det är det som EDI är till för.

Kopplingen sätts upp per kund. När en kund begär EDI hos er i Mowin skickas ett mejl med rubriken "Begäran om EDI till Mowin" till den EDI-kontakt som Mowin har registrerad hos er. Mejlet innehåller kundens företagsnamn, organisationsnummer och kundnummer hos er, och gäller orderbekräftelser.

Stödda format

JSON stöds inte. Mowin läser varje fil som antingen EDIFACT eller XML.

Vilka uppgifter som behövs

Mowin har ingen fast fältlista för orderbekräftelsen. Var uppgifterna ligger i filen avgör en mappning som Mowin sätter upp för varje grossist utifrån ert exempel. Uppgifterna nedan är det som behövs för att inköpet ska hamna rätt hos kunden.

Priset på raden

Har orderbekräftelsen ett pris för raden används det, även om det är negativt eller noll. Saknar raden pris räknar Mowin ut det från artikelns pris i prisfilen och kundens rabattbrev. Finns ingen rabatt för artikeln blir priset 0 och måste sättas för hand.

Dubbletter

Ett ordernummer från er läses bara in en gång per kund. Skickar ni en ny orderbekräftelse med samma ordernummer ersätter den inte den första. Rättelser får därför inte skickas som en ny fil med samma ordernummer.

Returer

Mowin har ingen särskild hantering av returer och matchar inte en retur mot ursprungsordern på ordernummer eller artikelnummer och antal. En retur läses in som en egen orderbekräftelse, och inköpet kopplas till en arbetsorder via märkningen som vilket annat inköp som helst. Radbeloppet räknas som antal gånger pris, så en retur ska ge ett negativt belopp. För Rexel vänder Mowin priset till positivt när både antal och pris är negativa. Hur returer ska se ut hos er avgörs vid testet, se avsnittet Testprocess.

Vad ni inte får tillbaka

Mowin skickar inga kvittenser eller felmeddelanden tillbaka till grossisten. En fil som inte kan läsas in märker ni inte av hos er.

Orderbekräftelser skickas till Mowin via SFTP eller FTP.

Använd helst SFTP, eller FTP över TLS (FTPS), så att uppgifterna krypteras. Vilka protokoll som är aktiverade för er bekräftar Mowin vid uppsättningen.

Mappstruktur

Orderbekräftelser ska läggas i mappen:

<användarnamn>/orderRsp/

När en fil har skapats i den mappen läses den automatiskt in i Mowin och flyttas sedan bort från mappen. En fil som läggs någon annanstans, eller som saknar filnamn, läses inte in och ger inget felmeddelande.

Ladda upp filen direkt under dess slutliga filnamn och byt inte namn på den efteråt. Mowin börjar läsa en fil så fort den har skapats.

Kan ni inte leverera prisfil och rabattbrev kan ni skicka en nettoprislista direkt till kunden. Kunden importerar den själv under Admin → Eget material, och priserna används sedan i materialsökningen i stället för grossistens listpris. Hur importen går till beskrivs i artikeln Eget material.

Filformat

CSV eller Excel (XLSX).

Fält

Kunden väljer själv vilken kolumn i filen som är vilket fält när filen läses in, så rubrikerna behöver inte heta på ett visst sätt.

Innan integrationen aktiveras genomförs tester tillsammans med Mowin. Testerna omfattar normalt:

Vid frågor om integrationen kan ni kontakta Mowin. Skicka gärna med:

Då kan integrationen verifieras innan produktionsstart.

Hur får vi inloggning till FTP-servern?
Mowin skapar inloggningen när integrationen sätts upp. Användarnamnet är också namnet på mappen där orderbekräftelserna ska ligga.

Vilka format kan vi skicka orderbekräftelser i?
XML och EDIFACT (ORDRSP). JSON stöds inte. En XML-fil enligt PEPPOL BIS Ordering 3 läses direkt. Andra XML-format kräver en mappning som Mowin bygger utifrån ett exempel.

Vilka fält måste orderbekräftelsen innehålla?
Det finns ingen fast fältlista, eftersom Mowin mappar varje grossists fil. För att inköpet ska hamna rätt behövs kundnummer, kundens märkning, ert ordernummer, artikelnummer, antal, enhet och styckpris. Märkningen är det som kopplar inköpet till kundens arbetsorder.

Varför kopplas inte orderbekräftelsen till kundens arbetsorder?
Då saknar filen kundens märkning, eller så är märkningen inte ett arbetsordernummer i Mowin. Inköpet läses ändå in och ligger under Ohanterade hos kunden. Det kan också bero på att kundnumret i filen inte är samma som kunden angett för er i Mowin. Då hittar Mowin kunden på organisationsnummer eller företagsnamn i andra hand.

Vad händer om vi skickar samma orderbekräftelse två gånger?
Den andra läses inte in. Ett ordernummer från er läses bara in en gång per kund, så en rättelse med samma ordernummer ersätter inte den första.

Hur skickar vi returer?
Som en egen orderbekräftelse. Mowin matchar inte returen mot ursprungsordern, och radbeloppet räknas som antal gånger pris. Formatet stäms av vid testet.

Vad händer med artiklar som saknas i prisfilen?
Mowin markerar dem som borttagna hos grossisten. Skicka därför alltid hela artikelregistret i prisfilen.

Måste vi skicka rabattbrevet till Mowin?
Nej. Ni skickar rabattbrevet till era kunder som vanligt, och kunden laddar upp det i Mowin. Mowin läser formatet ni redan använder.

Vad händer om vi lägger filen i fel mapp?
Filen läses inte in, och varken ni eller kunden får något felmeddelande. Använd mappen <användarnamn>/orderRsp/.

Kontakta Mowin via chatten här nere till höger så hjälper vi dig.