Tax Letter Help

by Spargur Tax & Accounting · static HTML/CSS/JavaScript PWA · no server, analytics, email or donation feature.

Using the app / Usar la app

Take or select up to 10 JPEG, PNG, HEIC or PDF files (20 MB total). Reading stays on the device. PDF text is extracted locally; scanned PDF pages use bundled Tesseract OCR with English and Spanish data. HEIC conversion is attempted locally; if unsupported, choose a JPEG copy. PDFs are limited to 50 pages to protect phone memory.

Tome o seleccione hasta 10 archivos JPEG, PNG, HEIC o PDF (20 MB total). La lectura ocurre en el dispositivo. Los PDF escaneados usan OCR local en inglés y español. Se intenta convertir HEIC localmente; si no funciona, elija JPEG. Los PDF se limitan a 50 páginas para proteger la memoria.

Check extracted details against the original. The guide covers federal notices and Florida DOR letters. Unknown notices show extracted fields and help options. Calculated deadlines are estimates, not legal determinations: printed dates, mailing date, overseas rules, weekends and holidays matter. Calendar downloads use the confirmed-date schedule described below, subject to calendar support after import. Local reminders do not produce background notifications.

Compare los datos con el original. La guía cubre avisos federales y cartas del DOR de Florida. Los plazos calculados son estimados; importan fechas impresas, envío, reglas del extranjero, fines de semana y feriados. El calendario usa el programa de fechas confirmadas explicado abajo, sujeto a la app de calendario. Los recordatorios locales no envían alertas en segundo plano.

Privacy / Privacidad

Cloudflare provides the “I’m not a robot” check, which runs only when you choose to send your letter.

Cloudflare proporciona la verificación «No soy un robot», que solo se ejecuta cuando elige enviar su carta.

Nothing uploads automatically. Unsaved scan files stay in memory. Save explicitly stores original pages in IndexedDB on this device. History deletion and Delete everything offer Undo during the session. A full backup contains original pages and should be kept private. Restore merges stable IDs without wiping existing records. Schema version 1 is checked; unsupported future schemas are rejected. Background photos are resized to 1600 pixels, stored in IndexedDB, and excluded from backups and exports. Optional AI is hidden with an empty endpoint and may receive only allowlisted masked fields, never OCR or images. There are no third-party runtime scripts or fonts.

Nada se sube automáticamente. Las páginas sin guardar quedan en memoria. Guardar conserva originales en IndexedDB local. Las eliminaciones permiten deshacer durante la sesión. La copia contiene originales: guárdela de forma privada. Restaurar combina sin borrar registros. La foto de fondo se limita a 1600 píxeles, queda en IndexedDB y no se exporta. La IA opcional está oculta y solo puede recibir campos permitidos, nunca OCR ni imágenes.

The original-page secure upload is the explicit exception to masking: the firm needs the actual notice. Contact information and pages are sent only after the specific consent checkbox and Submit. App-to-app and portal summaries contain only validated notice code, dates, year and amount, with no raw OCR, names, addresses, account numbers or pages.

La carga segura de originales es la excepción explícita al enmascarado: la firma necesita el aviso real. Datos de contacto y páginas se envían solo tras consentimiento y Enviar. Los resúmenes entre apps y al portal solo contienen código, fechas, año e importe validados, sin OCR, nombres, direcciones, cuentas ni páginas.

Appearance & preferences / Apariencia y preferencias

System/light/dark theme; six accents; plain, six CSS designs, six solids and a personal photo; small/normal/large text; optional home reminder count. Selections show check marks and persist locally. Text sits on opaque panels over patterns and photos. English and Spanish are available throughout app flows.

Tema sistema/claro/oscuro; seis acentos; fondo liso, seis diseños CSS, seis colores y foto propia; texto pequeño/normal/grande; número de recordatorios opcional en inicio. Las selecciones muestran marcas y se guardan localmente. Los paneles de texto son opacos sobre fotos y diseños.

Build, run, test

npm ci
npm test
npm run build
npm run test:browser
npm start

