Usare l'ambiente sandbox per i test

Obiettivo

Eseguire richieste di test verso l’API POP senza consumare crediti dell’account.

Prerequisiti

• Una license_key valida (vedi get-your-license-key).

Passi

Puoi attivare la sandbox in due modi equivalenti:

1. Parametro esplicito — invia "environment": "sandbox" nel body verso https://popapi.io/wp-json/api/v2/....
2. Gateway sandbox — chiama https://sandbox.popapi.io/wp-json/api/v2/... senza specificare environment: il gateway lo forza automaticamente. Se invii comunque environment esplicito, quello ha priorità.

Tutte le route di generazione documento (SdI, PEPPOL, KSeF, PDF, ZUGFeRD, Facturae legacy) accettano environment: sandbox.

Verifica

• Le richieste sandbox non consumano credito.
• Sulle route XML, invoice_number viene restituito con prefisso SANDBOX-.

Errori comuni

• Il webhook configurato non riceve nulla in sandbox — la consegna via webhook non è disponibile in sandbox: è un limite atteso, non un errore di configurazione.
• La consegna a Fatture in Cloud non parte in sandbox — stesso motivo: non supportata in sandbox.
• L’invio email PDF non funziona in sandbox — non è un limite: la consegna email PDF è consentita anche in sandbox.

Configurazione correlata

Vedi api/sdi e le altre pagine api/* per il comportamento specifico di ogni route in sandbox.