{"audience":"Dealer channel sales managers, marketing and campaign teams, order entry teams and finance.","authorization_objects":[{"note":"Campaign condition maintenance authorization by sales organization","object":"V_KONH_VKO"},{"note":"Order creation authorization by order type","object":"V_VBAK_AAT"},{"note":"Authorization to display the usage report by sales organization","object":"V_VBAK_VKO"}],"components":[],"countries":[],"effort_days_max":18,"effort_days_min":12,"effort_size":"L","faq":[{"a":"The campaign's discount records still sit in the standard sales deal. The enhancement adds the basket condition, tier selection, free goods, campaign payment terms and budget check on top, so existing pricing and reporting are not disturbed.","q":"How does this differ from the standard sales deal and promotion?"},{"a":"The budget is defined per campaign and compared with the total campaign discount in open and billed orders. Rejected items and returns are deducted from the total; the remaining budget appears in the usage report.","q":"How is the campaign budget tracked?"},{"a":"Yes. Because the rules run while the order is saved, they apply in the same way to orders created in VA01, by mass upload or from the portal through a BAPI.","q":"Does it also work for orders coming from the portal?"}],"features":[{"code":"alv","label":"ALV list (sort, filter, subtotals)","note":""},{"code":"drilldown","label":"Double-click drill-down to the document","note":"From a report row the user opens the list of campaign orders and VA03."},{"code":"excel","label":"Export to Excel","note":""},{"code":"transport","label":"Delivered as a transport request","note":"User exit and pricing routine changes are moved from test to production with a transport request."}],"functions":[{"name":"BAPI_SALESORDER_SIMULATE","role":"Calculates the campaign price in the portal and quotation screen without creating an order"},{"name":"PRICING","role":"Runs standard pricing after the campaign condition is added"}],"gap":"In the standard, discounts are kept as condition records (VK11), free goods with VBN1 and sales deals with VB21; each works on its own. Tiered campaigns based on the basket total, campaign-specific payment terms and instalment plans, a campaign budget per dealer and a warning when the budget is exceeded do not exist together in the standard. Order entry therefore applies campaigns manually, and errors are noticed only after invoicing.","id":"sd-dealer-campaign-promotion","industries":[],"input_columns":[],"kind":"program","language":"en","lastmod":"2026-11-17","logic":"1. The campaign is created as a standard sales deal (VB21); the campaign condition records are linked to the deal (KONH-KNUMA_AG). Extra rules such as dealer group, validity, basket conditions, free goods rule, payment terms and budget are kept per campaign number in a rule table created during installation.\n2. During order entry (VA01 or the portal) the sales order user exits (MV45AFZZ) and a pricing requirement routine run: valid campaigns are found with the dealer's customer group (KNVV-KDGRP) and the order date, and if the basket condition is met the campaign condition is applied to the items.\n3. If the free goods rule is met, a free-of-charge item is added; for tiered campaigns the correct tier is chosen from the basket total.\n4. The campaign's payment terms (ZTERM) and fixed value date are written to the order's business data (VBKD); if instalment payment terms are used, the payment plan is split into instalments on the invoice.\n5. Budget check: the discount granted by the campaign so far is totalled from the campaign condition lines of open and billed orders (KONV, PRCD_ELEMENTS in S/4HANA). If the budget is exceeded, the rule either issues a warning or saves the order with a delivery block.\n6. The campaign usage report shows per dealer the campaign order value, the discount granted, the free quantity and the remaining budget. The portal or quotation screen calculates the campaign price before creating an order with BAPI_SALESORDER_SIMULATE.","module":"SD","object_type":"enhancement","output_columns":[{"calculated":false,"formula":"","label":"Campaign","source_field":"KNUMA_AG","source_table":"KONH"},{"calculated":false,"formula":"","label":"Dealer","source_field":"KUNNR","source_table":"VBAK"},{"calculated":false,"formula":"","label":"Dealer name","source_field":"NAME1","source_table":"KNA1"},{"calculated":true,"formula":"Number of orders carrying the campaign condition","label":"Orders","source_field":null,"source_table":null},{"calculated":true,"formula":"Σ VBAP-NETWR (campaign items)","label":"Campaign order value","source_field":null,"source_table":null},{"calculated":true,"formula":"Σ campaign condition line KWERT","label":"Discount granted","source_field":null,"source_table":null},{"calculated":true,"formula":"Σ quantity of free-of-charge items","label":"Free quantity","source_field":null,"source_table":null},{"calculated":false,"formula":"","label":"Payment terms","source_field":"ZTERM","source_table":"VBKD"},{"calculated":true,"formula":"Campaign budget − Σ discount granted","label":"Remaining budget","source_field":null,"source_table":null},{"calculated":false,"formula":"","label":"Currency","source_field":"WAERK","source_table":"VBAK"}],"parameters":[{"example":"0000004012","kind":"select_option","label":"Campaign (sales deal)","name":"S_KNUMA","ref_field":"KONH-KNUMA_AG","required":false},{"example":"1000","kind":"select_option","label":"Sales organization","name":"S_VKORG","ref_field":"VBAK-VKORG","required":true},{"example":"B1","kind":"select_option","label":"Dealer group (customer group)","name":"S_KDGRP","ref_field":"KNVV-KDGRP","required":false},{"example":"200510","kind":"select_option","label":"Dealer","name":"S_KUNNR","ref_field":"VBAK-KUNNR","required":false},{"example":"01.11.2026 – 30.11.2026","kind":"select_option","label":"Order date","name":"S_AUDAT","ref_field":"VBAK-AUDAT","required":true},{"example":"","kind":"checkbox","label":"Save the order with a delivery block when the budget is exceeded","name":"P_BLOCK","ref_field":"","required":false}],"part_of":[],"performance":"Buffer the campaign rule table once at the start of order processing; avoid database reads per item. Instead of re-totalling budget consumption on every order, read it from a subtotal kept per campaign and reconcile it with a nightly job.","process":"O2C","quote_url":"https://nekuhub.com/en/request-a-quote/?report=sd-dealer-campaign-promotion","related":["sd-customer-price-conditions-validity","sd-invoice-vs-order-price-qty-differences","sd-price-condition-upload"],"releases":[],"source":"custom","standard_alternatives":[{"note":"Maintains sales deals and linked condition records; no basket condition, campaign payment terms or budget check.","tcode":"VB21"},{"note":"Maintains free goods rules; does not work together with discount and payment terms as one campaign.","tcode":"VBN1"}],"summary":"A custom enhancement that automatically applies the discount, free goods and campaign-linked payment terms of dealer-group campaigns to the sales order. Basket conditions (minimum quantity or value, product group mix) and the campaign budget are checked, and a usage report shows how much each dealer has benefited from a campaign.","tables":[{"access":"read","join_on":"","role":"Header of campaign condition records and linked sales deal","table":"KONH","variant":"both"},{"access":"read","join_on":"KONP-KNUMH = KONH-KNUMH","role":"Campaign discount rates and amounts","table":"KONP","variant":"both"},{"access":"read","join_on":"KNVV-KUNNR = VBAK-KUNNR","role":"Dealer's customer group and sales area","table":"KNVV","variant":"both"},{"access":"read","join_on":"","role":"Sales order header: dealer, date, order type","table":"VBAK","variant":"both"},{"access":"write","join_on":"VBAP-VBELN = VBAK-VBELN","role":"Order items: material, quantity, free-of-charge item","table":"VBAP","variant":"both"},{"access":"write","join_on":"VBKD-VBELN = VBAK-VBELN","role":"Campaign payment terms and fixed value date","table":"VBKD","variant":"both"},{"access":"read_write","join_on":"KONV-KNUMV = VBAK-KNUMV","role":"Campaign condition lines added to the order; budget consumption (ECC)","table":"KONV","variant":"ecc"},{"access":"read_write","join_on":"PRCD_ELEMENTS-KNUMV = VBAK-KNUMV","role":"Campaign condition lines added to the order; budget consumption (S/4HANA)","table":"PRCD_ELEMENTS","variant":"s4"},{"access":"read","join_on":"T052-ZTERM = VBKD-ZTERM","role":"Campaign payment terms and instalment definition","table":"T052","variant":"both"},{"access":"read","join_on":"KNA1-KUNNR = VBAK-KUNNR","role":"Dealer name","table":"KNA1","variant":"both"}],"title":"Dealer Campaign, Promotion and Payment Plan Calculation Enhancement","url":"https://nekuhub.com/en/programs/dealer-campaign-promotion-and-payment-plan-calculation/","vendor_id":"nekudos"}