Deze tool stelt de gebruiker in staat om zelf te bepalen welke velden vanuit Softwear mee worden genomen in de export richting de webshop.

Inloggen


Ga naar www.softwear.nl/shopfeed/



De inlogcodes zijn reeds doorgegeven. Zo niet, dan kunnen deze worden aangevraagd via help@softwear.nl.

Zijn er meer API-koppelingen bij 1 Softwear-installatie aanwezig, dan kan een token uitgekozen worden om op in te loggen.



Na het kiezen verschijnt de aanwezige of de gekozen shopfeed. 


Onder Account staat het unieke token of UUID-code waarmee de data-uitwisseling mogelijk is.

Article feed


Bij Articlefeed  staat het pad waar iedere ochtend het csv-bestand kan worden gedownload, icm onderin de settings-/export-bestandsnaam.

De opbouw zal zo zijn:
http://www.softwear.nl/ism/ABCD-1234-ABCD-1234-ABCD/data.csv

Deze url kan in een browser geplakt worden, waarna een excel-document gedownload wordt, met daarin alle artikelen die in de shop mogen komen.

Vervolgens verschijnen alle mogelijke velden die geëxporteerd kunnen worden. Graag niet alles selecteren maar in overleg bepalen welke velden gebruikt gaan worden.
Let op: Hoe meer velden er worden geselecteerd, des te later het bestand klaar staat voor import!

Voorbeelden:

  • Seizoen: neem het seizoen uit Softwear mee, om hier een filter op te maken in de webshop
  • Omschrijving: gebruik de omschrijving in Softwear ook in de webshop.
  • Afgedrukt: alleen artikelen waarvan een barcode is geprint, worden naar de webshop doorgezet.

Tabelkolommen

Kolom 1: Sel: Selectiemogelijkheid per veld
Kolom 2: Title: Naam veld
Kolom 3: Content: Interne veldnaam
Kolom 4: DF: datafeedtype
T = vrij tekstveld, is te bewerken
E = expressieveld, vast veld. Speciale wens in overleg met Softwear te bepalen
F = standaardveld uit de database
O = omzetgroep, specifieke kenmerken van een bepaald artikel
Kolom 5: Type: Veldsoort is niet echt van belang. Bij een N staan 2 getallen tussen haakjes (). Het cijfer voor de komma geeft de veldlengte weer, het cijfer na de komma het aantal decimalen.
Kolom 6: Order: Hier kan de volgorde bepaald worden van de weergegeven kolommen binnen de shopfeed. Een regel kan gesleept en verplaatst worden.

Rode menu-items

Add free text: vrijetekstveldregel toevoegen
Add expression: expressieregel toevoegen (in overleg met Softwear)
Delete row: regel verwijderen (werkt bij alle regels)
Restore: wijzigingen ongedaan maken
Save: wijzigingen opslaan
Create feed: aanmaken van een csv-bestand
Logout: uitloggen

Filter condition article groups

Hier kan een filter worden gezet op het artikelbestand. Dit betreft de zogenaamde omzetgroepen in Softwear.
Graag in overleg met Softwear.
Field: keuze uit Type, Naam en Waarde
Operand: keuze uit
Value: de waarde die gebruikt wordt
Filter condition: het opgebouwde filter
Add filter cond.: De filterconditie toevoegen

Voorbeeld filter:

naam = 'webshop' and waarde='ja' : Alle artikelen die bij omzetgroep "webshop" de waarde "ja" hebben, worden in het bestand gezet.

((naam = 'webshop'  AND waarde = 'ja') OR (naam = 'bol' AND waarde = 'ja') ) : Alle artikelen die bij omzetgroep "webshop" of omzetgroep "bol" de waarde "ja" hebben, worden in het bestand gezet.

Settings

