Skip to content

How-To Guide

This guide provides step-by-step workflows for common tasks with ADCELL Commission Approval.

How the Plugin Works

Data Flow Overview

ADCELL API (open commissions) → Plugin (reconciliation with Shopware orders) → Decisions → ADCELL API (approval/cancellation)

Detailed Flow:

  1. The plugin fetches open commissions from the ADCELL API
  2. For each commission, the corresponding Shopware order is looked up (via the order number in the "reference" field)
  3. The decision algorithm checks in this order:
  4. Is there a program mapping? → If no: Not mapped
  5. Does the order exist in Shopware? → If no: Cancel
  6. Is the order cancelled/failed? → Cancel
  7. Was the delivery fully returned? → Cancel
  8. Was the payment fully refunded? → Cancel
  9. Is the payment open/pending? → Cancel
  10. Did the payment fail? → Cancel
  11. Has it not been shipped yet? → Cancel
  12. Is there a partial refund? → Adjust
  13. Does the cart value deviate (beyond tolerance)? → Adjust
  14. Everything OK? → Approve
  15. Decisions are saved as a batch (status: "Prepared")
  16. You review the results and can override decisions
  17. When sending, decisions are submitted to the ADCELL API

Amount Calculation

The shop value is calculated as follows:

Shop value = Net order value − Net shipping costs

For gross-priced shops (B2C), VAT is automatically deducted. This value is compared against the ADCELL cart value.

Common Workflows

How to: Initial Setup

Goal: Fully set up the plugin and run the first reconciliation.

Time Required: Approximately 10 minutes

Steps:

  1. Activate the plugin
  2. Navigate to: Extensions → My Extensions

  3. Activate ADCELL Commission Approval

  4. Enable test mode

  5. Navigate to: Extensions → My Extensions → ADCELL Commission Approval → Configure
  6. Set Test mode to On

  7. Save

  8. Create an ADCELL account

  9. Navigate to: Orders → ADCELL Commission Approval → Accounts
  10. Create an account with username and password

  11. Test the connection

  12. Set up program mapping

  13. Navigate to: Orders → ADCELL Commission Approval → Program Mapping
  14. Select account → Load programs

  15. Create a mapping for each active program to the appropriate sales channel

  16. Run the first reconciliation

  17. Navigate to: Orders → ADCELL Commission Approval → Reconciliation
  18. Select account and date range (e.g. 30 days)

  19. Start reconciliation and review results

  20. Disable test mode (after successful review)

  21. Settings → Set Test mode to Off

Result: The plugin is ready for production. The next reconciliation will send decisions to ADCELL.

How to: Run a Manual Reconciliation

Goal: Review open commissions and send decisions to ADCELL.

Steps:

  1. Start reconciliation
  2. Navigate to: Orders → ADCELL Commission Approval → Reconciliation
  3. Select account and date range

  4. Start reconciliation

  5. Review results

  6. Use filters to focus on specific decisions (e.g. cancellations only)

  7. Override individual decisions via the dropdown if needed

  8. Send to ADCELL

  9. Click Send to ADCELL
  10. Wait for the confirmation message

Result: All decisions have been submitted to ADCELL. The batch appears in the dashboard.

How to: Resume a Prepared Batch

Goal: Open a previously created reconciliation that has not been sent yet and send it.

Steps:

  1. Open the dashboard

  2. Navigate to: Orders → ADCELL Commission Approval → Dashboard

  3. Select the batch

  4. In the "Recent reconciliations" table, find the desired batch (status: "Prepared")

  5. Click the date link or use the context menu (three dots) → "View details"

  6. Review and send

  7. Review decisions, adjust if needed
  8. Click Send to ADCELL

How to: Set Up Automatic Approval

Goal: Have commissions reconciled and approved automatically every day.

Prerequisites: - At least one active ADCELL account - Program mappings configured - Shopware message queue worker running

Steps:

  1. Configure settings
  2. Navigate to: Extensions → My Extensions → ADCELL Commission Approval → Configure
  3. Enable automatic approval: On
  4. Days before auto-accept deadline: 3 (recommended)

  5. Save

  6. Ensure the message queue is running

  7. Verify that bin/console messenger:consume is running as a cron job or Supervisor process

Result: The plugin runs a daily reconciliation and sends decisions to ADCELL automatically.

Quick Reference

Task Location Prerequisites
Create account Accounts ADCELL credentials
Set up mapping Program Mapping Active account
Manual reconciliation Reconciliation Account + Mapping
Resume batch Dashboard → Click batch Prepared batch
Auto-approval Settings Account + Mapping + Worker

Best Practices

  1. Test first: Use test mode to verify decisions before going live
  2. Reconcile regularly: Run reconciliations at least weekly to act before the auto-accept deadline
  3. Keep mappings current: New ADCELL programs should be mapped to a sales channel promptly
  4. Set minimum order age: Use the minimum order age (e.g. 14 days) to only approve commissions after the return period has passed

What to Avoid

  • Do not leave test mode accidentally enabled in production — decisions will not be sent
  • Do not run the same reconciliation multiple times without sending previous batches — dashboard statistics only count sent items, but you create unnecessary prepared batches
  • Do not set tolerance values too high, as legitimate adjustments may be skipped