Modelli del Marketplace

Cosa offrono i design pronti

Marketplace offre punti di partenza progettati da PDFgine per proposte, report, presentazioni e documenti simili. Dopo aver aggiunto un modello allo spazio di lavoro puoi modificarne testo, dati, colori e layout nel generatore.

Per ora solo PDFgine pubblica modelli nel Marketplace. Non esiste un flusso per consentire ai clienti di vendere i propri modelli.

Tipi di accesso

• Gratuito: un utente con l'autorizzazione richiesta può aggiungere il modello direttamente allo spazio di lavoro.
• Incluso nel piano: nessun costo extra se il piano di abbonamento attivo include il modello.
• A pagamento: il modello può essere installato nello spazio di lavoro interessato dopo la verifica del pagamento una tantum.

Ottenere e usare un modello

1. Trova un design per categoria o ricerca, poi esamina copertina e descrizione.
2. Aggiungi un modello gratuito o incluso nel piano oppure completa il checkout sicuro per un design a pagamento.
3. L'installazione aggiunge una copia modificabile del design alla sezione Modelli dello spazio di lavoro selezionato.
4. Aprilo nel generatore, sostituisci i dati di esempio con i tuoi e verifica output PDF, Word e visualizzatore prima di pubblicare.

Il codice del modello deve essere univoco nello spazio di lavoro. Una collisione non sovrascrive il modello esistente: viene richiesto un altro codice.

Pubblicare e installare tramite API

Tutte le operazioni della schermata del marketplace sono disponibili come endpoint: elencare le pubblicazioni, copiare un modello nel tuo account, pubblicarne uno tuo e impostarne il prezzo.

# Elenca le pubblicazioni
curl -s "https://api.pdfgine.com/api/v1/marketplace/templates?locale=en" \
  -H "X-PDFgine-Key: $PDFGINE_KEY"

# Copiane uno nel tuo account
curl -X POST https://api.pdfgine.com/api/v1/marketplace/templates/consulting-proposal/install \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "code": "proposal", "name": "Proposta" }'

# Pubblica uno dei tuoi modelli
curl -X POST https://api.pdfgine.com/api/v1/templates/invoice/marketplace \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "title": "Fattura con condizioni di pagamento",
        "summary": "Un modello di fatturazione con condizioni di pagamento e un blocco dei totali.",
        "category": "reports",
        "locale": "en",
        "license": "commercial",
        "visibility": "public",
        "confirmAssetRedistributionRights": true
      }'

# Imposta il prezzo - priceMinorUnits è obbligatorio quando isFree è false
curl -X PUT https://api.pdfgine.com/api/v1/marketplace/templates/invoice-with-payment-terms/offer \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "isFree": false,
        "priceMinorUnits": 4900,
        "currency": "USD",
        "includedPlanCodes": ["business", "enterprise"],
        "expectedVersion": 3
      }'

L'installazione copia il modello nel tuo account; le modifiche successive dell'autore non raggiungono la tua copia. Per pubblicare devi confermare di poter ridistribuire i font e le immagini del modello: tale conferma viene registrata.

I tuoi grafici e modelli

Creare un modello o un grafico proprio non richiede acquisti nel Marketplace. In vendita c'è il design pronto preparato da PDFgine.

Gli errori più comuni

• L'installazione copia il design nel tuo spazio di lavoro. Le modifiche successive dell'autore non raggiungono la copia e nemmeno i tuoi interventi vengono mai sovrascritti.
• Il codice deve essere libero nel tuo spazio di lavoro. Una collisione non sovrascrive mai il modello: l'installazione viene rifiutata e richiede un altro codice.
• Oggi pubblica solo PDFgine. Gli endpoint di pubblicazione e offerta rispondono 403 per uno spazio di lavoro senza ruolo di editore: non costruirci ancora un flusso di vendita.
• Il cursore dell'elenco contiene i filtri. Cambiare ricerca, categoria o lingua mantenendo before restituisce volutamente 400, altrimenti lo stesso cursore punterebbe a un elenco diverso.
• Un design a pagamento si installa solo dopo la verifica del pagamento. Chiamare install prima e checkout dopo causa un rifiuto, non una coda.