Bilaga E-handel och fakturering - tjänster

Bilaga E-handel och fakturering - tjänster stockholm.se

SID 2 (14) Innehåll Inledning 3 1 Enkel e-handel 3 2 Handla via leverantörs webbutik 3 Tester 4 Krav på leverantörs webbutik vid anslutning till e-handel 5 Teknisk information OCI 4.0 (3.0) 5 Teknisk information SFTI Varukorg. scenario 6.5.3 6 3 Fakturering 7 Betalningsvillkor 7 Svefaktura 7 3.2.1 Adresseringsmöjligheter Svefaktura 7 3.2.2 Fakturareferenser Svefaktura 8 3.2.3 Krav på fakturainnehåll Svefaktura 9 Pappersfaktura 9 3.3.1 Fakturaadresser pappersfaktura 9 3.3.2 Krav på fakturainnehåll pappersfaktura 10 4 Kundregister 11 5 STH-koder och GLN för kommunkoncernen 12 6 Exempel pdf-order 14

SID 3 (14) Inledning Stockholms stad och stadens bolag, kommunkoncernen Stockholms stad, inför e-handel för att det ska bli lätt att göra rätt för medarbetare som gör inköp. Inköpssystemet bidrar till att medarbetarna köper rätt vara eller tjänst från rätt leverantör till rätt pris/rätt villkor. E-handel innebär att aktuellt avtal ansluts till e-handel och blir beställningsbart i kommunkoncernens inköpssystem. Då blir avtalet lättillgängligt för medarbetare i kommunkoncernen Stockholm stad som beställer varor och tjänster. När ett avtal är anslutet till e-handel får leverantören elektroniska ordrar. Dessa ordrar är godkända av en behörig beställare i kommunkoncernen Stockholms stad. Detta dokument innehåller beskrivning av enkel e-handel med kommunkoncernen Stockholms stad samt faktureringsrutiner. 1 Enkel e-handel Metoden enkel e-handel innebär att leverantören ska; a) kunna ta emot ordrar i pdf-format som skickas från inköpssystemet via e-post till leverantören. b) skicka orderbekräftelse via e-post till beställaren. c) skicka fakturor till stadens förvaltningar eller bolag antingen som Svefaktura ver 1.0 (XML-format) eller genom att skicka en pappersfaktura till koncernens skanningleverantör (via brev eller e- post). Samtliga krav på fakturering framgår i avsnitt 3 nedan. 2 Handla via leverantörs webbutik Kommunkoncernen Stockholms stad har stöd för två metoder/standarder för att integrerat ansluta sig till en leverantörs webbutik: 3 (14)

SID 4 (14) 1) Handla via leverantörs webbutik (Punch-out) enligt OCI version: 4.0 (3.0) 2) Handla via leverantörs webbutik enligt SFTI Varukorg, scenario 6.5.3, version: 2.8 Kommunkoncernen Stockholms stad har stöd enligt ovan för att integrera mot leverantörers webbutik där användaren hämtar hem sin varukorg från webbutiken till kommunkoncernens ekonomisystem, där beställningen slutförs. Order kan skickas från oss som pdf- order, SFTI ORDERS-fil version 6.1.3 eller Sveorder-fil version 2.0. Fakturor kan tas emot i formatet Fulltextfaktura version 2.30 alternativt SFTI Svefaktura 1.0 utökad version (se avsnitt 3.2 Svefaktura). Ordersvar kan skickas som e-post eller som SFTI 6.1.4/ SFTI 6.1.5 ORDRSP/ SFTI 3.3.2 DESADV-filer. Elektroniska affärsmeddelanden skickas till vår VAN-tjänst. För tillfället är aktuell VAN-tjänst Tieto Sweden AB. För att kunna e- handla med stadens förvaltningar/bolag krävs att leverantörens VAN-tjänst/växel har ett samtrafikavtal med vår VAN-tjänst. Tester Leverantören ska vid anslutning till e-handel via metoden Handla via leverantörs webbutik medverka i ett gemensamt testarbete. Testerna ska verifiera att: Kopplingen mellan leverantörens webbutik och koncernens ekonomisystem fungerar. Webbutik innehåller korrekta/avtalade artiklar/tjänster enligt avtal. Leverantör säkerställer att ordern innehåller korrekt och tydlig information. Flödet av elektroniska meddelanden såsom order, ordersvar och faktura via aktuella VAN-operatörer fungerar korrekt. Fakturainnehållet är korrekt och matchar ordern. När testerna är godkända tecknas en separat överenskommelse med hänvisning till Nea-avtalet. Detta är ett så kallat E- kommunikationsavtal, som blir ett tillägg till förevarande avtal mellan parterna.

