Alles over jortt

Jortt: Verkooporders naar Jortt sturen

Stuur orders uit je webshop of marketplace naar Jortt als verkoopfactuur. APIcenter maakt ook de klant aan als die nog niet bestaat.

Bijgewerkt op 9 november 2026

Deze flow stuurt verkooporders uit een andere applicatie, zoals een webshop of marketplace, naar Jortt. APIcenter maakt elke order in Jortt aan als factuur.

Zo wordt een order verwerkt

  1. APIcenter controleert de instelling Send Order as. Jortt ondersteunt alleen facturen, dus dit moet Sales Invoice zijn, wat de standaardwaarde is. Bij een andere waarde mislukt de order.
  2. APIcenter controleert of de factuur al bestaat. Heeft het ordernummer minimaal 3 tekens, dan zoekt APIcenter in Jortt naar facturen en controleert of een factuur een referentie heeft die gelijk is aan het ordernummer. Is dat zo, dan mislukt de order met de melding dat de order al in Jortt is geregistreerd. Een ordernummer van minder dan 3 tekens wordt niet gecontroleerd, omdat Jortt alleen kan zoeken met minimaal 3 tekens.
  3. APIcenter zoekt de klant in Jortt op e-mailadres. Een klant die bestaat, wordt gebruikt en niet bijgewerkt. Een klant die niet bestaat, wordt aangemaakt. Zie hieronder.
  4. Bevat de order een handelsnaam, dan zoekt APIcenter die op in Jortt.
  5. APIcenter bereidt de orderregels voor. Zie hieronder.
  6. APIcenter maakt de factuur aan in Jortt en leest hem opnieuw uit Jortt.

De klant

  • Een klant heeft een e-mailadres nodig, want APIcenter zoekt de klant daarop.
  • Een nieuwe klant met een bedrijfsnaam wordt aangemaakt als bedrijf. De naam die je meestuurt, wordt dan de contactpersoon. Een nieuwe klant zonder bedrijfsnaam wordt aangemaakt als particulier.
  • Bij een klant die al in Jortt bestaat, volgt APIcenter de gegevens uit Jortt om te bepalen of de klant een particulier is. Heeft Jortt hiervoor geen waarde, dan behandelt APIcenter de klant als particulier.
  • Wil je bestaande klanten bijwerken? Gebruik dan de flow Klanten naar Jortt sturen.

Orderregels en prijzen

  • Jortt heeft geen kortingsveld. APIcenter verwerkt een korting in de stukprijs van de regel: het kortingsbedrag, of het kortingspercentage als er geen bedrag is, wordt van het regeltotaal afgetrokken en weer door het aantal gedeeld.
  • Btw-percentages worden afgerond op hele getallen.
  • Jortt werkt niet met SKU's. Heeft een orderregel geen omschrijving, dan gebruikt APIcenter de SKU als omschrijving.
  • Heeft de regel geen valuta? Dan gebruikt APIcenter de standaardvaluta voor prijzen, zie Jortt verbindings- en integratie-instellingen.
  • Wil je dat particulieren prijzen inclusief btw krijgen? Zet dan Use prices including tax for private persons aan. Bedrijven houden prijzen exclusief btw.
  • Jortt kent geen verzendkosten, betaalkosten of andere kosten op factuurniveau. Je kunt ze als aparte orderregels toevoegen met de instellingen, bijvoorbeeld Require order line for shipping costs. Vul voor die regel ook de omschrijving in, anders gebruikt APIcenter de itemcode als omschrijving.

Facturatiemethode

Met de instelling voor de facturatiemethode kies je wie de factuur verstuurt. APIcenter stuurt deze verzendmethode mee naar Jortt. Standaard is dat self: jij handelt de facturatie van de klant zelf af. Vul email in als Jortt de factuur direct naar het e-mailadres van de klant moet sturen.

Jortt maakt een factuur zonder verzendmethode aan als concept. Met een verzendmethode maakt Jortt de factuur aan en plant het versturen. Jortt geeft het factuurnummer pas als de factuur is verzonden. Jortt kent ook de verzendmethode peppol. Wil je die gebruiken, neem dan eerst contact op met APIcenter-support.

Handelsnaam