Export file name: naam artikelbestand. Standaard is het data.csv
Field delimiter: scheidingsteken in het csv-bestand
Quoted ("): moeten de velden tussen quotes staan?
End with newline: na de laatste regel een harde enter?
Only stock items: alleen artikelen gaan mee waar voorraad van is
Sellable articles: voor groothandels, is het artikel verkoopbaar?
Sellable colors: voor groothandels, is de kleur verkoopbaar?
Exclude articles: artikelen zonder barcode worden niet meegenomen in het bestand
Valuta feed: voor groothandels als er verschillende prijzen gehanteerd worden
Export file name: bestandsnaam. Standaard is het val.csv

Customer feed


De customer feed geeft een export van het klanten/debiteurenbestand. Werkt op dezelfde wijze als de article feed.
Indien er geen data verschijnt, is de customer feed niet aangemaakt. Graag in overleg met Softwear.

 

Settings

Export file name: naam klantenbestand. Standaard is het cust.csv

Field delimiter: scheidingsteken in csv-bestand

Quoted ("): moeten de velden tussen quotes staan? 

End with newline: na de laatste regel wordt een "harde enter" geplaatst

Group email addr: groepeer alle e-mailadressen (klanten zonder/ met hetzelfde e-mailadres worden samengevoegd tot 1 klant)

No blocked cust.: sluit de geblokkeerde klanten uit

E-mail bij afronden maak artikelbestand

Het is mogelijk een e-mailbericht te ontvangen wanneer het artikelbestand succesvol is aangemaakt.
Als dat bericht is ontvangen, is het artikelbestand vernieuwd en kan eventueel de webbouwer geïnformeerd worden het bestand opnieuw in te lezen.
Met name in het begin van het instellen van de koppeling kan het raadzaam zijn het e-mailadres van de webbouwer te gebruiken, zodat hij/zij de wijzigingen goed kan monitoren.

Hoe instellen?

  • Log in op Softwear
  • Ga naar menu Beheer - Gebruikers (voor groothandel) of menu Systeem - Gebruikers (voor detailhandel)
  • zoek de gebruiker FUSER
  • Vul daar een geldig e-mailadres
  • Sla de gebruikerskaart op.

Voortaan bij het handmatig vernieuwen van het artikelbestand (of klantenbestand) zal het ingevoerde e-mailadres een bevestiging krijgen van het feit dat het nieuwe bestand gemaakt is.

 

vanaf 2017: Als er niks te exporteren valt, omdat het bestand leeg zou zijn, blijft het vorige/oude bestand bestaan en wordt dan niet overschreven door het lege bestand.

 

Meer over de shopfeed (voor systeembeheerders/ webmasters):

Softwear Web-API

This tool enables the user to manage which data from Softwear should go in the article/ customer feed for the webshop, and in which order.

Sign in


Go to www.softwear.nl/shopfeed/



The credentials were mailed during the set-up of the connection between Softwear and the webshop. Lost the credentials or want your webshop connected to Softwear? Mail help@softwear.nl

If more than 1 API-connections are available, a list will appear. Choose the token of the API that needs editing/ viewing.
Click "Verder" (means "next").


After choosing the token and logging in, the shopfeed will appear.


At Account is the unique token or UUID which makes data exchange possible.

Article feed


Tab Articlefeed  gives the location of the csv-document. Combine that with the name of the data file and the location is complete.

The construction is like this:
http://www.softwear.nl/ism/ABCD-1234-ABCD-1234-ABCD/data.csv

This url can be pasted in a browser, which results in an Excel document, containing all articles for the webshop.

Then all possible data for the article feed (export) are shown.
Please consult the webbuilder when changing the order of the colums or adding/ removing items.


Pay attention: More info in the article feed means slower import in the webshop.

Examples:

  • Seizoen / Season: takes the season from Softwear, which can be used for filtering the article feed
  • Omschrijving / Description: use the article description from Softwear in the webshop
  • Afgedrukt / Printed: only articles with printed barcodes will be available for the webshop

Table columns

Column 1: Sel: selection of items for the article feed
Column2: Title: title column
Column3: Content: Internal name
Column4: DF: datafeed type
T = free text, editable
E = expression field. Custom data; consult Softwear when wishing to use this
F = standard field from the database
O = omzetgroep (=sales group), specific features of a specific article
Column5: Type: field sort. Not important
Column6: Order: Determine the order of the colums of the article field. A marked line can be dragged and dropped

Red menu items

Add free text: add a column with free text
Add expression: only after consulting Softwear
Delete row: beware: gone=really gone
Restore: undo changes
Save: save changes
Create feed: creating the csv-file
Logout: sign off

Filter condition article groups

The article feed can be filtered, so not all articles from Softwear are enclosed. It can be filtered by the "omzetgroepen" / sales groups from Softwear.
Not sure? Please consult with Softwear.
Field: choose from Type, Name and Value
Operand: choose from
Value
Filter condition
Add filter cond.

Settings

Export file name: Standard is data.csv
Field delimiter: Standard is ";"
Quoted ("): Should all fields be quoted?
End with newline: A hard enter after the last line?
Only stock items: no stock? no article
Sellable articles: for wholesale, is the article for sale?
Sellable colors: for wholsale, is the color saleable?
Exclude articles: no barcode? no article
Valuta feed: for wholesale with more than one currancy
Export file name: Standaard for the currency file is val.csv

Customer feed


The customer feed contains all customers / debtors. Similar to article feed
No data visible? Maybe the customer feed has not been created yet. Please consult with help@softwear.nl

Settings

Export file name: Standard is cust.csv

Field delimiter: Standard is ";"

Quoted ("): Should all fields be quoted?

End with newline: A hard enter after the last line?

Group email addr: group all email addresses (customers with the same email address will be merged)

No blocked cust.: exclude blocked customers

Email completing article feed

It's possible to get an email when the article feed has successfully been created.
How?

  • Log in at Softwear
  • Go to menu Manage - Users (wholesale) of menu System - Users (retail)
  • Seach for user FUSER
  • Fill in a valid email address
  • Save the user

From now on when creating an article feed / customer feed manually, the entered email address will get an email with the message that the file has been created.

 

new in 2017: When there is nothing to export, because the file would be empty, the old file will stay intact. The new fle will not overwrite the old file.

 

More about the shopfeed (for system administrators / webmasters):

Softwear Web-API