PEPPOL BIS / UBL XML

POST /wp-json/api/v2/create-ubl genera XML UBL PEPPOL BIS dal payload condiviso POP.

Cosa serve

• payload data valido, licenza autenticata abilitata
• PEPPOL è un corridoio B2B: il destinatario deve essere un soggetto business

Output

• successo: XML UBL grezzo
• errore (validazione, quota, webhook, integrazione): JSON strutturato

Consegna

XML generato può essere inviato a integrazioni PEPPOL attive o a webhook configurati.

Da sapere

• l’instradamento del destinatario non usa sdi_type; deriva da identificativi VAT/registrazione e, quando possibile, da lookup nella directory PEPPOL
• purchase_order_data.id diventa OrderReference (spesso necessario per soddisfare PEPPOL-EN16931-R003 in invio a validazione provider)
• connected_invoice_data.id/date diventano BillingReference per le note di credito
• connector_exclusive_channel_active (403): l’invio PEPPOL è bloccato mentre Zoho è il canale di fatturazione attivo e connesso sull’account; la generazione locale UBL non è comunque interessata
• country_not_eligible_for_peppol: il paese registrato sull’account non è un paese PEPPOL supportato
• generazione e invio via WordPress, API diretta, n8n o MCP non richiedono più un piano a pagamento: ogni piano, incluso Free, può inviare usando i propri crediti disponibili. Su Shopify l’invio richiede ancora il piano Basic o superiore
• paesi PEPPOL attualmente supportati (28): AT, BE, BG, CY, CZ, DE, DK, EE, FI, FR, GR, HR, HU, IE, IS, LT, LU, LV, MT, NL, NO, PT, RO, SE, SI, SK, CH, GB. Esclusi deliberatamente: Spagna (corridoio Facturae, non ancora supportato), Irlanda del Nord (non abilitata nel catalogo paesi), Liechtenstein (nessuno schema di identificativo endpoint PEPPOL configurato)
• Francia (gov-fr, beta): quando il paese del trasmittente è FR, la richiesta viene instradata automaticamente al corridoio gov-fr invece del PEPPOL generico: stesso contratto pubblico (integration.use = peppol), nessun valore diverso da passare. Il corridoio ha una propria Legal Entity e propri messaggi di errore ("France Legal Entity is missing.", "France integration is not active." al posto degli equivalenti PEPPOL). Il SIREN richiesto per la Legal Entity viene derivato automaticamente dalla partita IVA francese sull’account (ultime 9 cifre); un campo opzionale fr_siren nel payload di account-setup permette di forzarne uno diverso. Copre solo e-invoicing: l’e-reporting francese non è ancora implementato. Vedi france-peppol per la guida di attivazione.