Hoe is het XML orderdocument opgebouwd?#

Bij professional abonnementen wordt bij elke bestelling een XML attachment meegezonden met daarin alle ordergegevens. Ook is het mogelijk om vanuit orderbeheer bestellingen aan te vinken en direct te exporteren naar een XML document.
Met deze documenten kunnen ordergegevens eenvoudig worden overgedragen aan andere systemen.

! Gebruik altijd een XML parser om de gegevens uit het XML document te verwerken. Op deze wijze wordt voorkomen dat de verwerkende software aangepast moet worden als de representatie van de gegevens in het XML document aangepast wordt.

Definitie XML document#

Hieronder volgt een algemene beschrijving van versie 2.0 van het orderdocument. Vanaf oktober 2004 is dit de default versie. Per winkel kan de inhoud verschillen want via de mijnWinkel.nl editor kunnen nieuwe velden toegevoegd worden. Deze verschijnen ook in het XML document.

De XML documenten hebben de volgende algemene structuur:

<orders>
<mail>
<set id="session"/>
<set id="customer"/>
</mail>
</orders>

Per bestelling bevat het document twee sets met gegevens

  • set id="session" bevat de gegevens van de bestelling
  • set id="customer" bevat de klantgegevens (factuuradres en afleveradres)

Het XML document is gebaseerd op een DTD met de meta-definitie, welke is te vinden op de URL www.mijnwinkel.nl/DTD/orders_export_v2.dtd (voor de order export) en www.mijnwinkel.nl/DTD/order_v2.dtd (voor het attachment bij de bestelling). Een referentie naar de laatste versie zit altijd in het XML orderdocument.

Beschrijving set id="session"#

De set bevat de gegevens van de bestelling en begint met een aantal algemene gegevens (property id=xxxx). De belangrijkste zijn:

  • emailvendor (email winkelier)
  • emailvendor_reply (reply adres winkelier)
  • ordernumber (ordernummer)
  • shopnumber (klantnummer winkelier)

Daarna volgt een subset "order" met gegevens over de bestelling:

Daarna volgt een subset "order" met gegevens over de bestelling:

  • nrlines (aantal bestelregels)
  • paymentmethod (gekozen betaalmethode zoals zelf gedefinieerd)
  • totalUSA (totaalbedrag van de bestelling met decimale punt - standaard internationale notatie)
  • total (totaalbedrag van de bestelling met valutateken)
  • total_nr (totaalbedrag van de bestelling)
  • vat_price (BTW bedrag van de bestelling)

Per bestelregel een subset "article" met gegevens:

  • productlistnumber (volgnummer van de productlijst)
  • description (artikelomschrijving)
  • number (artikelnummer)
  • linetotal (totaalbedrag van de regel)
  • partner (emailadres van de affiliate)
  • price (prijs met valutateken)
  • pricevalue (prijs met decimale punt - standaard internationale notatie)
  • quantity (besteld aantal)
  • selection (productvariaties, bijv kleur=groen;maat=30)
  • vat (BTW bedrag)

Een subset "shipping" met gegevens over de verzending:

  • desc (extra tekst verzendmethode zoals zelf gedefinieerd)
  • id (interne nummer verzendmethode zoals zelf gedefinieerd)
  • price (verzendkosten met decimale punt - standaard internationale notatie)* title (naam verzendmethode zoals zelf gedefinieerd)

Na subset "order" volgt een subset "orderstatus" met gegevens over de status van de bestelling

  • date (datum: [dd/mm/yyyy])
  • date_time (datum/tijd in W3C formaat: [yyyy-mm-dd hh:mm:ss])
  • hostname (http://www.mijnwinkel.nl)
  • last_partial_payment_method (last partial payment method van de payment provider)
  • order_state (orderstatus: zie definitie velden)
  • payment_state (betaalstatus van de payment provider: started, considered_safe etc.: meer informatie)
  • quotation (offertevlag: 0=nee, 1=ja)
  • remoteaddress (IP adres klant)
  • time (tijd hh:mm:ss)
  • transaction_id (transactienummer payment provider)

Daarna volgt een subset "reduction" met gegevens over eventuele kortingen:

  • reduction (kortingsbedrag met decimale punt - standaard internationale notatie)
  • reduction_active (korting actief: true, false)
  • reduction_msg (kortingsboodschap)
!Beschrijving set id="customer"

De set bevat de klantgegevens en bevat een subset id="adr" waarbinnen weer twee subsets id="billing" en id="deliver". Daarin staan de gegevens van factuur- respectievelijk afleveradres.
Deze set bevat de zelf gedefinieerde gegevens uit het klantgegevensscherm.
De naam die in de editor aan het veld is toegewezen is terug te vinden in 'label'.

Overige informatie:

Mogelijke waarden van het veld order_state:

  • besteld
  • betaald
  • vervallen
  • in behandeling
  • bevestigd
  • uitgeleverd
  • gestorneerd
  • uitbetaald
  • offerte
  • voorlopig

Mogelijke waarden van het veld paymentmethod:

  • 1 - Default 1
  • 6 - Default 2
  • 7 - Default 3
  • 4 - Triple Deal
  • 8 - PayPal
  • 9 - iDEAL ING
  • 11 - iDEAL Rabo Proff.
  • 13 - Mollie
  • 14 - Ogone
  • 16 - ABN-AMRO
  • 17 - InternetKassa ABN-AMRO
  • 22 - MultiSafePay
  • 23 - DocData1 (ideal)
  • 24 - DocData2 (creditcard)
  • 25 - DocData3 (collect)
  • 26 - DocData4 (transfer)
  • 29 - Default 4
  • 30 - Default 5
  • 31 - Default 6*
  • 32 - Icepay (iDEAL)
  • 33 - Icepay (Fasterpay)
  • 34 - Icepay (Giropay)
  • 35 - Icepay (Safecharge)
  • 36 - Icepay (SMS)
  • 37 - Icepay (Wallie)
  • 38 - Icepay (Wire)
  • 39 - Icepay (Ddebit)
  • 40 - Icepay (CreditCard)
  • 41 - Icepay (Directbank)
  • 42 - Icepay (Phone)
  • 43 - Icepay*
  • 44 - Ogone iDEAL
  • 45 - Ogone CreditCard*
  • 46 - Sisow (iDEAL)*
  • 47 - No PSP message
  • 49 - Klarna
  • 50 - Buckaroo Giftcards
  • 51 - Ogone Paypal
  • 52 - Ogone Giropay
  • 53 - Ogone Transfer
  • 54 - Rabo Omnikassa
  • 55 - Rabo Omnikassa ideal
  • 56 - Rabo Omnikassa card
  • 57 - Rabo Omnikassa mintix
  • 58 - Rabo Omnikassa incasso
  • 59 - Rabo Omnikassa acceptgiro
  • 60 - Rabo Omnikassa rembours
  • 61 - Klarna Account 1
  • 62 - Klarna Account 2
  • 64 - Klarna Invoice 2
  • 67 - Buckaroo creditcard
  • 68 - Buckaroo ideal
  • 69 - Buckaroo collect
  • 70 - Buckaroo transfe
  • 71 - Buckaroo giropay
  • 72 - Buckaroo paypal
  • 73 - Buckaroo giftcards
  • 74 - Paypal Express Checkout
  • 75 - SISOW paypal
  • 76 - SISOW transfer
  • 77 - SISOW giftcard 1 (fijncadeau)
  • 78 - SISOW giftcard 2 (podium)
  • 79 - SISOW ebill
  • 80 - Buckaroo payment guarantee
  • 81 - SISOW esend
  • 82 - Multipaysafe ideal
  • 83 - Pay.nl
  • 84 - Pay.nl ideal
  • 85 - Pay.nl Credit card
  • 86 - Pay.nl Cash Ticket
  • 87 - Pay.nl Click and buy
  • 88 - Pay.nl direct ebanking
  • 89 - Pay.nl ebon
  • 90 - Pay.nl giro pay
  • 91- Pay.nl incasso
  • 92 - Pay.nl Maestro
  • 93 - Pay.nl Mistercash
  • 94 - Pay.nl Overboeking
  • 95 - Pay.nl Paypal
  • 96 - Pay.nl Paysafecard
  • 97 - Pay.nl Webshopgiftcard
  • 98 - Buckaroo Mistercash
  • 99 - Billink

Stel een vraag
Algemene Help
  1. Welkom bij mijnWinkel
  2. Trefwoorden
  3. Stappenplan
  4. Veelgestelde Vragen (FAQ)
  5. Handleidingen printen
  6. Abonnementen
    1. Affiliateshop
    2. Abonnementsvormen
    3. Abonnement beƫindigen
    4. Abonnement uitbreiden
    5. Betaaltermijnen & kortingen
    6. Betaaltermijnen en kortingen boven euro 150
    7. Basic webwinkel
    8. B2C
    9. Enterprise ordersysteem
    10. Internetkassa Professional
    11. Internetkassa Basic
    12. Light shop
    13. Offerteshop
    14. B2B/Ordersysteem vaste klanten
    15. Professional webwinkel-startup
    16. Professional webwinkel
  7. Betalen
    1. Achteraf betalen
    2. Advies betaalmethoden
    3. Afterpay
    4. Beschikbare betaalsystemen
    5. Billink
    6. Buckaroo
    7. Directe betaalmethoden
    8. Docdata Payments
    9. Electronische facturen rechtsgeldig?
    10. Internetkassa (ABN AMRO)
    11. Icepay
    12. iDEAL algemeen
    13. iDEAL ABN AMRO
    14. iDEAL ING bank
    15. iDEAL Rabo bank Professional
    16. iDEAL Mollie
    17. Klarna
    18. Multisafepay
    19. Multisafepay Connect
    20. Ogone
    21. Omnikassa Rabobank
    22. Pay.nl
    23. PayPal
    24. Paypal Checkout
    25. Postcode.nl
    26. Sisow
    27. Vemt
    28. Online betaalmethoden
  8. Ipad shop
    1. Ipad nieuw
    2. Ipad doorschakelen
    3. Ipad tekst
    4. Ipad links
    5. Ipad producten
  9. Iphone shop
    1. Iphone shop
  10. Mogelijkheden
    1. Betaalsystemen
    2. Internetkassa
    3. Koppeling met Exact
    4. Koppeling met EBoekhouden
    5. Koppeling met osFinancials
    6. Koppeling met SW Retail
    7. Koppeling met Snelstart
    8. Overzicht koppelingen via mijnWinkel
    9. Staffelkortingen
  11. Tips en Handigheidjes
    1. Acties
    2. BTW
    3. Javascript
  12. Vragen vooraf
    1. Algemene voorwaarden
    2. KvK inschrijving benodigd?
    3. Powered by mijnWinkel
    4. Wet verkoop op afstand
  13. Vragen over de techniek
    1. Besturingssystemen en browsers
    2. Techniek achter mijnWinkel
  14. Vragen over de lay-out
    1. Blokken links,midden,rechts
    2. Voorwaarden blokken
    3. Eigen layout productlijst
    4. Gebruik skin
    5. CSS editor
    6. Layout betaalmethode
    7. Release 3.5
    8. Eigen layout meerinfo
    9. Instellen Productlijst
    10. Instellen Meerinfo
  15. Vragen over afbeeldingen
    1. Beheer productplaatjes
    2. Verschillende afmeting
    3. Instellen Plaatjes
  16. Vragen over zoeken en navigatie
    1. Achterliggende zoektechniek
    2. globalsearch
    3. Meerdere menu\'s
    4. Menu en filter
    5. Rechtstreeks linken
    6. Selecties maken
    7. Uitgebreid zoeken
  17. Webwinkel opzetten
    1. AffiliateSellvia
    2. BTW verhoging
    3. B2B release3
    4. Centraal Boekenhuis
    5. Dropshipspecialist
    6. Dynamische tab menu
    7. Gerelateerd productlijst blok
    8. CSS
    9. Gerelateerd productlijst blok
    10. Ipadshop
    11. Lees meer blok
    12. Link en text grid
    13. Nummering productlijst pagina
    14. Meerinfovelden
    15. Navigatie menu
    16. Naviatie top/footer menu
    17. Aanvragen extra shop
    18. Online productmanagement
    19. Online toevoegen producten
    20. Opzetten productlijst in Excel
    21. Pakje gemak
    22. Productvariaties (maten en kleuren)
    23. Producten in meerdere categorieen
    24. Schaduwpagina's
    25. Opzet taalshops
    26. Instellen taalkolom
    27. Taalswitch
    28. Valuta
    29. Valuta childlijst
    30. Verzendmethoden
    31. Wizard
  18. Winkel optimaliseren
    1. 12Return
    2. 404
    3. Admarkt
    4. Advanced backoffice
    5. Affiliate4you
    6. Andere talen
    7. Backoffice connector
    8. Beslist.nl
    9. Bestelknop approval
    10. Beveiligd bestelprocess https
    11. Blog
    12. Broodkruimelpad
    13. BTW EU
    14. Cadeaubonnen
    15. Canonical url
    16. Ciao
    17. Daisycon
    18. DHL
    19. Donatie
    20. eWarehousing
    21. Facebookshop
    22. Fashionchick.nl
    23. Google AdWords
    24. Google Analytics
    25. Google check pagina
    26. Google check producten
    27. Google check sitemap
    28. Google check xml
    29. Google check 404
    30. Google shopping
    31. Google zoekmachine
    32. HTML sitemap
    33. Rich Snippet
    34. Keendelivery
    35. Kelkoo
    36. Keuze afleveradres
    37. Kieskeurig
    38. Koopkeus
    39. Koopzeker
    40. Kortingscodes
    41. Laposta
    42. Mailchimp
    43. Marktplaats
    44. Mopinion
    45. Myaccount
    46. Optimalisatie meerinfo scherm
    47. Q-Invoice
    48. Redirects
    49. Remarketing tag Google
    50. Reviewmeter
    51. Robots.txt
    52. RSSFeed
    53. Beveiliging
    54. Schone url
    55. Sendcloud
    56. Social media blok
    57. Sitemaps
    58. Statistieken webwinkel
    59. Subpagina's
    60. Tradetracker
    61. Twenga
    62. Twitter
    63. UDesk
    64. Automatisch aanmaken pages
    65. URL opties
    66. Userlike
    67. Vakantiepunten
    68. Vergelijk.nl
    69. Verticale slider
    70. Volgorde bestellingen
    71. Webwinkelkeur
    72. Sortering bestellingen
    73. Zoekoptimalisatie via Google
Eigen layout (technisch)
Handleidingen
Nieuwsbrieven