SID 5 (14) Krav på leverantörs webbutik vid anslutning till e-handel Webbutiken ska vara avgränsad i enlighet med avtal och enbart innehålla artiklar/ tjänster som omfattas av förevarande avtal. Leverantör ska tillhandahålla länk till webbutik. Leverantör ska tillhandahålla inloggningsuppgifter till webbutik. Det bör vara möjligt att logga in i leverantörs webbutik med så kallad single sign on dvs ett gemensamt användarid och inloggningslösenord för att komma in i webbutiken. I webbutiken ska priset per artikel/tjänst, för artikel som läggs i varukorg, vara avtalat nettopris per artikel exklusive moms. Varukorgen som skickas till koncernens inköpssystem ska innehålla UNSPSC-kod per artikel/ tjänst. Teknisk information OCI 4.0 (3.0) Agresso E-handel stödjer PunchOut enligt SAP OCI i HTMLformat, både vad gäller inloggning, kommunikation och varukorg. Inloggning (PunchOut) på leverantörens webbshop och kommunikation sker via en fast URL. Inloggningsinformationen (login/lösen mm) skickas med querystring (POST och GET). Informationen nedan är de som normalt skickas med i inloggningsformuläret, men vid behov kan fler parametrar skickas med. Anslutning till leverantörens webbshop kräver internetanslutning för systemkontot som kör Agressotjänsten, antingen via HTTP eller HTTPS. Eventuella brandväggsregler kan behöva ses över. För att förenkla administrationen används i regel ett gruppkonto per kund, men vid behov kan även enskilda och användarunika konton användas. USERNAME: Användarnamn hos mottagande webbshop PASSWORD: Lösenord hos mottagande webbshop LANGUAGE: Språkkod hos mottagande webbshop USER_ID: Användar-id hos mottagande webbshop HOOK_URL: Den URL (med sessionsid) dit varukorgen ska returneras Vid PostBack skickas varukorgen tillbaka via HTML till den URL som är angiven i parametern HOOK_URL. Följande uppgifter ska returneras tillbaka vid PostBack för att kunna ta emot och hantera 5 (14)

SID 6 (14) varukorgen i Agresso. Fler uppgifter kan skickas/tas emot, men kommer ej att hanteras av Agresso. NEW_ITEM-DESCRIPTION[n]: Artikelbeskrivning NEW_ITEM-QUANTITY[n]: Beställd kvantitet NEW_ITEM-UNIT[n]: Enhet NEW_ITEM-PRICE[n]: Enhetspris NEW_ITEM-PRICEUNIT[n]: Prisenhet NEW_ITEM-CURRENCY[n]: Valutakod NEW_ITEM-LONGTEXT_n:132: Artikeltext, längre beskrivning av konfiguration. NEW_ITEM-VENDORMAT[n]: Leverantörens artikelnummer NEW_ITEM-MATGROUP[n]: Produktklassificering (rekommenderat är UNSPSC-kod, UNSPSC-kod är också en förutsättning för mappning till UN-artiklar för bättre uppföljning och förkontering) NEW_ITEM-VENDOR[n]: Om produkten är köpt via en marknadsplats med fler leverantörer ska denna parameter innehålla leverantörsidentitet enligt kundens system. (Kan överstyras per leverantör med systemvärde från Agresso E-handel 2.4.4/3.01, se manualer.) NEW_ITEM-CONTRACT[n]: Avtal från leverantören (Gäller endast från Agresso E-handel 3.1) SESSIONID: Sessionsid från parametern HOOK_URL Om flera artiklar/orderrader förekommer i varukorgen upprepas ovan parametrar med nytt löpnummer inom hakparenteserna [n]. Teknisk information SFTI Varukorg. scenario 6.5.3 Specifika tekniska förutsättningar för SFTI Varukorg. scenario 6.5.3 version: 2.8: IP-adresser för punch-back mot produktionsmiljön: agressopunchback.stockholm.se - 217.21.237.150 IP-adresser för punch-back mot vår testmiljö: agressopunchbackint.stockholm.se - 217.21.237.174 Tekniskt krav för uppkoppling med Punch-out är kommunikationsprotokoll HTTPS TCP/443 med minst TLS 1.0

