API & Integrazioni
Genera chiavi API per collegare il tuo gestionale (Motork, Infinity, Carmove, ecc.) e sincronizzare l'inventario.
Guida al collegamento
Collega il tuo sito o gestionale a BUYCARNOW per pubblicare e sincronizzare automaticamente il tuo inventario. Segui i 5 passi.
1 · Genera una chiave API
Clicca «Nuova chiave» in alto, assegna un nome (es. il tuo gestionale) e copia subito la chiave mostrata: non sarà più visibile.
2 · Inserisci la chiave nel tuo gestionale
Nel pannello del tuo gestionale/sito cerca la sezione «Esportazione / Marketplace esterni / API» e incolla la chiave nel campo token/authorization. Indica come endpoint:
https://buycarnow.base44.app/functions/multipub-api3 · Mappa i campi del tuo inventario
Assicura che ogni veicolo esportato contenga almeno make, model, year, price. Usa external_id con un codice stabile del tuo gestionale per aggiornare e cancellare senza duplicati.
4 · Testa la connessione
Invia un primo veicolo con action create_listing. Se ricebi { status: "active" } la sincronizzazione funziona; se ricebi "pending" l'annuncio è in attesa di verifica dealer.
5 · Imposta la sincronizzazione
Programma sul tuo gestionale un export ogni 15-30 minuti con action upsert_listing (aggiorna i presenti, crea i nuovi) e delete_listing per i veicoli venduti/rimossi.
Dove trovi le impostazioni nei gestionali più comuni
I nomi delle sezioni possono variare: cerca voci come «API», «Esportazione», «Portali esterni» o «Web Service».
Una volta collegato, ogni veicolo pubblicato o vendito sul tuo gestionale viene riflesso automaticamente su BUYCARNOW entro il ciclo di sincronizzazione.
Documentazione API
Endpoint unico per l'integrazione con gestionali (Motork, Gestionale Auto, Infinity, Carmove, ManagerCar, Quattroruote, ecc.). Tutte le chiamate sonoPOSTcon chiave nell'header Authorization: Bearer <api_key>. Usa bulk_sync per la riconciliazione completa ogni 15 minuti: upsert di tutto lo stock e cancellazione automatica dei veicoli venduti/rimossi (max 300 veicoli per chiamata).
curl -X POST https://buycarnow.base44.app/functions/multipub-api \
-H "Authorization: Bearer bcn_live_..." \
-H "Content-Type: application/json" \
-d '{
"action": "create_listing",
"vehicle": {
"external_id": "V001",
"make": "Volkswagen",
"model": "Golf",
"version": "TSI 150",
"year": 2021,
"price": 18900,
"mileage": 32000,
"fuel_type": "petrol",
"transmission": "manual",
"location_city": "Milano",
"images": ["https://..."],
"features": ["navigator", "clima"]
}
}'Campi veicolo
| Campo | Tipo | Descrizione |
|---|---|---|
| external_id | string | ID interno del gestionale (per upsert/update) |
| make | string | Marca (obbligatorio) |
| model | string | Modello (obbligatorio) |
| version | string | Allestimento/versione |
| year | number | Anno (obbligatorio) |
| price | number | Prezzo € (obbligatorio) |
| price_type | free|financed|insurance | Tipo prezzo |
| mileage | number | Km |
| fuel_type | petrol|diesel|electric|hybrid|lpg|cng | Alimentazione |
| transmission | manual|automatic|semiautomatic | Cambio |
| body_type | sedan|suv|hatchback|... | Carrozzeria |
| color | string | Colore |
| vin | string | Telaio |
| plate | string | Targa |
| location_city | string | Località |
| postal_code | string | CAP |
| latitude | number | Latitudine |
| longitude | number | Longitudine |
| images | string[] | URL immagini |
| features | string[] | Optional |
| description | string | Descrizione |
Risposte
{ id, status, action } dove status è
bulk_sync risponde { action, upserted, deleted, skipped, total }: