Marti Orbak Software

Hieronder vindt u de generieke order import definitie van Bake-it zonder Id's.

Om deze functionaliteit te kunnen gebruiken heeft u de module Shop-it nodig in uw licentie.

De import gaat ervan uit dat er per order een XML wordt aangeboden.

Daarnaast dient er een FTP server ingericht worden waar we de orders kunnen downloaden.

De import heeft betrekking op dit menu uit Bake-it:

De voorbeeldbestanden kunt u onderaan dit document downloaden.

XML definitie:

<?xml version="1.0" encoding="iso-8859-1"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="XML_ORDER">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="order">
          <xs:complexType>
            <xs:sequence>
              <xs:element name="ordernr" type="xs:unsignedInt" />
              <xs:element name="locatienr" type="xs:unsignedByte" />
              <xs:element name="naam" type="xs:string" />
              <xs:element name="nummer" type="xs:unsignedInt" />
              <xs:element name="leverdatum" type="xs:string" />
              <xs:element name="leveringswijze" type="xs:unsignedByte" />
              <xs:element name="tijdvanaf" type="xs:decimal" />
              <xs:element name="tijdtot" type="xs:decimal" />
              <xs:element name="adres" type="xs:string" />
              <xs:element name="postcode" type="xs:string" />
              <xs:element name="plaats" type="xs:string" />
              <xs:element name="email" type="xs:string" />
              <xs:element name="tel" type="xs:string" />
              <xs:element name="betaalwijze" type="xs:string" />
              <xs:element name="bedragbetaald" type="xs:decimal" />
              <xs:element name="opm" type="xs:string" />
              <xs:element name="regels">
                <xs:complexType>
                  <xs:sequence>
                    <xs:element maxOccurs="unbounded" name="regel">
                      <xs:complexType>
                        <xs:sequence>
                          <xs:element name="artnr" type="xs:decimal" />
                          <xs:element name="artnaam" type="xs:string" />
                          <xs:element name="aantal" type="xs:unsignedByte" />
                          <xs:element minOccurs="0" name="teksten">
                            <xs:complexType>
                              <xs:sequence>
                                <xs:element name="tekst">
                                  <xs:complexType>
                                    <xs:sequence>
                                      <xs:element name="aantal_tekst" type="xs:unsignedByte" />
                                      <xs:element name="toeslag" type="xs:decimal" />
                                      <xs:element name="notitie" type="xs:string" />
                                    </xs:sequence>
                                  </xs:complexType>
                                </xs:element>
                              </xs:sequence>
                            </xs:complexType>
                          </xs:element>
                        </xs:sequence>
                      </xs:complexType>
                    </xs:element>
                  </xs:sequence>
                </xs:complexType>
              </xs:element>
            </xs:sequence>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType>
  </xs:element>
</xs:schema>

Uitleg per sectie:

Order element:

OrderRegel element:

Extra omschrijvingen element:

Extra omschrijvingen zijn optioneel, echter wanneer er gebruik van gemaakt wordt zijn de 3 subelementen verplicht.

Voorbeeld XML:

<?xml version="1.0" encoding="iso-8859-1" standalone="yes"?>
<XML_ORDER>
  <order>
    <ordernr>910027666</ordernr>
    <locatienr>10</locatienr>
    <naam> Johan de Haan</naam>
    <nummer>123456789</nummer>
    <leverdatum>30-04-2019</leverdatum>
    <leveringswijze>0</leveringswijze>
    <tijdvanaf>08.30</tijdvanaf>
    <tijdtot>17.30</tijdtot>
    <adres>Hollewateringen 3B</adres>
    <postcode>2628VS</postcode>
    <plaats>Kwintsheul</plaats>
    <email>helpdesk@marti-orbak.nl</email>
    <tel>0174-638690</tel>
    <betaalwijze>IDEAL</betaalwijze>
    <bedragbetaald>58.21</bedragbetaald>
    <opm>Opmerking: Graag Bij de buren afleveren indien meneer niet open doet.</opm>
    <regels>
      <regel>
        <artnr>1020.416</artnr>
        <artnaam>Slagroomtaart 16 personen</artnaam>
        <aantal>1</aantal>
        <teksten>
          <tekst>
            <aantal_tekst>1</aantal_tekst>
            <toeslag>5.95</toeslag>
            <notitie>Afbeelding (+ EUR 5.95) + tekst "Gefeliciteerd!"</notitie>
          </tekst>
        </teksten>
      </regel>
      <regel>
        <artnr>111800.000</artnr>
        <artnaam>Zacht Kaasbroodje</artnaam>
        <aantal>10</aantal>
      </regel>
      <regel>
        <artnr>59784</artnr>
        <artnaam>Witbrood gesneden</artnaam>
        <aantal>5</aantal>
      </regel>
    </regels>
  </order>
</XML_ORDER>

Alternatief bezorgadres

Indien de externe webshop alternatieve bezorgadressen ondersteunt, dan verwachten we dit bezorgadres in de tag 

<opm>Bezorgadres: Jacques Perkstraat 18 2274 GR - Voorburg, Nederland - Deze bestelling wordt verzonden als cadeau, - Opmerking: - Beste Mirjam, van harte gefeliciteerd van je legal collegas uit Rotterdam! Geniet ervan, De pizza (calzone) komt een andere keer nog wel :), Gr, Camilla, Pascal & Miriam </opm>

Het is belangrijk dat het alternatieve bezorgadres exact de opbouw heeft als de vetgedrukte tekst hierboven.

Nummer veld XML 

Het nummer veld betreft het afleveradresnummer. Tijdens de import wordt gecontroleerd of dit afleveradresnummer bestaat in Bake-it. Indien het nummer niet bestaat dan wordt er een nieuw afleveradres aangemaakt. Er wordt geen winkelklant aangemaakt, alleen een afleveradres!

Als het afleveradres wel bestaat, dan worden tijdens de import de NAW gegevens uit de XML overschreven in het afleveradres. Indien er aan het afleveradres reeds een winkelklant is gekoppeld, dan wordt die NAW gegevens ook bijgewerkt. 

Er is één speciaal klantnummer dat doorgeven kan worden en dat is WH0.

Als dit klantnummer wordt gebruikt dan worden de NAW gegevens als order notitie in de order opgeslagen.

Deze methode kan gebruikt worden als er geen Cash-it kassa's gekoppeld zijn aan Bake-it.

Zijn we wel Cash-it kassa's gekoppeld aan Bake-it dan is het advies om alle bestelling van webshop klanten zonder account een volgnummer te geven aan WH0. Bijvoorbeeld WH01000001, WH01000002, etc. 

Dan wordt er per order bij elke import een nieuwe klant (zonder webshop account) aangemaakt.

Deze afleveradressen kunnen eventueel op termijn na het archiveren van de database verwijderd worden.

Ordernummer veld XML

Wij adviseren om het ordernummer uit de XML aan te houden, zodat het ordernummer van de e-mail bevestiging naar de klant gelijk loopt in Bake-it. 

Zorg er wel voor dat deze range ver boven of onder de range van de ordernummers van Bake-it zit.

Letters met vreemde tekens (dyakrieten)

Vanaf Bake-it versie 5.02.020 worden tijdens de import van de XML de dyakrieten correct ingelezen in Bake-it.

Het gebruik van emoticons wordt niet ondersteund.