SID 7 (14) 3 Fakturering Kommunkoncernen Stockholms stad tar emot fakturor i Svefakturaeller pappersformat. Leverantör ska efter överenskommelse med staden/bolagen övergå till att skicka Svefakturor. Betalningsvillkor Fakturering ska ske månadsvis i efterskott och efter det att leveranser som omfattas av fakturan fullgjorts. Betalningstiden ska vara trettio (30) dagar från fakturadatum. Faktureringsavgifter eller liknande påslag ska inte utgå. Vid försenad betalning har Leverantören rätt att debitera dröjsmålsränta enligt räntelagen (1975:635). Vid eventuell räntefaktura ska fakturanummer för ursprungsfakturan finnas angiven. Betalningspåminnelser ska skickas digitalt om vi så önskar. Fakturor och bilagor som omfattas av sekretess ska kodas enligt särskild anvisning. Vid befrielse från moms ska hänvisning till relevant bestämmelse i momslag, momsdirektiv eller annan uppgift om att omsättningen är skattebefriad anges. Ovanstående uppgifter får inte finnas i färgade fält. Svefaktura Svefaktura version 1.0, utökad version, accepteras. Svefaktura skickas till vår VAN-tjänst. För tillfället är aktuell VAN-tjänst Tieto Sweden AB. För att kunna skicka elektroniska fakturor till oss krävs att leverantörens VAN-tjänst/växel har ett samtrafikavtal med vår VAN-tjänst. Endast en order per faktura får förekomma, ej samlingsfakturor. Delfakturering är godkänt. Vid behov får bilagor bifogas, godkända bildformat är PDF, TXT, JPEG, JPG, TIFF, GIF, PNG. 3.2.1 Adresseringsmöjligheter Svefaktura Det finns två olika möjligheter för Leverantörer att adressera elektroniska fakturor till kommunkoncernen Stockholms stad Leverantören väljer vilket av nedan alternativ de vill använda: Alternativ 1: Fakturan adresseras direkt till respektive förvaltning eller bolag, via aktuell GLN-kod för respektive förvaltning eller bolag. Förteckning över GLN-koder anges nedan. 7 (14)

SID 8 (14) Alternativ 2: Adress används för att adressera en grupp av bolag eller förvaltningar, det vill säga en e-fakturaadress används för att kuvertera fakturan till flera förvaltningar eller bolag, som en grupp. Oavsett alternativ så är det alltid förvaltningen eller bolagets GLNkod som används som köparens identitet i fakturan. 3.2.1.1 Adressering utan kuvert (Alternativ 1) Varje förvaltning och bolag inom kommunkoncernen har en unik GLN-kod för adressering av e-fakturor. Denna adress anges i den elektroniska fakturan för att kunna dirigera fakturan mellan e- fakturaväxlar och till aktuell förvaltning eller bolag. Leverantören ska därav meddela sin e-fakturaväxel respektive förvaltnings/bolags e-fakturaadress (GLN-kod). Observera att för alternativ 1 används inte Stadens eller bolagets organisationsnummer som adress på fakturan. 3.2.1.2 Adressering med kuvert (Alternativ 2) Om Leverantörens ekonomisystem stödjer adressering av elektroniska fakturor med kuvert där identiteten i fakturan kan skilja sig från den i kuvertet är detta alternativ att föredra. Fördelen med alternativ två är att Leverantörens e-fakturaväxel endast behöver känna till ett färre antal identiteter för oss, därmed förenklas konfigurationsarbete. Observera att detta enbart gäller e- fakturaväxeln, Behörig Beställares identitet ska alltid identifieras med en GLN-kod. Exempel på kuvert som vår e-fakturaväxel kan ta emot är: SBDH och SOAP i Svefakturan Om alternativ 2 adressering med hjälp av kuvert används ska organisationsnumret användas som mottagarens identitet i kuvertet. Vår e-fakturaväxel har operatörsadress TIETOSE. 3.2.2 Fakturareferenser Svefaktura För att den elektroniska fakturan ska matchas mot inköpsordern behöver korrekt information från inköpsordern ligga i rätt fält i Svefakturan. Leverantör som redan skickar Svefakturor till staden/bolagetmåste komplettera med ifyllt fält för inköpsordernummer.

