ResicoClick

AI-native platform protecting Mexican freelancers from a 35% retroactive tax penalty. Gemini Flash converts one simple voice command into an official invoice in seconds.

Comment

Inspiration

In Mexico, there is a highly attractive tax regime for independent contractors and micro-businesses called RESICO. It allows physical persons earning under $3.5M MXN (around $180k USD) to pay an income tax rate of just 1% to 2.5%. However, this regime has a strict, binary rule: any minor administrative mistake—such as missing a deadline or using the wrong invoice code—results in immediate, retroactive expulsion to the General Regime. This spikes their income tax rate up to 35% on all earnings of the fiscal year, causing constant anxiety for nearly 3 million taxpayers.

On the other hand, the official government tax portal is slow, frequently crashes, and forces users to navigate confusing menus and manually fill out dozens of complex tax codes every time they issue an invoice. While private accounting platforms exist, they are overly complex, expensive, and try to solve the entire universe of corporate taxes.

We were inspired by the philosophy of "extreme niching," similar to the single-item specialization model of fast-food chains focusing on delivering one thing exceptionally fast and affordably rather than managing a complex menu. We discovered that 23.4% of the RESICO universe (820,000 active taxpayers in Mexico) are independent professionals (software engineers, doctors, designers, landlords) with financial operations so simple they do not need an accountant: they only invoice in Mexican Pesos (MXN), under the PUE method (paid in full at emission), repeat the exact same service concepts monthly, and never apply discounts.

We built ResicoClick to bring absolute simplicity to this micro-niche. By configuring the platform once in minutes, users can issue official tax invoices in seconds using the power of Gemini, removing administrative friction while operating as a shield to protect their low tax status.

What it does

ResicoClick is an AI-native SaaS platform that acts as a Permanence Monitor and an Express Invoicing Engine for independent professionals under the RESICO tax regime. Its core MVP features include:

  1. Express Voice Invoicing (Powered by Gemini Flash): The user clicks the microphone and dictates a natural command (e.g., "Invoice Juan Pérez 15,000 pesos for software consulting"). The browser captures the audio and sends it directly to Gemini Flash. The model natively processes the audio, interprets the Spanish instruction, automatically maps the service to the correct government tax code, and returns a structured JSON payload to the backend to stamp the official invoice (CFDI) via authorized API providers in seconds.
  2. Permanence Monitor ("Mi Permanencia"):
    • 3.5M Limit Gauge: Graphically tracks annual earnings and mathematically projects if the user is approaching the threshold that triggers automatic expulsion.
    • SAT Traffic Lights: Locally and securely parses the digital certificate (e.firma / .cer) directly in the browser to track expiration dates without ever storing private keys on our servers (Privacy-First).
    • Compliance & Tax Mailbox: Leverages Gemini Flash to instantly read and parse the PDF of the official "Compliance Opinion" issued by the tax authority, checking for negative status or mailbox alerts.
  3. Client Self-Billing Links: The user shares a unique link with their clients. Clients can enter their tax information manually or upload their official Tax Certificate (Constancia de Situación Fiscal in PDF). Gemini Flash acts as a pre-fill assistant, extracting key details (Tax ID, Legal Name, Address, and Fiscal Regime) in seconds to autofill the form, reducing registration errors.
  4. Secure Onboarding (Google OAuth & Resend Verification): Users can sign up quickly using Google Sign-In or the traditional email/password flow. To prevent automated bot registrations and ensure valid users, the email/password registration is secured with an active email verification process powered by the Resend API.
  5. Stripe Integration: A clean, secure monthly subscription payment flow of $199.00 MXN ($10 USD) fully functional in production.

How we built it

