# Focus Admin MCP for AI Agents AI Agent Connect > Focus Admin lets you manage Brazilian electronic invoices through your AI agent. You can issue Correction Letters (CC-e), manage unused numbering ranges, distribute DF-e documents, and pull XML or DANFE files directly into your workspace. It connects to the Focus NFe API to handle complex fiscal tasks without you having to click through a separate dashboard. ## Overview - **Category:** erp-operations - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_gv7tw4naG0Gm4qYRFdVouQJFmPRX3mKFf7NgrEGj/ai-agent-connect - **Tags:** electronic-invoicing, fiscal-compliance, brazil-tax, xml-processing, invoicing ## Description Managing Brazilian fiscal documents usually means jumping between browser tabs, hunting for specific XML files, and manually entering data into different panels. It's a headache for anyone trying to keep compliance up to date. This Connector changes that by letting your AI agent handle the heavy lifting. Instead of navigating a complex portal to find a specific invoice from last month, you just ask your agent to pull it. You can issue Correction Letters for minor errors, mark lost numbering as unusable, or grab all the XMLs you need for an audit in one go. Because it's part of the Vinkius catalog, you get these capabilities integrated directly into your existing workflow. It turns a multi-step manual process into a simple conversation. You stop worrying about the how of the API and start focusing on the what of your accounting. ## Tools ### send_cc_e Issue a Correction Letter for an NF-e that has minor errors. This fixes small data mistakes without canceling the invoice. ### cancel_cc_e Cancel a Correction Letter that was sent but needs to be retracted. This helps correct mistakes in the correction process. ### download_nfe_danfe Grab the DANFE PDF for a specific NF-e. This is useful for quickly getting the physical document for a record. ### download_event_xml Get the XML for specific NF-e events like manifestations or CC-e. This provides deeper detail on invoice history. ### inutilize_numbering Mark a range of NF-e numbers as unused if they were lost or damaged. This prevents double-use of numbers. ### list_nfse_emitted See a list of all NFS-e documents your company has issued. This helps track service-related invoices. ### list_nfse_received View a list of all NFS-e documents your company has received. This is great for tracking incoming services. ### list_nfe_by_period Retrieve all NF-e documents within a specific date range. Use this to quickly gather data for a specific month. ### distribute_dfe Consult and distribute DF-e documents using the NSU. Use this to manage document distribution efficiently. ### download_nfe_xml Pull the XML document for an authorized NF-e. This is the primary way to get data for tax software. ## Prompt Examples **Prompt:** ``` List all NF-e issued by CNPJ 12.345.678/0001-00 from 2026-03-01 to 2026-03-31. ``` **Response:** ``` I've retrieved the list of NF-e documents for that period. Here is the summary: | Document ID | Date | Value | Status | | :--- | :--- | :--- | :--- | | REF-001 | 2026-03-02 | R$ 1,200.00 | Authorized | | REF-002 | 2026-03-05 | R$ 450.00 | Authorized | | REF-003 | 2026-03-10 | R$ 3,100.00 | Authorized | **Total documents found:** 3 ``` **Prompt:** ``` Inutilize NF-e numbering from 1000 to 1050 for series 1, model 55, year 2026. ``` **Response:** ``` ✅ **Success!** The numbering range **1000-1050** for **Series 1**, **Model 55**, **Year 2026** has been successfully marked as unusable. This range is now blocked to prevent any future use. ``` **Prompt:** ``` Send a CC-e for NF-e REF-001 correcting the buyer's phone number. ``` **Response:** ``` I've sent the Correction Letter (CC-e) for NF-e **REF-001**. * **Action:** Corrected buyer's phone number. * **Status:** Sent successfully. * **Protocol:** 123456789 You can use this protocol number to track the correction in your records. ``` ## Capabilities ### Issue Correction Letters Send CC-e for NF-e that have minor errors without leaving your chat interface. ### Manage Unused Numbering Mark lost or damaged NF-e numbering ranges as unusable to maintain fiscal integrity. ### Bulk Document Retrieval Download NF-e XML documents and DANFE PDFs for specific periods or records. ### Distribute DF-e Documents Query and distribute DF-e documents using the NSU for better tracking. ### Audit Invoice History List all NF-e or NFS-e documents issued or received within a specific date range. ### Retrieve Event XMLs Get XML files for specific NF-e events like manifestations or previous corrections. ## Use Cases ### Audit Preparation An accountant needs all XMLs from March. They ask the agent to use list_nfe_by_period and download_nfe_xml for that month. ### Quick Error Correction A fiscal analyst finds a typo in a buyer's phone number. They ask the agent to use send_cc_e to fix it immediately. ### Handling Lost Paperwork A warehouse manager reports a lost batch of invoices. The analyst uses inutilize_numbering to block those numbers. ### Service Invoice Tracking A compliance officer needs to see all service invoices received. They ask the agent to use list_nfse_received. ## Benefits - Stop hunting for files by using download_nfe_xml to grab every document your agent finds in seconds. - Handle errors faster by using send_cc_e to issue Correction Letters without logging into the portal. - Keep your numbering clean by using inutilize_numbering to mark lost ranges instantly. - Simplify audits by using list_nfe_by_period to see every invoice from a specific timeframe. - Streamline document distribution with distribute_dfe to query available documents by NSU. - Reduce manual entry errors by letting your agent handle CC-e issuance and numbering management. ## How It Works The bottom line is you get a direct line to your fiscal data without leaving your chat interface. 1. Subscribe to the Focus Admin MCP on Vinkius. 2. Provide your Focus NFe API Token and Base URL in your AI client settings. 3. Ask your agent to list invoices, download files, or manage numbering. ## Frequently Asked Questions **Can Focus Admin help with Brazilian NF-e?** Yes, it connects to the Focus NFe API to manage invoices, CC-e, and other fiscal documents directly through your AI agent. **How do I get XML files using Focus Admin?** You can ask your agent to download them for specific periods or individual records. It pulls the authorized XML documents for your records automatically. **Can I fix errors on old invoices with Focus Admin?** Yes, you can issue Correction Letters (CC-e) for minor errors on existing NF-e documents without having to cancel and re-issue the entire invoice. **What about lost numbering?** You can use the tool to mark lost numbering ranges as unusable. This ensures that your fiscal sequence remains accurate and compliant. **Does Focus Admin support NFS-e too?** Yes, it can list both issued and received service invoices (NFS-e) for your company, making it a complete solution for many fiscal tasks. **Does Focus Admin support DF-e?** Yes, it can query and distribute DF-e documents using the NSU, helping you manage document distribution more effectively. **What is a CC-e (Carta de Correção)?** CC-e is a Correction Letter used to fix minor errors in an authorized NF-e, such as typos in the buyer's address or product descriptions. It cannot be used to change values, quantities, or tax rates. **When should I use Inutilização?** Use Inutilização when a range of NF-e numbering has been damaged, lost, or will not be used. This tells the tax authority that those numbers are intentionally skipped. **What is DF-e Distribution?** DF-e Distribution allows you to query all fiscal documents (NF-e, CT-e, etc.) issued against your CNPJ. Use it with the last NSU to retrieve only new documents. **Can I automate my accounting department with this?** Yes! The 'List by Period' and 'Download XML & DANFE' tools allow your AI agent to fetch all invoices from a specific month, download the XMLs, and seamlessly integrate them into accounting workflows.