- What Laravel versions and PHP versions does this package support?
- The package requires PHP 8.4+ and is designed for Laravel 10.x or 11.x. It leverages modern PHP features like named arguments and enums, so ensure your Laravel app meets these requirements. If you're on an older version, consider upgrading or using Docker for isolation.
- How do I set up Wildberries FBS or DBS profiles in my Laravel app?
- Run the provided Artisan commands: `php artisan baks:users-profile-type:wildberries-fbs` for FBS or `php artisan baks:users-profile-type:wildberries-dbs` for DBS. Follow up with `baks:payment` and `baks:delivery` commands for each profile. These commands configure the necessary database and service layers for your chosen Wildberries marketplace.
- Will this package conflict with my existing orders or payments tables?
- Yes, the package introduces Wildberries-specific tables (e.g., `wb_orders`, `wb_payments`). To avoid conflicts, use table prefixes like `wb_` or review the migrations before running them. If your app already has overlapping schemas, you may need to customize the migrations or use a different namespace strategy.
- Can I use this package for both Wildberries FBS and DBS in the same Laravel app?
- Yes, the package supports both FBS and DBS workflows, but they must be configured separately using their respective Artisan commands. You can manage both profiles simultaneously, but ensure your database schema and payment/delivery integrations are distinct for each marketplace to avoid cross-contamination.
- How do I handle payment failures or delivery exceptions with this package?
- The package provides pre-configured payment and delivery profiles for FBS/DBS, but exceptions (e.g., payment failures) must be handled in your Laravel event listeners or middleware. Extend the package’s events (e.g., `PaymentFailed`) or add custom logic to retry failed transactions or notify users. Check the package’s documentation for available events.
- Does this package support real-time webhooks from Wildberries for order updates?
- No, the package does not include built-in webhook handling for real-time updates like shipment tracking or cancellations. You’ll need to implement custom webhook endpoints in your Laravel app and listen for Wildberries API events. The package may emit Laravel events (e.g., `OrderStatusUpdated`) that you can extend for this purpose.
- How do I run the package’s tests to ensure compatibility with my app?
- Run `php artisan test --group=wildberries-orders` to execute the package’s PHPUnit tests. These tests cover core functionality like order creation, payment processing, and delivery setup. If you encounter issues, review the test failures and ensure your Laravel environment matches the package’s dependencies (e.g., Doctrine, Guzzle).
- What if Wildberries changes its API, and the package isn’t updated?
- The package relies on Wildberries’ FBS/DBS APIs, so changes may break functionality. Monitor Wildberries’ API documentation and consider forking the package to maintain compatibility. Alternatively, wrap the package’s API calls in a custom service layer to isolate changes. Document any overrides in your `CHANGELOG.md`.
- Can I integrate this package with third-party payment gateways like Stripe or YooMoney?
- The package includes pre-configured payment profiles for Wildberries FBS/DBS, but you’ll need to extend or override these to integrate with external gateways. Use Laravel’s service container to bind custom payment handlers or create middleware to route transactions between Wildberries and your preferred gateway.
- Are there alternatives to this package for Wildberries integration in Laravel?
- If you need broader marketplace support (e.g., Ozon, AliExpress), consider packages like `spatie/laravel-wildberries` or `marketplace-sdk/laravel`. However, for Wildberries-specific FBS/DBS workflows, this package offers deep integration with orders, payments, and deliveries, reducing custom development time by 70–80%. Evaluate alternatives based on your need for real-time sync, analytics, or multi-marketplace support.