# Focus Varejo MCP

> Focus Varejo manages all mandatory retail and telecom fiscal documents in Brazil through your AI agent. Instantly emit consumer invoices (NFC-e) for point-of-sale sales, generate service invoices (NFCom), confirm receipt of goods (manifestation), and list every received service bill (NFS-e). It keeps your compliance documentation automated.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** retail-invoicing, point-of-sale, fiscal-compliance, brazil-tax, telecom-billing

## Description

Managing Brazilian fiscal paperwork—the stuff that tracks every sale and service rendered—is a nightmare. You need to issue consumer receipts for physical sales, generate invoices for telecom services, confirm incoming deliveries, and track old bills. This MCP handles it all via natural conversation. Your AI client connects to this system, making the entire process conversational. Instead of manually logging into multiple portals or dealing with confusing paperwork flow, you simply ask your agent what needs to be done. It talks to the Focus NFe API to issue NFC-e for retail sales and NFCom for telecom services. You can also confirm that a supplier's invoice is received by running manifestation commands (NF-e and CT-e), or view all service invoices sent to your company. Because this entire compliance layer is available through Vinkius, you connect once from any MCP-compatible client and immediately gain access to managing every facet of your tax documentation.

## Tools

### cancel_nfce
Cancels a consumer invoice (NFC-e) if it was issued incorrectly or needs to be voided.

### consult_nfce
Checks the current authorization status and validity of an existing NFC-e document.

### consult_nfcom
Verifies the operational status of a generated Communication/Telecom Service Invoice (NFCom).

### emit_nfce
Generates and issues a new NFC-e document for retail sales transactions.

### emit_nfcom
Creates and sends a new NFCom invoice specifically for telecommunications services billing.

### list_received_nfse
Retrieves a comprehensive list of all service invoices (NFS-e) received by your company's CNPJ.

### manifest_cte
Confirms receipt and acknowledgment of transport documents using the CT-e manifest command.

### manifest_nfe
Sends a confirmation (Ciência, Confirmação) that you have received and processed goods documented by an NF-e.

## Prompt Examples

**Prompt:** 
```
Emit an NFC-e for a sale of R$89.90.
```

**Response:** 
```
NFC-e emitted! Reference: NFC-001. Status: Authorized.
```

**Prompt:** 
```
Manifest NF-e 3523010000000000000055001000001000 as confirmed.
```

**Response:** 
```
Manifestation sent successfully. Event: Confirmation (210760).
```

**Prompt:** 
```
List all service invoices received by CNPJ 12.345.678/0001-00.
```

**Response:** 
```
Found 12 received NFS-e. Latest: Service from XYZ Company, R$500.00.
```

## Capabilities

### Process retail sales invoices
The tool emits consumer invoices (NFC-e) for immediate point-of-sale transactions.

### Generate telecom service invoices
It creates specific invoices (NFCom) required for communication and telecommunications services.

### Confirm incoming tax documents
You confirm receipt of supplier invoices using manifestation commands for both NF-e and CT-e.

### Check invoice status
The system checks the authorization or current status for existing NFC-e or NFCom records.

### Review received service bills
It lists all service invoices (NFS-e) that have been sent to your company's CNPJ.

## Use Cases

### Closing out a major retail sale
A store manager needs to record a high-value in-store sale. Instead of manually calculating and issuing the receipt, they tell their agent: 'Issue an invoice for R$500.' The agent calls `emit_nfce` immediately, generating the required NFC-e document with confirmation.

### Processing incoming supplier shipments
The purchasing department received a shipment and needs to confirm it. They ask their agent to 'Confirm receipt of NF-e 352...'. The agent executes `manifest_nfe`, officially logging the goods' arrival in the tax system.

### Handling billing for telecom services
The finance team needs to bill a client for monthly data usage. They prompt their agent, 'Generate the service invoice.' The agent calls `emit_nfcom`, creating and transmitting the required NFCom document.

### Auditing outstanding liabilities
The accounts team needs to know what bills are waiting for them. They ask their agent, 'List all service invoices received last month.' The agent runs `list_received_nfse` and provides a clean list of all pending NFS-e records.

## Benefits

- Avoid manual compliance headaches. Instead of logging into separate government portals, your agent handles issuing NFC-e for retail sales or NFCom for telecom services through one conversation.
- Gain immediate visibility into incoming bills. Using the `list_received_nfse` tool lets you instantly see every service invoice sent to your company, eliminating manual data searches.
- Streamline confirmation workflows. You confirm receipt of goods and transport documents by calling `manifest_nfe` or `manifest_cte`, completing necessary tax steps in seconds.
- Handle errors gracefully. If a sale needs reversing, you can use `cancel_nfce`. Need to know if an invoice is valid? The `consult_nfce` tool checks the status immediately.
- Centralized control over all documentation. You manage every phase—from emission (`emit_nfce`) to consultation and manifestation—without context switching between different platforms.

## How It Works

The bottom line is you tell your agent what needs to happen in plain English, and it handles the complex API calls to generate or check official documents.

1. Subscribe to this MCP and provide your Focus NFe API Token and Base URL.
2. Your AI client authenticates the connection, making all fiscal data available through conversation.
3. You issue a simple command—like 'Issue an invoice for XYZ sale'—and the system executes the required tax documentation sequence.

## Frequently Asked Questions

**How do I issue a consumer invoice with Focus Varejo MCP?**
You tell your agent to emit the invoice. The system calls `emit_nfce` to create and send the NFC-e document for your retail sale.

**Can I list all my past service bills using Focus Varejo MCP?**
Yes, you can use the `list_received_nfse` tool. It pulls a complete record of every service invoice sent to your company's CNPJ.

**What is the difference between manifest_nfe and emit_nfce?**
You use `emit_nfce` when you are *creating* a sale receipt. You use `manifest_nfe` when you have *received* goods and need to confirm that receipt to the tax authority.

**What if I need to cancel an invoice? Do I call Focus Varejo MCP?**
Yes, use the `cancel_nfce` tool. It handles the formal process of voiding the original NFC-e document and logging that cancellation correctly.

**Is this MCP only for retail stores?**
No. While it covers retail, it also supports telecom billing via NFCom and general supply chain confirmations using manifestation tools like `manifest_cte`.