Options for importing a catalog

Manual

Creating the products manually manual-import

If you have a limited catalog and updates are infrequent, creating them manually might be the best option. It requires time to enter each product and some limited training to how to use the Commerce Admin. Manual catalog management is not the right option for most stores, but in certain situations, it may make sense. To see additional documentation for this process, visit Create a product. Do not forget, you can use more than one method to manage your catalog, however once automation is used, manual edits must be limited. Automated updates have the opportunity to overwrite any changes performed manually, and therefore cause confusion. Once the integration with Adobe Commerce to manage the catalog is using automation and APIs, it is advised to restrict management of the catalog from the admin through user roles and permissions.

When to consider this approach

• Very small catalog, for example fewer than 50 products
• Updates are infrequent
• You have all the product details, images, videos, and you do not want to take the time to learn how to convert the data to CSV
• You want to include adding images and videos when creating the products
• Your team is not familiar with APIs and how OAUTH works

Admin CSV

Admin CSV import tool admin-csv

This tool allows a store owner to import a catalog using a CSV right from the commerce admin.
Import Data from Commerce Admin

Pros:
Uploading a CSV from the admin is a straight forward approach to catalog management. It allows for faster catalog product updates to a moderately sized catalog.

Cons:

• Slow
• Maximum upload file sized defined on server and may not be easily adjusted by a store owner.
• Requires admin access and someone to perform the action, automation is limited
• Schedule imports are limited to 1x a day max
• The images and videos associated must be uploaded separately

When to consider this approach

• Catalog size is moderate
• Updates are not more than once a day
• you have some access to server configurations in case that you must increase max file upload size
• Your team is not familiar with APIs and how OAUTH works

Bulk REST API

Bulk REST API bulk-rest-api

The bulk REST API allows for automation and more frequent updates. This API is faster than using the admin upload of CSV.
Bulk endpoints documentation

Pro:
Possibilità di importare set di dati di grandi dimensioni non in formato CSV.

Contro:

• Le immagini e i video associati devono essere caricati separatamente
• Può essere limitata dai vincoli di larghezza di banda del provider di hosting

Quando considerare questo approccio

• Il catalogo è di qualsiasi dimensione
• Gli aggiornamenti sono frequenti; è accettabile più di 1 volta al giorno
• Il tempo di importazione è importante ma non critico ed è accettabile un breve ritardo nell’elaborazione dei dati di importazione
• I dati non sono strutturati in formato CSV e non è possibile trasformarli utilizzando l’automazione

API REST ASINCRONA

API REST ASINCRONA async-rest-api

Un endpoint web asincrono intercetta i messaggi in un’API web e li scrive nella coda dei messaggi. Ogni volta che il sistema accetta una tale richiesta API, genera un identificatore UUID. Adobe Commerce include questo UUID quando aggiunge il messaggio alla coda. Quindi, un consumatore legge i messaggi dalla coda ed esegue i messaggi singolarmente.
Documentazione degli endpoint web asincroni

Pro:

• Importare rapidamente i dati
• L’ambito dell’archivio è supportato oppure è possibile specificare all per eseguire l’operazione su tutti gli archivi esistenti

Contro:

• La richiesta GET non è supportata

Quando considerare questo approccio

• Le importazioni sono frequenti
• Nessun problema con un ritardo ridotto dal momento in cui vengono inviati tramite API e quindi elaborati dalla coda dei messaggi.

API REST CSV

API REST CSV csv-rest-api

Questa opzione API consente importazioni estremamente veloci rispetto a tutte le altre opzioni native.

Importa dati REST CSV api
Pro:

• Metodo più veloce per elaborare i dati in arrivo
• Può essere eseguito più volte al giorno
• I dati possono essere compressi utilizzando gzip per le richieste di grandi dimensioni, in modo da evitare i limiti di dimensione delle richieste HTTP.

Contro:

• Le immagini e i video associati devono essere caricati separatamente
• I dati devono essere in formato CSV

Quando considerare questo approccio

• Il catalogo è di qualsiasi dimensione
• Gli aggiornamenti sono frequenti; è accettabile più di 1 volta al giorno
• Il tempo totale di importazione è importante
• I dati sono già in formato CSV o possono essere facilmente trasformati tramite automazione