Node 22+ recommended. The deploy output is dist/. Do not serve the source tree as the production site. All reader scripts, WASM, trained data and licenses are checked into vendor/; node tools/vendor.js refreshes scripts from the exact package-lock versions. Language data is from tessdata.projectnaptha.com/4.0.0 (eng/spa); SHA-256 hashes are in vendor/SHA256SUMS.json. Offline installation caches all local runtime files; first installation must finish online. Large OCR/HEIC assets are loaded into the UI only on demand. OCR installation can be tens of MB.

On Windows, the existing Chrome browser can be used with $env:TEST_BROWSER_CHANNEL=\"chrome\"; npm run test:browser. Otherwise Playwright Chromium must be installed (npx playwright install chromium). Tests use synthetic taxpayers and images only; no real letters. Browser checks cover 320-pixel layout, bilingual results, consent, mocked upload, fragment clearing, import selection and offline image OCR. No pre-existing browser check was present in the empty repo.

Build generates version.json and injects APP_VERSION (default package version) into the HTML meta tag and service-worker cache. Increment APP_VERSION or package version for each release. APK_VERSION is optional. Updates check at load, focus and every 30 minutes. Refresh activates the waiting worker before reloading. An APK version newer than ?apk= shows the all-apps download link. No deployment, commits or pushes are performed by this implementation.

Secure upload contract

CONFIG.SUBMIT_ENDPOINT is https://spargurtax.com/api/forms/tax-letter-handoff. The CSP permits that origin. All tests use local mocks. The app never calls the firm automatically and never retries automatically. Sent requires a valid finish receipt. Package PDF creation uses the supplied, locally vendored pdf-lib 1.17.1. No email is sent.

Envío seguro: inicio, fragmentos y finalización. Solo el recibo final válido permite mostrar Enviado. Reintentar requiere pulsar el botón. El paquete PDF local no significa enviado. No se envía correo.

THE TAX LETTER HAND-OFF CONTRACT, version 1 (job 16 builds the platform side from this same text)
- One address: POST https://spargurtax.com/api/forms/tax-letter-handoff
  - Cross-origin, from the app's own origin only; the platform keeps an allowlist. No cookies or credentials.
  - Every answer is JSON: { "ok": true, ... } or { "ok": false, "error": "<plain words>" }, with Cache-Control: no-store.
- Step 1, start. Content-Type application/json, at most 32 KB:
  {
    "step": "start", "version": 1, "app": "tax-letter-help", "appVersion": "<app version>", "language": "en" | "es",
    "website": "",                     // the bot trap: must be empty
    "contact": { "name": "...", "email": "...", "phone": "..." },   // all three required; a request with no phone is refused
    "existingClient": true | false,
    "relatedCase": "TL-XXXXXX" | null, // a later send for the same letter, e.g. the signed POA
    "notice": { "code": "CP2000", "issuedOn": "YYYY-MM-DD" | null, "taxForm": "1040" | null, "periods": ["2023"],
                "proposedChange": 2400.00 | null, "balanceDue": 0 | null, "summary": "<plain text, at most 600 characters>",
                "letterLanguage": "en" | "es" },
    "dates": [ { "type": "respond_by" | "pay_by" | "appeal_by" | "petition_by" | "hearing_by" | "other", "date": "YYYY-MM-DD",
                 "source": "printed" | "calculated", "page": 2 | null, "confirmedByUser": true | false, "tentative": true | false } ],  // 0 to 6
    "poa": { "status": "not_started" | "draft" | "signed", "spouse": true | false },
    "feeCard": { "version": "2026-11-06", "acknowledged": true },
    "consent": { "share": true, "marketing": true | false },   // share must be true; marketing is a separate, optional choice
    "note": "<at most 1,000 characters>",
    "files": [ { "name": "page-1.jpg", "type": "image/jpeg" | "image/png" | "image/heic" | "application/pdf", "size": 812345,
                 "sha256": "<64 hex>" } ]   // 1 to 10 files, 20 MB in all
  }
  Answer: { "ok": true, "case": "TL-7KQ4XM", "ticket": "<sealed>", "chunkBytes": 3145728, "expiresAt": "<ISO time, about 2 hours ahead>" }
  A second start with the same email and the same file hashes within 2 hours returns the same case, so there are no duplicates.
