E-commerce
July 1, 2026
"The bot promised me a VAT refund without checking my number." "The AI explains reverse charge but doesn't know if my order is eligible." "I was transferred to an agent who asked me for everything all over again from the beginning." Three bot failures where the AI advises on tax, promises exemption, or escalates without qualifying the VAT-MAP case.
A B2B e-commerce VAT questions AI chatbot does not replace VATNUM-FLOW agents (#464). It classifies bot_vat_* intents, performs grounded VAT-MAP lookups, cites VAT-* macros without legal advice, collects country number order context, and hands off to finance refund with a complete payload.
This guide #465 covers bot_vat_* intents, the VATBOT flow, and vat_bot KPIs. Distinct from the intracommunity VAT playbook (#464) and the documents bot (#255): here, the focus is on the B2B tax triage AI use case without legal advice prior to accounting escalation.
Summary
Why automate B2B VAT triage with a bot?
B2B VAT tickets combine pre-purchase FAQs, VIES checkout rejections, post-payment forgotten numbers, and urgent accounting requests. A generic bot replies with generic gross/net answers or promises refunds without VAT-MAP.
Volume and VAT bot risk
On cross-border DTC with 25 to 40% pro light revenue, 60 to 70% of vatnum tickets are tier 1 botifiable if VAT-MAP is grounded and NO-REFUND-PROMISE guardrails are active.
Three risks of an uncalibrated VAT bot
Tax advice hallucination : bot explains client's tax declaration
Refund promise : exemption promised without VIES VAT-MAP
Empty handoff : agent starts from scratch without payload
Tactas recommends supervised billing automation: automated lookup and FAQ, VAT corrections behind human approval (Tactas, ecommerce AI 2026). Shopify Tax validates EU/UK VAT at checkout 2026 (Ecommerce Today, VAT 2026).
Angle #465 vs related content
vatnum Support #464 : VATNUM-FLOW agents execute. #465 = bot triage qualify handoff.
VAT FAQ #160 : general explanation. #465 = VAT-MAP lookup automate.
Documents bot #255 : PDF resend auth. #465 = VAT number exemption triage.
Auth bot #462 : identity gate. #465 = post-auth VAT qualify.
INVADDR #463 : billing address. #465 = VAT amount not address.
Cross-border DTC Example
FR brand 94 vatnum tickets/month baseline #464. After VATBOT: vat_bot_auto_resolve 68%, vat_bot_wrong_refund_promise 0, vat_bot_handoff_quality 91%, vat_bot_csat 4.4/5.
Triage bot does not execute refund
VATBOT-SUP: bot qualify explain handoff, finance execute VN-7 refund credit note.
Q4 B2B bot capacity
November-January vat_bot_session_rate 1.4x: scale tier 1 FAQ capacity and finance handoff queue pre-peak.
Accountant chat entry point
compta@ domain detect VB-2: suggest order# upfront to reduce auth friction for B2B professional buyers.
How does
Human VAT playbook, PDF document bot, and VAT triage bot: three distinct tax bot layers.
Bot → tax role matrix
#465 VATBOT: classify VAT-MAP explain handoff finance
#464 VATNUM-FLOW: finance agents execute refund credit note
#255 DOC-BOT: invoice_resend PDF double auth
#160 TAX-FAQ: general gross net macro
#254 INV-PRO: human pro invoice issuance
Shared VAT-MAP corpus
#464 defines VAT-MAP JSON. #465 bot consumes same map: eligible exemption_type post_payment_action grounded.
Four BOT-VAT-TYPE flows
bot_vat_pre_checkout_faq: gross net input auto checkout
bot_vat_vies_guide: format retry VIES down
bot_vat_eligibility_check: order API countries VAT-MAP
bot_vat_finance_handoff: forgot refund invoice correction
#465 Commitment
Policy VATBOT-SUP, 12 intents bot_vat_*, flow VATBOT VB-1 to VB-8, guardrails, handoff payload, KPI vat_bot_*.
Upstream downstream bot pipeline
#462 CIV auth → #465 VATBOT qualify → #464 finance handoff execute → #255 resend corrected PDF post-fix.
Bot ops training 30 minutes
Module 1: tier 1 vs handoff. Module 2: guardrail red team prompts. Module 3: handoff payload review. Quiz 90% before prod.
Intent router upstream priority
Keywords VAT identification number reverse charge VIES route VATBOT before generic invoice_resend #255 or gross net FAQ #160 macro repeat.
Which bot_vat_* intents should be classified?
Twelve B2B VAT bot intents before the VATBOT flow.
Twelve bot_vat intents
bot_vat_ttc_ht_faq: corporate VAT-inclusive or VAT-exclusive price
bot_vat_checkout_how: where to enter checkout number
bot_vat_vies_reject: number rejected in cart
bot_vat_vies_down: service unavailable
bot_vat_format_help: format country prefix
bot_vat_domestic_explain: FR-FR VAT due pro
bot_vat_cross_border_eligible: reverse charge eligible order
bot_vat_forgot_checkout: paid VAT-inclusive number forgotten
bot_vat_invoice_mention: reverse charge missing on PDF
bot_vat_b2c_shipping_deny: personal delivery no exemption
bot_vat_not_tax_advice: tax reporting question
bot_vat_uk_hmrc: GB validation post-Brexit
Bot execution tiers
Tier 1 auto: bot_vat_ttc_ht_faq, checkout_how, format_help, vies_down, domestic_explain, not_tax_advice redirect.
Tier 2 qualify + handoff: bot_vat_forgot_checkout, invoice_mention, cross_border eligible verify.
Tier 3 immediate finance: refund execute forbidden bot, handoff VN-7 payload only.
Required bot session fields
vat_intent, order_id optional, seller_country, buyer_vat_number, ship_country, vat_map_eligible, vat_map_action, handoff_reason, auth_level.
VAT chat logs mining
Export 90 days bot sessions vatnum handoff empty payload wrong refund promise. Peak Q4 B2B budget flush.
Confidence threshold VAT intent
Classifier confidence below 0.75: clarifying question VAT-inclusive VAT-exclusive or VAT number before VB-4 lookup.
Post-handoff bot silence
After VB-7 finance handoff: bot stops refund eligibility discussion same session to prevent contradictory agent promise.
How does the bot consume VAT-MAP #464?
The bot reads VAT-MAP #464 for grounded eligibility without inventing exemptions.
Lookup VB-4 bot
countries from order API : seller ship billing VAT country
eligible Y/N : reverse charge domestic b2c_destination
post_payment_action : credit refund credit note deny
forgot_window_days : 7 days policy #464
macro_template : VAT-DOMESTIC VAT-DENY-B2C-SHIP VAT-REFUND-PROCESS
bot_can_execute : explain only | handoff finance
Pre-checkout no order
bot_vat_checkout_how + ttc_ht_faq : RAG /pages/b2b-vat + VAT-PRE-CHECKOUT macro no order API needed.
Post-checkout auth order
VB-2 auth order email → VB-3 read Shopify tax_lines vat_number order → VB-4 VAT-MAP lookup grounded.
Guardrail map miss
Country pair not in VAT-MAP : handoff finance default, never LLM invent eligibility.
RAG corpus VAT
Macros VAT-* #464 chunks, VAT-NOT-ADVICE disclaimer, /pages/b2b-vat FAQ. No external tax law RAG unverified.
Order age forgot window calc
VB-3 compute days_since_order vs forgot_window_days 7 before VB-6 branch auto deny past window.
Stale VAT-MAP version alert
Bot RAG VAT-MAP hash mismatch #464 source : block eligibility answers handoff finance until sync.
How to write the VATBOT-SUP policy in eight rules?
The VATBOT-SUP VAT bot policy governs triage without tax advice or refund execution.
Eight VATBOT-SUP rules
VAT-MAP grounded only: eligibility from map not LLM
NO-TAX-ADVICE: bot explains shop rules not client declaration
NO-REFUND-PROMISE: bot never promises € refund amount timeline
Auth before order VAT: VB-2 email order match post-purchase
Handoff payload complete: intent countries vat_number map result
Finance execute refund: bot handoff only forgot eligible tier 2
Domestic macro mandatory: FR-FR pro bot_vat_domestic_explain always
Disclaimer each session: VAT-NOT-ADVICE once per vat thread
Prohibited in production bot
Calculate client VAT declaration. Promise VAT-free invoice amount. Bypass checkout manual payment link. Execute credit note API. Contradict VAT-MAP deny with "exception".
bot_vat_not_tax_advice path
"How to declare reverse charge in Belgium?" → VAT-NOT-ADVICE + accountant link, no LLM tax tutorial.
Combined invaddr vatnum
Billing + VAT ticket: bot classifies both intents, handoffs single payload invaddr + vatnum chains.
Legal disclaimer footer
Every vat bot session footer: "Shop information, not tax advice. Consult your certified public accountant."
How to apply the VATBOT flow VB-1 to VB-8?
The VATBOT VB-1 to VB-8 flow structures the B2B VAT bot grounded maps triage.
Eight steps VB-1 to VB-8
VB-1 Intent classify: bot_vat_* from message
VB-2 Auth gate: pre-checkout skip | post order email match
VB-3 Order context: API tax_lines countries vat_number payment_date
VB-4 VAT-MAP lookup: eligible action macro template
VB-5 Respond tier 1: cite macro grounded VB-4 no refund €
VB-6 Branch: auto close | collect vat_number | handoff finance | deny explain
VB-7 Handoff payload: vatnum_* tag map result order chain if tier 2
VB-8 Log: intent eligible action handoff csat trigger
VB-5 bot_vat_vies_reject
TPL-VATBOT-FORMAT + TPL-VATBOT-VIES-DOWN if API down flag. Link /pages/b2b-vat retry checkout.
VB-6 bot_vat_forgot_checkout eligible
Within 7 days VAT-MAP eligible: explain process timeline, handoff finance VB-7, no € amount promise.
VB-6 bot_vat_forgot_checkout deny
Domestic or b2c_shipping or past window: VAT-DOMESTIC or VAT-DENY-B2C-SHIP macro close.
VB-6 bot_vat_invoice_mention
Order eligible reverse charge on invoice: handoff finance reissue Sufio, resend via #255 post-fix.
VB-2 accountant third
Domain match company on order: auth L1 skip buyer email if compta@ verified allowlist #464.
VB-5 macro variable injection
Template vars order_number seller_country ship_country from API only: prevent LLM country hallucination in TPL-VATBOT-ELIGIBLE-ORDER.
SLA bot response tier 1
VB-5 macro delivery under 5 s. Handoff acknowledgment under 10 s with ticket reference number.
Which TPL-VATBOT-* templates and guardrails should be configured?
Eight VAT bot templates and guardrails NO-TAX-ADVICE NO-REFUND-PROMISE.
TPL-VATBOT-PRE (pre-purchase)
"Prices displayed include VAT for private individuals. EU companies: enter VAT number at checkout. If VIES-validated, total recalculated based on B2B shipping eligibility."
TPL-VATBOT-FORMAT
"Format: country code + number without spaces (FR12345678901). Try checkout again or check the national business registry."
TPL-VATBOT-VIES-DOWN
"VIES service temporarily unavailable. Try again in 24 hours. No manual exemption without online validation."
TPL-VATBOT-DOMESTIC
"[country]-[country] sale: local VAT applies even with a business number. Recovery via your accountant."
TPL-VATBOT-ELIGIBLE-ORDER
"Order #[X]: cross-border B2B sale eligible for reverse charge. Invoice mentions 'Reverse charge - VAT due by the recipient'."
TPL-VATBOT-HANDOFF
"Your request requires finance verification (VAT correction / eligible refund). Transfer within 24-48 business hours with complete file."
Guardrail NO-REFUND-PROMISE-01
Block output containing € refund amount timeline "refunded within X days" without finance confirmation flag.
Guardrail NO-TAX-ADVICE-01
Block tutorial client country VAT declaration. Redirect VAT-NOT-ADVICE accountant.
Touchpoints widget
/pages/b2b-vat proactive T1 checkout abandon VAT field
Thank-you page B2B order TTC surprise hook
Invoice email footer "VAT question?" chat link
Handoff Gorgias vat_bot payload JSON
TPL-VATBOT-NOT-ADVICE
"We apply the VAT rules configured on our site. For your declaration, please contact your accountant or tax authority."
Which cases of forgot checkout, UK, and combined should be processed?
Special VAT bot cases require the VAT-MAP branch or immediate escalation.
Forgot checkout high value
Order > threshold : VB-6 handoff finance P1 payload, bot explain eligible only no execute.
UK HMRC bot_vat_uk_hmrc
VAT-MAP GB row separate VIES. TPL-VATBOT-FORMAT GB prefix. Handoff if HMRC validation ambiguous.
Wholesale pre-validated account
B2B account VAT on file : VB-3 skip re-explain, cite order tax_lines. Link wholesale (#144).
Multi-currency VAT display
VAT amount currency paid order. Link multi-devise (#452). Bot cite tax_lines not convert FX.
Combined invaddr + vat
Dual intent classify : handoff payload both #463 and #464 chains.
Chargeback open
VB-6 handoff finance hold flag chargeback_dispute open.
bot_vat_invoice_mention + resend
Post finance reissue : route bot documents #255 invoice_resend auth.
VIES intermittent same session
bot_vat_vies_down retry counter 3 : handoff agent manual VIES check #464 VN-3.
Norway Switzerland bot path
vatnum_norway_switzerland not in VAT-MAP auto : immediate finance handoff no bot eligibility explain.
Proforma pre-payment VAT question
bot_vat_pre_checkout on proforma flow : route #321 FAQ not post-order VAT-MAP lookup.
Which KPIs will the bot measure?
The B2B VAT bot KPIs link auto-resolve, zero wrong promise, and handoff quality.
Eight key metrics
vat_bot_session_rate: bot_vat sessions / 100 finance chats
vat_bot_auto_resolve: tier 1 closed without agent / sessions
vat_bot_handoff_rate: tier 2 finance transfer / sessions
vat_bot_handoff_quality: payload complete agent no re-ask / handoffs
vat_bot_wrong_refund_promise: guardrail violations (target 0)
vat_bot_tax_advice_violation: NO-TAX-ADVICE blocks (target 0)
vat_bot_map_grounded_rate: responses cite VAT-MAP / eligible answers
vat_bot_csat: satisfaction post session vat path
DTC cross-border B2B Benchmark
vat_bot_auto_resolve 60-72 %, vat_bot_wrong_refund_promise 0, vat_bot_handoff_quality > 88 %, vat_bot_csat > 4.2/5.
Weekly tax bot dashboard
Intent breakdown, tier 1 vs handoff, map miss rate, domestic_explain volume, guardrail incidents.
A/B proactive /pages/b2b-vat widget
Measure vat_bot_session_rate and pre-checkout vatnum ticket delta vs passive chat only.
vat_bot_intent_confusion matrix
Track misroute bot_vat vs invoice_resend #255: refine classifier if invoice PDF requests dominate vat sessions.
vat_bot_ticket_delta finance queue
Measure vatnum agent tickets month over month post-VATBOT deploy: target 40-55 % tier 1 deflection legitimate handoffs quality maintained.
What VAT bot anti-patterns should be avoided?
Twelve B2B VAT bot anti-patterns to ban from production.
1. Refund € amount promise
NO-REFUND-PROMISE-01 block. Handoff finance only.
2. Tax declaration tutorial
NO-TAX-ADVICE-01. bot_vat_not_tax_advice path.
3. Invent VAT-MAP eligibility
Rule 1 map miss handoff not LLM guess.
4. Skip VB-2 auth post-order
Rule 4 order email match.
5. Execute credit note bot
Rule 6 finance execute VN-7.
6. Empty handoff payload
Rule 5 intent countries map result mandatory.
7. Domestic exemption promise FR-FR
TPL-VATBOT-DOMESTIC always.
8. Manual HT payment link
#464 rule 3 no bypass checkout bot mirror.
9. Contradict VAT-MAP deny
No « exception manager » bot promise.
10. Route #255 invoice only for vatnum
#465 VATBOT classify before generic PDF resend.
11. Skip disclaimer
Rule 8 VAT-NOT-ADVICE once per thread.
12. Hallucinate VIES status
VB-3 API tax_lines only not LLM valid/invalid.
13. Mix WISMO and VAT same session
Intent router priority: if tracking question co-occur route WISMO bot first then vat FAQ separate turn not combined promise.
How does Qstomy implement VATBOT?
Qstomy on Shopify runs VATBOT: bot_vat_* classifier, VAT-MAP #464 lookup, order tax_lines API, NO-REFUND-PROMISE NO-TAX-ADVICE guardrails, finance handoff payload, grounded TPL-VATBOT-* templates.
Qstomy vat bot capabilities
vat_intent_classifier: 12 bot_vat intents
vat_map_bot_lookup: eligible action macro
order_tax_context: Shopify tax_lines countries
refund_promise_guard: block € timeline
tax_advice_guard: accountant redirect
finance_handoff_vat_payload: vatnum tag map chain
Pipeline #465 #464 #255 #462
#462 auth → #465 VATBOT triage → #464 finance execute → #255 PDF resend post-correction.
Encrypted DTC Scenario
Cross-border B2B FR, 94 vatnum tickets/month, 12 wrong refund baseline agents+bot uncalibrated.
After VATBOT-SUP + Qstomy: vat_bot_auto_resolve 70%, vat_bot_wrong_refund_promise 0, vat_bot_handoff_quality 93%, vat_bot_csat 4.5/5.
Explore customer support and request a demo.
Tax AI Governance
VB-8 logs feed AI governance (#124) monthly vat_bot guardrail audit.
Weekly vat bot guardrail audit
Sample 25 sessions regex refund € and tax declaration tutorial zero tolerance.
Corpus sync cadence
Re-index VAT-MAP and VAT-* macros within 24 hours of #464 policy update to prevent bot stale eligibility answers.
What is the checklist for deploying VATBOT?
html
Enzo
July 1, 2026
