Installare Sylius

Order Invoicer si collega al suo negozio Sylius tramite la sua Admin API (API Platform v2). L'autenticazione avviene con le credenziali di un amministratore dotato di accesso API: Order Invoicer le scambia con un token di breve durata a ogni sincronizzazione. Non è richiesta alcuna chiave API permanente.

Prerequisiti

Sylius 2.x con l'API abilitata (abilitata per impostazione predefinita)
Il suo negozio è accessibile tramite HTTPS
Un account amministratore con accesso API (ROLE_API_ACCESS)

1. Abilitare l'accesso API per un amministratore

L'Admin API di Sylius è raggiungibile solo dagli amministratori dotati del ruolo ROLE_API_ACCESS. Un amministratore normale può autenticarsi ma gli verrà negato l'accesso API (errore 403).

Le consigliamo di creare un amministratore dedicato per l'integrazione:

Acceda al pannello di amministrazione Sylius.
Apra Configuration → Administrators.
Crei un nuovo amministratore (o ne modifichi uno esistente) e attivi l'opzione API access (ROLE_API_ACCESS).
Salvi, quindi annoti la sua email e la sua password.

Un amministratore dedicato semplifica la revoca dell'accesso ed evita di esporre il suo account principale. Order Invoicer necessita solo dell'accesso in lettura agli ordini.

2. Raccogliere i dati di connessione

Avrà bisogno di tre informazioni:

URL del negozio: l'indirizzo principale del suo negozio, ad es. https://store.example.com (senza /admin o percorso: Order Invoicer aggiunge /api/v2/admin automaticamente).
Email dell'amministratore: l'email dell'amministratore con accesso API.
Password dell'amministratore: la password di quell'account.

3. Collegare il negozio in Order Invoicer

In Order Invoicer, aggiunga un connettore e selezioni Sylius.
Inserisca l'URL del negozio, l'email e la password dell'amministratore.
Clicchi su Testa connessione per verificare le sue credenziali.
Salvi: Order Invoicer inizierà a sincronizzare gli ordini completati.

4. Verificare la configurazione

Può testare l'autenticazione API tramite cURL:

curl -X POST "https://store.example.com/api/v2/admin/administrators/token" \
  -H "Content-Type: application/ld+json" \
  -d '{"email":"admin@example.com","password":"your-password"}'

Una risposta contenente un campo token conferma che le credenziali sono valide e che l'amministratore dispone dell'accesso API.

Risoluzione dei problemi comuni

Errore "The user doesn't have ROLE_API_ACCESS" (403)

L'amministratore si è autenticato ma non dispone dell'accesso API. Attivi l'opzione API access su quell'account (veda il passaggio 1), oppure utilizzi un amministratore dedicato.

Errore "Invalid credentials" (401)

Verifichi l'email e la password dell'amministratore.
Si assicuri che l'account sia attivo.

Errore di connessione o 404

Verifichi che l'URL sia la radice del negozio (https://store.example.com), non l'URL di amministrazione (.../admin/...).
Si assicuri che il negozio sia raggiungibile tramite HTTPS e che l'API sia abilitata.

Assistenza

Se incontra difficoltà, ci contatti all'indirizzo contact@orderinvoicer.com.

Nota: una volta completata questa configurazione, potrà collegare il suo strumento di fatturazione in Order Invoicer.