- Step 2, chunk. POST <address>?step=chunk&file=<0-based index>&offset=<bytes of that file already sent>
  - Header X-Handoff-Ticket: <the newest ticket>. Content-Type application/octet-stream. Body at most chunkBytes.
  - Each file's pieces go in order.
  - Answer: { "ok": true, "ticket": "<new sealed ticket>", "received": <bytes of that file so far> }. Always send the newest ticket.
- Step 3, finish. JSON { "step": "finish", "ticket": "<newest>" }
  - Answer, only when every file arrived whole and matches its size and SHA-256:
    { "ok": true, "case": "TL-7KQ4XM", "receivedAt": "<ISO>", "files": [ { "name", "size", "sha256" } ], "dates": [ { "type", "date" } ] }
  - Otherwise: { "ok": false, "error": "...", "missing": [<file indexes>] }. The app may resend those files' pieces with its ticket until the ticket expires.
- Refusals:
  - 400, in plain words:
    - a full SSN, ITIN or EIN, or a run of 10 or more digits, anywhere in the JSON. The pages themselves are the real notice and are the exception.
    - a missing phone;
    - consent.share not true;
    - more than 10 files, or more than 20 MB;
    - any other file type. The server checks the bytes, not just the declared type.
  - 403 for another origin, with no CORS headers.
  - 413 for a body over its limit, and 415 for the wrong Content-Type.
  - 429 for too many tries: 5 starts per sender an hour, 60 from everyone.
  - 503 { "ok": false, "error": "Secure sending is not switched on yet." } until the firm switches it on.
  - A filled-in bot trap is answered as if accepted, and nothing is recorded.
- Nothing is emailed by either side. The app says "Sent" only after finish answers ok:true.

App integrations and portal gap

Send a reviewed, masked event to Checklists or a record to Family Binder. Links use swfl-apps/1 UTF-8 base64url in a fragment up to 6,000 characters, otherwise a .swfl.json download. Receives strictly validated events and records only, maximum 500 items and 2 MB per import. The fragment is cleared before decoding. Nothing is added without checkbox selection and confirmation. Imported records are marked with source app. Other kinds are rejected because this app does not hold them.

Portal notice receiving contract is missing. reference/portal/app-handoff.ts permits no tax-letter app, and books-imports.ts permits no notice kind. Therefore PORTAL_NOTICE_ENABLED is false. The required “Send to my Spargur Tax portal” button presents the masked preview and explains the gap; it cannot honestly claim a successful supported handoff. The proposed extension is in reference/portal/notice-import.proposed.json. After the portal owner implements and validates that exact extension, enable the flag. Transport is /send-to-portal?app=tax-letter#payload=… or /portal/import?app=tax-letter for a saved file over 6,000 encoded characters. Existing reference contracts are preserved unchanged. Tests translate the proposed plain-field shape and assert that existing portal contracts lack support.

AI_ENDPOINT defaults to empty, hides the optional action, and must remain off until an approved HTTPS service is configured. Enabling a different host also requires explicitly updating CSP connect-src; it never receives original images or raw OCR. Retry is explicit.

Content sources and release review

Original bilingual explanations are in src/knowledge.js, grouped by workflow with notice-specific titles and exceptions. Official links are provided for follow-up. The final verification run passed 73 Node tests and 7 Chrome browser tests. All official notice guide URLs resolved successfully. Mobile layouts and dark mode screenshots were visually inspected. Before release, William Spargur, EA should verify tax wording, current official links and all deadlines, particularly deficiency petitions, CDP rights, backup withholding duties and Florida final-assessment challenges. A phone call or submission never extends legal rights.

Not affiliated with the IRS or the Florida Department of Revenue. General information, not tax advice for your situation.

