Binnen CCV Shop heb je veel mogelijkheden tot het exporteren van gegevens. Je kunt orders exporteren om deze bijvoorbeeld in een extern programma in te laden. Ook kun je de export zelf gebruiken om in Excel een administratie bij te houden. We bieden ook de mogelijkheid om producten te exporteren. Dit is bijvoorbeeld nodig om een koppeling te leggen met vergelijkingssites. Binnen dit artikel leggen we uit hoe je te werk gaat en hoe je dit ook zo veilig mogelijk kunt doen.
Beveiliging instellen
Je kunt een beveiliging inschakelen voor de export van order/producten. Dat kan hier: Startpunt > Mijn webshop > Algemeen > Beveiliging externe toegang
Wanneer je geen beveiliging instelt dan zijn al jouw exports van producten/orders beschikbaar voor derden. Hiervoor hebben ze uiteraard wel de juiste URL nodig. Wanneer je de beveiliging inschakelt dan kun je een gebruikersnaam en wachtwoord er in plaatsen. Deze is dan nodig voor het ophalen van de export feed. Je vinkt vervolgens aan waarvoor deze geldt. Mocht je bijvoorbeeld “Orders’ niet aanvinken dan zal deze feed niet beschikbaar zijn voor derden.
Export Orders
Het exporteren van orders kan op deze plek:
Startpunt > Mijn klanten > Exporteer Orders
variabelen
|
Veld |
Verplicht |
Type |
Omschrijving |
|
User |
Ja |
string |
Gebruikersnaam. |
|
Pass |
Ja |
string |
Wachtwoord.
|
|
Type |
Ja |
|
Type export |
|
Begin |
Ja |
ddmmyyyy |
Begindatum (voorbeeld: 01022010 voor 1 februari 2010) |
|
End |
Ja |
ddmmyyyy |
Einddatum (voorbeeld: 28022010 voor 28 februari 2010) |
|
Status |
Ja |
Zie Fout! Verwijzingsbron niet gevonden. |
Alleen orders met specifieke status, of alle orders. |
Type
Hieronder de mogelijke waarden voor het veld ‘Type’. Andere waarden zullen worden genegeerd.
|
Naam |
Waarde |
Omschrijving |
|
XML |
xml |
Export naar XML formaat |
|
CSV |
csv |
Export naar CSV formaat (gescheiden door een tab) |
|
DYMO Labelwriter |
dymo |
Export naar de DYMO-software |
|
DPD DELISprint |
dpd |
Export welke te importeren is in DELISprint van DPD |
Orderstatussen
Hieronder de mogelijke waarden voor het veld ‘Status’. Andere waarden zullen worden genegeerd.
|
Waarde |
Omschrijving |
|
all |
Alle statussen |
|
1 |
Nieuw |
|
2 |
In behandeling |
|
3 |
Wacht op fabrikant |
|
4 |
Wacht op betaling |
|
5 |
Verzonden |
|
6 |
Geleverd |
|
7 |
Afgerond |
|
8 |
Geannuleerd |
Voorbeelden
Vul in plaats van ‘uwdomein.nl’ jouw eigen hoofddomein in. Zie
‘Startpunt > Mijn webshop > Instellingen > Algemeen > Website gegevens > Domeinen’
Gebruikersnaam: demo
Wachtwoord: 1234
Type: CSV
Begindatum: 1 augustus 2010
Einddatum: 1 september 2010
Status: Alle statussen
http://uwdomein.nl/ExportBestanden/ExportOrder.php?User=demo&Pass=1234&Type=csv&Begin=01082010&End=01092010&Status=all
URL export producten Backup
Je kunt jouw producten exporteren via een URL. Wanneer je toegang hebt ingeschakeld (zie hoofdstuk “Beveiliging instellen”) zijn jouw producten opvraagbaar via:
http://uwdomein.nl/ExportBestanden/Export.php?Type=backup&User=xxx&Pass=xxx
variabelen
De URL bevat enkele variabelen welke verplicht zijn. Hieronder zijn de variabelen uitgelegd.
Zie hoofdstuk Fout! Verwijzingsbron niet gevonden. voor voorbeelden.
|
Veld |
Verplicht |
Type |
Omschrijving |
|
User |
Ja |
string |
Gebruikersnaam. Zie Fout! Verwijzingsbron niet gevonden. |
|
Pass |
Ja |
string |
Wachtwoord. Zie Fout! Verwijzingsbron niet gevonden. |
|
Type |
Ja |
Zie Fout! Verwijzingsbron niet gevonden. |
Type export |
Type
Hieronder de mogelijke waarden voor het veld ‘Type’ met betrekking tot het maken van een backup van de producten. Bij andere gekozen types is het mogelijk om feeds te krijgen voor vergelijkingssites en affiliates. Zie Hoofdstuk Fout! Verwijzingsbron niet gevonden. Fout! Verwijzingsbron niet gevonden. voor meer informatie hierover.
|
Naam |
Waarde |
Omschrijving |
|
Backup |
Backup |
Backup van producten in CSV formaat (gescheiden door een tab) |
Voorbeeld
Vul in plaats van ‘uwdomein.nl’ jouw eigen hoofddomein in. Zie ‘Startpunt > Mijn webshop > Instellingen > Algemeen > Website gegevens > Domeinen’ voor jouw domein.
Gebruikersnaam: demo
Wachtwoord: 1234
http://uwdomein.nl/ExportBestanden/Export.php?Type=backup&User=demo&Pass=1234
URL voor vergelijkingssites en affiliates
Wanneer je de beveiliging hebt ingeschakeld zijn standaard alle gegevens niet beschikbaar voor derden. Ook niet voor vergelijkingssites of affiliate partijen. Bij “Beveiliging extern toegang” zoals uitgelegd in hoofdstuk “Beveiliging instellen” kun je bepalen welke productfeed ingeschakeld dient te worden. Zie Figuur 2 voor een voorbeeld.
Uitgevinkte productfeeds zullen niet beschikbaar zijn voor de buitenwereld. Als je je aanmeld bij een van de onderstaande vergelijkingssites of affiliate partijen, dien je de bijbehorende productfeed ook hier aan te vinken.
Zie 'Startpunt > Mijn webshop > Vergelijkingssites' voor de exacte links naar deze product feeds.
Foutmeldingen
Wanneer je een foutmelding tegenkomt bij het exporteren dan wordt er een Error nummer weergegeven. Hieronder vind je de lijst met foutmeldingen.
|
Error |
Naam |
Omschrijving |
|
1001 |
Geen type |
Je heeft geen type meegegeven in de URL. Zie |
|
1002 |
Geen correct type |
Het type dat je heeft meegegeven is niet correct. |
|
1011 |
Geen gebruiker of wachtwoord |
Je heeft geen gebruikersnaam en/of wachtwoord opgegeven in de instellingen. Deze zijn verplicht als u toegang wilt verlenen tot deze gegevens. |
|
1012 |
Gebruiker of wachtwoord ongelijk |
De opgegeven gebruikersnaam en/of wachtwoord komen niet overeen met de instellingen. Controleer deze op juistheid. Let op! dit is hoofdletter gevoelig. |
|
1031 |
Geen extern toegang |
Je heeft het externe toegang tot jouw orders uit staan. U dient dit expliciet aan te zetten. |
|
1041 |
Geen juiste data ingevuld |
De ingevuld begin en/of einddatum is niet correct. |
|
2001 |
Geen type |
Je heeft geen type meegegeven in de URL. Zie: |
|
2002 |
Geen correct type |
Het type dat u heeft meegegeven is niet correct. |
|
2011 |
Geen gebruiker of wachtwoord |
Je heeft geen gebruikersnaam en/of wachtwoord opgegeven in de instellingen. Deze zijn verplicht als je toegang wilt verlenen tot deze gegevens. |
|
2012 |
Gebruiker of wachtwoord ongelijk |
De opgegeven gebruikersnaam en/of wachtwoord komen niet overeen met de instellingen. Controleer deze op juistheid. Let op: dit is hoofdletter gevoelig. |
|
2031 |
Geen extern toegang |
Je heeft het externe toegang tot jouw producten uit staan. Je dient dit expliciet aan te zetten.
|
Uitleg order export XML
Om de online webwinkel samen te laten werken met externe programma’s zijn er twee algemene exporteer mogelijkheden. Deze mogelijkheden verschillen in de indeling van het exportbestand. De ene mogelijkheid is via Comma Seperated Values, ook wel een CSV-bestand. In deze handleiding wordt de andere taal, de Extensible Markup Language, behandeld. Deze is beter bekend als een XML-bestand. Dit bestand bestaat uit een platte tekst, welke de opbouw heeft als een boom. De verschillende takken welke informatie bevatten worden aangegeven met een eigen naam binnen twee haken. Een klein voorbeeld van zo’n boom volgt hieronder:
<boom>
<tak>
<subtak1>Informatie</subtak1>
<subtak2>Informatie</subtak2>
</tak>
<tak>
<subtak1>Informatie</subtak1>
<subtak2>Informatie</subtak2>
</tak>
</boom>
Door middel van deze structuur kunnen zowel mensen als machines deze bestanden begrijpen. De XML takken worden ook wel XML Tags genoemd. Voor het exporteren van orders van jouw webwinkel wordt er gebruik gemaakt van de XML Tags zoals beschreven in de volgende tabel.
|
XML Tag |
Type |
Beschrijving |
|
<orders> |
|
De algehele basis-tak welke begin en einde van de xml aangeeft |
|
<order> |
|
Geeft aan waar een order begint en eindigt. |
|
<orderno> |
int(11) |
Het ordernummer of factuurnummer |
|
<createdate> |
datetime |
De datum waarop de order aangemaakt is |
|
<statusid> |
int(11) |
Het ID van de status van de order |
|
<statusname> |
|
De beschrijving van de statusid |
|
<invoicetext> |
text |
De tekst die op de factuur komt te staan |
|
<totalpriceinctax> |
float(10,2) |
Totale orderprijs inclusief belasting |
|
<totalpriceextax> |
float(10,2) |
Totale orderprijs exclusives belasting |
|
<customextracosts> |
float(10,2) |
Extra kosten die achteraf toegevoegd kunnen worden |
|
<customextracostsdesc> |
varchar(100) |
Beschrijving van de extra kosten |
|
<ispaid> |
enum('n','y') |
Of de order betaald is of niet |
|
<withtax> |
enum('y','n') |
Of er belasting op de order zit of niet |
|
<totaltax> |
float(10,2) |
De totale belasting die betaald dient te worden |
|
<tax0> |
float(10,2) |
De belasting die betaald dient te worden in deze belastingcategorie |
|
<tax1> |
float(10,2) |
De belasting die betaald dient te worden in deze belastingcategorie |
|
<tax6> |
float(10,2) |
De belasting die betaald dient te worden in deze belastingcategorie |
|
<tax7> |
float(10,2) |
De belasting die betaald dient te worden in deze belastingcategorie |
|
<tax12> |
float(10,2) |
De belasting die betaald dient te worden in deze belastingcategorie |
|
<tax19> |
float(10,2) |
De belasting die betaald dient te worden in deze belastingcategorie |
|
<tax21> |
float(10,2) |
De belasting die betaald dient te worden in deze belastingcategorie |
|
<tax25> |
float(10,2) |
De belasting die betaald dient te worden in deze belastingcategorie |
|
<currency> |
varchar(10) |
De valuta waarin gerekend wordt. De mogelijkheden die je terug kan krijgen zijn: €, £, $, SEK, RON of DKK |
|
<deliverycompany> |
varchar(100) |
Het leveringsbedrijf |
|
<deliverycomment> |
text |
Het commentaar voor het leveringsbedrijf |
|
<sentprice> |
float(10,2) |
De prijs voor het verzenden |
|
<remboursprice> |
float(10,2) |
De prijs voor de rembours |
|
<discountcouponcode> |
char(100) |
De kortingscode |
|
<paymethodname> |
|
De betalingsmethode |
|
<paymethodcustomlabel> |
char(50) |
De zelf toegewezen naam van een betalingsmethode |
|
<bankaccount> |
varchar(30) |
Het rekeningnummer |
|
<cardno> |
varchar(100) |
Het pasnummer van de rekening |
|
<bankname> |
varchar(100) |
De naam van de bank |
|
<iDEALorderno> |
bigint(21) |
Het ordernummer van de iDEAL bestelling |
|
<paymethodextraprice> |
float(10,2) |
De extra kosten voor de betaalmethode |
|
<firstname> |
varchar(50) |
Voornaam |
|
<name> |
varchar(50) |
Achternaam |
|
<birthdate> |
varchar(100) |
Geboortedatum van de gebruiker |
|
<birthtime> |
time |
Geboortetijd van de gebruiker |
|
<birthplace> |
varchar(100) |
Geboorteplaats van de gebruiker |
|
<comment> |
text |
Opmerking bij de gebruiker |
|
<address> |
varchar(100) |
Het adres van de gebruiker |
|
<street> |
varchar(100) |
De straatnaam van de gebruiker |
|
<streetnumber> |
varchar(10) |
het huisnummer van de gebruiker |
|
<streetsufix> |
varchar(10) |
De toevoeging aan het huisnummer |
|
<zipcode> |
varchar(10) |
De postcode van de gebruiker |
|
<city> |
varchar(80) |
De stad van de gebruiker |
|
<country> |
char(5) |
Het land van de gebruiker |
|
<telephone> |
varchar(20) |
Het telefoonnummer van de gebruiker |
|
<mailaddress> |
varchar(120) |
Het emailadres van de gebruiker |
|
<mailinglist> |
enum('y','n') |
Of de gebruiker lid is van de mailinglijst |
|
<delivername> |
varchar(50) |
De naam van de ontvanger |
|
<deliveraddress> |
varchar(100) |
Het adres van de ontvanger |
|
<deliverzipcode> |
varchar(10) |
De postcode van de ontvanger |
|
<delivercity> |
varchar(100) |
De stad van de ontvanger |
|
<delivercountry> |
char(3) |
Het land van de ontvanger |
|
<companyname> |
varchar(60) |
Bedrijfsnaam |
|
<vat> |
varchar(50) |
BTW-nummer |
|
<kvk> |
varchar(50) |
KVK-nummer |
|
<province> |
varchar(100) |
De provincie van de gebruiker |
|
<reference> |
varchar(100) |
De referentie die de klant kan meegeven |
|
<income> |
varchar(100) |
Het inkomen van de gebruiker |
|
<mobile> |
varchar(20) |
Het mobiele telefoonnummer van de gebruiker |
|
<branche> |
varchar(100) |
De branche van het bedrijf |
|
<website> |
varchar(100) |
De website van de gebruiker |
|
<clubname> |
varchar(100) |
Verenigingsnaam |
|
<clubcity> |
varchar(100) |
Stad van de vereniging |
|
<clubcomment> |
varchar(100) |
Opmerking bij de vereniging |
|
<gender> |
varchar(30) |
Het geslacht van de gebruiker |
|
<expo> |
varchar(100) |
Op welke beurs het bedrijf staat |
|
<boothnumber> |
varchar(100) |
Het standnummer van het bedrijf op de beurs |
|
<userid> |
int(11) |
Het ID van de gebruiker |
|
<totalweight> |
|
Het totale gewicht van de order |
|
<extrapaymentoption> |
char(40) |
Extra verzendopties |
|
<extrapaymentoptionprice> |
float(10,2) |
De prijs van de extra verzendopties |
|
<extrapaymentoptionnosentprice> |
enum('y','n') |
Of er verzendkosten worden berekend met de extra verzendoptie |
|
<extrapaymentoptionpayonpickup> |
enum('y','n') |
Of er betaald wordt bij levering |
|
<discountcoupondiscount> |
float(10,2) |
De korting van de kortingsbon |
|
<discountcoupontype> |
enum('price','procent') |
Het type korting |
|
<discountcouponfreeshippingcost> |
enum('y','n') |
Of de bon gratis verzendkosten geeft |
|
<discountcouponuseonetime> |
enum('y','n') |
Of de bon één keer te gebruiken is |
|
<discountcouponminimumprice> |
float(10,2) |
De minimumprijs alvorens de bon geldig is |
|
<discountcouponenddate> |
date |
De einddatum van de bon |
|
<findus> |
text |
Hoe de gebruiker je gevonden heeft |
|
<userlogindiscount> |
decimal(4,2) |
Hoeveel korting de gebruikersgroep geeft |
|
<orderrow> |
|
Een product die besteld is |
|
<rowprodno> |
|
Productnummer |
|
<rowprodname> |
|
Productnaam |
|
<count> |
|
Aantal van deze producten |
|
<pricepp> |
|
Prijs per stuk |
|
<discountpp> |
|
Korting per stuk |
|
<tax> |
|
belastingscategorie |
|
<piecename> |
|
Hoeveelheidstype |
|
<weightpp> |
|
Gewicht per stuk |
|
<packetname> |
|
Verpakking voor verzending |
|
<rowtotalprice> |
|
Totale prijs voor dit product (het aantal maal productprijs) |
|
<attribute> |
|
De attributen van een product |
|
<valuename> |
|
Waarde van het attribuut |
|
<optionname> |
|
Naam van het attribuut |
|
<price> |
|
Verschil in prijs van het attribuut |
|
<operator> |
|
Positief of negatief verschil van het attribuut |
Opmerkingen
0 opmerkingen
Artikel is gesloten voor opmerkingen.