All about jortt
Jortt: Send sales orders to Jortt
Send orders from your webshop or marketplace to Jortt as a sales invoice. APIcenter also creates the customer when it does not exist.
Updated November 9, 2026
This flow sends sales orders from another application, such as a webshop or marketplace, to Jortt. APIcenter creates each order in Jortt as an invoice.
How an order is processed
- APIcenter checks the setting Send Order as. Jortt only supports invoices, so this must be Sales Invoice, which is the default. With another value the order fails.
- APIcenter checks whether the invoice already exists. When the order number has at least 3 characters, APIcenter searches Jortt for invoices and checks whether one has a reference that is equal to the order number. If it does, the order fails with the message that the order is already registered in Jortt. An order number with fewer than 3 characters is not checked.
- APIcenter looks for the customer in Jortt by e-mail address. A customer that exists is used and is not updated. A customer that does not exist is created. See below.
- When the order contains a trade name, APIcenter looks it up in Jortt.
- APIcenter prepares the order lines. See below.
- APIcenter creates the invoice in Jortt and reads it from Jortt again.
The customer
- A customer needs an e-mail address, because APIcenter looks for the customer on it.
- A new customer with a company name is created as a company. The name you send then becomes the contact person. A new customer without a company name is created as a private person.
- For a customer that already exists in Jortt, APIcenter follows the Jortt data to decide whether the customer is a private person. When Jortt has no value, APIcenter treats the customer as a private person.
- Do you want to update existing customers? Use the Send customers to Jortt flow.
Order lines and prices
- Jortt has no discount field. APIcenter processes a discount into the unit price of the line: the discount amount, or the discount percentage when there is no amount, is subtracted from the line total and divided by the quantity again.
- VAT percentages are rounded to whole numbers.
- Jortt does not use SKUs. When an order line has no description, APIcenter uses the SKU as description.
- Does the line have no currency? Then APIcenter uses the default currency for prices, see Jortt connection and integration settings.
- Do you want private persons to get prices including VAT? Switch on Use prices including tax for private persons. Companies keep prices excluding VAT.
- Jortt has no shipping costs, payment costs or other costs at invoice level. You can add them as separate order lines with the settings, for example Require order line for shipping costs. Also fill in the description for that line, otherwise APIcenter uses the item code as description.
Invoicing method
With the invoicing method setting you choose who sends the invoice. The default is self: you handle the invoicing of the customer yourself. Enter email when Jortt has to send the invoice directly to the e-mail address of the customer.
Trade name
When you have several trade names in Jortt, you can choose on which trade name the invoice is created. Fill the trade name field under Data mapping with the company name of the trade name, exactly as it is in Jortt. APIcenter looks it up in Jortt and uses it on the invoice. When no trade name is found with that name, the invoice is created without a trade name.
What you need first
- Jortt is connected. See Connect Jortt to APIcenter.
- The other application of the integration can send sales orders, with the customer and an e-mail address.
Tips
- Does an order fail because it is already registered? Check whether the invoice exists in Jortt.
- Be careful with the check on existing invoices. It compares the order number with the reference of the invoices in Jortt. By default, the order number is mapped to the invoice number field and the order reference to the reference field. The check therefore only finds a duplicate when the reference in Jortt has the same value as the order number. Do you want to rely on this check? Check under Data mapping which value ends up in the reference field.
- Orders with an order number of fewer than 3 characters are never checked, so they can be created twice. Use order numbers of at least 3 characters in the source application.
- Do you need other fields on the invoice, such as the delivery period, the payment method or the remarks? Add them under Data mapping. See Data mapping.
You find all settings for this flow below, each with its own explanation.
Settings
The settings you see in the dashboard, with what each one does.
Create customers as guests
Customer SettingsThis setting has no effect for Jortt. When APIcenter sends an order to Jortt, it looks up the customer by email address and creates the customer in Jortt when it does not exist yet. There is no guest customer in this process, so you can leave this setting as it is. Off by default.
Default debtor email address
Customer SettingsThe email address of the customer in Jortt that APIcenter uses when Enable use of default debtor is on and the order contains no customer email address (or always, when Force the usage of the default debtor is on). APIcenter then looks up this email address in Jortt. When no customer with this email address exists, APIcenter creates a new customer in Jortt with the data of the order. Use a valid email address, otherwise the order fails with an error.
Default price list group
Customer SettingsThis setting has no effect for Jortt. The standard data mapping does not send a price list group to Jortt, so this value is not used. You can leave the field as it is; the default value ***** is not used for Jortt.
Enable fallback to default id and/or email when customer not found
Customer SettingsThis setting has no effect for Jortt. APIcenter always looks up the customer in Jortt by email address. When the customer does not exist, APIcenter creates it in Jortt, instead of falling back to a default customer.
Enable the send method setting
Customer SettingsTurn this on to send a send method with every invoice that APIcenter creates in Jortt, so you decide whether you or Jortt sends the invoice to the customer. You enter the value in Specify how you to handle the invoicing of your customers: self or email. Without a value, sending the order stops with an error. On by default.
Enable use of a default customer group
Customer SettingsThis setting has no effect for Jortt, because Jortt has no customer group field and the standard data mapping to Jortt does not send a customer group. Leave it off: when you turn it on without a value in Value to use as default customer group, sending orders stops with an error. Off by default.
Enable use of a default customer price list group
Customer SettingsThis setting has no effect for Jortt. The Jortt flows do not use a price list group: the standard data mapping does not send one to Jortt. Leave it off (default).
Enable use of default debtor
Customer SettingsTurn this on to use a default customer in Jortt for orders. For Jortt only the email address counts: enter it in Default debtor email address. With Force the usage of the default debtor you choose whether every order uses it or only orders without a customer email address. If this is on but no email address (or ID) is filled in, orders fail with an error. Off by default.
Force the usage of the default customer group
Customer SettingsThis setting has no effect for Jortt. Jortt has no customer group field and the standard data mapping to Jortt does not send a customer group, so there is nothing to force. You can leave it off. Off by default.
Force the usage of the default debtor
Customer SettingsWhen on, APIcenter replaces the email address of the customer on every order with the one from Default debtor email address, so every invoice is booked on that one customer in Jortt. When off (default), the default email address is only used when the order contains no customer email address. This only works when Enable use of default debtor is on and the customer with that email address exists in Jortt.
Force the usage of the default payment terms
Customer SettingsWhen on, APIcenter always uses the default payment term from default payment terms id, even if the data from the source already has one. When off (default), the default is only used when the data has no payment term. This only has effect when Make use of a default payment terms id is on. For Jortt, the payment term is only sent when APIcenter creates a new customer in Jortt from an order.
Force the usage of the default price list group
Customer SettingsThis setting has no effect for Jortt. The Jortt flows do not use a price list group: the standard data mapping does not send one to Jortt. Leave it off (default).
Force the usage of the payment_method id
Customer SettingsThis setting has no effect with the standard data mapping to Jortt, which does not send a payment method from the order. It only has an effect when you map the payment method yourself in the data mapping of the flow. Off by default.
Force the value used for the send method
Customer SettingsWhen on, APIcenter always uses the value from Specify how you to handle the invoicing of your customers as the send method of the invoice, even if the source sends another value. When off, that value is only used when the order contains no send method. This only works when Enable the send method setting is on, and only for sending sales orders: the Jortt customer data has no send method, so it has no effect when sending customers. On by default.
Make use of a default payment method id
Customer SettingsThis setting has no effect with the standard data mapping to Jortt, which does not send a payment method from the order. Leave it off unless you map the payment method yourself: when you turn it on without a value in Value for the default payment method id, sending orders and customers stops with an error. Off by default.
Make use of a default payment terms id
Customer SettingsTurn this on to use the payment term from default payment terms id when the data from the source contains none. Use Force the usage of the default payment terms if APIcenter must always use it. For Jortt the payment term is only sent when APIcenter creates a new customer from an order (Send Sales Order flow). Off by default.
Specify how you to handle the invoicing of your customers
Customer SettingsDecides who sends the invoice to your customer. Use self (default) when you send the invoice yourself. Use email when you want Jortt to send the invoice directly to the email address of your customer. The value is sent to Jortt as the send method of the invoice when APIcenter sends a sales order; when sending customers it has no effect.
Use a mapping table to map the default payment method id
Customer SettingsThis setting has no effect for Jortt in the standard configuration. The standard data mapping does not send a payment method to Jortt, so there is nothing to map. Leave it off (default).
Use default customer communication method id mapping table
Customer SettingsUse a mapping table to translate a value from the other application into the send method of the Jortt invoice: self (you send the invoice yourself) or email (Jortt sends the invoice to the customer by email). The table is only used when the source sends a value, and it is ignored as long as Force the value used for the send method is on, which is the default for Jortt. Turn that setting off to use the mapping table. Values that are not in the table are handled by What to do with a value that cannot be mapped using the mapping table. Off by default.
Use default payment terms id mapping table
Customer SettingsUse a mapping table to translate the payment term from the other application into the payment term that Jortt expects, a number such as 14 or 30. In the Send Sales Order flow it is only sent when APIcenter creates a new customer in Jortt; existing Jortt customers are not changed. The standard data mapping of the Send Customer flow does not send a payment term. Values that are not in the table are handled by What to do with a value that cannot be mapped using the mapping table. Off by default.
Use default price list group mapping table
Customer SettingsThis setting has no effect for Jortt. The Jortt flows do not use a price list group: the standard data mapping does not send one to Jortt, so there is nothing to map. Leave it off (default).
Use prices including tax for private persons
Customer SettingsBy default APIcenter sends the prices of the order lines to Jortt excluding VAT. Turn this on to send prices including VAT for private customers instead; for companies the prices stay excluding VAT. A customer counts as private when the order has no company name, or when the customer is registered in Jortt as a private customer (an existing Jortt customer without that information is treated as private). Off by default.
Value for the default payment method id
Customer SettingsThis setting has no effect with the standard data mapping to Jortt, which does not send a payment method from the order. The value only reaches Jortt when you map the payment method yourself in the data mapping of the flow. Otherwise you can leave this field empty.
Value to use as Default debtor ID
Customer SettingsThis setting has no effect for Jortt. APIcenter looks up customers in Jortt by email address, not by an ID, so this value is not used. Use Default debtor email address instead.
Value to use as default customer group
Customer SettingsThis setting has no effect for Jortt. Jortt has no customer group field and the standard data mapping to Jortt does not send a customer group, so you can leave this field empty.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsDecides what happens when the payment terms mapping table has no row for a value from the incoming data.
- Use default (default): APIcenter uses default payment terms id, if Make use of a default payment terms id is on; otherwise the field stays empty.
- Use value: the original value is sent to Jortt unchanged.
- Ignore value: the field stays empty.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsDecides what happens when the price list group mapping table has no row for a value from the incoming data.
- Use default (default): APIcenter uses Default price list group, if that default is switched on; otherwise the field stays empty.
- Use value: the original value is passed on unchanged.
- Ignore value: the field stays empty.
This has no effect for Jortt, because the standard data mapping does not send a price list group to Jortt.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsDecides what happens when the payment method mapping table has no row for a value from the incoming data.
- Use default (default): APIcenter uses Value for the default payment method id, if that default is switched on; otherwise the field stays empty.
- Use value: the original value is passed on unchanged.
- Ignore value: the field stays empty.
This has no effect for Jortt in the standard configuration, because the standard data mapping does not send a payment method to Jortt.
default payment terms id
Customer SettingsThe payment term APIcenter uses as default when the data from the source has none. Enter it as a number, for example 14 or 30. In the Send Sales Order flow the standard data mapping puts it on the Jortt customer, so it is only sent when APIcenter creates a new customer; existing Jortt customers are not changed. The standard data mapping of the Send Customer flow does not send a payment term: map it yourself to the Jortt field payment_term if you need it there. The value is only used when Make use of a default payment terms id is on.
Default administration id
General flow settingThis setting has no effect for Jortt. Jortt has no administration field and the standard data mapping to Jortt does not send an administration, so you can leave this field empty.
Enable URL Encoding of data in the endpoints of the source application
General flow settingEncodes values in request URLs when this flow retrieves data from Jortt. These requests only contain page numbers, invoice statuses and Jortt customer ids, so you rarely need this. Only works when Enable URL encoding of data in endpoints is on as well. Off by default.
Enable URL Encoding of data in the endpoints of the target application
General flow settingEnable URL encoding of data in endpoints
General flow settingForce the usage of the default administration id
General flow settingThis setting has no effect for Jortt. Jortt has no administration field and the standard data mapping to Jortt does not send an administration, so there is nothing to force. You can leave it off. Off by default.
Make use of a default administration id
General flow settingThis setting has no effect for Jortt, because Jortt has no administration field and the standard data mapping to Jortt does not send an administration. Leave it off: when you turn it on without a value in Default administration id, sending orders stops with an error. Off by default.
Use administration mapping table
General flow settingThis setting has no effect for Jortt. The data that APIcenter exchanges with Jortt has no administration field, so there is nothing to map. Leave it off (default).
What to do with a value that cannot be mapped using the mapping table
General flow settingDecides what happens when the administration mapping table has no row for a value from the incoming data.
- Use default (default): APIcenter uses Default administration id, if that default is switched on; otherwise the field stays empty.
- Use value: the original value is passed on unchanged.
- Ignore value: the field stays empty.
This has no effect for Jortt, because the data that APIcenter exchanges with Jortt has no administration field.
Default customer sales vat code id
Ledger SettingsThis setting has no effect for Jortt. Jortt has no sales VAT code field on customers and the standard data mapping to Jortt does not send one, so you can leave this field empty. The VAT percentage of an invoice line comes from the amounts of the order.
Enable the use of a default customer sales vat code id
Ledger SettingsThis setting has no effect for Jortt, because Jortt has no sales VAT code field on customers and the standard data mapping to Jortt does not send one. Leave it off: when you turn it on without a value in Default customer sales vat code id, sending orders and customers stops with an error. Off by default.
Force the usage of the customer sales vat code id
Ledger SettingsThis setting has no effect for Jortt. Jortt has no sales VAT code field on customers and the standard data mapping to Jortt does not send one, so there is nothing to force. You can leave it off. Off by default.
Use default customer sales vat code id mapping table
Ledger SettingsThis setting has no effect for Jortt in the standard configuration. The standard data mapping does not send a customer sales VAT code to Jortt, so there is nothing to map. Leave it off (default).
Decides what happens when the customer sales VAT code mapping table has no row for a value from the incoming data.
- Use default (default): APIcenter uses Default customer sales vat code id, if that default is switched on; otherwise the field stays empty.
- Use value: the original value is passed on unchanged.
- Ignore value: the field stays empty.
This has no effect for Jortt in the standard configuration, because the standard data mapping does not send a customer sales VAT code to Jortt.
Notifications Email address
NotificationsNotifications Slack webhook
NotificationsNotifications frequency
NotificationsReceive Notifications
NotificationsAdd order line for billing costs
Order SettingsAdd order line for commission
Order SettingsAdd order line for payment costs
Order SettingsDefault item code for Payment Costs
Order SettingsThe code APIcenter puts on the extra order line for payment costs. This field is required when Add order line for payment costs is on; without it the order fails with an error. Jortt does not use item codes and APIcenter does not look this code up in Jortt. The code is only used as the description of the line when you leave Description to use for the order line for payment costs empty.
Default item code for billing costs
Order SettingsThe code APIcenter puts on the extra order line for billing costs. This field is required when Add order line for billing costs is on; without it the order fails with an error. Jortt does not use item codes and APIcenter does not look this code up in Jortt. The code is only used as the description of the line when you leave Description to use for the order line for billing costs empty.
Default item code for commission
Order SettingsThe code APIcenter puts on the extra order line for commission. This field is required when Add order line for commission is on; without it the order fails with an error. Jortt does not use item codes and APIcenter does not look this code up in Jortt. The code is only used as the description of the line when you leave Description to use for the order line for commission empty.
Default item code to use for shipping cost order line
Order SettingsThe code APIcenter puts on the extra order line for shipping costs. This field is required when Require order line for shipping costs is on; without it the order fails with an error. Jortt does not use item codes and APIcenter does not look this code up in Jortt. The code is only used as the description of the line when you leave Description to use for the order line for shipping costs empty.
Default order prefix
Order SettingsText that APIcenter places in front of the order number, for example WEB- turns order 1001 into WEB-1001. This helps you recognise orders from a specific source in Jortt, or keep order numbers unique when you have several stores. The prefix is only added when the data mapping of the order number uses the micro-function for the order prefix; the standard data mapping to Jortt does not use it.
Default order suffix
Order SettingsText that APIcenter adds to the end of the order number, for example -NL turns order 1001 into 1001-NL. This helps you recognise orders from a specific source in Jortt, or keep order numbers unique when you have several stores. The suffix is only added when the data mapping of the order number uses the micro-function for the order suffix; the standard data mapping to Jortt does not use it.
Default tax class id for billing costs order line
Order SettingsThis setting has no effect with the standard data mapping to Jortt. The VAT percentage of the extra invoice line for billing costs comes from the amounts of the order. When the percentage cannot be determined, APIcenter uses Default tax rate billing costs. The tax class is only used when you map it yourself in the data mapping of the flow.
Default tax class id for commission order line
Order SettingsThis setting has no effect with the standard data mapping to Jortt. The VAT percentage of the extra invoice line for commission comes from the amounts of the order. When the percentage cannot be determined, APIcenter uses Default tax rate commission. The tax class is only used when you map it yourself in the data mapping of the flow.
Default tax class id for payment fee order line
Order SettingsThis setting has no effect with the standard data mapping to Jortt. The VAT percentage of the extra invoice line for payment costs comes from the amounts of the order. When the percentage cannot be determined, APIcenter uses Default tax rate payment costs. The tax class is only used when you map it yourself in the data mapping of the flow.
Default tax class id for shipping costs order line
Order SettingsThis setting has no effect with the standard data mapping to Jortt. The VAT percentage of the extra invoice line for shipping costs comes from the amounts of the order. When the percentage cannot be determined, APIcenter uses Default tax rate prices. The tax class is only used when you map it yourself in the data mapping of the flow.
Description to use for the order line for billing costs
Order SettingsThe text APIcenter puts on the extra invoice line for billing costs, for example Invoice costs. If you leave it empty, APIcenter uses the item code from Default item code for billing costs as the description of the line. Jortt needs a description on every invoice line.
Description to use for the order line for commission
Order SettingsThe text APIcenter puts on the extra invoice line for commission, for example Commission. If you leave it empty, APIcenter uses the item code from Default item code for commission as the description of the line. Jortt needs a description on every invoice line.
Description to use for the order line for payment costs
Order SettingsThe text APIcenter puts on the extra invoice line for payment costs, for example Payment costs. If you leave it empty, APIcenter uses the item code from Default item code for Payment Costs as the description of the line. Jortt needs a description on every invoice line.
Description to use for the order line for shipping costs
Order SettingsThe text APIcenter puts on the extra invoice line for shipping costs, for example Shipping costs. If you leave it empty, APIcenter uses the item code from Default item code to use for shipping cost order line as the description of the line. Jortt needs a description on every invoice line.
Require order line for shipping costs
Order SettingsSend Order as
Order SettingsDetermines what APIcenter creates in Jortt for each incoming order. Jortt only supports Sales Invoice (default), so leave it on that value. With any other choice the Send Sales Order flow fails with an error saying that Jortt only supports sending orders as Sales Invoice.
Skip negativity flip process
Product SettingsMaximum number of pages to retrieve
Run behaviourThe maximum number of pages APIcenter reads when it repeats a request to get a list in several pages. The Jortt flows read one page of customers or invoices per run (see Offset), so this setting has no practical effect for Jortt. The default is 20; you do not need to change it.
Use page size
Run behaviourThe number of records per page when APIcenter requests a list in several pages. The requests that the Jortt flows send for customers and invoices do not contain a page size, so this setting has no practical effect for Jortt. The default is 50; you do not need to change it.
Enable the use of a default shipping method
Shipment SettingsThis setting has no effect for Jortt. The data that APIcenter sends to Jortt for an order has no shipping method field. To get shipping costs on the Jortt invoice, use Require order line for shipping costs instead. Leave this setting off (default).
Force the use of the default shipping method
Shipment SettingsThis setting has no effect for Jortt. The data that APIcenter sends to Jortt for an order has no shipping method field, and the standard data mapping does not send one. Leave it off (default).
Use a mapping table to map shipping methods
Shipment SettingsThis setting has no effect for Jortt. The data that APIcenter sends to Jortt for an order has no shipping method field, so there is nothing to map. Leave it off (default).
Value to use as the default shipping method id
Shipment SettingsThis setting has no effect for Jortt. The data that APIcenter sends to Jortt for an order has no shipping method field, so this value is not used. Leave the field empty (default).
What to do with a value that cannot be mapped using the mapping table
Shipment SettingsDecides what happens when the shipping method mapping table has no row for a value from the incoming data.
- Use default (default): APIcenter uses Value to use as the default shipping method id, if that default is switched on; otherwise the field stays empty.
- Use value: the original value is passed on unchanged.
- Ignore value: the field stays empty.
This has no effect for Jortt, because the data that APIcenter sends to Jortt for an order has no shipping method field.
Enable the use of a default warehouse
Stock & Warehouse SettingsThis setting has no effect for Jortt. The data that APIcenter exchanges with Jortt has no warehouse field, so there is nothing to apply a default warehouse to. Leave it off (default).
Force the usage of the default warehouse
Stock & Warehouse SettingsThis setting has no effect for Jortt. The data that APIcenter exchanges with Jortt has no warehouse field, so there is nothing to apply a default warehouse to. Leave it off (default).
Use warehouse mapping table
Stock & Warehouse SettingsThis setting has no effect for Jortt. The data that APIcenter exchanges with Jortt has no warehouse field, so there is nothing to map. Leave it off (default).
Value for the default warehouse id
Stock & Warehouse SettingsThis setting has no effect for Jortt. The data that APIcenter exchanges with Jortt has no warehouse field, so this value is not used. Leave the field empty (default).
What to do with a value that cannot be mapped using the mapping table
Stock & Warehouse SettingsDecides what happens when the warehouse mapping table has no row for a value from the incoming data.
- Use default (default): APIcenter uses Value for the default warehouse id, if the default warehouse is switched on; otherwise the field stays empty.
- Use value: the original value is passed on unchanged.
- Ignore value: the field stays empty.
This has no effect for Jortt, because the data that APIcenter exchanges with Jortt has no warehouse field.
Enable the use of a default tax id
Tax & Tax RatesThis setting has no effect for Jortt in the standard configuration. Jortt gets the VAT percentage of each order line, not a tax class (VAT code), and the standard data mapping does not send a tax class. Leave it off (default).
Force the use of the default tax id
Tax & Tax RatesThis setting has no effect for Jortt in the standard configuration. Jortt gets the VAT percentage of each order line, not a tax class (VAT code), and the standard data mapping does not send a tax class. Leave it off (default).
Use default tax id mapping table
Tax & Tax RatesThis setting has no effect for Jortt in the standard configuration. Jortt gets the VAT percentage of each order line, not a tax class (VAT code), and the standard data mapping does not send a tax class, so there is nothing to map. Leave it off (default).
Value for the default tax id (exclude '%')
Tax & Tax RatesThis setting has no effect for Jortt in the standard configuration. Jortt gets the VAT percentage of each order line (rounded to a whole number), not a tax class (VAT code), and the standard data mapping does not send a tax class. Leave the field empty (default).
Decides what happens when the VAT mapping table has no row for a value from the incoming data.
- Use default: APIcenter uses Value for the default tax id (exclude '%'), if that default is switched on; otherwise the field stays empty.
- Use value: the original value is passed on unchanged.
- Ignore value (default): the field stays empty.
This has no effect for Jortt in the standard configuration, because the standard data mapping does not send a tax class to Jortt.