Logo
Sign Up

Fatture in Cloud

Learn how to connect and configure Fatture in Cloud for automated invoice generation.

Before You Start

Prerequisites

What You'll Need

  • Email Pre-registration - Contact BrickInvoice support first (required)
  • Fatture in Cloud Account - You'll authenticate using OAuth 2.0 (no API keys needed)
  • Company Access - Permission to create customers and invoices

Part 1: Email Pre-registration (Required)

Important: Register Before Connecting

Before you can connect to Fatture in Cloud, you must first register your email address with BrickInvoice support. This is required because Fatture uses a developer environment that requires pre-approved access.

Registration Steps

  1. Identify your Fatture email - Use the same email address you use to log into Fatture in Cloud
  2. Contact BrickInvoice - Visit the BrickInvoice contact form and submit:
    • Your email address used for Fatture in Cloud
  3. Wait for confirmation - BrickInvoice support will add your email to the developer environment
  4. Proceed with connection - Once confirmed, you can connect your account

Why Pre-registration?

Fatture in Cloud requires developers to whitelist user email addresses in their developer environment. This security measure ensures only authorized users can connect their Fatture accounts to BrickInvoice.

Note: This is a one-time requirement. Once registered, you can connect and disconnect without needing to register again.

Part 2: Connecting Fatture in Cloud

Step 1: Initiate OAuth Connection

  1. Navigate to: /home/accounting/connect
  2. Select "Fatture in Cloud" from the package dropdown
  3. Read the pre-registration notice - Ensure you've completed email registration
  4. Click "Connect to Fatture in Cloud" - you'll be redirected to Fatture
  5. Log into your Fatture account using your registered email
  6. Select the company you want to connect (if you have multiple)
  7. Authorize BrickInvoice to access your Fatture data

Step 2: Complete Connection

After authorizing:

  • You'll be redirected back to BrickInvoice
  • The connection will be verified and saved automatically
  • You'll be prompted to select your company for invoicing

Security Note

BrickInvoice uses OAuth 2.0 authentication, which means:

  • Your Fatture in Cloud credentials are never stored by BrickInvoice
  • Access tokens are encrypted in the database
  • Tokens automatically refresh when needed
  • You can revoke access anytime from Fatture settings

Part 3: Configuring Fatture in Cloud Settings

After successfully connecting Fatture in Cloud, you'll need to configure how orders are processed and mapped to your accounting system.

Understanding Fatture Products

Fatture in Cloud uses Products to represent items on invoices. Unlike some accounting systems that use general ledger accounts directly, Fatture requires you to:

  1. Create Products in Fatture first (via Prodotti menu)
  2. Configure each Product with appropriate VAT rates
  3. Map Products in BrickInvoice to different transaction types and regions

Each product in Fatture includes:

  • Product name and description
  • Price information
  • VAT rate (automatically applied to invoice line items)
  • Category and notes

Company Selection

After connecting, you'll select which Fatture company to use for invoicing:

  1. View available companies - All companies you have access to will be listed
  2. Select primary company - Choose the company where invoices should be created
  3. Save selection - This company will be used for all invoice creation

You can change the selected company later in the configuration settings.

Invoice Line Item Structure

Each order creates an invoice with separate line items for different product types and customer locations. You'll need to configure Products for:

Product Line Items (Standard Products)

  • LEGO parts and sets subject to standard VAT rates
  • Separate Products based on customer location:
    • Domestic: Sales within Italy (e.g., 22% VAT)
    • EU: Sales to other EU countries (e.g., 22% VAT for standard products)
    • Export/Other: International sales outside the EU (e.g., 0% VAT)
  • Each Product needs appropriate VAT rate based on your tax rules

Margin Scheme Line Items (Second-hand Goods)

  • Products subject to margin scheme (special VAT treatment for used goods)
  • Separate Products based on customer location:
    • Domestic: Margin scheme sales within Italy (0% or margin scheme rate)
    • EU: Margin scheme sales to other EU countries (0% or margin scheme rate)
    • Export/Other: Margin scheme sales outside the EU (0% VAT)
  • VAT rates typically set to 0% or margin scheme rate
  • Note: Only applicable if you use margin scheme for second-hand goods

Handling Fees Line Items

  • Processing and handling costs
  • Single Product that applies to all regions
  • Set appropriate VAT rate (usually same as standard rate)

Shipping Line Items

  • Shipping and delivery costs
  • Single Product that applies to all regions
  • Set appropriate VAT rate (usually same as standard rate)

Product Mapping

For each line item type and region, you'll map a Fatture Product:

Product Sales:

  • Domestic Product - For Italian customers (e.g., "LEGO Parts - Italy 22%")
  • EU Product - For other EU customers (e.g., "LEGO Parts - EU 22%")
  • Export Product - For non-EU customers (e.g., "LEGO Parts - Export 0%")

Margin Scheme Sales:

  • Domestic Margin - For Italian customers (e.g., "Margin Scheme - Italy")
  • EU Margin - For other EU customers (e.g., "Margin Scheme - EU")
  • Export Margin - For non-EU customers (e.g., "Margin Scheme - Export")

Other Items:

  • Shipping Product - For shipping costs (e.g., "Shipping Costs")
  • Handling Fees Product - For processing fees (e.g., "Handling Fees")

Subject Configuration

The Subject field appears on Fatture invoices as an optional reference text:

  • This is a fixed text field (not variable/dynamic)
  • Enter a description like "BrickInvoice Order" or "LEGO Parts Order"
  • Can be left empty if you don't need a subject line
  • This text will appear on all invoices created from BrickInvoice

