API Documentation - Impresa Felice

Panoramica API

Le API di Impresa Felice permettono di integrare e gestire dati di prodotti finanziari, pratiche, anagrafiche aziendali e documenti attraverso endpoint RESTful.

Prodotti Finanziari

Gestione completa dei prodotti bancari e finanziari

Pratiche

Creazione e gestione delle pratiche di finanziamento

Anagrafiche

Gestione delle aziende e dei dati anagrafici

Autenticazione

Nota: Attualmente le API non richiedono autenticazione. In un ambiente di produzione, sarebbe necessario implementare un sistema di autenticazione con token API.

Base URL: https://your-domain.com/api/

Content-Type: application/json

API GET - Recupero Dati

GET /api/prodotti - Recupera tutti i prodotti finanziari

Descrizione

Restituisce l'elenco completo di tutti i prodotti finanziari con i relativi dettagli.

Esempio di Risposta

{
  "success": true,
  "data": [
    {
      "id": 1,
      "nome": "Prestito PMI Plus",
      "tipo": "Prestito PMI",
      "istituto_id": 1,
      "istituto_nome": "Banca Esempio",
      "importo_minimo": 10000.0,
      "importo_massimo": 500000.0,
      "durata_massima": 60,
      "tasso_interesse_medio": 3.5,
      "data_aggiornamento": "2025-07-07T10:00:00"
    }
  ],
  "count": 1
}

GET /api/pratiche - Recupera tutte le pratiche

Descrizione

Restituisce l'elenco completo di tutte le pratiche di finanziamento.

Esempio di Risposta

{
  "success": true,
  "data": [
    {
      "id": 1,
      "codice_pratica": "P20250001",
      "ragione_sociale": "Azienda Esempio S.r.l.",
      "partita_iva": "12345678901",
      "importo_richiesto": 50000.0,
      "stato_pratica": "In Revisione",
      "data_creazione": "2025-07-07T10:00:00"
    }
  ],
  "count": 1
}

GET /api/anagrafiche - Recupera tutte le aziende

Descrizione

Restituisce l'elenco completo delle aziende con i relativi dati anagrafici.

Esempio di Risposta

{
  "success": true,
  "data": [
    {
      "id": 1,
      "ragione_sociale": "Azienda Esempio S.r.l.",
      "partita_iva": "12345678901",
      "email": "info@aziendaesempio.it",
      "telefono": "+39 012 345 6789",
      "citta": "Milano",
      "settore_attivita": "Tecnologia",
      "fatturato_annuo": 1000000.0,
      "numero_dipendenti": 25
    }
  ],
  "count": 1
}

GET /api/reti-terze - Recupera tutte le reti terze

Descrizione

Restituisce l'elenco delle reti terze (segnalatori) con statistiche di performance.

GET /api/documenti - Recupera tutti i documenti

Descrizione

Restituisce l'elenco dei documenti caricati nel sistema.

GET /api/istituti-bancari - Recupera tutti gli istituti bancari

Descrizione

Restituisce l'elenco degli istituti bancari partner.

API POST - Creazione Dati

POST /api/prodotti - Crea un nuovo prodotto finanziario

Parametri Richiesti

Campo	Tipo	Descrizione
nome	string	Nome del prodotto
tipo	string	Tipologia (Mutuo, Leasing, Prestito PMI, etc.)
istituto_id	integer	ID dell'istituto bancario
importo_minimo	float	Importo minimo finanziabile
importo_massimo	float	Importo massimo finanziabile

Esempio di Richiesta

{
  "nome": "Prestito PMI Plus",
  "tipo": "Prestito PMI",
  "istituto_id": 1,
  "importo_minimo": 10000.0,
  "importo_massimo": 500000.0,
  "durata_massima": 60,
  "tasso_interesse_medio": 3.5
}

POST /api/pratiche - Crea una nuova pratica

Parametri Richiesti

Campo	Tipo	Descrizione
ragione_sociale	string	Ragione sociale dell'azienda
partita_iva	string	Partita IVA dell'azienda
importo_richiesto	float	Importo richiesto per il finanziamento
azienda_id	integer	ID dell'azienda (se esistente)
rete_terza_id	integer	ID della rete terza segnalante

Esempio di Richiesta

{
  "ragione_sociale": "Nuova Azienda S.r.l.",
  "partita_iva": "98765432101",
  "importo_richiesto": 75000.0,
  "settore_attivita": "Manifatturiero",
  "azienda_id": 5,
  "rete_terza_id": 2
}

POST /api/anagrafiche - Crea una nuova azienda

Parametri Richiesti

Campo	Tipo	Descrizione
ragione_sociale	string	Ragione sociale dell'azienda
partita_iva	string	Partita IVA (deve essere unica)
email	string	Email aziendale
telefono	string	Numero di telefono
indirizzo	string	Indirizzo sede legale

Esempio di Richiesta

{
  "ragione_sociale": "Nuova Azienda S.r.l.",
  "partita_iva": "98765432101",
  "email": "info@nuovaazienda.it",
  "telefono": "+39 012 345 6789",
  "indirizzo": "Via Roma 123",
  "citta": "Milano",
  "settore_attivita": "Tecnologia",
  "fatturato_annuo": 500000.0,
  "numero_dipendenti": 15
}

POST /api/documenti - Crea un nuovo record documento

Parametri Richiesti

Campo	Tipo	Descrizione
filename	string	Nome del file documento
document_type	string	Tipo di documento
pratica_id	integer	ID della pratica collegata
azienda_id	integer	ID dell'azienda collegata

Esempi di Utilizzo

JavaScript (Fetch API)

// Recupera tutti i prodotti
fetch('/api/prodotti')
  .then(response => response.json())
  .then(data => {
    console.log('Prodotti:', data.data);
  });

// Crea una nuova pratica
fetch('/api/pratiche', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    ragione_sociale: 'Azienda Esempio',
    partita_iva: '12345678901',
    importo_richiesto: 50000
  })
})
.then(response => response.json())
.then(data => {
  console.log('Pratica creata:', data);
});

Python (Requests)

import requests

# Recupera tutte le aziende
response = requests.get('https://your-domain.com/api/anagrafiche')
companies = response.json()

# Crea una nuova azienda
new_company = {
    'ragione_sociale': 'Nuova Azienda S.r.l.',
    'partita_iva': '98765432101',
    'email': 'info@nuovaazienda.it'
}

response = requests.post(
    'https://your-domain.com/api/anagrafiche',
    json=new_company
)
result = response.json()

Gestione Errori

Codici di Stato HTTP

200 OK - Richiesta eseguita con successo
201 Created - Risorsa creata con successo
400 Bad Request - Dati della richiesta non validi
404 Not Found - Risorsa non trovata
409 Conflict - Conflitto (es. P.IVA duplicata)
500 Internal Server Error - Errore del server

Formato delle Risposte di Errore

{
  "success": false,
  "error": "Descrizione dettagliata dell'errore"
}

Esempi di Errori Comuni

// Campo obbligatorio mancante
{
  "success": false,
  "error": "Missing required field: ragione_sociale"
}

// P.IVA duplicata
{
  "success": false,
  "error": "Company with this VAT number already exists"
}

// Istituto bancario non trovato
{
  "success": false,
  "error": "Banking institution not found"
}