Heb je meerdere handelsnamen in Jortt, dan kun je kiezen op welke handelsnaam de factuur wordt aangemaakt. Je beheert handelsnamen in Jortt bij Instellingen > Handelsnamen. Vul het veld voor de handelsnaam onder Data mapping met de bedrijfsnaam van de handelsnaam, precies zoals die in Jortt staat. APIcenter zoekt hem op in Jortt en gebruikt hem op de factuur. Wordt er geen handelsnaam met die naam gevonden, dan wordt de factuur zonder handelsnaam aangemaakt.

Wat je eerst nodig hebt

  • Jortt is gekoppeld. Zie Jortt koppelen aan APIcenter.
  • De andere applicatie van de integratie kan verkooporders versturen, met de klant en een e-mailadres.

Tips

  • Mislukt een order omdat hij al is geregistreerd? Controleer of de factuur in Jortt bestaat.
  • Wees voorzichtig met de controle op bestaande facturen. Die vergelijkt het ordernummer met de referentie van de facturen in Jortt. Standaard wordt het ordernummer gemapt naar het veld factuurnummer en de orderreferentie naar het veld referentie. De controle vindt dus alleen een dubbele order als de referentie in Jortt dezelfde waarde heeft als het ordernummer. Wil je op deze controle vertrouwen? Controleer dan onder Data mapping welke waarde in het veld referentie terechtkomt.
  • Orders met een ordernummer van minder dan 3 tekens worden nooit gecontroleerd en kunnen dus dubbel worden aangemaakt. Gebruik in de bronapplicatie ordernummers van minimaal 3 tekens.
  • Heb je andere velden op de factuur nodig, zoals de leveringsperiode, de betaalmethode of opmerkingen? Voeg ze toe onder Data mapping. Zie Data mapping.

Hieronder vind je alle instellingen van deze flow, elk met een eigen uitleg.

Instellingen

De instellingen die je in het dashboard ziet, met wat elke instelling doet.

Create customers as guests

Customer Settings

Deze instelling heeft geen effect voor Jortt. Als APIcenter een order naar Jortt stuurt, zoekt het de klant op e-mailadres en maakt het de klant in Jortt aan als die nog niet bestaat. In dit proces bestaat geen gastklant, dus je kunt deze instelling laten staan zoals hij is. Standaard staat deze instelling uit.

Default debtor email address

Customer Settings

Het e-mailadres van de klant in Jortt dat APIcenter gebruikt als Enable use of default debtor aan staat en de order geen e-mailadres van de klant bevat (of altijd, als Force the usage of the default debtor aan staat). APIcenter zoekt dit e-mailadres dan op in Jortt. Bestaat er geen klant met dit e-mailadres, dan maakt APIcenter met de gegevens van de order een nieuwe klant aan in Jortt. Gebruik een geldig e-mailadres, anders mislukt de order met een foutmelding.

Default price list group

Customer Settings

Deze instelling heeft geen effect voor Jortt. De standaard data mapping stuurt geen prijslijstgroep naar Jortt, dus deze waarde wordt niet gebruikt. Je kunt het veld laten zoals het is; de standaardwaarde ***** wordt voor Jortt niet gebruikt.

Deze instelling heeft geen effect voor Jortt. APIcenter zoekt de klant in Jortt altijd op e-mailadres. Bestaat de klant niet, dan maakt APIcenter de klant aan in Jortt, in plaats van terug te vallen op een standaardklant.

Enable the send method setting

Customer Settings

Zet deze instelling aan om bij elke factuur die APIcenter in Jortt aanmaakt een verzendwijze mee te sturen, zodat jij bepaalt of jij of Jortt de factuur naar de klant verstuurt. De waarde vul je in bij Specify how you to handle the invoicing of your customers: self of email. Zonder waarde stopt het versturen van de order met een foutmelding. Standaard staat deze instelling aan.

Deze instelling heeft geen effect voor Jortt, omdat Jortt geen klantgroepveld heeft en de standaard data mapping naar Jortt geen klantgroep meestuurt. Laat hem uit: zet je hem aan zonder waarde bij Value to use as default customer group, dan stopt het versturen van orders met een foutmelding. Standaard staat deze instelling uit.

Deze instelling heeft geen effect voor Jortt. De Jortt-flows gebruiken geen prijslijstgroep: de standaard data mapping stuurt er geen naar Jortt. Laat deze instelling uit staan (standaard).

Enable use of default debtor

Customer Settings

