OCI en PunchOut
OCI koppeling Technische Unie
Technische Unie biedt een OCI 4.0 PunchOut, artikelbestanden in PAB-formaat, conditiebestanden in ICC 1.1 en orders, pakbonnen en facturen als XML. Hier staat wat elke route levert, met de cijfers uit de bestanden zelf, en hoe assortiment en prijzen in je eigen systeem komen als Technische Unie voor jouw pakket naar een implementatiepartner verwijst.
Wat Technische Unie aanbiedt
Technische Unie noemt zijn koppelingen System 2 System. De uitleg op de klantenservice deelt het bestelproces op in vier stappen, selecteren, order plaatsen, leveren en betalen, en noemt per stap de berichten:
| Stap | Route | Formaat | Transport |
|---|---|---|---|
| Selecteren | OCI PunchOut | OCI 4.0 | Browser, vanuit je inkoopsysteem |
| Selecteren | Artikel- en conditiebestand | PAB 1.05, ICC 1.1 of TU-formaat | Download of e-mail via Mijn berichten |
| Order plaatsen | Order en orderbevestiging | XML insbou003, XML SALES005 | HTTP Post, AS2, Message Service 3.1 |
| Leveren | Digitale pakbon op de dag van levering | XML insbou003, XML SALES005 | E-mail, AS2, Message Service 3.1 |
| Betalen | Factuur, met of zonder pdf | insbou003, SALES005, UBL 2.1, ICF, UBL NL-CIUS | E-mail, AS2, Message Service 3.1, Peppol voor NL-CIUS |
OCI is dus één van vijf routes, en het dekt alleen het selecteren. De order na de OCI-sessie loopt via een van de XML-formaten. Bij AFAS bijvoorbeeld schrijft Technische Unie: artikelen via OCI, orders als XML insbou003 via een HTTP Post, facturen als UBL 2.1 per e-mail. AFAS heeft voor Technische Unie een eigen definitie, zie OCI koppeling AFAS.
Welk systeem is leidend, per gegeven
| Gegeven | Leidend | Waar het vandaan komt |
|---|---|---|
| Assortiment en brutoprijs | Technische Unie | PAB-bestand, ArtLev.txt en ArtPr.txt |
| Jouw korting en nettoprijs | Technische Unie, volgens jouw afspraak | ICC-conditiebestand, of de OCI-winkelwagen |
| Dagprijs van koper- en zinkartikelen | Technische Unie | Alleen op de website en in de OCI-sessie, niet in de bestanden |
| Inkooporder en ordernummer | Jouw systeem | Gaat als insbou003 of SALES005 naar Technische Unie |
| Ontvangst en factuurcontrole | Jouw systeem | Pakbon en factuur van Technische Unie, gekoppeld aan jouw order |
Het verschil tussen de eerste twee rijen bepaalt de hele koppeling. Het artikelbestand is voor iedereen gelijk. Volgens de toelichting downloadbestanden heeft het bestand een veld nettoprijs, maar in het kwartaalbestand van 29 september 2026 is dat veld bij alle 703.369 regels leeg. Je nettoprijs komt uit het conditiebestand, dat niet op de website staat en dat je per klantaccount via Mijn berichten ontvangt.
Wat er in de bestanden staat
Het kwartaalbestand voor het vierde kwartaal van 2026 (Q-PAB.zip, 26,5 MB) pakt uit tot drie tekstbestanden met vaste kolombreedtes, CRLF-regeleinden en ASCII-tekst. ArtLev.txt is 265 MB, ArtPr.txt 85 MB. Wat er in staat, geteld op 3 oktober 2026:
| Veld | Positie | Wat er in het bestand staat |
|---|---|---|
| Bestelbaar | 152 tot 153 | 691.394 regels TU, 11.975 regels NO (verwijderd) |
| Besteleenheid | 177 tot 179 | Alle regels PCE |
| Stapgrootte afname | 190 tot 199 | 639.918 per 1, 17.736 per 10, 10.200 per 50, 4.678 per 100 |
Levertijd, eenheid 804 (dag) |
223 tot 232 | Meest voorkomend 21 dagen (147.637 regels), dan 1 dag (92.967) |
| Leveranciersomschrijving | 310 tot 359 | Veld van 50 tekens, langste waarde 30 |
| Btw | ArtPr.txt 101 tot 111 |
703.266 regels S 21,00, 103 regels S 9,00 |
Het weekbestand is cumulatief: het bevat alles wat sinds het kwartaalbestand is gewijzigd. Op 2 oktober 2026 waren dat 4.477 regels, met mutatiecode 1 (nieuw) voor 2.140 en 3 (gewijzigd) voor 2.337. Het bestand relatie.txt met de namen van fabrikanten is ISO-8859-1, de andere drie zijn ASCII. Een koppeling die alles als UTF-8 leest, maakt van een merknaam met een é een onleesbaar teken. Zie tekencodering en UTF-8.
Rekenvoorbeeld: een prijs en een bestelling
Een artikel heeft in ArtPr.txt een brutoprijs van 40,00 per PCE. In het ICC-bestand staat voor de kortingsgroep van dat artikel een conditie van 18.5. De nettoprijs is 40,00 × (1 − 0,185) = 32,60. De toelichting van Technische Unie noemt ook condities in de vorm 18-14 en 18.5-14.5, zonder uit te leggen hoe die rekenen; dat leg je vast met je verkoopkantoor voordat de koppeling ze omrekent.
Hetzelfde artikel heeft minimum afname en stapgrootte 50. Je inkoper vraagt 30 stuks aan. Die 30 past niet in de afname van het artikel, en wordt de regel bij de order naar 50 gezet, dan is het bedrag 50 × 32,60 = 1.630,00 in plaats van de 30 × 32,60 = 978,00 die de aanvrager zag: 652,00 meer dan goedgekeurd. De koppeling legt de stapgrootte uit positie 190 tot 199 daarom al bij de aanvraag vast, zodat de aanvrager 50 ziet voordat hij goedkeurt.
De technische werkelijkheid van deze combinatie
De bestanden zijn groot en je systeem is meestal klein. Wie alle 703.369 artikelen via een API in een ERP wil zetten, loopt tegen het limiet aan. Exact Online staat 5.000 calls per dag toe; met één call per artikel is dat 703.369 / 5.000 = 140,7 dagen voor één volledige import. Een koppeling neemt daarom alleen de artikelen over die je gebruikt, bijvoorbeeld de 3.000 uit je bestelhistorie, en past daarop het weekbestand toe. 3.000 artikelen kosten 3.000 calls, 60 procent van één dag.
De actualiteit verschilt per route:
| Route | Prijs is zo oud als | Gevolg |
|---|---|---|
| OCI PunchOut | Het moment van bestellen | Geen onderhoud aan artikelbestanden |
| PAB weekbestand, wekelijks ingelezen | Tot 7 dagen | Een prijsverhoging van maandag staat pas na de volgende download in je systeem |
| ICC-conditiebestand | Tot een maand | Een korting die halverwege de maand is afgesproken, ontbreekt tot de volgende maand |
| Dagprijsgevoelige artikelen | Niet in de bestanden | Prijs alleen via de website of de OCI-sessie |
Technische Unie schrijft zelf dat de OCI PunchOut de eenvoudigste manier is om prijzen actueel te houden, omdat de winkelwagen artikelnummers, aantallen, nettoprijzen en levertijden meegeeft. Daarvoor moet je inkoopsysteem wel een OCI-sessie kunnen starten. Kan het dat niet, dan zijn de bestanden de route. De afweging per onderdeel staat in PunchOut of catalogusbestand.
Als je pakket via een implementatiepartner loopt
Technische Unie noemt per softwarepakket wat het ondersteunt: 4PS, ACTO, AFAS, BouwinfoSys, ENK, GildeSoftware, Simar, Syntess en Minuba op de dienstenpagina, en onder meer Basware, Proquro, Proactis en SAP Ariba in de tabel van de klantenservice. Bij Exact Online, SAP, Microsoft Dynamics, Ridder IQ en een paar andere pakketten staat "via implementatiepartner": de berichten bestaan aan de kant van Technische Unie, de koppeling met je pakket moet iemand anders bouwen. Odoo staat niet in de lijst.
De formaten liggen vast, dus de koppeling kan voor elk systeem gebouwd worden. Voor een ERP met een API:
- Kwartaal- en weekbestand downloaden en de vaste kolommen inlezen, met
relatie.txtals ISO-8859-1. - Het ICC-bestand uit Mijn berichten verwerken tot een nettoprijs per artikel.
- Alleen de artikelen in je selectie bijwerken, met nieuwe prijs, stapgrootte en levertijd.
- Een inkooporder uit je ERP omzetten naar insbou003 en via HTTP Post versturen.
- Pakbon en factuur aannemen en aan de inkooporder hangen, zodat ontvangst en factuurcontrole in je ERP kloppen.
Dezelfde opbouw werkt voor de bestanden van andere leveranciers: zie leveranciersvoorraad koppelen en DICO voor de berichten van de installatiebranche.
Als het misgaat
| Situatie | Oorzaak | Wat de koppeling doet |
|---|---|---|
| Artikel uit je order is niet meer leverbaar | Bestelbaar NO in het nieuwe kwartaalbestand |
Markeert het artikel en meldt de vervanger uit positie 82 tot 101 |
| Aantal past niet in de afname | Bestelling buiten minimum afname of stapgrootte | Toont de stapgrootte bij de aanvraag en houdt een afwijkende regel tegen voor verzending |
| Nettoprijs op de factuur wijkt af | Conditiebestand ouder dan de afspraak, of een dagprijsartikel | Toont het verschil per regel bij de factuurcontrole |
| Merknamen met vreemde tekens | relatie.txt gelezen als UTF-8 |
Leest het bestand als ISO-8859-1 |
| Weekbestand mist | Download mislukt | Haalt het weekbestand opnieuw op; omdat het cumulatief is, gaat er niets verloren |
Elke download, elke import en elke verstuurde order staat in het dashboard, met het aantal gewijzigde regels per run. Wat er na de order bij je klant gebeurt als je zelf leverancier bent, staat op OCI en PunchOut. Vertel welk ERP je gebruikt en welke routes van Technische Unie je nu hebt.
Veelgestelde vragen
Hoe krijg ik een OCI koppeling met Technische Unie?
Je inkoopsysteem moet zelf een OCI-sessie kunnen starten. AFAS kan dat en heeft een eigen definitie voor Technische Unie. Voor de inrichting verwijst Technische Unie naar je verkoopkantoor, dat je in contact brengt met een System 2 System-adviseur. Welke gebruiker binnen jouw bedrijf mag bestellen, regel je met de profielen en autorisaties in je account.
Wat is het verschil tussen het PAB-bestand en het ICC-bestand?
Het PAB-bestand bevat artikelen en brutoprijzen van het hele assortiment, voor iedere klant gelijk. Het ICC-bestand bevat jouw kortingen, per kortingsgroep of als nettoprijs per artikel. Pas samen geven ze je inkoopprijs. Een OCI-winkelwagen bevat de nettoprijs al.
Hoe vaak verandert het artikelbestand?
Technische Unie geeft per kwartaal een volledig bestand uit en daarnaast weekbestanden met alles wat sinds dat kwartaalbestand veranderd is. Het weekbestand van 2 oktober 2026 telde 4.477 regels: 2.140 nieuwe artikelen en 2.337 wijzigingen. Het conditiebestand komt maandelijks.
Bij mijn ERP staat "via implementatiepartner". Wat betekent dat?
Dat Technische Unie de berichten levert en dat de koppeling met je pakket door een partner wordt gebouwd. Dat geldt onder meer voor Exact Online, SAP en Microsoft Dynamics. De formaten zijn gepubliceerd: PAB 1.05 en ICC 1.1 voor artikelen en kortingen, insbou003 of SALES005 voor orders, UBL 2.1 voor facturen. Een koppeling leest die in en zet ze om naar de API van je ERP, zoals Exact Online, Business Central of Odoo.
Waarom wijkt de prijs in mijn systeem af van de webshop van Technische Unie?
Meestal door de leeftijd van de bestanden. Een conditiebestand van de eerste werkdag van de maand kent geen korting die halverwege de maand is afgesproken, en artikelen met koper of zink hebben een dagprijs die alleen op de website staat. Via OCI krijg je de prijs van het moment van bestellen.
Vertel wat je nodig hebt
Vertel welke systemen je gebruikt en wat je wilt verbeteren. Je krijgt binnen één werkdag een persoonlijk antwoord. We helpen je de werkzaamheden helder te krijgen en spreken de prijs en planning af voordat je iets toezegt.
- Je weet de prijs en de doorlooptijd voordat je iets toezegt
- Wij zoeken uit welke koppeling het werk uit handen neemt
- Wij verzorgen de bouw, hosting, bewaking en het onderhoud
- Je team krijgt minder overtypwerk en minder uitzoekwerk