Generare fatture senza un account POP

Per iniziare2026-09-01

Obiettivo

Generare un documento fiscale (fattura, nota di credito o PDF) chiamando l’API POP senza aver ancora creato un account, per provare il formato di output prima di decidere se collegare un account vero.

Cosa serve

Nessuna license_key: basta omettere il campo (o il header X-API-Key) dalla richiesta.
Un payload data valido, come per una chiamata autenticata.

Cosa copre

Route disponibili: create-xml (SdI), create-ubl (PEPPOL), create-ksef-xml (KSeF), create-zugferd (ZUGFeRD), create-pdf.
Solo generazione locale del documento: nessun invio a un canale esterno (SdI, PEPPOL, KSeF, Zoho, Fatture in Cloud, Aruba, SdI via PEC). Per inviare un documento serve un account POP con un’integrazione attiva.
Limite: 1000 generazioni al mese per sito, condiviso tra tutte le route sopra.

Come viene identificato il chiamante

Senza un account non c’è un user_id da usare: il limite mensile è tracciato per combinazione di site_url (se presente nel payload) e indirizzo IP della richiesta. Includere site_url nel payload rende il conteggio stabile anche se l’IP cambia (es. dietro un proxy o CDN).

Verifica

Chiama una delle route sopra senza license_key: se sotto il limite mensile, ottieni l’XML/PDF generato normalmente, come con un account autenticato.

Errori comuni

pop_api_generation_rate_limit (429): limite mensile di generazioni anonime raggiunto per questo sito/IP, collega un account POP per continuare oltre le 1000 generazioni.
L’invio a un canale fallisce: atteso, la generazione anonima copre solo l’output locale del documento, non l’invio. Serve un account con l’integrazione desiderata attiva.

Configurazione correlata

Per collegare un account vero e sbloccare l’invio ai canali ufficiali, vedi get-your-license-key.