Skip to main content
This guide will help you quickly set up FacturaScripts and create your first invoice. Perfect for getting familiar with the system.
This guide uses the development version. For production deployment, see the Installation Guide.

​
Prerequisites

Before you begin, ensure you have:
  • PHP 8.0 or higher
  • MySQL/MariaDB or PostgreSQL
  • Composer
  • Node.js & npm
See System Requirements for detailed specifications.

​
Installation

1

Clone and Install

Clone the repository and install dependencies:
# Clone the repository
git clone https://github.com/NeoRazorX/facturascripts.git
cd facturascripts

# Install PHP dependencies
composer install

# Install JavaScript dependencies
npm install
2

Configure Database

Create a database and configuration file:
CREATE DATABASE facturascripts CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
Create config.php in the root directory:
<?php
define('FS_DB_TYPE', 'mysql');
define('FS_DB_HOST', 'localhost');
define('FS_DB_NAME', 'facturascripts');
define('FS_DB_USER', 'your_user');
define('FS_DB_PASS', 'your_password');
define('FS_TIMEZONE', 'Europe/Madrid');
define('FS_DEBUG', true);
3

Start the Server

Launch the development server:
php -S localhost:8000 index.php
Or use the Composer script:
composer dev-server
Open http://localhost:8000 in your browser.
4

Complete Setup Wizard

The setup wizard will guide you through:
  1. Create Admin Account
    • Choose a secure username and password
    • Enter your email address
  2. Company Information
    • Company name and tax ID
    • Address and contact details
    • Default currency
  3. Accounting Setup
    • Fiscal year start date
    • Chart of accounts (select your country template)
    • Tax rates and VAT configuration
Click Complete Setup and wait for initialization (30-60 seconds).

​
Create Your First Invoice

Now that FacturaScripts is set up, let’s create your first invoice:
1

Add a Customer

  1. Go to Sales → Customers
  2. Click New Customer
  3. Fill in required fields:
    • Name or business name
    • Tax ID / VAT number
    • Email address
    • Billing address
  4. Click Save
FacturaScripts will automatically create a subaccount for this customer in your chart of accounts.
2

Add a Product

  1. Go to Warehouse → Products
  2. Click New Product
  3. Enter product details:
    • Reference code (SKU)
    • Description
    • Sale price
    • Tax rate
  4. Click Save
You can leave stock management for later. For services, you don’t need to track inventory.
3

Create the Invoice

  1. Go to Sales → Invoices
  2. Click New Invoice
  3. Select your customer from the dropdown
  4. In the lines section, click Add Line:
    • Select the product (or enter description manually)
    • Enter quantity
    • Price will auto-fill from product data
    • Tax is calculated automatically
  5. Review the totals at the bottom
  6. Click Save
The invoice code is generated automatically following your configured series numbering.
4

Generate the PDF

After saving the invoice:
  1. Click the Print button (printer icon)
  2. Select the template (default is fine)
  3. The PDF will be generated and downloaded
  4. You can now send this to your customer!
To email the invoice directly from FacturaScripts:
  1. Click More Actions → Send by Email
  2. Enter recipient email (pre-filled from customer data)
  3. Customize the subject and message
  4. Click Send
Make sure email is configured in Admin → Settings → Email.

​
Record a Payment

Mark the invoice as paid when you receive payment:
  1. Open the invoice
  2. Click More Actions → Generate Payment Receipt
  3. Enter payment details:
    • Payment method (cash, bank transfer, etc.)
    • Payment date
    • Amount (pre-filled with invoice total)
  4. Click Save
The invoice status will change to “Paid” and an accounting entry will be created automatically.
FacturaScripts automatically creates the accounting entry that debits your bank/cash account and credits the customer’s receivables account.

​
Explore Key Features

Now that you’ve created your first invoice, explore these features:

Quotes & Orders

Create quotes and convert them to invoices

Accounting Entries

View and create accounting journal entries

Inventory Management

Track stock levels and movements

Reports

Generate sales and accounting reports

​
Common Next Steps

Go to Admin → Settings → Payment Methods to configure:
  • Cash
  • Bank transfer
  • Credit card
  • Direct debit
  • Custom payment methods
Each payment method can have default due dates and accounting accounts.
Go to Admin → Settings → Taxes to add or modify tax rates:
  • Standard VAT rate
  • Reduced VAT rates
  • Exempt categories
  • Special tax regimes
Tax rates are automatically applied when creating invoices based on product configuration.
Import customers, products, or other data:
  1. Go to the relevant list view (Customers, Products, etc.)
  2. Click Import
  3. Download the CSV template
  4. Fill in your data
  5. Upload and map columns
  6. Review and confirm import
See Managing Customers for detailed import instructions.
Extend FacturaScripts functionality:
  1. Go to Admin → Plugins
  2. Browse available plugins
  3. Install plugins for:
    • E-commerce integration
    • Payment gateways
    • Shipping providers
    • Advanced reporting
    • Custom features
See Plugin Management for more information.

​
Getting Help

User Guides

Step-by-step tutorials

FAQ

Common questions answered

Community Support

Discord & GitHub help

​
What’s Next?

1

Learn Core Features

Explore the main features:
2

Configure Your System

Set up FacturaScripts for your business:
3

Customize & Extend

Make FacturaScripts your own:
For production deployment with Apache or Nginx, proper SSL configuration, and performance optimization, see the complete Installation Guide.

Build docs developers (and LLMs) love

Get started for freeTalk to us