Oversikt
LagDinBridge av Technobridge synkroniserer WooCommerce-ordrer til Tripletex. Ordrer, kunder, produkter, fakturaer og betalinger overføres automatisk med korrekt MVA-håndtering. Integrasjonen følger Tripletex naming convention: «LagDinBridge av Technobridge».
Autentisering
- Employee Token + Consumer Token → Session Token
- Session tokens opprettes per API-økt
- Token-fornyelse håndteres automatisk
API-endepunkter
| Metode | Endepunkt | Formål |
|---|---|---|
| GET | /v2/customer | Søk etter kunde på e-post |
| POST | /v2/customer | Opprett ny kunde |
| POST | /v2/order | Opprett salgsordre |
| POST | /v2/invoice | Opprett faktura |
| PUT | /v2/invoice/{id}/:invoice | Fakturer en ordre |
| POST | /v2/invoice/{id}/:registerPayment | Registrer betaling |
| PUT | /v2/invoice/{id}/:createCreditNote | Opprett kreditnota |
| GET | /v2/product | Søk etter produkt (SKU-matching) |
| POST | /v2/product | Opprett produkt |
| PUT | /v2/product/{id} | Oppdater produkt |
Tre posteringsmodi
Full auto (full_auto)
Ordre → faktura → betaling i en flyt. Ordren konverteres til faktura automatisk, og betalingen registreres.
Kun faktura (invoice_only)
Ordre → faktura. Betaling registreres manuelt i Tripletex etterpå.
Kun ordre (order_only)
Kun salgsordre opprettes. Konvertering til faktura gjøres manuelt.
Dataflyt
Hent ordrer fra WooCommerce
REST API v3. Kun ordrer med status 'completed' og 'processing' (betalt).
Valider og sjekk idempotens
wc_tripletex_mappings sikrer at ingen ordre behandles to ganger.
Finn eller opprett kunde
Søk på e-post i Tripletex. Opprett med navn, adresse og kontaktinfo hvis ny.
Synkroniser produkter
SKU-matching mellom WooCommerce og Tripletex. Opprett manglende produkter.
Bestem MVA per linje
Automatisk deteksjon fra WooCommerce tax-data med toleransebånd.
Opprett ordre/faktura
Basert på valgt posteringsmodus: full_auto, invoice_only, eller order_only.
Registrer betaling
Automatisk betalingsregistrering med riktig betalingstype og konto.
Lagre mapping
Tripletex-ID lagres for idempotens og refusjonssporing.
MVA-håndtering
| SAF-T kode | Sats | Beskrivelse |
|---|---|---|
| 3 | 25% | Standard (de fleste varer og tjenester) |
| 31 | 15% | Næringsmidler (matvarer) |
| 33 | 12% | Transport, overnatting, kino |
| 5 | 0% | Fritatt for MVA |
| 6 | 0% | Utenfor MVA-området |
| 52 | 0% | Eksport (0% utførsel) |
MVA-sats detekteres automatisk per ordrelinje fra WooCommerce tax-data. Systemet bruker toleransebånd (±2 %) for å matche korrekt MVA-kode. Fallback til brukerens standardkode hvis deteksjon feiler.
Produktsynkronisering
- Toveis synk mellom WooCommerce og Tripletex
- SKU brukes som primær matchingnøkkel
- Hvis produkt ikke finnes i Tripletex, opprettes det automatisk med navn, pris og MVA-kode
- Produktsynk kan aktiveres/deaktiveres per integrasjon
Refusjonshåndtering
Full refusjon
Hele fakturaen krediteres via PUT /v2/invoice/{id}/:createCreditNote
Delvis refusjon
Proporsjonell MVA-fordeling etter Bokføringsforskriften § 5-1-1. Negative ordrelinjer med korrekt MVA per linje.
processed_refund_ids JSON-array i mapping-tabellen for å unngå duplikat-kreditering.Konfigurasjon
| Nøkkel | Type | Beskrivelse |
|---|---|---|
| only_paid | bool | Kun synkroniser betalte ordrer |
| only_fulfilled | bool | Kun synkroniser fullførte ordrer |
| handle_refunds | bool | Automatisk refusjonshåndtering |
| posting_mode | string | full_auto | invoice_only | order_only |
| sync_products | bool | Aktiver produktsynkronisering |
| default_vat_code | string | Fallback MVA-kode |
| payment_account | string | Standard betalingskonto |
Idempotens og feilhåndtering
- wc_tripletex_mappings: wc_order_id + integration_id = unik
- processed_refund_ids: JSON-array som sporer behandlede refusjoner
- Strukturerte feilkoder: MISSING_EMAIL, INVOICE_CREATE_FAILED, CUSTOMER_CREATE_FAILED
- Circuit breaker og exponential backoff
Sikkerhet
Kryptert lagring
Alle API-nøkler og tokens krypteres med Fernet (AES-128-CBC + HMAC-SHA256) før lagring
HTTPS-only
All kommunikasjon med eksterne API-er skjer over TLS 1.2+ — ingen ukryptert trafikk
Tenant-isolering
Hver brukers credentials er isolert — ingen deling av nøkler mellom kunder
Feilhåndtering
Circuit breaker, exponential backoff (5 forsøk), og respekt for rate limits
Forutsetninger
- Aktiv Tripletex-konto
- Employee Token og Consumer Token
- WooCommerce REST API med Consumer Key + Consumer Secret
- LagDinBridge-konto hos Technobridge
LagDinBridge er utviklet av Technobridge
Spørsmål? Kontakt oss på post@technobridge.no