SID 9 (14) Orderradnummer <cac:buyersline><cac:invoiceline><cac:orderlinereference> Orderreferens (=stadens ordernr, genereras i inköpssystemet, visas i pdf-ordern) <cac:buyersid><cac:invoiceline><cac:orderlinereference><cac: OrderReference> Artikelnummer <cac:id><cac:invoiceline><cac:item><cac:sellersitemidentificati on> Avtalsreferens (xxxxxxxxxxxx) <AdditionalDocumentReference><cac:IDidentificationSchemeID= CT identificationschemeagencyname= SFTI > Uppgifterna ovan framgår av förvaltningens/bolagets inköpsorder. Exempel på order finns i avsnitt 6, i bilagan är uppgifterna ovan inringade. 3.2.3 Krav på fakturainnehåll Svefaktura Krav på fakturainnehåll för Svefaktura framgår av annex 1 Fakturainnehåll Svefaktura. En Svefaktura ställd till kommunkoncernen Stockholms stad ska vara strukturerad i enlighet med annex 1 och ha det innehåll som framgår av annex 1. Samtliga fakturor som innehåller sekretesskänslig information ska kodas enligt särskild anvisning.. Alla belopp ska avrundas till två decimaler. Pappersfaktura 3.3.1 Fakturaadresser pappersfaktura För att fakturan ska kunna hanteras rationellt via skanning ska förvaltningskod/bolagskod anges i fakturaadressen. Fakturaadressen för pappersfaktura har för närvarande följande struktur: Förvaltning/Bolag Ref xxxxxxxxxxxxx Kund-ID STH fff 106 42 Stockholm 9 (14)

SID 10 (14) Ref: Beställarreferens används för att distribuera fakturan till korrekt mottagare i koncernens ekonomisystem. Referensen ska alltid uppges i samband med beställning av beställande enhet. Saknas aktuell referens finns det risk att fakturan betalas efter förfallodatum då det är omständigt att identifiera aktuell mottagare. STH: Den kod skanningoperatören eftersöker för att identifiera förvaltningens /bolagets tillhörighet. Förvaltningskod/bolagskod anges efter strängen STH, se avsnitt 5 för nu aktuella STH-koder. Exempel fakturaadress: Socialförvaltningen Ref INK3110000162 Kund-ID STH 113 106 42 Stockholm Säkerställ alltid att ni som leverantör har aktuella uppgifter avseende faktureringsdresser för förvaltningar och bolag i samband med att att avtal tecknats. Fakturor kan med fördel skickas via e-post: Till e-postadress: Sth0000@privatgirot.se Fakturaadress och fakturamärkning på fakturan ska vara densamma som för en pappersfaktura. Endast en faktura samt eventuella bilagor per e- postmeddelande kan mottas. Godkända bildformat är PDF, PNG och TIF. Information som lämnas i ämnesfält och meddelandefält kan inte beaktas. 3.3.2 Krav på fakturainnehåll pappersfaktura En pappersfaktura ställd till Stockholm stad ska innehålla följande: Allmänna fakturafält (obligatoriska) Leverantörens namn Leverantörens adress Leverantörens organisationsnummer Uppgift om att leverantören har F- skattebevis, ange Godkänd för F- skatt Leverantörens momsregistreringsnummer Beskrivning t

SID 11 (14) Leverantörens bankgiro/plusgironummer Köparens namn Bolag/förvaltningskod. Köparens/beställares namn Normalt förvaltningens eller bolagets namn. Exempelvis Stadsledningskontoret t om ordernummer inte finns. Exempelvis 110 Referens/Kostnadsställe Exempelvis KST 728 Övrig fakturareferens Avtalsnummer, diarienummer eller annan referens. Köparens adress Köparens faktureringsadress Er Kontakt Namn på er kontaktperson Vad varan/tjänsten avser Faktura ska specificera fakturerade varor/tjänster motsvarande sätt som framgår av beställningen och detaljeras så att utförda leveranser kan kontrolleras. När varan/tjänsten levererades Unikt fakturanummer Fakturanummer (debet) som krediteras Fakturadatum Betalningsvillkor och förfallodatum Fakturabelopp brutto Fakturabelopp netto Valuta Inköpsordernummer Avtalsnummer Momssats % Momsbelopp Företagets säte Det ska tydligt framgå när varan levererades eller för vilken tidsperiod fakturan avser. på debet- och kreditfaktura. Ska vara unikt. t på kreditfakturor Fakturabelopp inklusive moms Fakturabelopp exklusive moms Valutakod Om inköpsordernummer finns på beställningen ska den anges på fakturan och inleds med prefixet INK Om avtalsnummer finns på beställningen ska avtalsnummer anges på fakturan och inleds med prefixet AVT Kan utelämnas om postorten, i adressen, är densamma som företagets säte 4 Kundregister Leverantör ska upprätta och underhålla ett kundregister vilket garanterar korrekt hantering av referenser och fakturaadresser för distribution av fakturor till koncernens affärssystem. 11 (14)

