Additionele informatie voor de XML import

In dit artikel

• Alle velden
• Kosten invoeren in de XML
• CDATA gebruiken
• In de XML startdata en rooster aanleveren
• In de XML trainers toevoegen aan trainingen
• In de XML PE punten toevoegen

Veldmapping

Hieronder vind je een overzicht van alle velden in de product.xsd met een nadere toelichting en voorbeelden. Deze velden zijn hier benoemd om het eenvoudiger leesbaar te maken. In Automatisch updaten van je aanbod met XML vind je de product.xsd. Hierin staat de technische opzet van de XML structuur beschreven, inclusief alle mogelijke data types/waarden.

Kijk ook naar ons xml voorbeeld om een beeld te krijgen hoe al deze data moet worden vormgegeven.

Kosten invoeren in XML

Cursusprijs

 <Price>

Dit veld kun je het totale verplichte kosten opgeven voor de opleiding. 

Het is ook mogelijk om de totale verplichte kosten te specificeren per kostenpost. Vul dan enkel het lesgeld in en vul de extra kosten in onder <AdditionalCosts>. Hieronder meer over het gebruik van verschillende kostenposten. 

<VatAmount>

Hier kunt je aangeven wat het BTW bedrag is voor de cursus. 

NB. Als je gratis opleidingen wil aanbieden op Springest, geef dan de waarde 0 mee voor 'price' veld in de XML. Voor in-company trainingen kun je het veld leeg laten. Om er voor te zorgen dat 'op aanvraag' wordt getoond geef dan de waarde 'true' mee voor 'price-agreement' veld in de XML. 

Cost types, taxes and calculations in the XML:

It is possible to state the costs per cost type. This can be useful for example when you have different vat percentages per cost type. 
If this is the case you can fill in the cost for the 'tuition fee' in <price> and for stating different cost types and matching VAT percentages you can use the node  <AdditionalCosts> stating each cost type and all values per <AdditionalCost>.

Our example: 
Let assume you have these values in the xml:

<Price>100</Price> 

<AdditionalCost>

<Type> lunch </Type><Price> 40</Price> <VatIncluded> no</VatIncluded><VatAmount> 3</VatAmount><Mandatory> no</Mandatory>

</AdditionalCost>

<AdditionalCost>

<Type>registration fee </Type> * 
<Price> 20</Price> 
<VatIncluded> no</VatIncluded>
<VatAmount> 5</VatAmount>
<Mandatory>no</Mandatory>

</AdditionalCost>

* see our xsd for possible values. Note that tuition fee is not included because we expect it to be(included) in the <price> tag, it is 100 in our example.

Calculating course price

Below a tabel with different price options:

Adding different cost types from Additional Costs:

The calculation follows the same method as for <price>. 

------------------------------------------------------------------------------------------------------------------

Calculation of the TOTAL price:

We will sum all mandatory costs and add to the total of the course price.

Additional information:

• Courses free of charge should have <price>0</price>
• For <producttype> in-company</producttype> there should not be a price. To make sure we don't show a price you can use the <PriceAgreement> true</PriceAgreement in the XML. We won't show any prices in that case.
• The <VATamount> for for In-company trainings is not relevant. Please leave empty.
• Optional costs are not shown until the actual booking is happening. On this booking screen we will give users the option to book any optional costs.

Aanleveren van startdata en rooster

