Changelog

This page describes the changes from the old API V1 to the new V2. First, general changes are discussed. Then the individual endpoints are addressed.

General changes

There are three overarching changes to the API.

1. Introduction of parameter fulfillment_type: The fulfillment_type parameter (e.g. fulfilled_by_kaufland) specifies who is responsible for fulfillment
2. Introduction of parameter storefront: The storefront parameter (e.g. de) refers to a specific country of the Kaufland marketplace.
3. Introduction of parameter locale: The locale parameter (e.g. de-DE) enables providing product data for different languages and different dialects that are spoken in different countries.
4. Introduction of attribute delivery in order units endpoint: This attribute provides information about the pickup location specific information. For now, only pickup location deliveries are supported. The attribute is only responded when explicitly requested as an embedded field.
5. Datetime formats: All timestamps in the new API follow ISO 8601.
6. For the 200 status code responses the data is returned in an envelope data
7. Information on pagination is returned in an envelope pagination with keys offset, limit, total
8. The HTTP header "Hm-Client-Key" has been renamed to "Shop-Client-Key"
9. The HTTP header "Hm-Timestamp" has been renamed to "Shop-Timestamp"
10. The HTTP header "Hm-Signature" has been renamed to "Shop-Signature"

Endpoint changes

• attributes
  • GET /attributes
    • new
  • GET /attributes/search
    • new
  • GET /attributes/{id_attribute}:
    • request:
      • new required parameter: storefront
  • GET /attributes/by-name/{name}:
    • new
• carriers
  • GET /carriers
    • new
• categories
  • GET /categories/tree
    • new
  • GET /categories
    • request:
      • new required parameter: storefront
    • response:

      {
        "data": [
          {
              "real_main_category_id": 0
          }
        ]
      }

  • GET /categories/{id_category}
    • request:
      
      • new required parameter: storefront
    • response:

      {
        "data": {
          "real_main_category_id": 0
          "mandatory_attributes": []
          "required_attributes": []
        }
      }

  • POST /categories/decide

• claim-messages
  • removed
• claims
  • removed
• import-files
  • POST /import-files
    • removed
  • POST /import-files/order-command
    • new
  • POST /import-files/inventory-feed
    • new
  • POST /import-files/inventory-command
    • new
  • GET /import-files/seller/
    • removed
  • GET /import-files/{id_import_file}
    • removed
  • GET /import-files/order-command/{id_import_file}
    • new
  • GET /import-files/inventory-feed/{id_import_file}
    • new
  • GET /import-files/inventory-command/{id_import_file}
    • new
• info
  • GET /info/locale
    • new
  • GET /info/storefornt
    • new
• items renamed to products
  • GET /items renamed to GET /products/search
    • request:
      • new required parameter storefront
      • new embedded option "category_basic"
    • response

      {
        "data": [
          {
            "storefront": "de",
            
                "real_mgb_article_number": "",
      
                "dangerous_goods_li_shipping": "",
      
                "danger_label_9A": ""
            
          }
        ]
      }

  • GET /products/ean/{ean}
    • new
    • response

      {
        "data": [
          {
            "units": [
              {
                  "fulfillment_type": "fulfilled_by_kaufland"
              }
            ]
          }
        ]
      }

  • GET /items/{id_item} renamed to GET /products/{id_product}

    Note: In Seller API version 1, when "embedded=units" was requested, the response contained all offers. In Seller API version 2, when "embedded=units" is requested, we only return the best offer.

    • request:
      
      • new required parameter storefront
    • response

      {
        "data": [
          {
            "storefront": "de",
            
                "real_mgb_article_number": "",
      
                "dangerous_goods_li_shipping": "",
      
                "danger_label_9A": ""
            
            "units": [
              {
                  "fulfillment_type": "fulfilled_by_kaufland"
              }
            ]
          }
        ]
      }

