Skip to main content

Integrating with your ERP

A customer's checkout has been risk reivewed and approved, and your servers are listening for topi's webhooks. Now what? How is the order going to be placed in your Enterprise Resource Planning (ERP) or other systems?

Order placement flow​

Here is the a flow chart that you could use as reference:

From order placed in topi to order placed in your ERP

Who is your customer?​

Once an order confirmation arrives from topi to your systems, you'll be confronted with an important question: who exactly is your customer? Is it the business buying your products, or is it topi?

From a legal perspective, topi Asset GmbH is your customer. The customer who placed the order -- let's call them "end customer" in this page for clarity -- has a rental contract with topi.

However, we strongly recommend that you record topi only as the payment method to the offer and later to the order in your system. The "customer" in all your systems should remain the "end customer" for 2 key reasons:

  • Maintain full customer sovereignty, as your customers are exclusively yours, with topi serving as the financing provider for the rental.
  • Retain the ability to analyze customer performance comprehensively. Assigning all offers and orders originating from topi to topi would hinder your ability to conduct essential customer analyses.

The customer in your ERP​

  • An offer and/or order is created in your ERP system, e.g. SAP or Microsoft Navvision
    • The end customer remains in your system
    • The purchased devices are associated with this end customer profile in your system
    • There are 3 specific adjustments needed:
      • topi as the billing address - this is always the same
      • topi is set as the payment method linked to the offer in the ERP system
      • A field in which you save the topi offer id. The offer id is communicated to you in the response to the create Offer API call.
        • The format is as follows: 00k17036-a789-4acb-a603-7k131j092efl
  • Upon successful completion:
    • The goods are dispatched to the end customer
    • The invoice is sent to topi
  • This results in:
    • Invoice recipient (Rechnungsempfänger) = topi Asset GmbH
    • Recipient of goods (Warenempfänger) = end customer
    • Client (Auftrageber) = end customer
    • Payer (Auftrageber) = topi Asset GmbH

The customer in your ecommerce store​

Following the outlined logic in the ERP system section, the customer transaction should be accessible and visible within your customer's "My Account," "My Profile," or equivalent section, ensuring a transparent overview of their orders and interactions.