Odoo

Odoo-koppeling in Tillor exporteert klanten (res.partner) en geboekte facturen (account.move, type klantenfactuur). Betalingsrapporten naar Odoo volgen in een latere release; gebruik tot die tijd Admisol als je betalingsrapporten automatisch wilt doorsturen.

Installatie

1. Ga naar Instellingen en open de App Marketplace.
2. Zoek de Odoo-kaart en klik op Installeren.
3. Vul eerst in onder Verbinding:
   • Odoo-URL - bijvoorbeeld https://mijnbedrijf.odoo.com of alleen mijnbedrijf (Tillor vult dan de .odoo.com-URL aan)
   • Gebruikersnaam - gebruiker met API-toegang
   • API-sleutel - API-sleutel (Odoo: gebruikersprofiel > API-sleutels)
4. Klik op Doorgaan naar database. Tillor haalt beschikbare databases op (of laat u de naam handmatig invullen).
5. Kies de database onder Database en voltooi de installatie.

Bij opslaan test Tillor de verbinding.

Boekhoudparameters (Odoo-app)

Na installatie stel je exportparameters in via Instellingen op de Odoo-app (naast URL, database, gebruiker en API-sleutel). Tillor haalt verkoopdagboeken en omzetrekeningen live uit Odoo; je kiest ze via een zoekveld (code en naam).

Tillor zoekt per factuurregel eerst een account.account met code gelijk aan het ledger-veld van de regel; anders de standaard omzetrekening. BTW: account.tax met type sale en hetzelfde percentage als op de regel.

Factuur-PDF in Odoo

Met attachInvoicePdf (standaard aan) uploadt Tillor dezelfde PDF als in Tillor (blobopslag of opnieuw gegenereerd indien nodig). Bij een nieuwe export gebeurt dat vóór het boeken in Odoo, zodat de voorvertoning rechts op de factuur kan worden gekoppeld. Het bestand komt in Odoo als bijlage op de factuur (ir.attachment, gekoppeld aan account.move). De bestandsnaam is afgeleid van het Tillor-factuurnummer (bijv. INV_2026_0001.pdf). Tillor zet de bijlage ook als hoofdbijlage (message_main_attachment_id).

In het activiteitenlog op de Tillor-factuur staat één JSON-bijlage met alle exportstappen: klant (res.partner create/write), factuur (account.move create/write en eventueel button_draft, action_post), PDF (ir.attachment create/write) en UBL (ir.attachment create/write) wanneer die zijn geüpload.

• Bestaat de Odoo-factuur al (zelfde ref), dan werkt Tillor klant, factuurregels, datums en betalingsreferentie bij op die Odoo-factuur. Was de factuur al geboekt in Odoo, dan zet Tillor ze eerst terug naar concept, past de gegevens aan en boekt opnieuw wanneer autoPostInvoices aan staat of de factuur al geboekt was.
• Daarna worden PDF- en UBL-bijlagen vervangen of toegevoegd wanneer attachInvoicePdf / attachInvoiceUbl aan staan.
• Mislukt het uploaden na een nieuw aangemaakte conceptfactuur, dan wordt die Odoo-factuur verwijderd zodat een volgende export opnieuw kan proberen.

Peppol UBL in Odoo

Met attachInvoiceUbl (standaard aan) uploadt Tillor de Peppol-UBL-XML uit blobopslag als extra bijlage op de Odoo-factuur (ir.attachment, application/xml). De bestandsnaam volgt het Tillor-factuurnummer (bijv. INV_2026_0001.xml).

• Tillor genereert zelf geen UBL: het bestand komt pas beschikbaar na een geslaagde Peppol-levering (sync van het netwerk-UBL naar blobopslag).
• Staat de UBL nog niet klaar op het moment van export, dan slaat Tillor de UBL-bijlage over; zodra de UBL binnenkomt, wordt ze alsnog op de bestaande Odoo-factuur gezet.
• Mislukt het UBL-uploaden, dan faalt de hele Odoo-export niet (in tegenstelling tot de PDF). Alleen een PDF-fout na een nieuwe factuur rolt het Odoo-concept terug.

Facturen

• Bij boeken of herboeken van een factuur wordt een achtergrondtaak gestart (send-invoice-to-accounting).
• Handmatig: factuuracties > export naar boekhouding (zelfde knop als bij Admisol).
• Alleen facturen met status Geboekt worden geëxporteerd.
• Bestaat er al een Odoo-factuur met dezelfde ref (Tillor displayId), dan wordt geen tweede factuur aangemaakt. Tillor werkt klant, regels en datums op die factuur bij (bijvoorbeeld na verplaatsen naar een andere klant of herboeken) en vervangt PDF/UBL-bijlagen wanneer attachInvoicePdf / attachInvoiceUbl aan staan.
• Wijzigt het factuur-PDF na een betaling (of ander bedrag op het document), dan vervangt Tillor de bestaande PDF-bijlage in Odoo zodra het nieuwe PDF klaar is. Er komt geen tweede Odoo-factuur en er wordt geen betaling in Odoo geboekt.

Klanten

Klanten worden gesynchroniseerd als res.partner met ref = Tillor klantnummer (displayId). Bestaande partners met dezelfde ref worden bijgewerkt.

Betalingsrapporten

Automatisch en handmatig versturen van betalingsrapporten naar Odoo is nog niet beschikbaar. Het dagelijkse betalingsrapport-proces slaat Odoo over zonder foutmelding.

Vereisten in Odoo

• Verkoopdagboek met de ingestelde code (standaard INV)
• G/L-rekeningen met codes die overeenkomen met Tillor-regels of de standaard omzetrekening
• Optioneel: BTW-tarieven als percentage (sale), passend bij validTaxPercentages van de organisatie