• product-data
  • GET /product-data/import-files
    • new
  • POST /product-data/import-files
    • new
    • locale column is added to CSV files
  • GET /product-data/import-files/{id_import_file}
    • new
  • GET /product-data/{ean}
    • request:
      • new required parameter locale
  • DELETE /product-data/{ean}
    • request:
      • new required parameter locale
  • PUT /product-data/
    • request:
      • new required parameter locale
      • removed parameter ean (moved to body)
  • PATCH /product-data/
    • request
      • new required parameter locale
      • removed parameter ean (moved to body)
  • GET /product-data/status/{ean}
    • request:
      • new required parameter locale
    • response

      {
          
              "item_not_ready_reason": "",
      
              "item_quality": 0, 
      
              "missing_attributes": "",
      
              "update_fail_reason": "",
      
              "attribute_values": ""
          
      }

• order-invoices
  • GET /order-invoices/seller/ rename to GET /order-invoices
    • request:
      • new parameter storefront
      • changed timestamp to ISO format
    • response

      {
        "data": [
          {
            "storefront": "de",
            "is_marketplace_deemed_supplier": false,
            "ts_created": "",
            "ts_created_iso": "2021-07-24T19:26:05Z"
          }
        ],
        "pagination": {
          "offset": 30,
          "limit": 10,
          "total": 200
        }
      }

  • GET /order-invoices/{id_order}/{id_invoice}
    • request:
      • new required parameter id_order

    Note: Invoice IDs are not unique across all invoices as there are two types of order invoices

    • Invoices uploaded by the seller
    • Invoices provided by Kaufland.de which fall under the deemed supplier model (DSM)
    • response

      {
        "data": {
            "storefront": "de",
            "is_marketplace_deemed_supplier": false,
            "ts_created": "",
            "ts_created_iso": "2021-07-24T19:26:05Z"
        }
      }

  • DELETE /order-invoices/{id_order}/{id_invoice}
    • request:
      • new required parameter id_order
  • POST /order-invoices/{id_order}
    
    • request:
      • new required parameter id_order (previously part of the request body)
• order-units
  • GET /order-units/seller/ renamed to GET /order-units
    • request:
      •  new parameter storefront
      • new optional parameter fulfillment_type
      • changed timestamps to ISO format
    • response

      {
      "data": [
          {
            "ts_created": "",
            "ts_created_iso": "2021-07-24T19:26:05Z",
            "ts_updated": "",
            "ts_updated_iso": "2021-07-24T19:26:05Z",
            "storefront": "de",
            "currency": "EUR",
            "delivery_time": "",
            "delivery_time_expires": "",
            "order_received_timestamp": "",
            "delivery_time_expires_iso": "2021-07-28T12:13:14Z",
            "order_received_timestamp_iso": "2021-07-26T11:13:14Z",
            "vat": 0,
            "claim": {...},
            "invoice": {...}
            "fulfillment_type": "fulfilled_by_kaufland",
          }
        ],
        "pagination": {
          "offset": 30,
          "limit": 10,
          "total": 200
        }
      }

  • GET /order-units/{id_order_unit}
    • response

      {
        "data": {
            "ts_created": "",
            "ts_created_iso": "2021-07-24T19:26:05Z",
            "ts_updated": "",
            "ts_updated_iso": "2021-07-24T19:26:05Z",
            "storefront": "de",
            "currency": "EUR",
            "delivery_time": "",
            "delivery_time_expires": "",
            "order_received_timestamp": "",
            "delivery_time_expires_iso": "2021-07-28T12:13:14Z",
            "order_received_timestamp_iso": "2021-07-26T11:13:14Z",
            "vat": 0,
            "claim": {...},
            "invoice": {...}
            "fulfillment_type": "fulfilled_by_kaufland",
            "tickets" : [
                {
                    "fulfillment_type": "fulfilled_by_kaufland"
                }
            ],
            "delivery": {
                "pickup_location": {
                    "pickup_location_id": "260",
                    "provider": "Packeta",
                    "carrier": "Packeta",
                    "services": "",
                    "dhl_post_number": null
                }
            }
        }
      }

  • PATCH /order-units/{id_order_unit}/fulfil
  • PATCH /order-units/{id_order_unit}/cancel
  • PATCH /order-units/{id_order_unit}/send
    • request:
      • renamed tracking_number to tracking_numbers
  • PATCH /order-units/{id_order_unit}/refund
