Numero fattura e stato POP nei report Shopify (es. Report Pundit)
Obiettivo
Rendere numero fattura, numero nota di credito e stato di invio POP leggibili da app di reporting Shopify di terze parti (es. Report Pundit), senza export manuali né l’integrazione a pagamento “POP to Webhook”.
Cosa serve
- Nessuna configurazione: i metafield vengono creati automaticamente al primo caricamento dell’app POP dopo l’aggiornamento (funziona anche su installazioni già esistenti).
- Per leggerli da un’app terza (es. Report Pundit): mappa i seguenti metafield nella configurazione di quell’app.
Metafield disponibili
Tutti sotto il namespace app, visibili nativamente nella pagina ordine di Shopify Admin (sono “pinned”):
| Chiave | Tipo | Contenuto |
|---|---|---|
app.pop_fattura_numero | testo | Numero fattura (es. 0787/2026) |
app.pop_fattura_status | testo | Stato del canale attivo per la fattura (es. RC, MC, NS, sent, valid) |
app.pop_nota_credito_numero | JSON | { "<refund_id>": "<numero nota di credito>" }, una voce per ogni nota di credito sull’ordine |
app.pop_nota_credito_status | JSON | { "<refund_id>": "<stato>" }, stesso schema |
Da sapere
- Il numero fattura viene pubblicato indipendentemente dall’invio a un canale ufficiale (SdI, PEPPOL, ecc.): anche gli store solo-PDF o su mercati senza canale ufficiale ottengono il metafield popolato.
- Se lo stato passa a
NS(non spedibile), il numero fattura resta invariato: cambia solo lo stato. - Un ordine può avere più note di credito (rimborsi multipli): ogni nota di credito ha la propria voce nel JSON, indicizzata per id del rimborso.
Verifica
- Genera una fattura (o nota di credito) su un ordine di test dopo l’aggiornamento.
- Apri l’ordine in Shopify Admin: i metafield
app.pop_fattura_numeroeapp.pop_fattura_statusdevono comparire nella sezione metafield, con i valori attesi. - Configura la tua app di reporting per leggere questi metafield sull’ordine.
Errori comuni
- Gli ordini vecchi non hanno il metafield valorizzato: atteso, i metafield vengono popolati solo dalle fatture generate dopo l’aggiornamento, non retroattivamente. Per un ordine specifico, rigenera il documento per farlo comparire.
- I metafield non compaiono affatto sulla pagina ordine: riapri l’app POP da Shopify Admin, le definizioni dei metafield vengono create al primo caricamento dopo l’aggiornamento.
Configurazione correlata
Per capire quando POP genera effettivamente la fattura o la nota di credito su Shopify, vedi shopify-faq.