Fatturazione elettronica - Francia

L'API Fatturazione Elettronica - Francia permette di automatizzare l'intero ciclo di vita delle fatture elettroniche, semplificando l'integrazione con il sistema francese di e-invoicing e riducendo la complessità dei flussi documentali.

Con un'unica API puoi gestire l'emissione, la ricezione e il monitoraggio delle fatture elettroniche. La piattaforma instrada automaticamente ogni documento attraverso il canale di trasmissione più appropriato, utilizzando la rete Peppol, la rete nazionale francese oppure, quando previsto, canali alternativi, garantendo la conformità alla normativa vigente.

Oltre all'invio delle fatture, l'API consente di configurare le aziende, ricevere documenti passivi, monitorarne lo stato in tempo reale e ricevere aggiornamenti automatici tramite callback. L'integrazione è progettata per adattarsi sia a software gestionali sia a piattaforme enterprise che elaborano elevati volumi di documenti.

La logica di integrazione riprende quella dell'API Fatturazione Elettronica Italia: stessi principi di configurazione, stessa gestione asincrona e stesso utilizzo delle callback. Chi utilizza già il servizio italiano può quindi estendere rapidamente i propri sistemi anche al mercato francese.

Dopo l'invio di una fattura, gli aggiornamenti sullo stato del documento vengono notificati automaticamente tramite callback, consentendo al gestionale di rimanere costantemente sincronizzato senza effettuare interrogazioni continue alle API.

Configurazione azienda e servizi

POST /FR-configurations

La configurazione dell'azienda rappresenta il primo passo per utilizzare l'API Fatturazione Elettronica Francia. Attraverso questo endpoint puoi registrare l'azienda, abilitare il servizio di invio, di ricezione oppure entrambi, in base alle esigenze della tua integrazione, e configurare le callback che riceveranno automaticamente gli aggiornamenti sullo stato dei documenti.

Per completare l'onboarding è sufficiente fornire il SIREN (9 cifre) oppure il SIRET (14 cifre). Il servizio crea automaticamente la configurazione dell'azienda, recupera le informazioni necessarie per l'identificazione fiscale e prepara l'ambiente per la gestione delle fatture elettroniche secondo la normativa francese.

Una volta completata la configurazione, l'azienda è pronta a utilizzare i servizi abilitati, sia per l'invio delle fatture elettroniche, sia per la ricezione, oppure per entrambe le funzionalità. Non è necessario gestire configurazioni differenti in base al canale di trasmissione: sarà l'API a occuparsi dell'intero processo durante il ciclo di vita del documento.

ESEMPIO RICHIESTA

L'esempio seguente mostra una richiesta di configurazione dell'azienda con l'abilitazione dei servizi di fatturazione elettronica e la definizione di una callback per ricevere automaticamente gli aggiornamenti relativi alle fatture.

{
  "fiscal_id": "21750001600019",
  "vat_id": "FR12217500016",
  "name": "Your Company FR",
  "email": "[email protected]",
  "customer_invoice": true,
  "supplier_invoice": true,
  "address": {
    "street_address": "Rue de Rivoli 42",
    "zip_code": "75001",
    "city": "Paris",
    "country": "FR"
  },
  "api_configurations": [
    {
      "event": "customer-invoice",
      "callback": {
        "url": "https://your-server.site/webhook/fr/out"
      }
    }
  ]
}

La configurazione viene eseguita una sola volta e costituisce il punto di partenza dell'integrazione. Da questo momento il gestionale potrà inviare e ricevere fatture elettroniche, mentre gli aggiornamenti sullo stato dei documenti verranno notificati automaticamente tramite le callback configurate.

Invio fattura elettronica

POST /FR-invoices

L'endpoint POST /FR-invoices permette di inviare fatture elettroniche francesi B2B e B2G tramite un'unica richiesta API. È sufficiente trasmettere i dati della fattura: il servizio ne verifica la correttezza, genera il formato conforme alla normativa francese e avvia automaticamente il processo di trasmissione.

L'integrazione è progettata per semplificare al massimo il lavoro degli sviluppatori. Il gestionale invia sempre la fattura allo stesso endpoint REST, mentre la piattaforma gestisce automaticamente tutte le operazioni necessarie per la consegna del documento.

Per le fatture destinate alla Pubblica Amministrazione francese, il documento viene instradato verso il canale previsto dalla normativa. Per le fatture B2B, invece, il servizio individua automaticamente il canale di trasmissione più appropriato in base alla configurazione del destinatario.

ESEMPIO RICHIESTA

L'esempio seguente mostra l'invio di una fattura elettronica. Una volta ricevuta la richiesta, il servizio prende in carico il documento e ne gestisce automaticamente il processo di trasmissione.