• orders
  • GET /orders/seller/ renamed to GET /orders
    • request
      • new parameter storefront
      • new optional parameter fulfillment_type
      • changed timestamps to ISO format
    • response

        
      {
        "data": [
          {
            "ts_created": "",
            "ts_created_iso": "2021-07-24T19:26:05Z",
            "ts_units_updated": "",
            "ts_units_updated_iso": "2021-07-24T19:26:05Z",
            "storefront": "de",
            "seller_units_count": "",
            "order_units_count": "1",
            "fulfillment_type": "fulfilled_by_kaufland"
          }
        ],
        "pagination": {
          "offset": 30,
          "limit": 10,
          "total": 200
        }
      }
        
      

  • GET /orders/{id_order}
    • Removed billing_address, buyer, seller_units & shipping_address from list of possible values for query parameter embedded. The information is now returned with each response by default
    • response

        
      {
        "data": {
          "ts_created": "",
          "ts_created_iso": "2021-07-24T19:26:05Z",
          "storefront": "de",
          "seller_units": [...],
          "order_units": [...],
          "fulfillment_type": "fulfilled_by_kaufland"
          "order_units": [
              {
                  "tickets": [
                      {
                          "fulfillment_type": "fulfilled_by_kaufland"
                      }
                  ]
              }
          ]
        }
      }
        
      

• reports
  
  • GET /reports/seller/ renamed to /reports
    • request:
      • new parameter storefront
    • response:
      • rename params to parameters

      
      {
        "data": [
          {
            "id_report": 11011,
            "status": "NEW",
            "date_requested": "2021-09-13 13:14:47",
            "url": "https://kaufland.de/report_files/21527778/",
            "report_name": "MyReport",
            "storefront": "de"
            "params": []
            "parameters": [
                {
                  "name": "parameter_name",
                  "value": "parameter_value"
                }
              ]
            }
          }
        ],
        "pagination": {
          "offset": 0,
          "limit": 10,
          "total": 1
        }
      }
                  

  • GET /reports/{id_report}
    • request:
      • new parameter storefront
    • response:
      • rename params to parameters

      
      {
        "data": {
          "id_report": 11011,
          "status": "NEW",
          "date_requested": "2021-09-13 13:14:47",
          "url": "https://kaufland.de/report_files/21527778/",
          "report_name": "MyReport",
          "storefront": "de"
          "params": []
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                        

  • POST /reports/account-listing
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_report": 11011,
          "report_name": "MyReport",
          "storefront": "de"
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                  

  • POST /reports/account-listing-with-shop-price
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_report": 11011,
          "report_name": "MyReport",
          "storefront": "de"
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                  

  • POST /reports/bookings
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_report": 11011,
          "report_name": "MyReport",
          "storefront": "de"
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                 

  • POST /reports/bookings-new
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_report": 11011,
          "report_name": "MyReport",
          "storefront": "de"
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                  

  • POST /reports/eans-not-found
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_report": 11011,
          "report_name": "MyReport",
          "storefront": "de"
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                  

  • POST /reports/cancellations
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_report": 11011,
          "report_name": "MyReport",
          "storefront": "de"
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                    

  • POST /reports/competitors-comparer
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_report": 11011,
          "report_name": "MyReport",
          "storefront": "de"
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                    

  • POST /reports/sales
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_report": 11011,
          "report_name": "MyReport",
          "storefront": "de"
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                    

  • POST /reports/sales-new
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_report": 11011,
          "report_name": "MyReport",
          "storefront": "de"
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                    

  • POST /reports/product-data-import-file-errors
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_report": 11011,
          "report_name": "MyReport",
          "storefront": "de"
          "parameters": [
            {
              "name": "parameter_name",
              "value": "parameter_value"
            }
          ]
        }
      }
                    