Zet deze instelling aan om voor orders een standaardklant in Jortt te gebruiken. Voor Jortt telt alleen het e-mailadres: vul dat in bij Default debtor email address. Met Force the usage of the default debtor kies je of elke order de standaardklant gebruikt of alleen orders zonder e-mailadres van de klant. Staat dit aan maar is er geen e-mailadres (of ID) ingevuld, dan mislukken orders met een foutmelding. Standaard staat deze instelling uit.

Deze instelling heeft geen effect voor Jortt. Jortt heeft geen klantgroepveld en de standaard data mapping naar Jortt stuurt geen klantgroep mee, dus er valt niets te forceren. Je kunt deze instelling uit laten. Standaard staat deze instelling uit.

Staat deze instelling aan, dan vervangt APIcenter bij elke order het e-mailadres van de klant door dat uit Default debtor email address, zodat elke factuur op die ene klant in Jortt wordt geboekt. Staat ze uit (standaard), dan wordt het standaard e-mailadres alleen gebruikt als de order geen e-mailadres van de klant bevat. Dit werkt alleen als Enable use of default debtor aan staat en de klant met dat e-mailadres in Jortt bestaat.

Staat dit aan, dan gebruikt APIcenter altijd de standaard betalingstermijn uit default payment terms id, ook als de data uit de bron er al een heeft. Staat dit uit (standaard), dan wordt de standaardwaarde alleen gebruikt als de data geen betalingstermijn bevat. Dit werkt alleen als Make use of a default payment terms id aan staat. Bij Jortt wordt de betalingstermijn alleen meegestuurd als APIcenter op basis van een order een nieuwe klant in Jortt aanmaakt.

Deze instelling heeft geen effect voor Jortt. De Jortt-flows gebruiken geen prijslijstgroep: de standaard data mapping stuurt er geen naar Jortt. Laat deze instelling uit staan (standaard).

Deze instelling heeft geen effect met de standaard data mapping naar Jortt, die geen betaalmethode uit de order meestuurt. Hij heeft alleen effect als je de betaalmethode zelf in de data mapping van de flow koppelt. Standaard staat deze instelling uit.

Staat deze instelling aan, dan gebruikt APIcenter altijd de waarde uit Specify how you to handle the invoicing of your customers als verzendwijze van de factuur, ook als de bron een andere waarde meestuurt. Staat ze uit, dan wordt die waarde alleen gebruikt als de order geen verzendwijze bevat. Dit werkt alleen als Enable the send method setting aan staat, en alleen bij het versturen van verkooporders: de klantgegevens van Jortt hebben geen verzendwijze, dus bij het versturen van klanten heeft dit geen effect. Standaard staat deze instelling aan.

Deze instelling heeft geen effect met de standaard data mapping naar Jortt, die geen betaalmethode uit de order meestuurt. Laat hem uit, tenzij je de betaalmethode zelf koppelt: zet je hem aan zonder waarde bij Value for the default payment method id, dan stopt het versturen van orders en klanten met een foutmelding. Standaard staat deze instelling uit.

Zet dit aan om de betalingstermijn uit default payment terms id te gebruiken als de data uit de bron er geen bevat. Gebruik Force the usage of the default payment terms als APIcenter de waarde altijd moet gebruiken. Bij Jortt wordt de betalingstermijn alleen meegestuurd als APIcenter op basis van een order een nieuwe klant aanmaakt (flow Send Sales Order). Standaard staat dit uit.

Bepaalt wie de factuur naar je klant verstuurt. Gebruik self (standaard) als je de factuur zelf verstuurt. Gebruik email als je wilt dat Jortt de factuur direct naar het e-mailadres van je klant stuurt. De waarde gaat als verzendwijze van de factuur naar Jortt als APIcenter een verkooporder verstuurt; bij het versturen van klanten heeft hij geen effect.

Deze instelling heeft in de standaardconfiguratie geen effect voor Jortt. De standaard data mapping stuurt geen betaalmethode naar Jortt, dus er valt niets te mappen. Laat deze instelling uit staan (standaard).

Gebruik een mappingtabel om een waarde uit de andere applicatie te vertalen naar de verzendwijze van de Jortt-factuur: self (je verstuurt de factuur zelf) of email (Jortt stuurt de factuur per e-mail naar de klant). De tabel wordt alleen gebruikt als de bron een waarde meestuurt, en wordt genegeerd zolang Force the value used for the send method aan staat, wat bij Jortt de standaard is. Zet die instelling uit om de mappingtabel te gebruiken. Waarden die niet in de tabel staan, worden afgehandeld volgens What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.

