answear/acs-bundle

Symfony bundle for ACS api.

3.0.1 2024-12-17 09:01 UTC

Requires

• php: ^8.2
• ext-json: *
• guzzlehttp/guzzle: ^6.0|^7.0
• symfony/http-kernel: ^6.4|^7.0
• symfony/property-info: ^6.4|^7.0
• symfony/serializer: ^6.4|^7.0
• webmozart/assert: ^1.11

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.64
• phpro/grumphp: ^1.5.0|^2.5
• phpstan/phpstan: ^1.11
• phpstan/phpstan-webmozart-assert: ^1.0
• phpunit/phpunit: ^10.5
• roave/security-advisories: dev-master
• symfony/phpunit-bridge: 6.4.*|^7.0

MIT

README

ACS pickup point integration for Symfony.

Installation

• install with Composer

composer require [e-mail]:answear/acs-bundle.git

Answear\AcsBundle\AnswearAcsBundle::class => ['all' => true],
should be added automatically to your config/bundles.php file by Symfony Flex.

Setup

• provide required config data: apiKey, companyId, companyId, userId, userPassword

# config/packages/answear_acs.yaml
answear_gls:
    apiKey:
    companyId:
    companyPassword:
    userId:
    userPassword:
    language: //default GR

Usage

Get ParcelShops

/** @var \Answear\AcsBundle\Service\ParcelShopsService $parcelShopService **/
$parcelShopService->getList(CountryIdEnum $countryId, ?int $kind = null);

will return \Answear\AcsBundle\Response\DTO\ParcelShop[] array.

Where countryId is Greece or Cyprus, and kind is shop kind according to ACS documentation, null means all kinds

Error handling

• Answear\AcsBundle\Exception\ServiceUnavailable for all GuzzleException
• Answear\AcsBundle\Exception\MalformedResponse for incorrect responses

Final notes

Feel free to open pull requests with new features, improvements or bug fixes. The Answear team will be grateful for any comments.