JTL WaWi - Configuration guide

Update payment method titles

To have the ability to see on the JTL Wawi side a proper Net Term value for the "Rechnungskauf - jetzt kaufen, später bezahlen" payment method, it's nice to update on the JTL side the "Displayed name (German)" field, and include the Net Term value to the "Displayed name", e.g., for the 14 Tagen the "Displayed name" could be "Rechnungskauf - jetzt kaufen, später bezahlen (14 Tagen)"

You must repeat the same action for all Mondu Payment Methods containing the Net Term field.

Add Payment Methods

  1. Navigate to the Payments -> Payment Methods in JTL Wawi
  2. Add the following payment methods:
Rechnungskauf - jetzt kaufen, später bezahlen (14 Tagen) 
Rechnungskauf - jetzt kaufen, später bezahlen (30 Tagen) 
Rechnungskauf - jetzt kaufen, später bezahlen (45 Tagen) 
Rechnungskauf - jetzt kaufen, später bezahlen (60 Tagen) 
Rechnungskauf - jetzt kaufen, später bezahlen (90 Tagen) 
SEPA-Lastschrift - jetzt kaufen, später per Bankeinzug bezahlen (14 Tagen) 
SEPA-Lastschrift - jetzt kaufen, später per Bankeinzug bezahlen (30 Tagen) 
SEPA-Lastschrift - jetzt kaufen, später per Bankeinzug bezahlen (45 Tagen) 
SEPA-Lastschrift - jetzt kaufen, später per Bankeinzug bezahlen (60 Tagen) 
SEPA-Lastschrift - jetzt kaufen, später per Bankeinzug bezahlen (90 Tagen)
Ratenzahlung - Bequem in Raten per Bankeinzug zahlen

Note: In case Payment Method names are changed manually in the JTL Shop, please update accordingly in the JTL Wawi.

Create Invoice Workflow

  1. Navigate to the Admin -> JTL-Workflows
  2. Select Rechnungen tab
  3. Select Rechnungen -> Erstellt -> Rechnungen_Erstellt workflow
  4. Configure condition with "One condition met" (Eine Bedingung erfüllt")
    1. Rechnungen\Auftrag\Zahlungsart\Name Enthält Rechnungskauf - jetzt kaufen, später bezahlen (14 Tagen) (you need to repeat this for all Net Terms options)
    2. Rechnungen\Auftrag\Zahlungsart\Name Enthält SEPA-Lastschrift - jetzt kaufen, später per Bankeinzug bezahlen (14 Tagen) (you need to repeat this for all Net Terms options)
    3. Rechnungen\Auftrag\Zahlungsart\Name Enthält Ratenzahlung - Bequem in Raten per Bankeinzug zahlen
  5. Configure action
    1. Web-Request POST:
      1. URL:
        http://{SHOP-URL}/mondu-api?return=invoice-create&webhooks_secret={WEBHOOK SECRET}
        
      2. Parameter:
        gross_amount_cents={{ Vorgang.Auftrag.Positionen.BruttopreisGesamt2 }}&net_amount_cents={{ Vorgang.Auftrag.Positionen.NettopreisGesamt2 }}&invoice_id={{ Vorgang.Rechnungsnummer }}&order_id={{ Vorgang.Auftrag.ExterneAuftragsnummer }}
        
      3. Header:
        Content-Type: application/x-www-form-urlencoded
        

👍

Web-Request

Please make sure, that you click to the three dots and paste the data for the URL, Parameter and Header manualy.

📘

Parameters

Make sure the invoice_id parameter is assigned to the variable that holds the invoide ID printed on the invoice sent to the buyer. i.e

  • „Vorgang.Rechnungsnummer“
  • „Vorgang.InterneRechnungsnummer“

📘

Your Webhook Secret

Don't know your webhook secret yet? Contact us at [email protected]!

Cancel Invoice Workflow

  1. Navigate to the Admin -> JTL-Workflows
  2. Select Rechnungen tab
  3. Select Rechnungen - Manuell, create new Event with "Ereignis anlegen" button
  4. Create new event
  5. Configure condition with "One condition met" (Eine Bedingung erfüllt")
    1. Auftrag\Zahlungsart\Name Enthält Rechnungskauf - jetzt kaufen, später bezahlen (14 Tagen) (you need to repeat this for all Net Terms options)
    2. Auftrag\Zahlungsart\Name Enthält SEPA-Lastschrift - jetzt kaufen, später per Bankeinzug bezahlen (14 Tagen) (you need to repeat this for all Net Terms options)
    3. Auftrag\Zahlungsart\Name Enthält Ratenzahlung - Bequem in Raten per Bankeinzug zahlen
  6. Configure action
    1. Web-Request POST:
      1. URL:
        http://{SHOP-URL}/mondu-api?return=cancel-invoice&webhooks_secret={WEBHOOK SECRET}
        
      2. Parameter:
        invoice_number={{ Vorgang.Rechnungsnummer }}
        
      3. Header:
        Content-Type: application/x-www-form-urlencoded
        

Cancel Order Workflow

  1. Navigate to the Admin -> JTL-Workflows
  2. Select Aufträge tab
  3. Select Auftrag -> Storniert and create a workflow
    1. Configure condition with "One condition met" (Eine Bedingung erfüllt")
    2. Zahlungen\Zahlungsart\Name Enthält Rechnungskauf - jetzt kaufen, später bezahlen (14 Tagen) (you need to repeat this for all Net Terms options)
    3. Zahlungen\Zahlungsart\Name Enthält SEPA-Lastschrift - jetzt kaufen, später per Bankeinzug bezahlen (14 Tagen) (you need to repeat this for all Net Terms options)
    4. Zahlungen\Zahlungsart\Name Enthält Ratenzahlung - Bequem in Raten per Bankeinzug zahlen
  4. Configure action
    1. Web-Request POST:
      1. URL:
        http://{SHOP-URL}/mondu-api?return=cancel-order&webhooks_secret={WEBHOOK SECRET}
        
      2. Parameter:
        order_number={{ Vorgang.Stammdaten.ExterneAuftragsnummer }}
        
      3. Header:
        Content-Type: application/x-www-form-urlencoded
        

Configure Invoice Template

  1. Navigate to the Admin -> Druck-/ E-Mail-/ Exportvorlagen

  2. Choose under Root the item Rechnung and click Bearbeiten to edit invoice template

  3. Under Payment blocks, copy any of the payment block and then paste it under payment blocks table

  4. Change the name to Payment with Mondu Invoice

    1. Right-click on the block Payment with Mondu Invoice and choose "Edit element or block"

    2. Change the block structure to match the one in the screenshot

    3. Copy the text below and change the values as needed. The text will be available here.

      "Diese Rechnung wurde abgetreten gemäß den Allgemeinen Bedingungen von [MERCHANT] und Mondu GmbH zum Modell Kauf auf Rechnung. Wir bitten um schuldbefreiende Zahlung auf folgendes Konto:
      
      Kontoinhaber: Mondu Capital Sàrl
      
      IBAN:
      " + If(Report.InvoiceBillToAddress.CountryISO= "DE","DE_IBAN","") + " +
      " + If(Report.InvoiceBillToAddress.CountryISO= "NL","NL_IBAN","") + "
      
      BIC: HYVEDEMME40
      
      Verwendungszweck: " + Report.InvoiceNumber + "
      
      Zahlungsziel: " + Report.PaymentMethodName
      

    And the result of the invoice template will be like this:

  1. Repeat these steps for the payment methods Instalment and SEPA. Please refer to this page for the invoice snippet texts.