Configuration Tips

1. Create Products in Fatture First

  • Go to Fatture in Cloud → Prodotti (Products)
  • Create Products for each category and region
  • Set appropriate VAT rates for each product
  • Use clear, descriptive names

2. Use Consistent Naming

  • Example: "LEGO Parts - Domestic 22%", "Shipping - EU 0%"
  • Makes it easier to identify Products in BrickInvoice configuration
  • Helps with bookkeeping and reporting

3. Review VAT Settings

  • Domestic (Italy): Usually 22% standard VAT rate
  • EU: Usually 22% standard VAT rate (same as domestic for standard products)
  • Export: 0% for sales outside the EU
  • Margin Scheme: 0% or special margin scheme rate (for second-hand goods only)

4. Test with Sample Order

  • Process one test order to verify configuration
  • Check created invoice in Fatture
  • Verify VAT amounts and product assignments are correct
  • Ensure customer information syncs properly

Part 4: Invoice Features

Automatic Invoice Creation

When orders are synchronized:

  1. Customer Sync: Customer data is created or updated in Fatture
  2. Invoice Generation: Invoice is created with proper line item structure
  3. VAT Application: Correct VAT rates applied based on customer location and product
  4. Invoice Number: Fatture automatically assigns an invoice number
  5. Invoice URL: Direct link to view invoice in Fatture is provided

Customer Management

BrickInvoice automatically manages customers (clienti) in your Fatture system:

  • Customer Creation: New customers are automatically created based on order data
  • Customer Updates: Existing customer information is updated when needed
  • Customer Search: System searches by company/customer name to avoid duplicates
  • Address Information: Billing addresses are mapped from order data

Invoice URLs

BrickInvoice automatically generates direct links to view invoices in your Fatture interface. These URLs allow you to quickly navigate to the invoice in Fatture for review or further processing.

Example URL format: https://secure.fattureincloud.it/invoices/view/{invoice_id}

Troubleshooting

Connection Issues

"Email Not Registered" or "Connection Failed"

  • Cause: Your email hasn't been added to BrickInvoice's Fatture developer environment
  • Solution: Contact support@brickinvoice.com with your Fatture email address
  • Wait time: Usually processed within 24 hours

"Failed to Connect to Fatture"

  • Browser popup blockers: Disable for BrickInvoice domain
  • Invalid company: Ensure you selected the correct Fatture company
  • Wrong email: Verify you're using the registered email address

"Token Expired" or "Authentication Failed"

  • Automatic refresh: Tokens refresh automatically, but connection may have been revoked
  • Reconnect: Go to accounting settings and reconnect Fatture
  • Revoked access: Check if you revoked BrickInvoice access in Fatture settings

Configuration Issues

"Products Not Loading"

  • Check connection: Verify Fatture is still connected
  • Permissions: Ensure your Fatture user has access to Products
  • Empty products: Check that you have created products in Fatture
  • Refresh: Try refreshing the configuration page

"Company Not Found"

  • Access rights: Verify you have access to the company in Fatture
  • Company status: Ensure company is active in Fatture
  • Reconnect: Try disconnecting and reconnecting your account

"Invoice Creation Failed"

  • Missing products: Verify all required products are configured
  • Invalid VAT: Selected product may have invalid VAT rate
  • Product settings: Verify Products have correct VAT assignments in Fatture
  • Customer data: Ensure order has complete customer information

Common Errors

"No company selected"

  • Cause: Company ID not configured in settings
  • Solution: Go to accounting configuration and select your company

"Product {id} not found"

  • Cause: Configured product was deleted or made inactive in Fatture
  • Solution: Update product mappings in BrickInvoice configuration

"VAT rate mismatch"

  • Cause: Product's VAT rate in Fatture doesn't match expected rate
  • Solution: Review and update VAT rates in Fatture for configured products

Disconnecting Fatture in Cloud

To disconnect Fatture:

  1. Navigate to: /home/accounting/connect
  2. Click "Disconnect" button
  3. Confirm the disconnection
  4. Access is revoked both in BrickInvoice and Fatture

Note: Existing invoices in Fatture are not affected by disconnecting. Your email remains registered for future connections.

Best Practices

VAT Configuration for Italian Businesses

Standard Setup:

  • Domestic (Italy): 22% standard VAT rate
  • EU Sales: 22% standard VAT rate (same as domestic for standard products)
  • Export Sales: 0% (no VAT for non-EU sales)
  • Margin Scheme: 0% (special treatment for second-hand goods)

Product Organization

Recommended Product Structure:

Products in Fatture:
├── LEGO Parts - Domestic (22% VAT)
├── LEGO Parts - EU (22% VAT)
├── LEGO Parts - Export (0% VAT)
├── Margin - Domestic (0% Margin)
├── Margin - EU (0% Margin)
├── Margin - Export (0% Margin)
├── Shipping (22% VAT)
└── Handling Fees (22% VAT)

Next Steps

After configuring Fatture in Cloud:

  1. Test integration - Process a few test orders
  2. Verify invoices - Check that invoices are created correctly in Fatture
  3. Review VAT treatment - Ensure VAT rates are applied correctly based on customer location
  4. Set up automation - Configure automated invoice generation schedules
  5. Monitor integration - Regularly check that orders sync properly

Support

If you encounter issues with the Fatture in Cloud integration:

  • Pre-registration: Use the BrickInvoice contact form
  • Connection issues: Verify email registration and Fatture credentials
  • Configuration help: Review product mappings and VAT settings
  • Invoice errors: Check Fatture product setup and customer data
  • Technical support: Use the contact form with specific error details