TNS overige order tools

Shopify metaobject reviews

Welke reviews in de shop komen. Opslaan bewaart de instellingen in Shopify; de reviews zelf gaan elke nacht (of met "Nu naar Shopify schrijven") naar de metaobjecten.

Automatisch: elke nacht om 04:17 UTC (05:17 winter-, 06:17 zomertijd).

Resultaat

Zo ziet de selectie er met de opgeslagen instellingen uit. Favorieten hebben een gele ster. Elke nacht schrijft de Worker deze selectie naar de metaobjecten in Shopify; met de knop gebeurt dat nu.

ICL-BTW-correctie

Belgische zakelijke klanten met een geldig BTW-nummer bestellen met BTW verlegd (ICL). Shopify rekent standaard prijzen incl. BTW; deze tool zet de prijzen voor zulke klanten automatisch om naar excl. BTW (prijs ÷ 1,21) en draait dat terug als de klant geen ICL-klant meer is. De routes worden aangeroepen door Shopify Flow (actie Send HTTP request met header Webhook-Auth-Token).

Wanneer is een klant ICL?

Klant-metafield custom.customer_icl_reverse_charge staat aan, én
de klant heeft de BTW-vrijstelling EU_REVERSE_CHARGE_EXEMPTION_RULE (BTW verlegd).

Metafield aan maar vrijstelling ontbreekt: er wordt niets aan de prijzen gedaan, de order krijgt de tag ICL-CORRECTIE-FOUT en wordt on hold gezet met de melding "Stel BTW VERLEGD in bij de klant!".

Routes

Route	Flow-trigger	Wat het doet
`POST /icl-btw-correctie`	Order edited	Regels die via een order-edit zijn toegevoegd of gewijzigd krijgen per stuk de korting `ICL-BTW-CORRECTIE` ter grootte van de BTW. Gesloten orders worden nooit aangeraakt.
`POST /icl-btw-correctie-draft`	Draft order created / updated	Prijs direct op excl. BTW (`priceOverride`) en `taxable: false`; geen korting nodig. Wisselt de draft order naar een niet-ICL-klant, dan worden de prijzen teruggezet.
`POST /icl-btw-herstel-na-klantwijziging`	Customer updated	Zoekt open orders en draft orders van die klant met `ICL-CORRECTIE` of `ICL-CORRECTIE-FOUT` en laat de correctie opnieuw draaien, bijv. nadat de vrijstelling alsnog is gezet.

Tags en meldingen

`ICL-CORRECTIE`	Prijzen zijn gecorrigeerd naar excl. BTW.
`ICL-CORRECTIE-FOUT`	ICL-klant zonder BTW-vrijstelling: niet gecorrigeerd, order on hold. Verdwijnt vanzelf (met de hold) zodra de correctie alsnog lukt.
`ICL-HANDMATIG-CONTROLEREN`	Regel uit een voltooide draft order staat nog excl. BTW terwijl de klant geen ICL meer is; dat wordt bewust niet automatisch hersteld. Order on hold: maak een nieuwe order of zet de prijzen handmatig op incl. BTW.

Het verslag van elke correctie staat bij de order of draft order onder Aanvullende gegevens (attribuut ICL BTW Correctie, nieuwste regel bovenaan).

Samenhang met TNS Orderbeheer

Een handmatige korting op een ICL-regel (potlood in TNS Fulfillmentbeheer) vervangt de korting ICL-BTW-CORRECTIE; de correctie per stuk staat dan in custom.exact_facturen.icl_correction_per_unit.