• returns
  • GET /returns/seller/ renamed to GET /returns
    • request
      • new parameter storefront
      • new optional parameter fulfillment_type
      • changed timestamps to ISO format
    • response

                    
      {
        "data": [
          {
            "ts_created": "",
            "ts_created_iso": "2021-07-24T19:26:05Z",
            "ts_updated": "",
            "ts_updated_iso": "2021-07-24T19:26:05Z",
            "storefront": "de",
            "fulfillment_type": "fulfilled_by_kaufland"
          }
        ],
        "pagination": {
          "offset": 30,
          "limit": 10,
          "total": 200
        }
      }
                    
                  

  • GET /returns/{id_return}
    • response

                    
      {
        "data": {
            "ts_created": "",
            "ts_created_iso": "2021-07-24T19:26:05Z",
            "ts_updated": "",
            "ts_updated_iso": "2021-07-24T19:26:05Z",
            "storefront": "de",
            "units": [...],
            "fulfillment_type": "fulfilled_by_kaufland",
            "return_units": [
              "fulfillment_type": "fulfilled_by_kaufland",
            ]
        }
      }
                    
                  

  • POST /returns
    • Accepts an individual reason as well as a note for each provided order unit ID, instead of one reason / note for all order unit IDs
    • Returns the created return entity together with the corresponding return units
    • response

                    
      {
        "data": {
            "fulfillment_type": "fulfilled_by_kaufland",
            "return_units": [
              "fulfillment_type": "fulfilled_by_kaufland",
            ]
        }
      }
                    
                  

  • PUT /returns/{id_return}
    • Accepts an individual reason as well as a note for each provided order unit ID, instead of one reason / note for all order unit IDs
    • Returns the return entity together with the created return units
    • response

                    
      {
        "data": {
            "fulfillment_type": "fulfilled_by_kaufland",
            "return_units": [
              "fulfillment_type": "fulfilled_by_kaufland",
            ]
        }
      }
                    
                  

• return units
  • GET /return-units/seller/ renamed to GET /return-units
    • request
      • new parameter storefront
      • new optional parameter fulfillment_type
      • changed timestamp to ISO format
    • response

                    {
        "data": [
          {
            "ts_created": "",
            "ts_created_iso": "2021-07-24T19:26:05Z",
            "storefront": "de",
            "fulfillment_type": "fulfilled_by_kaufland"
          }
        ],
        "pagination": {
          "offset": 30,
          "limit": 10,
          "total": 200
        }
      }
                    
                  

  • GET /return-units/{id_return_unit}
    • response

                    {
        "data": {
            "ts_created": "",
            "ts_created_iso": "2021-07-24T19:26:05Z",
            "storefront": "de",
            "claim": {...},
            "item": {...}
            "fulfillment_type": "fulfilled_by_kaufland",
            "return": {
              "fulfillment_type": "fulfilled_by_kaufland"
            },
            "tickets": [
              {
                  "fulfillment_type": "fulfilled_by_kaufland"
              }
            ],
            "order_unit": {
              "fulfillment_type": "fulfilled_by_kaufland"
            }
      
        }
      }
                    
                  

• shipping-groups
  
  • GET /shipping-groups/seller/ renamed to GET /shipping-groups
    • request:
      •  new parameter storefront
      • changed timestamps to ISO format
    • response:

      • {
          "data": [
            {
              "currency": "EUR",
              "id_shipping_group": 1,
              "storefront": "de",
              "type": "PACKAGE",
              "is_default": true,
              "regions": [
                {
                  "countries": [
                    "string"
                  ],
                  "shipping_options": [
                    {
                      "name": "default",
                      "cost_first": 0,
                      "cost_next": 0,
                      "cost_max": 0,
                      "cost_free": 0,
                      "cut_off_time": "string",
                      "transport_time_min": 1,
                      "transport_time_max": 1
                    }
                  ]
                }
              ]
            }
          ],
          "pagination": {
            "offset": 30,
            "limit": 10,
            "total": 200
          }
        }
        

  • GET /shipping-groups/{id_shipping_group}
    • new