Sin afiliación con el IRS ni con el Departamento de Ingresos de Florida. Información general; no es asesoramiento tributario para su situación.

Spargur Tax & Accounting PA · William Spargur, EA · 3521 Bonita Bay Blvd Suite 100, Bonita Springs FL 34134 · 239-488-4555 · spargurtax.com

Profile review build

Header profiles route each profile to a separate IndexedDB database, including letter attachments and settings. Existing records remain in the original database as the first profile. Optional salted PBKDF2 PINs are a privacy screen, not encryption. Profile removal keeps the database for recovery and offers immediate undo. Backup remains available in Settings for the current profile. Moving to the new app version? Save a backup in the old one (or in Chrome), then restore it here. All-profile/encrypted backups and full task-specific help are unfinished.

Device profiles and full backups / Perfiles y copias completas

Settings offers current-profile or all-profile backups, including saved pages and the background photo. Share uses the device share sheet when available. Optional passphrase encryption works offline; a lost passphrase means a lost backup. Enter that passphrase before selecting an encrypted restore file. Review profile names and counts, select Merge (existing IDs win) or Replace, then confirm. Undo restores the complete previous data until you leave the page. Version 1 backup files remain supported.

Profiles use accessible name, color and PIN forms. A PIN is a privacy screen, not encryption. Moving to the new app version? Save a backup in the old one (or on the website in Chrome), then restore it here.

Ajustes permite copias del perfil actual o de todos los perfiles, con páginas y foto de fondo. La contraseña opcional cifra la copia sin conexión; si la pierde, pierde la copia. Ingrese la contraseña antes de elegir una copia cifrada. Revise los perfiles y cantidades, elija Combinar o Reemplazar y confirme. Deshacer recupera los datos anteriores hasta salir de la página. El PIN es solo privacidad, no cifrado.

Result review (round 4 part 1) / Revisión del resultado

The result separates proposed changes from established balances, shows the notice/year, exact full date, days remaining and source page/line when found. PDF/OCR text retains page boundaries. Original source-page preview is local. No pixel coordinates are available from the current reader, so the app reports page/line rather than inventing a highlight. Manually changed dates without source evidence remain explicitly unverified. Check the original, tick the review checkbox, and Update details; this never means the firm reviewed or accepted the case. Official guide content was last reviewed 2026-11-05, as recorded in knowledge.js. The fee card uses the owner's supplied 2026-11-06 wording and needs William's release review.

El resultado separa propuestas de saldos, muestra aviso/año, fecha completa, días restantes y página/línea cuando se encuentran. La vista del original es local. El lector no ofrece coordenadas; se muestra página/línea sin inventar un resaltado. Fechas cambiadas sin origen siguen sin verificar. Compare, marque la revisión y Actualizar datos; no significa que la firma revisó ni aceptó el caso. El contenido de la guía se revisó el 5 de noviembre de 2026. Los honorarios del 6 de noviembre de 2026 requieren revisión de William antes de publicar.

Send securely and Schedule an appointment are equally prominent. Scheduling opens exactly https://spargurtax.com/schedule.html without parameters. Sending/booking never extends a deadline or hires the firm. DIY/EA choices currently navigate to the existing checklist and firm action block; the expanded situation routes belong to part 4. The three-step send and later parts are not implemented by part 1.

Enviar y Programar cita tienen igual prominencia. Programar abre la dirección exacta sin parámetros. Enviar/reservar no amplía plazos ni contrata la firma. Las opciones propia/EA abren lista y acciones existentes; las rutas ampliadas corresponden a la parte 4. El envío en tres pasos y las partes posteriores no están implementados por la parte 1.

Every date, reminders and proof / Cada fecha, recordatorios y comprobantes

