commercetools sync

More at https://commercetools.github.io/commercetools-sync-java

Java library for importing and syncing (taking care of changes) data into one or more commercetools projects from external data files or from another commercetools project.

The library supports synchronising the following entities in commercetools

• Categories
• Products
• InventoryEntries
• ProductTypes
• Types
• CartDiscounts
• States
• TaxCategories

• Usage
  • Quick Start
  • Prerequisites
  • Installation
    • Maven
    • Gradle
    • SBT
    • Ivy
• Roadmap
• Release Notes
• Javadoc
• Benchmarks

Usage

commercetools sync is a Java library that imports commercetools platform data in the following ways:

1. Synchronise data coming from an external system in any form (CSV, XML, etc..) that has been already mapped to commercetools-jvm-sdk resource draft objects (e.g. CategoryDraft).

2. Synchronise data from another commercetools project as commercetools-jvm-sdk resource draft objects (e.g. CategoryDraft).

Note: During a synchronisation, resources are either created or updated, but not deleted.

⚡ See the Quick Start Guide for more information on building a product importer!

🔛 Check out the commercetools-project-sync for a ready-to-use CLI application that syncs your entire data catalogue between 2 commercetools projects!

Prerequisites

• Make sure you have JDK 8 installed.
• commercetools-jvm-sdk as a dependency in your JVM-based application. (Make sure to use a version >= 1.47.0).
• a target commercetools project for syncing your source data to.

Installation

There are multiple ways to add the commercetools sync dependency to your project, based on your dependency manager. Here are the most popular ones:

Maven

<dependency>
  <groupId>com.commercetools</groupId>
  <artifactId>commercetools-sync-java</artifactId>
  <version>2.0.0</version>
</dependency>

Gradle

implementation 'com.commercetools:commercetools-sync-java:2.0.0'

SBT

libraryDependencies += "com.commercetools" % "commercetools-sync-java" % "2.0.0"

Ivy

<dependency org="com.commercetools" name="commercetools-sync-java" rev="2.0.0"/>

Roadmap

https://github.com/commercetools/commercetools-sync-java/milestones