Download the PHP package beziworld/laravel-idosell without Composer

On this page you can find all versions of the php package beziworld/laravel-idosell. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package laravel-idosell

Laravel IdoSell

tests Latest Version

IdoSell Shop Admin API client for Laravel. Orders, products, stock and prices, customers, parcels and labels, returns, complaints and sales documents of one or many IdoSell shops:

Polska wersja dokumentacji

What this package adds. Packagist has no Laravel package for IdoSell and no maintained PHP client for the v8 REST Admin API (the official IdoSell SDK repository is empty). This package covers the integration work an agency repeats for every shop: configuration per shop, pagination, typed orders and products, stock and price writes within the API limits, labels and invoices as binary files, and verified webhooks.

Installation

Requires PHP 8.3+ and Laravel 12 or 13. Requests go to https://{domain}/api/admin/v8/...; change the major version with IDOSELL_API_VERSION. Dates are exchanged without a time zone, so they are read and written in IDOSELL_TIMEZONE (Europe/Warsaw by default). IdoSell has no sandbox: every call works on a real panel, and API calls (including webhook deliveries) count towards the API usage of the shop.

Multiple shops

Orders

Synchronising orders with the scheduler

For several shops loop over IdoSell::connectionNames() (or your tenant table with IdoSell::using()) and keep one cursor per shop.

Products, stock and prices

Shipments, tracking and labels

Returns, complaints and documents

Any other endpoint

List values in queries are joined with commas and nested arrays become key[sub]=..., as the API expects.

Webhooks

Webhooks are configured per API key in the panel (Settings > API > Access > Webhook): URL, events and an optional authorization token, which IdoSell sends as Authorization: Bearer {token}.

Register https://your-app/idosell/webhook (default connection) or https://your-app/idosell/webhook/outlet. Every verified delivery dispatches WebhookReceived; the payload is the response of the matching API gateway (GET orders/orders for order events), so it maps to the same objects:

Failed deliveries (no 2xx answer) are retried every 10 minutes for an hour, then hourly for 23 hours; a webhook failing for 7 days is disabled. The platform also sends x-iai-signature ("HMAC hash of the payload"); the algorithm and key are not documented, so its check is opt-in (IDOSELL_WEBHOOK_SECRET, IDOSELL_WEBHOOK_SIGNATURE_ALGORITHM=sha256). For tenant shops call app(WebhookHandler::class)->handle($request, $client->config(), 'shop-7') from your own controller.

Rate limits

The Admin API answers 429 Too Many Requests when the shop limit is exceeded. Read requests are retried once when Retry-After is at most IDOSELL_RETRY_MAX_WAIT seconds (10 by default); otherwise, and always for writes, RateLimitExceeded is thrown with retryAfter(). Writes are never retried, because they are not idempotent.

Errors

Exception When Details
AuthenticationFailed HTTP 401 or 403 (invalid key, missing permission) httpStatus(), faultString() holds the X-Error header, for example "Błędne hasło oraz login"
ApiException errors.faultCode other than 0 and 2, HTTP 4xx/5xx, non-JSON body, connection failure faultCode(), faultString(), httpStatus(), method(), path(), body()
RateLimitExceeded HTTP 429 not retried retryAfter()
InvalidResponse a label is not valid base64
InvalidSignature webhook token or signature mismatch
InvalidConfiguration missing domain or credentials, unknown connection

Fault code 2 ("Empty result") is not an error: searches return an empty list. Per-item failures of writes (HTTP 207) do not throw; they are collected in WriteResult::$errors. All exceptions extend Beziworld\IdoSell\Exceptions\IdoSellException.

Coverage of the API

Resource Admin API operations
orders() POST orders/orders/search, GET/POST/PUT orders/orders, GET orders/statuses, POST orders/unfinished/search, GET orders/history, GET orders/packages, GET orders/labels, PUT orders/courier, PUT orders/shippingCosts, PUT orders/warehouse
products() POST products/products/search, GET/POST/PUT products/products, POST products/products/delete, GET/PUT products/stocks, PUT products/stockQuantity, GET/PUT products/sizes
customers() GET/POST/PUT clients/clients, GET clients/deliveryAddress
shipments() GET couriers/couriers, GET couriers/pickupPoints, POST packages/packages/search, POST/PUT/DELETE packages/packages, GET/POST packages/labels
returns() GET/POST/PUT returns/returns, GET returns/statuses
rma() GET/PUT rma/rma, GET rma/statuses
documents() GET orders/documents, POST orders/documents/create, POST orders/documents, POST orders/documents/delete

The full OpenAPI document of a shop is published at https://{domain}/api/doc/admin/v8/json; every operation in it can be called with request(), get(), post() or put().

Development

Tests use Http::fake() with stray requests prevented; nothing is sent to a real shop.

Author

Created and maintained by Kamil Ćwiertnia, beziworld.eu.

Need an e-commerce integration? Get in touch through beziworld.eu.

License

MIT. See LICENSE.md. This package is not affiliated with IdoSell (IAI S.A.).


All versions of laravel-idosell with dependencies

PHP Build Version
Package Version
Requires php Version ^8.3
ext-json Version *
guzzlehttp/guzzle Version ^7.8
illuminate/contracts Version ^12.0|^13.0
illuminate/http Version ^12.0|^13.0
illuminate/routing Version ^12.0|^13.0
illuminate/support Version ^12.0|^13.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package beziworld/laravel-idosell contains the following files

Loading the files please wait ...