← Back to AI Agents
In production

Agente Conversor IAE CNAE

Your AI tax advisor: accurate answers 24/7 with official sources

Stop searching through PDFs. The AI agent that understands your tax question and guides you to the correct code through conversation.

3,257

Codes in database

IAE, CNAE 2025 and CNAE 2009

9

AI tools

specialized in Spanish taxation

13

Official documents

indexed with semantic embeddings

The Challenge

Self-employed workers waste hours searching codes in confusing tables. A wrong code means tax authority fines and problems with your tax return.

The Approach

Conversational agent with 9 specialized tools. Describe your activity in natural language and receive precise recommendations based on semantic search.

Architecture

01

384-dimensional embeddings for semantic search of tax codes

02

9 specialized agent tools for code lookup and validation

03

13 official Spanish documents (PDFs/DOCX) indexed in Supabase Storage

04

Cloudflare Workers + Durable Objects for agent runtime with persistent state

05

Access controlled by newsletter subscription (157 authorized subscribers)

Key Technical Decisions

Semantic search via embeddings instead of keyword search: captures user intent, not just keywords

Newsletter subscription gate: builds audience while controlling access

Cloudflare Workers + Durable Objects: minimal latency and persistent state per session

Email validation via Edge Function: prevents unauthorized access

How It Was Built

Solves the problem of overlapping tax classification systems in Spain. IAE codes (1,187) are used by AEAT for tax registration. CNAE 2025 codes (1,060) are used by Social Security and INE. CNAE 2009 (1,010) are now obsolete. No 1:1 mapping exists; a wrong code triggers audits or administrative rejections. The agent provides accurate, database-driven recommendations with legal disclaimers and step-by-step guidance.

Results

Targets Spanish businesses registering new activities or migrating from CNAE 2009 to CNAE 2025 (January 2025 deadline compliance). Tax advisors (gestorías) and entrepreneurs use it for accurate code lookups. 157 authorized subscribers with controlled access.

Tech Stack

Cloudflare WorkersDurable ObjectsSupabaseOpenAIReact

What you get

  • Describe your work and get the exact code - no memorizing tables or acronyms
  • Ask at any hour - the agent never sleeps or gets tired
  • Codes updated to current regulations - includes CNAE 2009→2025 migration
  • Answers based on your specific context - no generic responses
  • Private access via email - your tax queries are confidential