Overview

This document explains how to share your product catalog with Equativ.

Supported formats

The Kamino platform supports several methods for importing your product catalog. CSV is the preferred format, but the system also supports XML, JSON, and TSV formats.

If you’d like to use a different format, contact rm-support@equativ.com.

Share product catalog as public URL

You can share your product catalog as a public URL that points to a single catalog file in a flat format. This can be a single URL for your entire catalog or multiple URLs, such as one URL per category.

Based on your system's capabilities, you can provide the following:

• A static URL that provides the latest catalog update and doesn’t change.
• A static URL with dynamic parts, such as a timestamp or category.
• Multiple URLs that point to multiple files.

The preferred file format is CSV. If you provide multiple files, they must all use the same format and specifications. If you’d like to use a different file format, such as JSON, XML, or TSV, contact rm-support@equativ.com.

Store product catalog in OVH S3 bucket

Create OVH S3 bucket

Equativ is in charge of creating your dedicated S3 bucket.

Obtain credentials

After Equativ confirms that your dedicated S3 bucket is ready, you’ll receive the following credentials required to upload your files:

• AWS_ACCESS_KEY_ID: Your access key ID.
• AWS_SECRET_ACCESS_KEY: Your secret access key.
• BUCKET_NAME: The name of your S3 bucket.
• ENDPOINT_URL: The endpoint URL for your OVH S3 service.
• REGION: The location of your OVH S3 service—Gravelines (GRA), Roubaix (RBX), or Strasbourg (SBG).

For security, credentials and access information are shared in an encrypted archive. The password to open the archive is sent through a separate communication channel of your choice, such as SMS, encrypted email, or Slack. This ensures that the credentials remain protected if one channel is compromised.

Push files to the S3 bucket

To upload your files, use the following command:

AWS_ACCESS_KEY_ID=<acces_key_id> AWS_SECRET_ACCESS_KEY=<secret_access_key> aws --endpoint-url https://s3.<region>.io.cloud.ovh.net s3 cp file.extension s3://<bucket_name>/file.extension

Replace the placeholders in the command with your actual credentials and file details:

• <acces_key_id>: Your OVH access key ID.
• <secret_access_key>: Your OVH secret access key.
• <region>: The region identifier within the endpoint URL for your OVH S3 service.
• file.extension: Your file name and extension.
• <bucket_name>: Your S3 bucket name.

Example

AWS_ACCESS_KEY_ID=YOUR_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY=YOUR_SECRET_ACCESS_KEY aws --endpoint-url https://s3.gra.io.cloud.ovh.net s3 cp product_catalog.csv s3://my-retail-bucket/product_catalog.csv

Configure a recurring file upload job based on how often you update your product catalog. If you need a recommendation, contact the Equativ team.

Use SFTP server

If you’d like to use your own SFTP server, contact rm-support@equativ.com.