Gebruik een mappingtabel om de betalingstermijn uit de andere applicatie te vertalen naar de betalingstermijn die Jortt verwacht, een getal zoals 14 of 30. In de flow Send Sales Order wordt die alleen meegestuurd als APIcenter een nieuwe klant in Jortt aanmaakt; bestaande klanten in Jortt worden niet gewijzigd. De standaard data mapping van de flow Send Customer stuurt geen betalingstermijn mee. Waarden die niet in de tabel staan, worden afgehandeld volgens What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.

Deze instelling heeft geen effect voor Jortt. De Jortt-flows gebruiken geen prijslijstgroep: de standaard data mapping stuurt er geen naar Jortt, dus er valt niets te mappen. Laat deze instelling uit staan (standaard).

Standaard stuurt APIcenter de prijzen van de orderregels exclusief btw naar Jortt. Zet dit aan om voor particuliere klanten de prijzen inclusief btw te sturen; bij bedrijven blijven de prijzen exclusief btw. Een klant geldt als particulier als de order geen bedrijfsnaam heeft, of als de klant in Jortt als particulier is geregistreerd (een bestaande Jortt-klant zonder die informatie wordt als particulier behandeld). Standaard staat dit uit.

Deze instelling heeft geen effect met de standaard data mapping naar Jortt, die geen betaalmethode uit de order meestuurt. De waarde komt alleen in Jortt terecht als je de betaalmethode zelf in de data mapping van de flow koppelt. Anders kun je dit veld leeg laten.

Deze instelling heeft geen effect voor Jortt. APIcenter zoekt klanten in Jortt op e-mailadres en niet op een ID, dus deze waarde wordt niet gebruikt. Gebruik in plaats daarvan Default debtor email address.

Deze instelling heeft geen effect voor Jortt. Jortt heeft geen klantgroepveld en de standaard data mapping naar Jortt stuurt geen klantgroep mee, dus je kunt dit veld leeg laten.

Bepaalt wat er gebeurt als de mappingtabel voor de betalingstermijn geen regel heeft voor een waarde uit de binnenkomende data.

  • Standaardwaarde gebruiken (standaard): APIcenter gebruikt default payment terms id, als Make use of a default payment terms id aan staat; anders blijft het veld leeg.
  • Waarde gebruiken: de oorspronkelijke waarde gaat ongewijzigd naar Jortt.
  • Waarde negeren: het veld blijft leeg.

Bepaalt wat er gebeurt als de mappingtabel voor de prijslijstgroep geen regel heeft voor een waarde uit de binnenkomende data.

  • Standaardwaarde gebruiken (standaard): APIcenter gebruikt Default price list group, als die standaardwaarde aan staat; anders blijft het veld leeg.
  • Waarde gebruiken: de oorspronkelijke waarde wordt ongewijzigd doorgegeven.
  • Waarde negeren: het veld blijft leeg.

Dit heeft geen effect voor Jortt, omdat de standaard data mapping geen prijslijstgroep naar Jortt stuurt.

Bepaalt wat er gebeurt als de mappingtabel voor de betaalmethode geen regel heeft voor een waarde uit de binnenkomende data.

  • Standaardwaarde gebruiken (standaard): APIcenter gebruikt Value for the default payment method id, als die standaardwaarde aan staat; anders blijft het veld leeg.
  • Waarde gebruiken: de oorspronkelijke waarde wordt ongewijzigd doorgegeven.
  • Waarde negeren: het veld blijft leeg.

Dit heeft in de standaardconfiguratie geen effect voor Jortt, omdat de standaard data mapping geen betaalmethode naar Jortt stuurt.

default payment terms id

Customer Settings

De betalingstermijn die APIcenter standaard gebruikt als de data uit de bron er geen heeft. Vul die in als aantal dagen, bijvoorbeeld 14 of 30. Zonder waarde gebruikt Jortt de betaaltermijn van de klant, daarna die van de administratie en anders 30 dagen. In de flow Send Sales Order zet de standaard data mapping de waarde op de Jortt-klant, dus hij wordt alleen meegestuurd als APIcenter een nieuwe klant aanmaakt; bestaande klanten in Jortt worden niet gewijzigd. De standaard data mapping van de flow Send Customer stuurt geen betalingstermijn mee: map die zelf naar het Jortt-veld payment_term als je dat daar nodig hebt. De waarde wordt alleen gebruikt als Make use of a default payment terms id aan staat.