Keep up to six typed dates with their original wording, page, printed/calculated source, confirmation, tentative status and change history. Estimates remain tentative. Confirm each against the original; reminders start at confirmation, skip passed slots, and combine same-day dates. The calendar uses the chosen local time for 30, 14, 7, 3, 1 days before, due day and a next-day check. Its private title has no notice code or amount. Every reminder detail carries both actions and the current fee card. Re-import after a date or time-zone change. Upcoming / Overdue stays visible; notifications need permission and an open app. No closed-app push alerts. A date is handled only with an action description and photo/PDF proof; other dates stay open. Profile backups include the dates, histories and proof.

Conserve hasta seis fechas con texto original, página, origen impreso/calculado, confirmación, estado provisional e historial. Los estimados siguen provisionales. Confirme con el original; los avisos empiezan al confirmar, omiten fechas pasadas y combinan fechas del mismo día. El calendario usa la hora local elegida: 30, 14, 7, 3, 1 días antes, vencimiento y comprobación el día siguiente. El título privado no contiene código ni importe. Cada detalle incluye ambas acciones y honorarios actuales. Importe de nuevo tras cambiar fecha o zona horaria. Próximos / Vencidos siempre está visible; avisos requieren permiso y app abierta. Una fecha se resuelve solo con descripción y foto/PDF de comprobante; otras fechas siguen abiertas. Las copias incluyen fechas, historial y comprobantes.

DIY or an EA / Ayuda propia o EA

Every knowledge notice has a route. Select applicable situations; disagreement, CP2000 mismatch, missing payments, inability to pay, multiple years, penalties, audit, business/payroll, identity theft, unclear dates and repeated notices recommend review. Deficiency, final levy/hearing deadlines, active levy, possible criminal matters and dates within three days or passed are urgent. CP504 is separate from CP90/LT11/1058. An EA represents before the IRS; court petitions and criminal matters need an appropriate attorney or admitted practitioner. A POA or call never extends a petition period. TAS and LITC links offer free help with no purchase. Never agree to a disputed change to finish a checklist.

Cada aviso de la guía tiene ruta. Seleccione situaciones pertinentes; desacuerdo, discrepancia CP2000, pagos faltantes, incapacidad de pago, varios años, multas, auditoría, empresa/nómina, robo de identidad, fechas dudosas y avisos repetidos recomiendan revisión. Deficiencia, plazos de audiencia/embargo final, embargo activo, posible delito y fechas dentro de tres días/vencidas son urgentes. CP504 se separa de CP90/LT11/1058. Un EA representa ante el IRS; peticiones judiciales y asuntos penales requieren abogado o profesional admitido correspondiente. Poder o llamada nunca amplían plazo de petición. TAS y LITC ofrecen ayuda gratuita sin compra. Nunca acepte un cambio disputado para terminar una lista.

IRS account and transcripts / Cuenta del IRS y transcripciones

The optional checklist keeps only setup progress. Open https://www.irs.gov/account in your normal browser, choose the Individual Online Account and use the identity provider currently offered. Keep security and recovery details private. Each spouse needs their own account; IRS pages may not be in Spanish. The app and firm never ask for SSN, ID documents, passwords or codes. Account transcripts show credits, assessments and dates; return transcripts show the first processed return; record of account combines both; wage and income transcripts can be incomplete or late. Select only wanted transcript PDFs for the package. If setup fails, use https://www.irs.gov/individuals/get-transcript including mail options. Keep the deadline visible; an account is never required to send.

La lista opcional conserva solo progreso. Abra https://www.irs.gov/account en su navegador, elija cuenta individual y use proveedor de identidad actual. Mantenga privados seguridad y recuperación. Cada cónyuge necesita cuenta propia; páginas pueden no estar en español. App y firma nunca piden SSN, documentos de identidad, contraseñas ni códigos. Transcripciones de cuenta muestran créditos, determinaciones y fechas; declaración muestra lo procesado inicialmente; registro de cuenta combina ambas; salarios e ingresos pueden estar incompletos o llegar tarde. Seleccione solo PDF deseados para el paquete. Si falla, use https://www.irs.gov/individuals/get-transcript con opción postal. Mantenga visible el plazo; nunca necesita cuenta para enviar.

