Transferring products via the REST API | Create OCI and cXML PunchOut Catalogues | PunchCommerce                            ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

Transferring products via the REST API
======================================

You can generate an API key for each of your customers and use it for the automated transfer of products. A PHP library is currently available for this purpose as a Composer bundle.

**API URL and Authentication**

The current version of the REST API is available at . Authentication is carried out via the bearer token, which is displayed in your PunchCommerce account.

**Retrieve products**

GET

**Retrieve a product**

GET }

```
{
    "brand_ordernumber": "",
    "category": "Leisure & Electronics",
    "description_long": null,
    "image_url": null,
    "purchase_unit": null,
    "reference_unit": null,
    "unit": null,
    "unit_name": null,
    "ordernumber": "SW10001",
    "brand": "Shopware Freetime",
    "title": "Main item",
    "description": "Main item",
    "price": 459.94999999999999,
    "tax_rate": 19,
    "packaging_unit": "STCK",
    "weight": 0.17000000000000001,
    "classification_type": "UNSPSC",
  "classification": "43232403",
    "shipping_time": 3,
    "active": true
}
```

**Create product**

POST

```
{
    "brand_ordernumber": "",
    "category": "Leisure & Electronics",
    "description_long": null,
    "image_url": null,
    "purchase_unit": null,
    "reference_unit": null,
    "unit": null,
    "unit_name": null,
    "ordernumber": "SW10001",
    "brand": "Shopware Freetime",
    "title": "Main item",
    "description": "Main item",
    "price": 459.94999999999999,
    "tax_rate": 19,
    "packaging_unit": "STCK",
    "weight": 0.17000000000000001,
    "shipping_time": 3,
    "classification_type": "UNSPSC",
  "classification": "43232403",
    "active": true
}
```

**Update product**

PUT }

```
{
    "brand_ordernumber": "",
    "category": "Leisure & Electronics",
    "description_long": null,
    "image_url": null,
    "purchase_unit": null,
    "reference_unit": null,
    "unit": null,
    "unit_name": null,
    "ordernumber": "SW10001",
    "brand": "Shopware Freetime",
    "title": "Main item",
    "description": "Main item",
    "price": 459.94999999999999,
    "tax_rate": 19,
    "packaging_unit": "STCK",
    "weight": 0.17000000000000001,
    "shipping_time": 3,
  "classification_type": "UNSPSC",
  "classification": "43232403",
    "active": true
}
```

**Delete all products**

DELETE

**Delete a product**

DELETE }

**Composer Bundle**

You can find the PunchCommerce client library as a Composer bundle in our Git repository at

**Units of Measure**

We recommend using UN/CEFACT units when tagging products. A complete list of units can be found at the following link:

[https://unece.org/fileadmin/DAM/cefact/recommendations/rec20/rec20\_rev3\_Annex3e.pdf](https://unece.org/fileadmin/DAM/cefact/recommendations/rec20/rec20_rev3_Annex3e.pdf)

**Category**

A category can be specified as a path of categories. The individual category names must be separated by a "|". The path is interpreted from left to right as a nested structure.

Example:

Living|Kitchen|Electrical appliances

becomes

- Living
    - Kitchen
        - Electrical appliances

 [ PunchCommerce® ist ein Produkt der ![Netzdirektion GmbH](https://www.punchcommerce.de/static/netzdirektion-logo.png "PunchCommerce® ist ein Produkt der netzdirektion | Gesellschaft für digitale Wertarbeit mbH") ](https://netzdirektion.de)

 [Give feedback now - your opinion helps us to become even better!](https://easy-feedback.de/umfrage/1883200/5FuM95 "Your opinion helps us to become even better!")