Default administration id

General flow setting

Deze instelling heeft geen effect voor Jortt. Jortt heeft geen administratieveld en de standaard data mapping naar Jortt stuurt geen administratie mee, dus je kunt dit veld leeg laten.

Codeert waarden in verzoek-URL's als deze flow gegevens uit Jortt ophaalt. Deze verzoeken bevatten alleen paginanummers, factuurstatussen en Jortt-klant-id's, dus je hebt dit zelden nodig. Werkt alleen als Enable URL encoding of data in endpoints ook aan staat. Standaard staat dit uit.

Hiermee codeer je de waarden in het adres (de URL) van de doelapplicatie, dus bij flows die gegevens versturen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.

Zet dit aan als er speciale tekens in de data staan die in het adres (de URL) van een verzoek terechtkomen, zoals in een SKU of categorienaam. De waarden worden dan URL-gecodeerd, zodat het verzoek niet misgaat. Met Enable URL Encoding of data in the endpoints of the source application en Enable URL Encoding of data in the endpoints of the target application bepaal je voor welke kant dit geldt. Standaard staat dit uit.

Deze instelling heeft geen effect voor Jortt. Jortt heeft geen administratieveld en de standaard data mapping naar Jortt stuurt geen administratie mee, dus er valt niets te forceren. Je kunt deze instelling uit laten. Standaard staat deze instelling uit.

Deze instelling heeft geen effect voor Jortt, omdat Jortt geen administratieveld heeft en de standaard data mapping naar Jortt geen administratie meestuurt. Laat hem uit: zet je hem aan zonder waarde bij Default administration id, dan stopt het versturen van orders met een foutmelding. Standaard staat deze instelling uit.

Use administration mapping table

General flow setting

Deze instelling heeft geen effect voor Jortt. De data die APIcenter met Jortt uitwisselt, heeft geen administratieveld, dus er valt niets te mappen. Laat deze instelling uit staan (standaard).

Bepaalt wat er gebeurt als de mappingtabel voor de administratie geen regel heeft voor een waarde uit de binnenkomende data.

  • Standaardwaarde gebruiken (standaard): APIcenter gebruikt Default administration id, als die standaardwaarde aan staat; anders blijft het veld leeg.
  • Waarde gebruiken: de oorspronkelijke waarde wordt ongewijzigd doorgegeven.
  • Waarde negeren: het veld blijft leeg.

Dit heeft geen effect voor Jortt, omdat de data die APIcenter met Jortt uitwisselt geen administratieveld heeft.

Deze instelling heeft geen effect voor Jortt. Jortt heeft geen veld voor een btw-code voor verkoop bij klanten en de standaard data mapping naar Jortt stuurt er geen mee, dus je kunt dit veld leeg laten. Het btw-percentage van een factuurregel komt uit de bedragen van de order.

Deze instelling heeft geen effect voor Jortt, omdat Jortt geen veld voor een btw-code voor verkoop bij klanten heeft en de standaard data mapping naar Jortt er geen meestuurt. Laat hem uit: zet je hem aan zonder waarde bij Default customer sales vat code id, dan stopt het versturen van orders en klanten met een foutmelding. Standaard staat deze instelling uit.

Deze instelling heeft geen effect voor Jortt. Jortt heeft geen veld voor een btw-code voor verkoop bij klanten en de standaard data mapping naar Jortt stuurt er geen mee, dus er valt niets te forceren. Je kunt deze instelling uit laten. Standaard staat deze instelling uit.

Deze instelling heeft in de standaardconfiguratie geen effect voor Jortt. De standaard data mapping stuurt geen btw-code voor de klant naar Jortt, dus er valt niets te mappen. Laat deze instelling uit staan (standaard).

Bepaalt wat er gebeurt als de mappingtabel voor de btw-code van de klant geen regel heeft voor een waarde uit de binnenkomende data.

  • Standaardwaarde gebruiken (standaard): APIcenter gebruikt Default customer sales vat code id, als die standaardwaarde aan staat; anders blijft het veld leeg.
  • Waarde gebruiken: de oorspronkelijke waarde wordt ongewijzigd doorgegeven.
  • Waarde negeren: het veld blijft leeg.

Dit heeft in de standaardconfiguratie geen effect voor Jortt, omdat de standaard data mapping geen btw-code voor de klant naar Jortt stuurt.

