> For the complete documentation index, see [llms.txt](https://docs.ziosync.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ziosync.com/handleidingen/paypal.md).

# Installatiehandleiding PayPal - Exact Online

{% embed url="<https://www.youtube.com/watch?v=TU109ZZb9Gg>" %}

In deze installatiehandleiding wordt stap-voor-stap uitgelegd hoe de ZioSync koppeling voor PayPal kan worden ingesteld.

{% hint style="info" icon="circle-question" %}
Mocht je naar aanleiding van deze uitleg nog vragen hebben of wil je gebruikmaken van de gratis instelservice, neem dan [contact op met ons support team](https://www.ziosync.com/contact/).
{% endhint %}

### Connecties Exact Online en PayPal

Ga naar de app store, kies de [PayPal integratie](https://www.ziosync.com/app-store/paypal/) en klik op **Installeren**. Nu moeten Exact Online en PayPal met de ZioSync koppeling worden verbonden.

{% stepper %}
{% step %}

#### PayPal verbinden met ZioSync

Ga naar het dashboard in ZioSync en navigeer in de toolbar aan de linkerzijde naar de sectie **Mijn Integraties**. Klik daar op de [PayPal koppeling](https://www.ziosync.com/blog/paypal-exact-online-koppeling/) en ga naar **PayPal** onder het kopje **Connecties** aan de linkerzijde. Vervolgens moeten er in PayPal een aantal stappen worden doorlopen:

<details>

<summary><strong>Stap 1:</strong> Log in bij PayPal</summary>

Navigeer [hier](https://developer.paypal.com/) naar je PayPal ontwikkelaars dashboard en log in met het PayPal account dat je wilt koppelen.

<figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FuQu9bpp8ruD3sIj3iOfK%2FloginButton.gif?alt=media&amp;token=97fb9de6-51a1-42d5-9c2f-a3d67faa9920" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Stap 2:</strong> Activeer de <strong>Live</strong> knop</summary>

In het PayPal dashboard zie je de knop **Live**, zorg dat deze aan staat.

<figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FlY7Jeuvp12ejN2oqi6NR%2FenableLiveMode.gif?alt=media&amp;token=27e4d5a3-dc75-407e-9acf-a89fc61bf091" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Stap 3:</strong> Maak een app aan</summary>

Klik op **Create app**, en vul bij app name **ZioSync** in. Klik op de **Create app** knop en je client-ID is geregistreerd.

<figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FbwmwvUhYK6S7FPgvq8DX%2FcreateApp.gif?alt=media&amp;token=8d9477e7-eab2-4555-9424-bdf4d462cb20" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Stap 4:</strong> Sla Client-ID en Client-secret op</summary>

Klik op **Show** bij je **Client-ID** en **Client-secret**. De codes zijn nu zichtbaar, sla deze tijdelijk op, deze heb je later nodig.

<figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FEqHV7y3pSWweHdp4es8h%2FshowKeys.gif?alt=media&amp;token=247d8980-57f0-4c58-88c0-8ecb6f9ea5c4" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Stap 5:</strong> Activeer Transaction search in de instellingen</summary>

Scroll op de PayPal pagina naar beneden om de **Transaction search** aan te vinken in de instellingen, dit is een belangrijke stap om de transacties te kunnen importeren.

<figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FVNl8YjpoCHZ7fdW5gwjP%2FchangeSettings.gif?alt=media&amp;token=a51f012f-eb1a-4d3b-99b5-ceb6bccf6881" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Stap 6:</strong> Vul Client-ID en Client-secret in in ZioSync</summary>

Ga naar het ZioSync dashboard, klik op **PayPal verbinden** en vul de twee codes in.

<figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2Fguh8jZ0wUzhLqnrf4Z2x%2FPayPal%20handleiding%20stap%206.gif?alt=media&amp;token=6d2f1203-1717-42dd-bad4-945f2c9100b9" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>Stap 7:</strong> Verbind PayPal met ZioSync</summary>

Als laatste stap klik je op **Configuratie opslaan**, waarna de verbinding wordt gecontroleerd.

<figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2Fdv1IVz4Zor3v2cl3qFxI%2FPayPal%20handleiding%20stap%207.gif?alt=media&amp;token=2af886a4-2a47-41e2-b857-9935eb7838ea" alt=""><figcaption></figcaption></figure>

</details>

{% hint style="warning" %}
Als je problemen ondervindt, controleer dan of de applicatie daadwerkelijk in live mode staat in je PayPal dashboard. Neem bij vragen gerust contact op met onze support afdeling via <support@ziosync.com>.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FqqBhpuS3iprChwjjBBdD%2F3.2%20Paypal%20secret%20ID%20ingevuld%20(blurred).png?alt=media&amp;token=6467472b-9e86-45c7-932b-80e61237d74b" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Exact Online verbinden met ZioSync

Als PayPal is verbonden met ZioSync, ga je naar de sectie **Exact Online** en klik je op **Exact Online Verbinden**. Log in bij Exact Online en de verbinding met ZioSync wordt automatisch gemaakt.

{% hint style="warning" %}
**Let op!** Heb je meerdere administraties? Selecteer dan de administratie waar je de PayPal transacties naartoe wilt exporteren en waar je openstaande posten staan.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FTj9bUW8PGY0hGILXkskJ%2F5.%20Exact%20Online%20verbinden%20met%20ZioSync%20(blurred).png?alt=media&amp;token=7c8908b5-c407-451a-9dea-2ab20fb83e8e" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### Instellingen PayPal koppeling <a href="#heading-h.xga2k1oal2g8" id="heading-h.xga2k1oal2g8"></a>

{% stepper %}
{% step %}

#### PayPal

In deze sectie kun je kiezen vanaf wanneer je de transacties vanuit PayPal wil importeren. Ook kun je hier selecteren welke referentie gebruikt moet worden om te matchen met de openstaande posten van Exact Online:

* **Beschrijving:** De referentie van de transactie in de beschrijving.
* **Paypal ID (PSP):** De ID die PayPal aan de transactie geeft als referentie.

Als er op de PayPal rekening transacties plaatsvinden in meerdere valuta selecteer je in deze sectie ook de grootboekrekening voor de koersverschillen.

<div data-with-frame="true"><figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FxyiyLZ45uYMooEgq8WX5%2F6.2%20paypal%20instellingen%20gemaakt.png?alt=media&amp;token=0f124c32-1de6-483b-9e92-f8e594788522" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Exact Online

Bij de Exact Online instellingen koppel je de juiste grootboekrekeningen vanuit de financiële administratie aan de betreffende posten. Er dient voor alle posten een rekening en / of dagboek geselecteerd te worden.

<details>

<summary><strong>Instellingen</strong></summary>

* **Grootboekrekening betaalkosten:** Op deze grootboekrekening worden de betaalkosten van PayPal geboekt.
* **Grootboekrekening betalingsverschillen:** Op deze rekening wordt het eventuele betalingsverschil tussen de webshoporder en de betaling via PayPal geboekt.
* **Grootboekrekening chargebacks:** Op deze rekening worden eventuele disputen / chargebacks geboekt die via de payment provider zijn gedaan.
* **Grootboekrekening refunds:** Op deze grootboekrekening worden eventuele refunds / retouren geboekt.
* **Grootboekrekening kruisposten:** Op deze rekening worden de periodieke betalingen vanuit PayPal naar de bankrekening geboekt.
* **Bankboek aflettermodule:** Hiervoor moet het dagboek geselecteerd worden waarop de boekingen gemaakt moeten worden.
* **Automatisch boeken wanneer volledig gematcht:** Als voor alle binnenkomende betalingen een match is gevonden, wordt automatisch de batch geboekt naar Exact Online. Je kunt hier kiezen voor **Ja** of **Nee**.
* **Openstaande posten referentie locatie:** Dit betreft de referentiekolom waarmee de match gemaakt wordt met de verkooporder vanuit de webshop. Als er gebruik wordt gemaakt van een van onze webshop koppelingen, dan staat de referentiepost standaard op **Uw referentie**. Als je niet zeker weet waar de referentie zich bevindt, neem dan contact op met onze supportafdeling.

</details>

<details>

<summary><strong>Geavanceerde instellingen</strong></summary>

* **Grootboekrekening debiteuren (fallback):** Deze grootboekrekening wordt als tegenrekening gebruikt wanneer een openstaande post geboekt is in een dagboek zonder tegenrekening. Deze instelling is **optioneel**.
* **Administratie voor wisselkoersen:** Hier kun je een andere administratie selecteren waaruit wisselkoersen worden opgehaald, bijvoorbeeld als je koersen centraal in één administratie beheert. Deze instelling is **optioneel.**

</details>

<div data-with-frame="true"><figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FOp7AiHIsqmZqCTlyyH6E%2F8.%20Paypal%20instellingen%20akkoord.png?alt=media&amp;token=a75d6743-962d-496d-a993-4b6a0c18001f" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Add-ons toevoegen (optioneel)

Het is mogelijk om add-ons toe te voegen aan de koppeling. Ga hiervoor naar **Overzicht** **> Add-ons** en klik op **Add-ons Bewerken / Toevoegen**.

<details>

<summary><strong>Add-ons</strong></summary>

**Niet-Gematchte Transacties Boeken:** Het kan voorkomen dat niet voor alle transacties van PayPal een openstaande post in Exact Online gevonden kan worden. Als je toch wilt dat deze transacties geboekt worden naar Exact Online, kun je deze add-on toevoegen.

Selecteer bij de instellingensectie van de add-ons de grootboekrekening, en kies of je wel of niet deels-gematchte synchronisaties automatisch wilt boeken. Bij **Ja**, kies dan ook hoeveel dagen we moeten wachten totdat automatisch boeken wordt uitgevoerd. Kies voor **0 dagen** als je wilt dat niet-gematchte transacties direct zonder wachttijd worden geboekt. &#x20;

{% hint style="info" %}
Deze add-on moet in ieder geval worden toegevoegd als er ook betalingen worden gedaan via PayPal. Anders worden deze transacties niet opgenomen in de administratie.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FVf9T2iJzLzOu8YEj2tkk%2Fimage%20(33).png?alt=media&amp;token=932b2543-3e36-4a29-8373-b7bd64a541de" alt=""><figcaption></figcaption></figure></div>

**Openstaande Posten Beschrijvingen Filteren:** Met deze add-on kunnen openstaande posten gefilterd worden op basis van de beschrijving. Dit helpt bij het identificeren van specifieke transacties en het verbeteren van de nauwkeurigheid van de boekhouding. Je krijgt hiermee meer controle over de referentie die gebruikt wordt bij het matchen van openstaande posten.

Je kunt meerdere filters instellen (maximaal 20). Elk filter moet ten minste een van de volgende variabelen bevatten: {referentie}, {orderId}, {transactionId} of {?} - dit is een wildcard teken om tekst weg te filteren. Elke openstaande post wordt met elk filter geprobeerd; de referentie wordt overgenomen uit ieder filter dat op de beschrijving past.

{% hint style="warning" %}
Dit is een geavanceerde add-on. Neem bij twijfel contact op met onze support afdeling.
{% endhint %}

**Achteraf importeren:** Hiermee kun je PayPal transacties met terugwerkende kracht importeren in je boekhouding in Exact Online.

**Matchen op Meerdere Referentievelden:** Met deze add-on kunnen openstaande posten op meerdere referentievelden tegelijk worden gematcht, in een zelfgekozen prioriteitsvolgorde. Zo worden ook betalingen gematcht waarvan de referentie per factuur in een ander veld staat.

**Deelbetalingen Matchen:** Met deze add-on koppel je meerdere transacties aan één openstaande post, zodat een factuur die in delen is betaald toch in één keer wordt afgeletterd. Stel zelf het geaccepteerde afrondingsverschil in, zodat een post van een paar cent niet blijft openstaan.

</details>
{% endstep %}

{% step %}

#### Koppeling inschakelen

Nu zijn alle stappen doorlopen en kan de PayPal koppeling worden aangezet. Ga terug naar het overzicht en controleer of PayPal en Exact Online verbonden zijn. Wanneer beide groen zijn, kan de koppeling worden aangezet. Klik hiervoor op **Inschakelen**.&#x20;
{% endstep %}

{% step %}

#### Uitbetalingen

Nadat de koppeling is ingeschakeld, start deze direct met het importeren van PayPal betalingsbestanden om te matchen met openstaande posten. Als je op een geïmporteerde uitbetaling klikt, kun je meer inzien over deze transactie.&#x20;

<details>

<summary><strong>Transactiedetails</strong></summary>

* Logs
* Progressie
* Status
* Kosten en kruisposten
* Refunds en chargebacks
* Betalingen
* Opties: synchronisaties overslaan en uitbetalingen boeken

</details>

<div data-with-frame="true"><figure><img src="https://1476898082-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7NsTwz3P0RDRFCEEkz8v%2Fuploads%2FU16EDp4I85YTULofHlHv%2FUitbetalingen%20Paypal%20voorbeeld.png?alt=media&amp;token=00e17eb0-4d62-4506-ab8f-b8dc7eea4645" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### Samenvattende checklist <a href="#heading-h.76gsv06q1s7a" id="heading-h.76gsv06q1s7a"></a>

* [ ] PayPal verbinden met ZioSync
* [ ] Exact Online verbinden met ZioSync
* [ ] PayPal instellingen personaliseren
* [ ] Exact Online instellingen personaliseren
* [ ] Add-ons toevoegen (optioneel)