Form 2848 helper / Ayuda para Form 2848

Uses the supplied official Form 2848 (January 2021) and pdf-lib 1.17.1. XFA is removed before filling real AcroForm fields; print copies are flattened. The four taxpayer ID/plan boxes, all signatures/dates and optional powers stay blank. Enter only name, mailing address and optional telephone. Proposed Income/1040 matters carry exact periods and source pages; confirm them. Penalties, other forms and unclear matters stay blank for William. Joint letters make two separate forms. The unverified representative profile keeps line 2 and Part II blank until release verification. Print, write SSN/ITIN by hand, check matters/periods, sign page 2 only after William says he will take the case, scan every page and review a signed-POA secure send. A later signed POA uses relatedCase. Signing does not hire the firm or extend deadlines. Spanish cover guidance does not replace the English IRS form.

Usa Form 2848 oficial suministrado (enero 2021) y pdf-lib 1.17.1. Se elimina XFA antes de llenar campos reales y aplanar copias de impresión. Cuatro espacios de ID/plan, firmas/fechas y poderes opcionales quedan vacíos. Escriba solo nombre, dirección y teléfono opcional. Asuntos Income/1040 incluyen períodos exactos y páginas; confírmelos. Multas, otros formularios y dudas quedan vacíos para William. Cartas conjuntas generan dos formularios separados. Perfil de representante sin verificar deja línea 2 y Parte II vacías. Imprima, escriba SSN/ITIN a mano, revise asuntos/períodos, firme página 2 solo cuando William diga que aceptará el caso, escanee todas las páginas y revise envío seguro como poder firmado. Un envío posterior usa relatedCase. Firmar no contrata ni amplía plazos. La guía española no sustituye formulario inglés.

Help for round 4 / Ayuda para ronda 4

Open ? Help, choose a task and Show me how. Tours highlight the actual controls for result reading, every date and proof, reminders, package review and PDF fallback, DIY/EA routes, your IRS account/transcripts and Form 2848. Next explains without activating a control; Skip or Escape exits and focus returns. Reopen any tour from ?. Each new field has an explanation and example. Glossary: POA = specified representation, CAF = representative authorization-file number, transcript = IRS account/return record, notice of deficiency = notice with a separate petition period, CDP hearing = collection hearing with a request deadline, Taxpayer Advocate = independent IRS problem assistance. Sending/booking/POA never handles an IRS deadline.

Abra ? Ayuda, elija tarea y Muéstreme cómo. Las guías resaltan controles reales para resultados, cada fecha y comprobante, recordatorios, paquete y PDF alternativo, rutas propia/EA, cuenta/transcripciones y Form 2848. Siguiente explica sin activar controles; Omitir o Escape sale y devuelve foco. Reabra desde ?. Cada campo nuevo tiene explicación y ejemplo. Glosario: POA = representación específica, CAF = número del archivo de autorizaciones del representante, transcripción = registro de cuenta/declaración del IRS, aviso de deficiencia = plazo separado de petición, audiencia CDP = audiencia de cobro con plazo de solicitud, Defensor del Contribuyente = ayuda independiente del IRS. Enviar/reservar/poder nunca resuelve un plazo.

If a date or page is unclear, check the original or ask for review. If alerts are denied, use the visible list or calendar. If secure send fails, Retry is manual, or save the PDF packet and open secure upload. If a transcript PDF is rejected, select a readable PDF within 10 files / 20 MB for the complete package. If Form 2848 cannot be made, check typed name/address, confirm clear matters and cache the official form once online. Never type a tax ID into this helper.

Si fecha o página es dudosa, revise original o solicite revisión. Si se deniegan avisos, use lista visible o calendario. Si falla envío, Reintentar es manual, o guarde PDF y abra carga segura. Si rechaza transcripción, elija PDF legible dentro de 10 archivos / 20 MB del paquete completo. Si falla Form 2848, revise nombre/dirección, confirme asuntos claros y descargue formulario oficial una vez con conexión. Nunca escriba ID tributario en esta ayuda.