Vul hier het e-mailadres in waarnaar APIcenter meldingen stuurt over mislukte activiteiten van deze flow. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan gebruikt APIcenter bij Direct het e-mailadres van je account. Er is geen standaardwaarde.

Vul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. Er is geen standaardwaarde.

Notifications frequency

Notifications

Kies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.

Receive Notifications

Notifications

Zet dit aan om een melding te krijgen als een activiteit van deze flow mislukt. Met Notifications frequency bepaal je hoe vaak je de melding krijgt, en met Notifications Email address en Notifications Slack webhook waar die naartoe gaat. Standaard staat dit uit.

Zet dit aan om de factuurkosten van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een bedrag aan factuurkosten heeft. Vul daarna Default item code for billing costs in, anders mislukt de flow. Standaard staat dit uit.

Zet dit aan om de commissie van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een commissiebedrag heeft. Vul daarna Default item code for commission in, anders mislukt de flow. Standaard staat dit uit.

Zet dit aan om de betaalkosten van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een bedrag aan betaalkosten heeft. Vul daarna Default item code for Payment Costs in, anders mislukt de flow. Standaard staat dit uit.

De code die APIcenter op de extra orderregel met betaalkosten zet. Dit veld is verplicht als Add order line for payment costs aan staat; zonder code mislukt de order met een foutmelding. Jortt gebruikt geen artikelcodes en APIcenter zoekt deze code niet op in Jortt. De code wordt alleen als omschrijving van de regel gebruikt als je Description to use for the order line for payment costs leeg laat.

De code die APIcenter op de extra orderregel met factuurkosten zet. Dit veld is verplicht als Add order line for billing costs aan staat; zonder code mislukt de order met een foutmelding. Jortt gebruikt geen artikelcodes en APIcenter zoekt deze code niet op in Jortt. De code wordt alleen als omschrijving van de regel gebruikt als je Description to use for the order line for billing costs leeg laat.

De code die APIcenter op de extra orderregel met commissie zet. Dit veld is verplicht als Add order line for commission aan staat; zonder code mislukt de order met een foutmelding. Jortt gebruikt geen artikelcodes en APIcenter zoekt deze code niet op in Jortt. De code wordt alleen als omschrijving van de regel gebruikt als je Description to use for the order line for commission leeg laat.

De code die APIcenter op de extra orderregel met verzendkosten zet. Dit veld is verplicht als Require order line for shipping costs aan staat; zonder code mislukt de order met een foutmelding. Jortt gebruikt geen artikelcodes en APIcenter zoekt deze code niet op in Jortt. De code wordt alleen als omschrijving van de regel gebruikt als je Description to use for the order line for shipping costs leeg laat.

Default order prefix

Order Settings

Tekst die APIcenter vóór het ordernummer plaatst, bijvoorbeeld WEB- maakt van order 1001 de order WEB-1001. Zo herken je in Jortt orders uit een bepaalde bron, of houd je ordernummers uniek als je meerdere stores hebt. Het voorvoegsel wordt alleen toegevoegd als de data mapping van het ordernummer de microfunctie voor het ordervoorvoegsel gebruikt; de standaard data mapping naar Jortt doet dat niet.

Default order suffix

Order Settings

Tekst die APIcenter achter het ordernummer plaatst, bijvoorbeeld -NL maakt van order 1001 de order 1001-NL. Zo herken je in Jortt orders uit een bepaalde bron, of houd je ordernummers uniek als je meerdere stores hebt. Het achtervoegsel wordt alleen toegevoegd als de data mapping van het ordernummer de microfunctie voor het orderachtervoegsel gebruikt; de standaard data mapping naar Jortt doet dat niet.

Deze instelling heeft geen effect met de standaard data mapping naar Jortt. Het btw-percentage van de extra factuurregel voor factuurkosten komt uit de bedragen van de order. Als het percentage niet te bepalen is, gebruikt APIcenter Default tax rate billing costs. De btw-code wordt alleen gebruikt als je hem zelf in de data mapping van de flow koppelt.

Deze instelling heeft geen effect met de standaard data mapping naar Jortt. Het btw-percentage van de extra factuurregel voor commissie komt uit de bedragen van de order. Als het percentage niet te bepalen is, gebruikt APIcenter Default tax rate commission. De btw-code wordt alleen gebruikt als je hem zelf in de data mapping van de flow koppelt.

