Attivare l'invio PEPPOL da WordPress o Shopify

Obiettivo

Attivare l’invio di fatture elettroniche tramite la rete PEPPOL direttamente dal tuo store WordPress o Shopify.

Per la Francia il corridoio è distinto (gov-fr, non PEPPOL generico): vedi france-peppol.

Prerequisiti

• Su WordPress: nessun piano minimo, l’attivazione e l’invio sono disponibili su ogni piano (incluso Free), a consumo di crediti. Su Shopify serve invece il piano Basic o superiore.
• Indirizzo (via, città, CAP) della legal entity completo — PEPPOL richiede questi campi per la registrazione dell’endpoint.
• Per la Germania: va scelto esplicitamente il “corridoio documentale” (zugferd o peppol) — senza questa scelta l’attivazione non si completa.

Passi

Puoi attivare PEPPOL in tre modi equivalenti:

1. Pannello account — su popapi.io, vai su Il mio account > Integrazioni, apri la scheda PEPPOL e attiva “Attiva PEPPOL”.
2. Dal plugin/app, account già esistente — su WordPress: scheda Generali, aggiorna le informazioni di licenza, poi vai su Integrazioni e clicca sulla card PEPPOL per attivarla.
3. Wizard di configurazione al primo accesso — se stai configurando l’account per la prima volta e il tuo paese usa il corridoio PEPPOL, l’attivazione avviene automaticamente al completamento del wizard.

Invio automatico

• WordPress — scheda Avanzate > Invio automatico delle fatture: abilita l’invio via WP-Cron in background.
• Shopify — l’invio automatico su ordine pagato è disponibile sui piani a pagamento; è disabilitato di default per i clienti privati (PEPPOL è un corridoio B2B).

Invio manuale

Usa il bottone “Invia Fattura” nella tabella fatture per inviare un singolo documento alla rete PEPPOL.

Errori comuni

• “Questo campo è richiesto quando PEPPOL è attivo” — manca indirizzo, città o CAP della legal entity: completali nel pannello account prima di riprovare.
• Attivazione Germania bloccata — per gli account DE serve scegliere il corridoio documentale (zugferd o peppol) prima che l’attivazione vada a buon fine.
• L’invio automatico non parte per un cliente privato — atteso: PEPPOL è pensato per destinatari business, l’invio automatico a clienti privati è disabilitato per design.

Configurazione correlata

Per i dettagli del contratto API (payload, mapping campi UBL), vedi api/peppol.