We built ResicoClick using a modern, scalable, and secure architecture:

  • Frontend: Developed in SvelteKit styled with Vanilla CSS to achieve maximum visual control, fast load times, and a premium responsive design featuring smooth micro-animations.
  • Backend: A robust and secure .NET 10 Web API running in Docker containers, managing authentication, user metadata, tax calculations, and database persistence.
  • AI Core: Gemini Flash (Latest) integrated via the official Google Gen AI SDK. Gemini acts as our multi-tasking utility engine, handling audio interpretation, text extraction, and PDF parsing.
  • Invoicing Engine: Connected directly to Facturama's API (Authorized Certification Provider) for official CFDI 4.0 validation, stamping, and XML/PDF generation.
  • Authentication: Google OAuth for social logins alongside traditional email/password registration confirmed via Resend's API to block automated sign-up spam.
  • Billing Infrastructure: Fully integrated with Stripe Billing to handle subscriptions and monthly webhooks securely.

Challenges we ran into

  • Enforcing Strict Structured Output from Voice: Interpreting Spanish audio instructions with fiscal jargon (like "Factúrale a...") and reliably mapping them to strict JSON structures required rigorous system instructions. We overcame this by using Gemini's structured output settings to guarantee the schema required by the PAC API, handling errors before they reached SAT servers.
  • Securing Digital Seal Certificates (CSD): Officially stamping invoices requires users to upload their Digital Seal Certificates (CSD). To protect this sensitive cryptographic material, we implemented robust, industry-standard encryption protocols within our .NET backend environment. Keys are encrypted at rest and in transit, ensuring users' fiscal signatures remain completely secure.
  • Document Layout Variability: Official tax documents in Mexico (like Constancia de Situación Fiscal or Opinión de Cumplimiento) have different layouts, fonts, and visual formats. We configured Gemini Flash's multimodal inputs to reliably locate and extract key information (RFC, address, tax regime, compliance status) regardless of the PDF format.
  • Overcoming Fiscal Mistrust & Friction: Handling tax and invoice information creates natural reluctance; users are highly protective of their credentials and tax status. We tackled this trust barrier by designing a friction-free onboarding flow where new users can access the dashboard, ask questions to the AI Tax Assistant, and test voice drafting without uploading any certificate or sensitive data until they decide to stamp a real invoice.

Accomplishments that we're proud of

  • Full Production Deployment: Launching a functional SaaS platform at https://resicoclick.mx/ within the competition window.
  • Stripe Validation: Successfully testing the payment and subscription loop in the live production environment.
  • Under 10-Second Voice-to-CFDI Flow: Achieving a pipeline where a raw audio recording is captured, interpreted by Gemini Flash, validated, and officially stamped in seconds.
  • Clean, Accessible UX: Designing a tax compliance platform from scratch that feels accessible and simple, proving that tax software does not have to be ugly or confusing.

What we learned

  • Cost-Efficiency of a Single Model: We learned that leveraging a single, low-latency model like Gemini Flash for diverse tasks (audio command parsing, document extraction, and conversational support) is highly viable. It keeps operational API costs near zero, validating the profitability of our $10/month subscription model.
  • The Importance of the Confirmation Step: Initially, we designed the system for complete automation. However, during our initial testing and system validation, we realized that in financial and legal matters, users must have absolute control before data is sent to government APIs. We added an interactive confirmation modal displaying the parsed details prior to stamping to ensure trust and accuracy.
  • Micro-niche Focus is Key: Trying to solve tax rules for everyone is a trap. Specializing strictly in the low-volume, single-concept RESICO target allowed us to ship a highly stable product fast.

What's next for ResicoClick

  • Gemini Pro Multimodal Auditor: Develop a monthly reconciliation engine where users can drag and drop bank statement PDFs alongside SAT XML files. Gemini will audit them to detect mismatching concepts or untaxed income, serving as an early-warning system against retroactive tax penalties.
  • Pre-filled Monthly SAT Declarations: Automate the calculation of the monthly RESICO tax payment directly within the dashboard.
  • Growth Marketing: Launch localized SEO landing pages for specific professions (e.g., "RESICO for Doctors", "RESICO for Developers") to scale user acquisition towards our target market of 820,000 taxpayers.

Built With

Share this project:

Updates