Deze instelling heeft geen effect met de standaard data mapping naar Jortt. Het btw-percentage van de extra factuurregel voor betaalkosten komt uit de bedragen van de order. Als het percentage niet te bepalen is, gebruikt APIcenter Default tax rate payment costs. De btw-code wordt alleen gebruikt als je hem zelf in de data mapping van de flow koppelt.

Deze instelling heeft geen effect met de standaard data mapping naar Jortt. Het btw-percentage van de extra factuurregel voor verzendkosten komt uit de bedragen van de order. Als het percentage niet te bepalen is, gebruikt APIcenter Default tax rate prices. De btw-code wordt alleen gebruikt als je hem zelf in de data mapping van de flow koppelt.

De tekst die APIcenter op de extra factuurregel voor factuurkosten zet, bijvoorbeeld Factuurkosten. Laat je dit veld leeg, dan gebruikt APIcenter de code uit Default item code for billing costs als omschrijving van de regel. Jortt heeft op elke factuurregel een omschrijving nodig.

De tekst die APIcenter op de extra factuurregel voor commissie zet, bijvoorbeeld Commissie. Laat je dit veld leeg, dan gebruikt APIcenter de code uit Default item code for commission als omschrijving van de regel. Jortt heeft op elke factuurregel een omschrijving nodig.

De tekst die APIcenter op de extra factuurregel voor betaalkosten zet, bijvoorbeeld Betaalkosten. Laat je dit veld leeg, dan gebruikt APIcenter de code uit Default item code for Payment Costs als omschrijving van de regel. Jortt heeft op elke factuurregel een omschrijving nodig.

De tekst die APIcenter op de extra factuurregel voor verzendkosten zet, bijvoorbeeld Verzendkosten. Laat je dit veld leeg, dan gebruikt APIcenter de code uit Default item code to use for shipping cost order line als omschrijving van de regel. Jortt heeft op elke factuurregel een omschrijving nodig.

Zet dit aan om de verzendkosten van de order als aparte orderregel toe te voegen. APIcenter doet dit alleen als de order een bedrag aan verzendkosten heeft. Vul daarna Default item code to use for shipping cost order line in, anders mislukt de flow. Standaard staat dit uit.

Send Order as

Order Settings

Bepaalt wat APIcenter in Jortt aanmaakt voor elke binnenkomende order. Jortt ondersteunt alleen Sales Invoice (standaard), dus laat het op die waarde staan. Bij elke andere keuze mislukt de flow Send Sales Order met een foutmelding dat Jortt orders alleen als Sales Invoice kan ontvangen.

Skip negativity flip process

Product Settings

Standaard zet APIcenter negatieve bedragen bij prijzen, kortingen en belasting om naar positieve bedragen. Bedragen inclusief en exclusief belasting worden dan ook omgewisseld als de belasting negatief is. Zet je deze instelling aan, dan slaat APIcenter deze omzetting over en blijven negatieve waarden negatief. De standaardwaarde is uit.

Het maximale aantal pagina's dat APIcenter leest als het een verzoek herhaalt om een lijst in meerdere pagina's op te halen. De Jortt-flows lezen per run één pagina klanten of facturen (zie Offset), dus deze instelling heeft voor Jortt in de praktijk geen effect. De standaardwaarde is 20; je hoeft dit niet aan te passen.

Use page size

Run behaviour

Het aantal records per pagina als APIcenter een lijst in meerdere pagina's opvraagt. De verzoeken die de Jortt-flows voor klanten en facturen versturen bevatten geen paginagrootte, dus deze instelling heeft voor Jortt in de praktijk geen effect. De standaardwaarde is 50; je hoeft dit niet aan te passen.

Deze instelling heeft geen effect voor Jortt. De data die APIcenter voor een order naar Jortt stuurt, heeft geen veld voor de verzendmethode. Wil je verzendkosten op de Jortt-factuur hebben, gebruik dan Require order line for shipping costs. Laat deze instelling uit staan (standaard).

Deze instelling heeft geen effect voor Jortt. De data die APIcenter voor een order naar Jortt stuurt, heeft geen veld voor de verzendmethode, en de standaard data mapping stuurt er geen mee. Laat deze instelling uit staan (standaard).

Deze instelling heeft geen effect voor Jortt. De data die APIcenter voor een order naar Jortt stuurt, heeft geen veld voor de verzendmethode, dus er valt niets te mappen. Laat deze instelling uit staan (standaard).