• subscriptions
  
  • GET /subscriptions/seller/ renamed to /subscriptions
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": [
          {
            "id_subscription": 123456,
            "callback_url": "https://www.kaufland.de",
            "fallback_email": "test@kaufland.de,
            "event_name": "order_new",
            "is_active": true,
            "storefront": "de"
          }
        ],
      
        "pagination": {
          "offset": 0,
          "limit": 10,
          "total": 1
        }
      }
                        

  • POST /subscriptions/ renamed to /subscriptions
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_subscription": 123456,
          "callback_url": "https://www.kaufland.de",
          "fallback_email": "test@kaufland.de,
          "event_name": "order_new",
          "is_active": true,
          "storefront": "de"
        }
      }
                        

  • PATCH /subscriptions/{id_subscription}
    • request:
      • new parameter storefront
    • response:

      
      {
        "data": {
          "id_subscription": 123456,
          "callback_url": "https://www.kaufland.de",
          "fallback_email": "test@kaufland.de,
          "event_name": "order_new",
          "is_active": true,
          "storefront": "de"
        }
      }
                        

• tickets
  
  • GET /tickets/seller renamed to /tickets
    • request:
      • rename ts_created:from to ts_created_from_iso
      • rename ts_updated:from to ts_updated_from_iso
      • Added parameter storefront
      • Added optional parameter fulfillment_type
    • response:

      • {
          "data": [
             {
                "id_ticket": "0011234567",
                "ids_order_units": [
                  123456789,
                  987654321
                ],
                "id_buyer": 123456789,
                "ts_created_iso": "2021-07-24T19:26:05Z",
                "ts_created": "",
                "ts_updated_iso": "2021-07-24T19:26:05Z",
                "ts_updated": "",
                "status": "opened",
                "open_reason": "product_not_as_described",
                "topic": "delivery_not_received",
                "callback_phone": "",
                "is_seller_responsable": false
                "fulfillment_type": "fulfilled_by_kaufland",
             }
          ],
          "pagination": {
            "offset": 30,
            "limit": 10,
            "total": 200
          }
        }
        

  • POST /tickets
    • response:

      • {
          "data": {
            "id_ticket": "0011234567",
          }
        }
        

  • GET /ticket-messages/seller renamed to /tickets/messages
    • request:
      • rename timestamp_from to ts_created_from_iso
      • Added optional parameter fulfillment_type
    • response:

      • {
          "data": [
             {
                "id_ticket_message": 64123123,
                "id_ticket": "00110123123",
                "author": {
                  "role": "seller",
                  "name": "Kaufland"
                },
                "text": "Ticket message content here",
                "ts_created_iso": "2021-09-24T10:26:05Z",
                "ts_created": "",
             }
          ]
        }
        

  • POST /ticket-messages/ renamed to /tickets/{id_ticket}/messages
    • request:
      • remove id_ticket from body param (now in request url)
      • rename claim_message_files to ticket_message_files
  • GET /tickets/{id_ticket}
    • response:

      • {
          "data": {
            "id_ticket": "0011234567",
            "ids_order_units": [
              123456789,
              987654321
            ],
            "id_buyer": 123456789,
            "ts_created_iso": "2021-09-24T10:26:05Z",
            "ts_created": "",
            "ts_updated_iso": "2021-09-24T10:26:05Z",
            "ts_updated": "",
            "status": "opened",
            "open_reason": "product_not_as_described",
            "topic": "delivery_not_received",
            "callback_phone": "",
            "is_seller_responsible": false,
            "fulfillment_type": "fulfilled_by_kaufland",
            "messages": [
                {
                  "id_ticket_message": 0,
                  "id_ticket": "0011234567",
                  "author": {
                    "role": "seller",
                    "name": "Kaufland"
                  },
                  "text": "Ticket message content here",
                  "ts_created_iso": "2021-09-24T10:26:05Z",
                  "ts_created": "",
                }
            ],
            "order_units": [
                {
                  "id_order_unit": 0,
                  "id_order": "MB7UWLD",
                  "ts_created_iso": "2021-09-24T10:26:05Z",
                  "ts_created": "",
                  "is_marketplace_deemed_supplier": false,
                  "ts_updated_iso": "2021-09-24T10:26:05Z",
                  "ts_updated": "",
                  "status": "cancelled",
                  "price": 0,
                  "id_offer": "AB-120",
                  "revenue_gross": 0,
                  "revenue_net": 0,
                  "note": "Some note",
                  "unit_condition": "new",
                  "storefront": "de",
                  "fulfillment_type": "fulfilled_by_kaufland",
                  "currency": "EUR",
                  "delivery_time": "",
                  "delivery_time_min": 3,
                  "delivery_time_max": 6,
                  "delivery_time_expires_iso: "2021-07-28T12:13:14Z",
                  "delivery_time_expires": "",
                  "order_received_timestamp_iso: "2021-07-28T12:13:14Z",
                  "order_received_timestamp": "",
                  "shipping_rate": 0,
                  "cancel_reason": "BuyerCancelled",
                  "buyer": {
                    "id_buyer": 0,
                    "email": "buyer@dev.com"
                  },
                  "claim": {
                    "id_claim": 0,
                    "id_order_unit": 0,
                    "id_buyer": 0,
                    "ts_created": "",
                    "ts_updated": "",
                    "status": "",
                    "open_reason": "",
                    "callback_phone": "",
                    "is_seller_responsible": false
                  },
                  "billing_address": {
                    "first_name": "Tom",
                    "last_name": "Smith",
                    "gender": "",
                    "company_name": "Smith Holding GmBH",
                    "street": "Test Ln.",
                    "house_number": "1",
                    "postcode": "12345",
                    "additional_field": "something",
                    "city": "New York",
                    "phone": "+491234567",
                    "country": "USA"
                  },
                  "shipping_address": {
                    "first_name": "Tom",
                    "last_name": "Smith",
                    "gender": "",
                    "company_name": "Smith Holding GmBH",
                    "street": "Test Ln.",
                    "house_number": "1",
                    "postcode": "12345",
                    "additional_field": "something",
                    "city": "New York",
                    "phone": "+491234567",
                    "country": "USA"
                  },
                  "invoice": {
                    "id_invoice": 0,
                    "id_order_unit": 0,
                    "number": "",
                    "url": "",
                    "type": ""
                  },
                  "item": {
                    "id_item": 0,
                    "title": "",
                    "eans": [
                    ""
                    ],
                    "id_category": 0,
                    "main_picture": "",
                    "manufacturer": "",
                    "url": "",
                    "real_mgb_article_number": "",
                    "age_rating": 0,
                    "is_valid": false,
                    "dangerous_goods_li_shipping": "",
                    "danger_label_9A": ""
                  }
                  "product": {
                    "id_product": 362524873,
                    "title": "Apple iPhone 12 mini 64GB Schwarz",
                    "eans": [
                      "0194252013212",
                      "194252013212",
                      "0194252012925"
                    ],
                    "id_category": 34401,
                    "main_picture": "https://media.cdn.kaufland.de/product-images/2048x2048/7ddfbf37e8c5d3137179e1361c432246.jpg",
                    "manufacturer": "Apple",
                    "url": "https://www.kaufland.de/product/362524873/",
                    "age_rating": 0,
                    "is_valid": true,
                    "dangerous_goods_li_shipping": "UN 3090",
                    "danger_label_9A": "Nein"
                  }
              }
            ],
            "buyer": {
              "id_buyer": 0,
              "email": ""
            },
            "item": {
                "id_item": 0,
                "title": "",
                "eans": [
                  ""
                ],
                "id_category": 0,
                "main_picture": "",
                "manufacturer": "",
                "url": "",
                "real_mgb_article_number": "",
                "age_rating": 0,
                "is_valid": false,
                "dangerous_goods_li_shipping": "",
                "danger_label_9A": ""
                }
            "product": {
                "id_product": 362524873,
                "title": "Apple iPhone 12 mini 64GB Schwarz",
                "eans": [
                  "0194252013212",
                  "194252013212",
                  "0194252012925"
                ],
                "id_category": 34401,
                "main_picture": "https://media.cdn.kaufland.de/product-images/2048x2048/7ddfbf37e8c5d3137179e1361c432246.jpg",
                "manufacturer": "Apple",
                "url": "https://www.kaufland.de/product/362524873/",
                "age_rating": 0,
                "is_valid": true,
                "dangerous_goods_li_shipping": "UN 3090",
                "danger_label_9A": "Nein"
            }
            "files": [
                {
                  "filename": "test.jpg",
                  "ts_created_iso": "2021-09-24T10:26:05Z",
                  "ts_created": "",
                  "uri": "https://www.kaufland.de/dynamic/files/test"
                }
            ],
            "storefront": "string"
          }
        }
        