SID 12 (14) 5 STH-koder och GLN för kommunkoncernen Namn på förvaltning STHkod/Förvaltn.ID GLN Finansförvaltning 101 7381031004834 Valnämnden 108 7381031004759 Stadsledningskontoret 110 7381031003233 Socialtjänstnämnden 113 7381031003547 Kulturnämnden 115 7381031003301 Stadsbyggnadsnämnden 116 7381031003134 Utbildningsnämnden 117 7381031003554 Stadsarkivet 120 7381031003103 Äldrenämnden 122 7381031007002 Överförmyndarnämnden 126 7381031004797 Revisorskollegiet 131 7381031004872 Idrottsnämnden 132 7381031004810 Kyrkogårdsnämnden 168 7381031003271 Miljö- och hälsoskyddsnämnden 169 7381031000003 Fastighetskontoret 177 7381031004629 Trafikkontoret 181 7381031004612 Exploateringskontoret 183 7381031006999 Servicenämnden 190 7381031007019 Arbetsmarknadsnämnden 191 7381031010118 Stadsdelsnämnd Rinkeby-Kista 701 7381031003318 Stadsdelsnämnd Spånga-Tensta 703 7381031003332 Stadsdelsnämnd Hässelby-Vällingby 704 7381031003349 Stadsdelsnämnd Bromma 706 7381031003363 Stadsdelsnämnd Kungsholmen 708 7381031003387 Stadsdelsnämnd Norrmalm 709 7381031003394 Stadsdelsnämnd Östermalm 710 7381031003400 Stadsdelsnämnd Södermalm 712 7381031003424 Stadsdelsnämnd Enskede-Årsta- Vantör 714 7381031003561 Stadsdelsnämnd Skarpnäck 715 7381031003448 Stadsdelsnämnd Farsta 718 7381031003479 Stadsdelsnämnd Älvsjö 721 7381031003509 Stadsdelsnämnd Hägersten- Liljeholmen 722 7381031003516 Stadsdelsnämnd Skärholmen 724 7381031003615

SID 13 (14) Bolagsnamn Organisationsnummer STH-kod/ bolag GLN-kod Stockholms Stadshus AB 5564151727 200 7381031022562 Stokab, AB 5564756467 212 7381031028663 Familjebostäder, AB 5560350067 213 7365560350068 Aktiebolaget Stockholmshem 5560359555 216 7365560359559 Svenska Bostäder, AB 5560436429 217 7365560436427 Invest Stockholm Business Region AB 5560831306 225 7381031028656 Stockholms Stads Parkerings AB 5560017153 228 Skolfastigheter i Stockholm AB, SISAB 5560348970 235 Stockholm Vatten AB 5562106855 248 7381031007125 Stockholm Globe Arena Fastigheter AB 5562064914 249 7381031022555 Stockholms Stadsteater AB 5560261553 251 Kapellskärs Hamn AB, tidigare Roslagshamnar AB 5561891010 277 7381031025891 Stockholms Hamn AB 5560081647 278 7381031025884 Bostadsförmedlingen i Stockholm AB 5560578303 291 7381031022579 S:t Erik Markutveckling AB 5560645813 292 7381031014161 Stockholm Vatten VA AB 5561751867 296 7381031007149 S:t Erik Försäkrings AB 5164017948 298 7381031022531 Fastighets AB Burspråket 5560215336 308 7365560215336 Stockholm Business Region AB 5564916798 361 7381031028632 Micasa Fastigheter i Stockholm AB 5565817870 362 7365565817870 Visit Stockholm AB 5560275736 367 7381031028649 Bostads AB Hammarbygård 5566644745 381 7365566644741 S:t Erik Livförsäkring AB 5164060427 385 7381031022548 AB Stockholmshem Fastighetsnät 5567155394 386 7365567155390 S:t Erik Kommunikation AB 5567389951 391 Hemmahamnen Kontor AB 5567362156 392 7381031016295 Stockholm Vatten Avfall AB 5569693087 470 7381031007132 13 (14)

6 Exempel pdf-order SID 14 (14)