Deze instelling heeft geen effect voor Jortt. De data die APIcenter voor een order naar Jortt stuurt, heeft geen veld voor de verzendmethode, dus deze waarde wordt niet gebruikt. Laat het veld leeg (standaard).

Bepaalt wat er gebeurt als de mappingtabel voor de verzendmethode geen regel heeft voor een waarde uit de binnenkomende data.

  • Standaardwaarde gebruiken (standaard): APIcenter gebruikt Value to use as the default shipping method id, als die standaardwaarde aan staat; anders blijft het veld leeg.
  • Waarde gebruiken: de oorspronkelijke waarde wordt ongewijzigd doorgegeven.
  • Waarde negeren: het veld blijft leeg.

Dit heeft geen effect voor Jortt, omdat de data die APIcenter voor een order naar Jortt stuurt geen veld voor de verzendmethode heeft.

Enable the use of a default warehouse

Stock & Warehouse Settings

Deze instelling heeft geen effect voor Jortt. De data die APIcenter met Jortt uitwisselt, heeft geen magazijnveld, dus er is niets waarop een standaardmagazijn kan worden toegepast. Laat deze instelling uit staan (standaard).

Force the usage of the default warehouse

Stock & Warehouse Settings

Deze instelling heeft geen effect voor Jortt. De data die APIcenter met Jortt uitwisselt, heeft geen magazijnveld, dus er is niets waarop een standaardmagazijn kan worden toegepast. Laat deze instelling uit staan (standaard).

Use warehouse mapping table

Stock & Warehouse Settings

Deze instelling heeft geen effect voor Jortt. De data die APIcenter met Jortt uitwisselt, heeft geen magazijnveld, dus er valt niets te mappen. Laat deze instelling uit staan (standaard).

Value for the default warehouse id

Stock & Warehouse Settings

Deze instelling heeft geen effect voor Jortt. De data die APIcenter met Jortt uitwisselt, heeft geen magazijnveld, dus deze waarde wordt niet gebruikt. Laat het veld leeg (standaard).

Bepaalt wat er gebeurt als de mappingtabel voor het magazijn geen regel heeft voor een waarde uit de binnenkomende data.

  • Standaardwaarde gebruiken (standaard): APIcenter gebruikt Value for the default warehouse id, als het standaardmagazijn aan staat; anders blijft het veld leeg.
  • Waarde gebruiken: de oorspronkelijke waarde wordt ongewijzigd doorgegeven.
  • Waarde negeren: het veld blijft leeg.

Dit heeft geen effect voor Jortt, omdat de data die APIcenter met Jortt uitwisselt geen magazijnveld heeft.

Deze instelling heeft in de standaardconfiguratie geen effect voor Jortt. Jortt krijgt per orderregel het btw-percentage en geen btw-code, en de standaard data mapping stuurt geen btw-code mee. Laat deze instelling uit staan (standaard).

Deze instelling heeft in de standaardconfiguratie geen effect voor Jortt. Jortt krijgt per orderregel het btw-percentage en geen btw-code, en de standaard data mapping stuurt geen btw-code mee. Laat deze instelling uit staan (standaard).

Deze instelling heeft in de standaardconfiguratie geen effect voor Jortt. Jortt krijgt per orderregel het btw-percentage en geen btw-code, en de standaard data mapping stuurt geen btw-code mee, dus er valt niets te mappen. Laat deze instelling uit staan (standaard).

Deze instelling heeft in de standaardconfiguratie geen effect voor Jortt. Jortt krijgt per orderregel het btw-percentage (afgerond op een geheel getal) en geen btw-code, en de standaard data mapping stuurt geen btw-code mee. Laat het veld leeg (standaard).

Bepaalt wat er gebeurt als de mappingtabel voor btw geen regel heeft voor een waarde uit de binnenkomende data.

  • Standaardwaarde gebruiken: APIcenter gebruikt Value for the default tax id (exclude '%'), als die standaardwaarde aan staat; anders blijft het veld leeg.
  • Waarde gebruiken: de oorspronkelijke waarde wordt ongewijzigd doorgegeven.
  • Waarde negeren (standaard): het veld blijft leeg.

Dit heeft in de standaardconfiguratie geen effect voor Jortt, omdat de standaard data mapping geen btw-code naar Jortt stuurt.

Nog vragen?

Stel je vraag aan de supportassistent in je dashboard of maak een supportticket aan.

Naar support