Custom Product Catalog Source
Porta il tuo catalogo prodotti
In Bird, puoi creare una fonte personalizzata di catalogo prodotti utilizzando un endpoint API. La risposta API deve rispettare un formato specifico che include dettagli del prodotto, varianti, immagini e altro. Di seguito è riportata una guida su come strutturare i dati del tuo catalogo prodotti e su come crearlo utilizzando l'API.
Creare Custom Product Catalog
Catalogo Prodotti Source API Format
La risposta dall'endpoint API dovrebbe essere un array di oggetti prodotto, ciascuno contenente diversi campi. Ecco la struttura e i valori di esempio per ciascun campo:
Campi Obbligatori:
id (stringa): Un identificatore univoco per il prodotto. Esempio:
"8890650190078"
name (stringa): Il nome del prodotto. Esempio: "
My Test Product"
description (stringa): Una descrizione del prodotto. Esempio:
"Un prodotto fantastico con luci disponibili in diversi colori"
status (stringa): Lo stato attuale del prodotto. I valori validi sono:
active
: Il prodotto è attivo e disponibile.archived
: Il prodotto è archiviato.draft
: Il prodotto è una bozza. Esempio:"active"
created_at (stringa): La data e l'ora in cui il prodotto è stato creato, in formato ISO-8601. Esempio:
"2022-05-25T10:55:16+02:00"
updated_at (stringa): La data e l'ora in cui il prodotto è stato aggiornato l'ultima volta, in formato ISO-8601. Esempio:
"2022-05-25T10:55:16+02:00"
published_at (stringa): La data e l'ora in cui il prodotto è stato pubblicato, in formato ISO-8601. Esempio:
"2022-05-25T10:55:16+02:00"
vendor (stringa): Il nome del fornitore del prodotto. Esempio:
"My Vendor"
deleted_at (stringa): La data e l'ora in cui il prodotto è stato cancellato (se applicabile), in formato ISO-8601. Esempio:
"2022-05-25T10:55:16+02:00"
o una stringa vuota""
se il prodotto non è stato cancellato.
Campi Opzionali:
url (stringa): L'URL del prodotto. Esempio:
"https://www.myproduct.com"
type (stringa): Il tipo di prodotto, che può essere utilizzato per filtrare e cercare i prodotti. Esempio:
"color"
variants (array): Un array di varianti del prodotto. Se specificato, ciascuna variante deve includere
id
,name
,sku
, e prezzo.
Esempio:
images (array): Un array di immagini del prodotto. Se specificato, ciascuna immagine deve includere
id
,position
,url
,alt
,width
eheight
. L'arrayvariant_ids
può anche collegare le immagini a varianti specifiche del prodotto.
variant_ids (array): Un array di ID variante associati all'immagine del prodotto.
Istruzioni dettagliate per creare una sorgente personalizzata per il catalogo prodotti
Prepara i tuoi dati: Format your product catalog response according to the structure outlined above. Ensure all required fields are included, and optional fields like
variants
,images
, andurl
are added as needed.Crea l'Endpoint API: Usa l'API BirdCRM per inviare i dati del prodotto. L'endpoint si aspetta una risposta che aderisce alla struttura menzionata sopra. Assicurati che i dati siano in un formato JSON valido.
Testa l'Endpoint: Prima di integrare la fonte del catalogo prodotti nel tuo flusso di lavoro, è importante testare l'API endpoint per verificare che i dati vengano elaborati correttamente. Ciò garantisce che tutti i prodotti e le loro informazioni correlate (come varianti e immagini) vengano recuperati correttamente.
Monitora e Manutieni: Una volta creata la fonte del catalogo prodotti, puoi monitorarne le prestazioni attraverso le funzionalità di reporting di BirdCRM. Se hai bisogno di aggiornare i dettagli di un prodotto o aggiungere nuovi prodotti, basta aggiornare i dati utilizzando l'API.
Esempio di risposta API:
Seguendo questi passaggi, puoi creare e gestire una fonte di catalogo prodotti personalizzata all'interno di Bird. Assicurati che la risposta dell'API aderisca al formato richiesto in modo da poter integrare i tuoi prodotti nella piattaforma senza problemi.