{
  "document_number": "INV-2026-001",
  "issue_date": "2026-05-12",
  "currency": "EUR",
  "total_amount_including_tax": 61.20,
  "sender": {
    "name": "Your Company",
    "fiscal_id": "YourCompanyFiscalId",
    "vat_id": "FR12345678901"
  },
  "recipient": {
    "name": "Customer Company",
    "fiscal_id": "CustomerFiscalId",
    "email": "[email protected]"
  },
  "invoice_lines": [
    {
      "description": "Professional Service",
      "quantity": 1,
      "unit_price": 250.00,
      "tax_rate": 20
    }
  ]
}

Dopo l'invio viene restituita una conferma tecnica della presa in carico della richiesta. L'elaborazione della fattura prosegue in modalità asincrona e gli aggiornamenti relativi alla consegna, all'accettazione, al rifiuto o al pagamento vengono notificati automaticamente tramite callback.

Monitoraggio del ciclo di vita delle fatture

CALLBACK Stati documento

Dopo l'invio della fattura, il servizio restituisce immediatamente una conferma tecnica della presa in carico della richiesta. L'elaborazione del documento prosegue in modalità asincrona e ogni aggiornamento viene notificato automaticamente tramite callback.

A differenza del sistema italiano, dove il Sistema di Interscambio comunica principalmente l'esito della trasmissione, il processo francese continua anche dopo la consegna della fattura. Il destinatario può infatti accettare il documento, contestarlo, rifiutarlo oppure comunicarne il pagamento.

Per questo motivo è possibile monitorare l'intero ciclo di vita della fattura attraverso una serie di stati che vengono aggiornati automaticamente durante tutto il processo.

Le notifiche vengono inviate automaticamente agli endpoint configurati durante la fase di onboarding, consentendo al gestionale di rimanere costantemente sincronizzato con l'evoluzione dei documenti senza dover effettuare richieste periodiche alle API.

Consultazione delle fatture

GET /FR-invoices

L'endpoint GET /FR-invoices consente di recuperare l'elenco delle fatture elettroniche associate all'azienda configurata, sia attive che passive. I documenti vengono restituiti con le relative informazioni di dettaglio e con lo stato aggiornato del processo di elaborazione.

Questo servizio è utile per sincronizzare il proprio gestionale, costruire dashboard di monitoraggio oppure recuperare rapidamente lo storico delle fatture elaborate dalla piattaforma.

{
  "data": [
    {
      "document_number": "INV-2026-001",
      "issue_date": "2026-05-12",
      "currency": "EUR",
      "type": "380",
      "amount_including_tax": 61.2,
      "total_amount_including_tax": 61.2,
      "amount_excluding_tax": 51,
      "total_amount_excluding_tax": 51,
      "tax_amount": 10.2,
      "total_tax_amount": 10.2,
      "sender": {
        "name": "ACME France SARL",
        "fiscal_id": "21750001600019",
        "siren": "217500016",
        "siret": "21750001600019",
        "vat_id": "FR12217500016",
        "email": "[email protected]",
        "address": {
          "street_address": "Rue de Rivoli 42",
          "zip_code": "75001",
          "city": "Paris",
          "country": "FR"
        }
      },
      "recipient": {
        "name": "ACME France SARL",
        "fiscal_id": "21750001600019",
        "siren": "217500016",
        "siret": "21750001600019",
        "vat_id": "FR12217500016",
        "email": "[email protected]",
        "address": {
          "street_address": "Rue de Rivoli 42",
          "zip_code": "75001",
          "city": "Paris",
          "country": "FR"
        }
      },
      "invoice_lines": [
        {
          "description": "Wireless Mouse",
          "quantity": 2,
          "unit_price": 25.5,
          "tax_rate": 20,
          "total_net_amount": 51,
          "unit_of_measure": "C62",
          "nature": "standard",
          "tax_category": "standard"
        }
      ],
      "payment_means": [
        {
          "payment_mode": "sepa_credit_transfer",
          "due_date": "2026-06-12",
          "amount": 61.2,
          "financial_account": "FR7630006000011234567890123"
        }
      ],
      "tax_subtotals": [
        {
          "taxable_amount": 51,
          "tax_amount": 10.2,
          "vat_rate": 20,
          "tax_category": "standard"
        }
      ],
      "chorus_pro_service_code": "SERVICES_TECH",
      "commitment_number": "PO-12345",
      "attachments": [
        {
          "document": "JVBERi0xLjcKJeLjz9MK...",
          "mime_type": "application/pdf",
          "filename": "INV-2026-001.pdf",
          "description": "Invoice PDF",
          "document_id": "INV-2026-001"
        }
      ],
      "id": "645a3f2b1c0d9e8f7a6b5c4d",
      "state": "NEW",
      "details": {
        "external_status": "submitted",
        "network": "fr-dgfip",
        "siren": "217500016",
        "siret": "21750001600019",
        "service_code": "SERVICES_TECH",
        "commitment_number": "PO-12345",
        "invoice_type": "Factur-X",
        "submission_date": "2026-05-12T15:30:00Z"
      },
      "create_at": "2026-05-12T15:30:00Z"
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

La risposta include tutte le informazioni della fattura, comprese le informazioni del mittente e del destinatario, il dettaglio delle righe del documento, gli importi, le modalità di pagamento, gli allegati e lo stato corrente del processo di trasmissione. Gli endpoint di consultazione consentono di recuperare in qualsiasi momento i dati aggiornati delle fatture elettroniche elaborate dal servizio.

Dettaglio di una fattura

GET /FR-invoices/{id}

Per ottenere il dettaglio di una specifica fattura è possibile utilizzare l'endpoint GET /FR-invoices/{id}, specificando l'identificativo del documento restituito durante la fase di invio o di ricezione.

La risposta include tutte le informazioni della fattura, lo stato corrente del documento e i dati relativi al processo di trasmissione.

Quando necessario è possibile utilizzare il parametro refresh=true, che forza la sincronizzazione con il sistema di trasmissione e restituisce lo stato più aggiornato disponibile.

ESEMPIO RICHIESTA

L'esempio seguente mostra come recuperare il dettaglio di una fattura aggiornandone lo stato in tempo reale.

GET /FR-invoices/645a3f2b1c0d9e8f7a6b5c4d?refresh=true

Nella maggior parte dei casi gli aggiornamenti vengono ricevuti automaticamente tramite callback. Gli endpoint di consultazione rappresentano uno strumento aggiuntivo per verificare lo stato di uno specifico documento o sincronizzare sistemi esterni quando necessario.

Ricezione delle fatture elettroniche passive

L'API Fatturazione Elettronica Francia permette di ricevere automaticamente le fatture elettroniche emesse dai fornitori, centralizzando l'intero ciclo passivo direttamente all'interno del proprio gestionale.

Dopo aver abilitato il servizio durante la configurazione dell'azienda, ogni fattura destinata all'organizzazione viene acquisita automaticamente e resa disponibile attraverso le callback configurate, indipendentemente dal canale utilizzato per la consegna.

Ogni evento supplier-invoice contiene le informazioni necessarie per identificare il documento e avviare automaticamente i processi di registrazione, contabilizzazione o approvazione nel gestionale.

CONFIGURAZIONE CALLBACK

Per ricevere automaticamente le fatture passive è sufficiente configurare un endpoint di callback durante l'onboarding dell'azienda.

{
  "api_configurations": [
    {
      "event": "supplier-invoice",
      "callback": {
        "url": "https://your-server.site/webhook/fr/in"
      }
    }
  ]
}

Ogni nuova fattura ricevuta viene inviata automaticamente all'endpoint configurato, consentendo al gestionale di acquisire il documento e avviare immediatamente i processi interni senza ulteriori chiamate alle API.

La fatturazione elettronica francese prevede diversi canali di trasmissione, utilizzati in base alla tipologia del destinatario e alle modalità di ricezione configurate. Questo rende l'integrazione più articolata rispetto ad altri sistemi nazionali.

Con l'API Fatturazione Elettronica Francia non è necessario implementare logiche differenti per ogni canale. Il gestionale invia sempre la fattura allo stesso endpoint REST e sarà la piattaforma a selezionare automaticamente il percorso di consegna più appropriato.

Per le fatture destinate alla Pubblica Amministrazione francese (B2G), il documento viene invece trasmesso direttamente tramite Chorus Pro, secondo le modalità previste per gli enti pubblici.

Questo approccio consente di sviluppare un'unica integrazione API, lasciando alla piattaforma tutta la complessità legata alla selezione del canale di trasmissione e alla gestione delle evoluzioni normative.

A chi si rivolge l'API Fatturazione Elettronica Francia

L'API Fatturazione Elettronica Francia è progettata per tutte le realtà che desiderano integrare e automatizzare la gestione delle fatture elettroniche francesi direttamente nei propri software. È la soluzione ideale per software house, sviluppatori, ERP e Independent Software Vendor (ISV) che vogliono aggiungere rapidamente la conformità alla normativa francese attraverso un'unica integrazione API, senza dover gestire la complessità dei diversi canali di trasmissione.

Si rivolge anche ad aziende italiane e internazionali con clienti, fornitori o sedi operative in Francia, piattaforme e-commerce, marketplace e software di contabilità che devono emettere e ricevere automaticamente fatture elettroniche, oltre a studi professionali e società di consulenza che gestiscono i processi amministrativi e fiscali dei propri clienti.

Grazie all'instradamento intelligente delle fatture, alle callback in tempo reale e alla logica di integrazione condivisa con l'API Fatturazione Elettronica Italia, la soluzione si adatta sia a progetti con volumi contenuti sia a piattaforme enterprise che elaborano migliaia di documenti ogni giorno, riducendo tempi di sviluppo, costi di manutenzione e complessità operativa.