• units
  
  • GET /units/seller/ renamed to /units
    • request:
      • rename id_item to id_product
      • embedded: rename value "item" to "products"
      • changed timestamps to ISO format
      • Added optional parameter fulfillment_type
    • response

      • {
          "data": [
            {
              "currency": "EUR",
              "condition": "USED___ACCEPTABLE",
              "id_product": 1,
              "id_item": 0,
              "id_shipping_group": 1,
              "id_warehouse": 1,
              "date_inserted_iso": "2021-12-02T15:56:15.310Z",
              "date_lastchange_iso": "2021-12-02T15:56:15.310Z",
              "delivery_time": "",
              "delivery_time_min": 0,
              "delivery_time_max": 0,
              "shipping_group": "",
              "warehouse": "name",
              "reference_price": 0,
              "seller": {
                "pseudonym": ""
              },
              "date_inserted": "",
              "date_lastchange": "",
              "location": "",
              "item": {
                "id_item": 0,
                "title": "",
                "eans": [ "" ],
                "id_category": 0,
                "main_picture": "",
                "manufacturer": "",
                "url": "",
                "real_mgb_article_number": "",
                "age_rating": 0,
                "is_valid": false,
                "dangerous_goods_li_shipping": "",
                "danger_label_9A": ""
              }
              "fulfillment_type": "fulfilled_by_kaufland"
              "handling_time": 100,
              "shipping_rate": 0,
              "storefront": "de",
              "transport_time_min": 1,
              "transport_time_max": 1,
              "product": {
                "id_product": 362524873,
                "title": "Apple iPhone 12 mini 64GB Schwarz",
                "eans": [
                  "0194252013212",
                  "194252013212",
                  "0194252012925"
                ],
                "id_category": 34401,
                "main_picture": "https://media.cdn.kaufland.de/product-images/2048x2048/7ddfbf37e8c5d3137179e1361c432246.jpg",
                "manufacturer": "Apple",
                "url": "https://www.kaufland.de/product/362524873/",
                "age_rating": 0,
                "is_valid": true,
                "dangerous_goods_li_shipping": "UN 3090",
                "danger_label_9A": "Nein"
              }
            }
          ],
          "pagination": {
            "offset": 30,
            "limit": 10,
            "total": 200
          }
        }
        

  • GET /units/{id_unit}
    • request
      • new parameter storefront
      • removed parameter embedded
    • response

      • {
          "data": {
            "currency": "EUR",
            "id_item": 0,
            "condition": "USED___ACCEPTABLE",
            "location": "",
            "warehouse": "",
            "delivery_time": "",
            "delivery_time_min": 0,
            "delivery_time_max": 0,
            "shipping_group": "",
            "reference_price": 0,
            "seller": {
              "pseudonym": ""
            },
            "date_inserted": "",
            "date_lastchange": "",
            "item": {
              "id_item": 0,
              "title": "",
              "eans": [
                ""
              ],
              "id_category": 0,
              "main_picture": "",
              "manufacturer": "",
              "url": "",
              "real_mgb_article_number": "",
              "age_rating": 0,
              "is_valid": false,
              "dangerous_goods_li_shipping": "",
              "danger_label_9A": ""
            },
            "fulfillment_type": "fulfilled_by_kaufland"
            "id_product": 1,
            "id_shipping_group": 1,
            "id_warehouse": 1,
            "date_inserted_iso": "2021-12-02T16:06:07.528Z",
            "date_lastchange_iso": "2021-12-02T16:06:07.528Z",
            "handling_time": 0,
            "storefront": "de",
            "transport_time_min": 1,
            "transport_time_max": 1
          }
        }

  • POST /units
    • request
      • Either "ean" or "id_product" is mandatory
      • "condition" could be an integer or a string according to Available Conditions
      • "id_offer" is mandatory
      • new parameter storefront

      • {
          "handling_time": 100,
          "id_shipping_group": 0,
          "id_warehouse": 0,
          "condition": "USED___ACCEPTABLE",
          "id_offer": "",
          "id_product": 0,
          "id_item": 0,
          "offer_id": "",
          "delivery_time": "",
          "delivery_time_min": 0,
          "delivery_time_max": 0,
          "shipping_group": "",
          "location": "",
          "warehouse": "",
          "reference_price": 0
        }
        

    • response

      • {
          "data": {
            "currency": "EUR",
            "id_item": 0,
            "condition": "USED___ACCEPTABLE",
            "location": "",
            "warehouse": "",
            "delivery_time": "",
            "delivery_time_min": 0,
            "delivery_time_max": 0,
            "shipping_group": "",
            "reference_price": 0,
            "seller": {
              "pseudonym": ""
            },
            "date_inserted": "",
            "date_lastchange": "",
            "item": {
              "id_item": 0,
              "title": "",
              "eans": [
                ""
              ],
              "id_category": 0,
              "main_picture": "",
              "manufacturer": "",
              "url": "",
              "real_mgb_article_number": "",
              "age_rating": 0,
              "is_valid": false,
              "dangerous_goods_li_shipping": "",
              "danger_label_9A": ""
            },
            "id_product": 1,
            "id_shipping_group": 1,
            "id_warehouse": 1,
            "date_inserted_iso": "2021-12-02T16:06:07.528Z",
            "date_lastchange_iso": "2021-12-02T16:06:07.528Z",
            "handling_time": 0,
            "storefront": "de",
            "transport_time_min": 1,
            "transport_time_max": 1
            "fulfillment_type": "fulfilled_by_kaufland"
          }
        }

  • PATCH /units/{id_unit}
    • request:
      • new parameter "storefront"
      • changed timestamps to ISO format
    • response

      • {
          "data": {
            "currency": "EUR",
            "id_unit": 1,
            "note": "string",
            "condition": "USED___ACCEPTABLE",
            "listing_price": 1,
            "minimum_price": 1,
            "price": 1,
            "id_offer": "string",
            "id_product": 1,
            "id_shipping_group": 1,
            "id_warehouse": 1,
            "amount": 1,
            "date_inserted_iso": "2021-12-02T16:17:12.273Z",
            "date_lastchange_iso": "2021-12-02T16:17:12.273Z",
            "handling_time": 0,
            "shipping_rate": 0,
            "storefront": "de",
            "fulfillment_type": "fulfilled_by_kaufland",
            "transport_time_min": 1,
            "transport_time_max": 1
          }
        }
        

  • DELETE /units/{id_unit}
    • request
      • new parameter storefront
• warehouses
  
  • GET /warehouses/seller/ renamed to /warehouses
    • response

      • {
          "data": [
            {
              "is_pickup_possible": false,
              "type": "normal"
            }
          ],
          "pagination": {
            "offset": 30,
            "limit": 10,
            "total": 200
          }
        }

  • GET /warehouses/{id_warehouse}
    • response

      • {
          "data": {
            "is_pickup_possible": false,
            "type": "normal"
          }
        }
        

  • POST /warehouses
    • request

      • {
            "is_pickup_possible": false
        }
        

    • response

      • {
          "data": {
            "id_warehouse": 1,
            "name": "string",
            "address": {
              "street": "string",
              "city": "string",
              "house_number": "string",
              "postcode": "string",
              "country": "string",
              "phone": "string"
            },
            "is_default": true,
            "type": "normal"
          }
        }

  • PUT /warehouses/{id_warehouses}
    • new
  • PATCH /warehouses/{id_warehouses}
    • removed