wpify / kaufland-api-php-sdk
This is the Kaufland.de Seller API v2. You can find more information on [https://sellerapi.kaufland.com/](https://sellerapi.kaufland.com/)
Requires
- php: ^7.4 || ^8.0
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- guzzlehttp/guzzle: ^7.3
- guzzlehttp/psr7: ^1.7 || ^2.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.5
- phpunit/phpunit: ^8.0 || ^9.0
This package is auto-updated.
Last update: 2024-10-30 02:16:23 UTC
README
This is the Kaufland.de Seller API v2. You can find more information on https://sellerapi.kaufland.com/
Installation & Usage
Requirements
PHP 7.4 and later. Should also work with PHP 8.0.
Composer
To install the bindings via Composer, add the following to composer.json
:
{
"repositories": [
{
"type": "vcs",
"url": "https://github.com/wpify/kaufland-api-php-sdk.git"
}
],
"require": {
"wpify/kaufland-api-php-sdk": "*@dev"
}
}
Then run composer install
Manual Installation
Download the files and include autoload.php
:
<?php
require_once('/path/to/OpenAPIClient-php/vendor/autoload.php');
Getting Started
Please follow the installation procedure and then run the following:
<?php
require_once(__DIR__ . '/vendor/autoload.php');
$apiInstance = new KauflandApiClient\Api\AttributesApi(
// If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
// This is optional, `GuzzleHttp\Client` will be used as default.
new GuzzleHttp\Client()
);
$id_attribute = 21; // int | The ID of the attribute
$storefront = new \KauflandApiClient\Model\Storefront(); // Storefront | Specifies the store by country
$locale = new \KauflandApiClient\Model\ProductDataLocale(); // ProductDataLocale | Allows clients to consume the data in languages that are different from the storefront-default locale
try {
$result = $apiInstance->getAttribute($id_attribute, $storefront, $locale);
print_r($result);
} catch (Exception $e) {
echo 'Exception when calling AttributesApi->getAttribute: ', $e->getMessage(), PHP_EOL;
}
API Endpoints
All URIs are relative to /v2
Class | Method | HTTP request | Description |
---|---|---|---|
AttributesApi | getAttribute | GET /attributes/{id_attribute} | Get attribute by ID |
AttributesApi | getAttributeByName | GET /attributes/by-name/{name} | Get attribute by name |
AttributesApi | getAttributeList | GET /attributes | Get an attribute list |
AttributesApi | getAttributeListBySearch | GET /attributes/search | Get attributes by search term |
CarriersApi | getCarriers | GET /carriers | Get a list of available carriers |
CategoriesApi | decideCategory | POST /categories/decide | Guess categories |
CategoriesApi | getCategoriesList | GET /categories | Get category list by search term |
CategoriesApi | getCategory | GET /categories/{id_category} | Get category by ID |
CategoriesApi | getCategoryTree | GET /categories/tree | Get complete category tree |
ImportFilesApi | createInventoryCommandImportFile | POST /import-files/inventory-command | Add an INVENTORY_COMMAND file URL |
ImportFilesApi | createInventoryFeedImportFile | POST /import-files/inventory-feed | Add an INVENTORY_FEED file URL |
ImportFilesApi | createOrderCommandImportFile | POST /import-files/order-command | Add an ORDER_COMMAND file URL |
ImportFilesApi | getInventoryCommandImportFile | GET /import-files/inventory-command/{id_import_file} | Get an inventory command import file by ID |
ImportFilesApi | getInventoryCommandImportFiles | GET /import-files/inventory-command | Get a list of your inventory command import files |
ImportFilesApi | getInventoryFeedImportFile | GET /import-files/inventory-feed/{id_import_file} | Get an inventory feed import file by ID |
ImportFilesApi | getInventoryFeedImportFiles | GET /import-files/inventory-feed | Get a list of your inventory feed import files |
ImportFilesApi | getOrderCommandImportFile | GET /import-files/order-command/{id_import_file} | Get an order command import file by ID |
ImportFilesApi | getOrderCommandImportFiles | GET /import-files/order-command | Get a list of your order command import files |
InfoApi | getAllLocales | GET /info/locale | Get values for parameter 'locale' |
InfoApi | getAllStorefronts | GET /info/storefront | Get values for parameter 'storefront' |
OrderInvoicesApi | deleteOrderInvoice | DELETE /order-invoices/{id_order}/{id_invoice} | Delete an order invoice by given order ID and invoice ID |
OrderInvoicesApi | getOrderInvoice | GET /order-invoices/{id_order}/{id_invoice} | Get an order invoice by order ID and invoice ID |
OrderInvoicesApi | getOrderInvoices | GET /order-invoices | Get a list of order invoices |
OrderInvoicesApi | uploadOrderInvoice | POST /order-invoices/{id_order} | Upload an order invoice to a given order |
OrderUnitsApi | cancelOrderUnit | PATCH /order-units/{id_order_unit}/cancel | Cancel an order unit |
OrderUnitsApi | fulfilOrderUnit | PATCH /order-units/{id_order_unit}/fulfil | Mark an order unit to be in fulfillment |
OrderUnitsApi | getOrderUnit | GET /order-units/{id_order_unit} | Get an order unit by ID |
OrderUnitsApi | getOrderUnits | GET /order-units | Get a list of order units |
OrderUnitsApi | refundOrderUnit | PATCH /order-units/{id_order_unit}/refund | Send a refund to a customer |
OrderUnitsApi | sendOrderUnit | PATCH /order-units/{id_order_unit}/send | Mark an order unit as sent |
OrdersApi | getOrder | GET /orders/{id_order} | Get an order by ID |
OrdersApi | getOrders | GET /orders | Get a list of orders |
ProductDataApi | createProductData | PUT /product-data | Add new product data for an EAN or replace your existing one |
ProductDataApi | createProductDataFile | POST /product-data/import-files | Add an import file URL |
ProductDataApi | deleteProductData | DELETE /product-data/{ean} | Delete your product data for an EAN |
ProductDataApi | getProductData | GET /product-data/{ean} | Get your product data for an EAN |
ProductDataApi | getProductDataFile | GET /product-data/import-files/{id_import_file} | Get import file by ID |
ProductDataApi | getProductDataFileList | GET /product-data/import-files | Get import files |
ProductDataApi | getProductDataStatus | GET /product-data/status/{ean} | Get the process status for your product data |
ProductDataApi | updateProductData | PATCH /product-data | Update existing product data for an EAN |
ProductsApi | getProduct | GET /products/{id_product} | Get product by ID |
ProductsApi | getProductByEan | GET /products/ean/{ean} | Get a product by EAN |
ProductsApi | getProductList | GET /products/search | Get a list of products by search term |
ReportsApi | getReport | GET /reports/{id_report} | Get meta-data for a single report by ID |
ReportsApi | getReports | GET /reports | Get a list of your reports |
ReportsApi | requestAccountListingReport | POST /reports/account-listing | Queue an inventory report |
ReportsApi | requestAccountListingWithShopPriceReport | POST /reports/account-listing-with-shop-price | Queue an inventory report |
ReportsApi | requestCancellationsReport | POST /reports/cancellations | Queue a cancellations report. |
ReportsApi | requestCompetitorsComparerReport | POST /reports/competitors-comparer | Queue a competitors comparison report |
ReportsApi | requestEansNotFoundReport | POST /reports/eans-not-found | Queue an EANs not found report |
ReportsApi | requestNewBookingsReport | POST /reports/bookings-new | Queue a bookings report |
ReportsApi | requestNewSalesReport | POST /reports/sales-new | Queue a sales report |
ReportsApi | requestProductDataChangesReport | POST /reports/product-data-changes | Queue a product data changes report |
ReportsApi | requestProductDataImportFileErrorsReport | POST /reports/product-data-import-file-errors | Queue a product data import file errors report |
ReturnUnitsApi | acceptReturnUnit | PATCH /return-units/{id_return_unit}/accept | Accept a return unit |
ReturnUnitsApi | clarifyReturnUnit | PATCH /return-units/{id_return_unit}/clarify | Clarify a return unit |
ReturnUnitsApi | getReturnUnit | GET /return-units/{id_return_unit} | Get a return unit by ID |
ReturnUnitsApi | getReturnUnits | GET /return-units | Get a list of return units |
ReturnUnitsApi | rejectReturnUnit | PATCH /return-units/{id_return_unit}/reject | Reject a return unit |
ReturnUnitsApi | repairReturnUnit | PATCH /return-units/{id_return_unit}/repair | Repair a return unit |
ReturnsApi | getReturn | GET /returns/{id_return} | Get a return by ID |
ReturnsApi | getReturns | GET /returns | Get a list of returns |
ReturnsApi | initiateReturn | POST /returns | Initialize a return |
ReturnsApi | updateReturn | PUT /returns/{id_return} | Add one or more order units to an already existing return |
ShipmentsApi | addShipment | POST /shipments | Add a shipment to an order unit which is already marked as sent. |
ShippingGroupsApi | getShippingGroup | GET /shipping-groups/{id_shipping_group} | Get a shipping group by ID |
ShippingGroupsApi | getShippingGroups | GET /shipping-groups | Get the list of your predefined shipping groups |
StatusApi | ping | GET /status/ping | Ping the Marketplace Seller API by Kaufland |
SubscriptionsApi | addSubscription | POST /subscriptions | Subscribe for event |
SubscriptionsApi | deleteSubscription | DELETE /subscriptions/{id_subscription} | Unsubscribe from event |
SubscriptionsApi | getSubscription | GET /subscriptions/{id_subscription} | Get a push notification subscription by ID |
SubscriptionsApi | getSubscriptions | GET /subscriptions | Get a list of your push notification subscriptions |
SubscriptionsApi | updateSubscription | PATCH /subscriptions/{id_subscription} | Update subscription |
TicketsApi | closeTicket | PATCH /tickets/{id_ticket}/close | Close a ticket by ID |
TicketsApi | createTicketMessage | POST /tickets/{id_ticket}/messages | Create a new message for the ticket |
TicketsApi | getTicket | GET /tickets/{id_ticket} | Get a ticket by ID |
TicketsApi | getTicketMessages | GET /tickets/messages | Get a list of ticket messages |
TicketsApi | getTickets | GET /tickets | Get a list of tickets |
TicketsApi | openTicket | POST /tickets | Open a ticket |
UnitsApi | createUnit | POST /units | Add a unit |
UnitsApi | deleteUnit | DELETE /units/{id_unit} | Delete a unit |
UnitsApi | getUnit | GET /units/{id_unit} | Get a unit by ID |
UnitsApi | getUnits | GET /units | Get a list of your units |
UnitsApi | patchUnit | PATCH /units/{id_unit} | Update some of the fields of a unit |
WarehousesApi | createWarehouse | POST /warehouses | Create a new Warehouse |
WarehousesApi | deleteWarehouse | DELETE /warehouses/{id_warehouse} | Delete a warehouse |
WarehousesApi | getWarehouse | GET /warehouses/{id_warehouse} | Get a warehouse by its ID |
WarehousesApi | getWarehouses | GET /warehouses | Get a list of your Warehouses |
WarehousesApi | updateWarehouse | PUT /warehouses/{id_warehouse} | Update a Warehouse |
Models
- AccountListingReportVersion
- AddShipmentRequest
- AddShipmentRequestShipmentInformation
- Address
- ApiResponse
- ApiResponseAttribute
- ApiResponseCarriers
- ApiResponseCategoryTree
- ApiResponseCategoryWithEmbedded
- ApiResponseImportFileInventoryCommand
- ApiResponseImportFileInventoryFeed
- ApiResponseImportFileOrderCommand
- ApiResponseInfoLocaleObject
- ApiResponseInitializeReturn
- ApiResponseOpenTicketResponse
- ApiResponseOrderDetails
- ApiResponseOrderInvoice
- ApiResponseOrderUnitDetails
- ApiResponsePingMessage
- ApiResponseProductDataImportFileResponse
- ApiResponseProductDataObject
- ApiResponseProductDataStatusResponse
- ApiResponseProductWithEmbedded
- ApiResponseReport
- ApiResponseRequestedReport
- ApiResponseReturnDetails
- ApiResponseReturnUnitDetails
- ApiResponseShippingGroup
- ApiResponseStringArray
- ApiResponseSubscription
- ApiResponseTicketWithEmbedded
- ApiResponseUnit
- ApiResponseUpdateReturn
- ApiResponseWarehouse
- Attribute
- Buyer
- Carrier
- Carriers
- Category
- CategoryBasic
- CategoryDecideBodyProduct
- CategoryDecideRequestBody
- CategoryEmbeddable
- CategoryTree
- CategoryWithEmbedded
- CollectionApiResponseAttribute
- CollectionApiResponseCategory
- CollectionApiResponseImportFileInventoryCommand
- CollectionApiResponseImportFileInventoryFeed
- CollectionApiResponseImportFileOrderCommand
- CollectionApiResponseOrder
- CollectionApiResponseOrderInvoice
- CollectionApiResponseOrderUnit
- CollectionApiResponseProductDataImportFileResponse
- CollectionApiResponseProductWithEmbedded
- CollectionApiResponseReport
- CollectionApiResponseReturn
- CollectionApiResponseReturnUnit
- CollectionApiResponseShippingGroup
- CollectionApiResponseSubscription
- CollectionApiResponseTicket
- CollectionApiResponseTicketMessage
- CollectionApiResponseUnitEmbedded
- CollectionApiResponseWarehouse
- CreateTicketMessageRequest
- Currency
- ErrorDetails
- ErrorResponse
- FulfillmentType
- ImportFileInventoryCommand
- ImportFileInventoryCommandPostRequest
- ImportFileInventoryFeed
- ImportFileInventoryFeedPostRequest
- ImportFileOrderCommand
- ImportFileOrderCommandPostRequest
- ImportFileRequestBody
- ImportFilesSortBy
- ImportStatus
- ImportType
- InitializeReturn
- InitializeReturnRequest
- Locale
- ModelReturn
- NotFoundResponse
- OpenTicketRequest
- OpenTicketResponse
- Order
- OrderDetails
- OrderDetailsOrderUnitsInner
- OrderEmbeddable
- OrderInvoice
- OrderInvoiceUploadRequest
- OrderUnit
- OrderUnitCancelReason
- OrderUnitCancelRequest
- OrderUnitDetails
- OrderUnitEmbeddable
- OrderUnitRefundReason
- OrderUnitRefundRequest
- OrderUnitSendRequest
- OrderUnitStatus
- Pagination
- PartialPickSubscriptionCallbackUrlOrFallbackEmailOrEventNameOrIsActiveOrStorefront
- PickSubscriptionCallbackUrlOrFallbackEmailOrEventName
- PingMessage
- Product
- ProductDataImportFileResponse
- ProductDataImportFileSorting
- ProductDataImportFileStatus
- ProductDataLocale
- ProductDataObject
- ProductDataStatus
- ProductDataStatusAttribute
- ProductDataStatusAttributeValueState
- ProductDataStatusProductNotReadyReason
- ProductDataStatusResponse
- ProductDataStatusUpdateFailReason
- ProductEmbeddable
- ProductUnitEmbedded
- ProductUnitEmbeddedSeller
- ProductWithEmbedded
- Report
- ReportParameterValue
- ReportsSorting
- RequestBookingsReportRequest
- RequestNewSalesReportRequest
- RequestProductDataImportFileErrorsReportRequest
- RequestedReport
- ReturnDetails
- ReturnEmbeddable
- ReturnReason
- ReturnStatus
- ReturnUnit
- ReturnUnitClarifyRequest
- ReturnUnitDetails
- ReturnUnitEmbeddable
- ReturnUnitRejectRequest
- ReturnUnitStatus
- SellerApiShippingGroupRegionOptionNameEnum
- SellerApiShippingGroupType
- SellerApiWarehouseType
- ShippingGroup
- ShippingGroupOption
- ShippingGroupRegion
- Storefront
- Subscription
- SubscriptionEventName
- Ticket
- TicketEmbeddable
- TicketFile
- TicketMessage
- TicketMessageAuthor
- TicketMessageFile
- TicketMessagesSort
- TicketReason
- TicketStatus
- TicketTopic
- TicketWithEmbedded
- TicketWithEmbeddedBuyer
- TicketWithEmbeddedProduct
- TicketsSort
- Unit
- UnitCondition
- UnitEmbedded
- UnitEmbeddedEnum
- UnitPatchRequest
- UnitRequest
- UnitRequestCondition
- UnitStatuses
- UpdateReturn
- UpdateReturnRequest
- Warehouse
- WarehouseAddress
- WarehouseAddressRequest
- WarehouseBodyRequest
- WriteableUnitStatuses
Authorization
All endpoints do not require authorization.
Tests
To run the tests, use:
composer install
vendor/bin/phpunit
Author
seller-api-support@kaufland-online.de
About this package
This PHP package is automatically generated by the OpenAPI Generator project:
- API version:
2.10.1
- Build package:
org.openapitools.codegen.languages.PhpClientCodegen