Emag

Description

eMag integrates Enso catalog, offer, order, pricing, and fulfilment flows with the eMag marketplace.

The package stores integration settings and courier-account configuration, synchronizes remote categories and commissions, publishes or matches local products as eMag offers, reacts to order callbacks, creates and updates local eMag order records, and supports invoice upload plus AWB generation.

It is a private marketplace integration package intended for Enso deployments that operate on eMag.

Installation

This is a proprietary package distributed through the private Enso registry.

Run the package migrations:

php artisan migrate

The package also publishes backend client assets into the host application:

php artisan vendor:publish --tag=emag-assets

In production, when the integration is enabled, the package schedules:

enso:emag:generate-awbs daily at 07:00 when AWB scheduling is enabled in commercial settings
enso:emag:order-fallback every 15 minutes

Features

Encrypted settings for API credentials, company, sale channel, and warehouse/contact metadata.
Offer actions for activate, deactivate, upload, download, manual/automatic pricing, picture download, match publishing, and new-product publishing.
Order processing with acknowledgement, synchronization, invoice upload, AWB generation, quarantined order flows, and signed invoice serving.
Callback endpoints for AWBs, orders, returns, cancellations, and newly available products.
Commands for enabling/disabling the API and syncing categories, commissions, courier accounts, and AWBs.

Usage

The package centers on two core models:

LaravelEnso\\Emag\\Models\\Offer
LaravelEnso\\Emag\\Models\\Order

Useful offer actions:

activate()
deactivate()
upload()
download()
downloadPictures()
updateMeasurements()
syncCommission()
publishMatch(Product $product, $pnk)
publishNew(Product $product)

Useful order actions:

acknowledge()
sync()
generateAWB()
uploadInvoice()
process(int $id)

Operational commands:

php artisan enso:emag:api-up
php artisan enso:emag:api-down
php artisan enso:emag:sync-categories
php artisan enso:emag:sync-commissions --only-missing
php artisan enso:emag:sync-courier-accounts
php artisan enso:emag:generate-awbs
php artisan enso:emag:order-fallback
php artisan enso:emag:quarantined-orders