Het komt vaak voor dat eenzelfde training meerdere startdata heeft. Aangezien de XML enkel unieke titels (unieke id's) mag bevatten, is het de bedoeling dat de verschillende data aan dezelfde training gekoppeld worden.

Hieronder zie je de structuur waar aangehouden moet worden, welke ook in het  xml voorbeeld te zien is

<Products>
  <Product>
    <ID>product-0001</ID>
    <StartingDatePlaces>
     <StartingDatePlace>
	<ID></ID>
       <Startdate>2014-08-24</Startdate>
       <Place>Amsterdam</Place>
       <StartdateIsMonthOnly>false</StartdateIsMonthOnly>
       <Enddate>2014-09-24</Enddate>
       <EnddateIsMonthOnly>false</EnddateIsMonthOnly>
       <StartGuaranteed>true</StartGuaranteed>
       <Schedule>
         <CourseDay>
           <ID>ROO16_0657</ID>
           <Date>2017-02-08</Date>
           <Name lang="nl"><![CDATA[ Dag 2 ASOI ]]></Name>
           <StartTime>09:00:00</StartTime>
           <EndTime>17:00:00</EndTime>
           <Place>UTRECHT</Place>
         </CourseDay>
       </Schedule>
     </StartingDatePlace>
     <StartingDatePlace>
	<ID></ID>
       <Startdate>2014-09-24</Startdate>
       <Place>Rotterdam</Place>
       <StartdateIsMonthOnly>false</StartdateIsMonthOnly>
       <Enddate>2014-10-24</Enddate>
       <EnddateIsMonthOnly>false</EnddateIsMonthOnly>
       <StartGuaranteed>false</StartGuaranteed>
       <Schedule>
         <CourseDay>
           <ID>ROO16_0657</ID>
           <Date>2017-02-08</Date>
           <Name lang="nl"><![CDATA[ Dag 2 ASOI ]]></Name>
           <StartTime>09:00:00</StartTime>
           <EndTime>17:00:00</EndTime>
           <Place>UTRECHT</Place>
         </CourseDay>
       </Schedule>
      </StartingDatePlace>
    </StartingDatePlaces>
 </Product>
</Products>
	

Trainers toevoegen aan trainingen

Je kunt gebruik maken van jouw XML-feed voor Springest, om ook automatisch (nieuwe) trainers te koppelen aan jouw aanbod op Springest. Je hoeft enkel de email van de trainer toe te voegen aan de XML. Zie hieronder het gedeelte wat aan de  XML-feed moet toegevoegd worden:

<Trainers>
        <Trainer>
        	<Email>trainer_name_a@springest.com</Email>
	</Trainer>
        <Trainer>
        	<Email>trainer_name_b@springest.com</Email>
	 </Trainer>
 </Trainers>
	

Mocht de email nog niet bekend zijn in ons systeem, dan wordt automatisch een uitnodiging gestuurd naar de betreffende persoon om een trainer profiel aan te maken. Het profiel zal vervolgens automatisch gekoppeld zijn met de trainingen die je hebt aangegeven in de XML.

Importeren van trainer gegevens

Naast het koppelen van trainers aan trainingen is het ook mogelijk om trainers los toe te voegen aan. Via een aparte trainer XML/FEED is het mogelijk om alvast de gegevens van trainers aan te leveren. Wij zullen automatisch de trainers toe voegen aan ons systeem. Op basis van het aangeleverde email adres wordt een uitnodiging gestuurd aan de trainers om hun account te bevestigen. Het profiel van de trainers is op dat moment al aangevuld met de gedeelde informatie. 

Bekijk het  XML en XSD voorbeeld om te zien welke informatie is in te laden. 

Aanleveren van trainer gegevens

1. Download: import_trainer_example.xml
2. Voeg trainers toe aan de hand van de bestaande velden (zo compleet mogelijk)
3. Check welke waarden zijn toegestaan per veld aan de hand van XML Schema: import_trainers_example.xsd
4. Verander de naam van de XML in Provider-name_AllTrainers.xml. Voorbeeld: Springest_AllTrainers.xml
5. Valideren: We verwachten dat je de XML die je aanmaakt eerst valideert eer je het deelt met datasupport. Op de volgende website kun je gemakkelijk jouw XML valideren tegen de XSD:  http://www.freeformatter.com/xml-validator-xsd.html
6. Mail het bestand of de url van de feed naar datasupport@springest.com
7. NOTE: Maak melding van de character encoding die gebruikt is voor de XML. Voorbeeld: UTF-8

PE punten toevoegen

Het is mogelijk om informatie over PE Punten per training aan te leveren via een Springest  XML-feed. 

In het  XML voorbeeld kan je zien hoe je verschillende PE organisaties, type punten, punten aan de XML kan toevoegen. 

Hieronder is de structuur nog eens uitgelicht:

f
	<PePoints>
            <PePoint>
                <Organisation></Organisation>
                <PointType></PointType>
                <Points></Points>
            </PePoint>
             <PePoint>
                <PeOrganisation></PeOrganisation>
                <PointType></PointType>
                <Points></Points>
            </PePoint>
        </PePoints>
	

Uit welke organisaties kan ik kiezen?

Op dit moment hebben we een aantal organisaties gekoppeld in ons systeem. Neem gerust  contact met ons op als er een organisatie ontbreekt.

De volledige lijst van organisatie namen en type punten die we op dit moment hebben kun je terug vinden onder het kopje PE Punten op de training pagina:

Bij deze ook een CSV met een lijst aan organisaties (niet volledig).

Vragen of feedback?

Neem dan contact op met onze technische helpdesk:

Mail: datasupport@springest.nl