Payment Reference (FIK, KID, BGMAX)

As a Accountant
I want to automatically generate a FIK 71 payment reference on every sales invoice so that Danish customers can pay via their online banking using the invoice reference
So that payments are automatically reconciled in our bank system without manual matching

Setup:

1. Open the Bank Account card for the bank account used for DKK invoice payments. Enter the SCB Bank Creditor No. (the 8-digit Nets creditor number issued to your company).
2. Open Payment Methods and select the method used for domestic invoice payments (e.g. FIK).
3. Set SCB Payment ID Type to FIK 71.
4. Set SCB Payment Bank No. to the bank account entered in step 1.
5. The Reference Mask is auto-populated as +71<{DDDDDDCCCCCCCT}M+B<. Verify this matches your bank's requirements.
6. In Document Customizer Content for the Sales Invoice, set PaymentIDType to FIK 71.
7. In the Footer HTML for the Sales Invoice, place %1 at the position where the FIK reference should appear and configure HTML Parameter No. 1 with Return Parameter = 1 to inject the Payment ID.
8. Post a test invoice with Payment Method = FIK and verify the Payment ID is populated and prints correctly.

As a Accountant
I want to embed the customer number inside the FIK 71 reference so that our bank can automatically identify which customer made the payment, in addition to which invoice it relates to
So that payment matching is fully automatic even for customers who pay multiple invoices together

Setup:

1. Open the Payment Method configured for FIK payments.
2. Enable SCB Include Customer No. This adds the customer number to the reference mask alongside the document number.
3. The mask will be adjusted to accommodate both the document number and the customer number within the 14-digit base.
4. Note the combined length constraint: the document number and customer number together must fit within the 14-digit base of FIK 71. If either is too long, the system will raise an error when posting.

Note: The customer number is right-padded with the document number and left zero-filled to reach the required length. If the customer number exceeds the available space (typically 8 digits with document type, 7 without), the posting will fail with a descriptive error.

As a Accountant
I want to use FIK 75 instead of FIK 71 for invoices where the document number plus customer number exceeds the 14-digit FIK 71 capacity
So that longer document or customer numbers are accommodated within the structured payment reference

Setup:

1. Open the relevant Payment Method and set SCB Payment ID Type to FIK 75.
2. The Reference Mask is auto-set to +75<{DDDDDDDCCCCCCCT}M+B< (15-digit base instead of FIK 71's 14).
3. Set SCB Payment Modulus Algorithm to Mod 10.
4. In Document Customizer Content, set PaymentIDType to FIK 75 for the Sales Invoice.
5. Post a test invoice and verify the generated reference starts with +75<.

As a Accountant
I want to generate KID references on invoices for Norwegian customers so that they can pay via AvtaleGiro or other Norwegian KID-based methods
So that Norwegian payments are automatically reconciled without manual processing

Setup:

1. Ensure the Norwegian KID Setup is configured in Sales & Receivables Setup (fields for KID Setup type, Document No. length, Customer No. length). Document Customizer reads these values to auto-generate the KID mask.
2. Open the Payment Method for Norwegian payments and set SCB Payment ID Type to KID.
3. The Reference Mask is auto-generated based on your Norwegian KID Setup configuration (e.g. {DDDDDDCCCCCC}M).
4. Set SCB Payment Modulus Algorithm to Mod 10.
5. Set SCB Payment Bank No. to the Norwegian bank account (with the creditor number filled in).
6. In Document Customizer Content, set PaymentIDType to KID for the relevant Sales Invoice template.
7. Post a test invoice and verify the KID reference is calculated correctly.

Note: The KID mask is validated to have between 2 and 24 digits inside the {...} block. If the Norwegian KID Setup is not present (the Norwegian localisation extension is not installed), the default mask {DDDDDDCCCCCC}M is used.

As a Accountant
I want to configure a BGMAX reference string for invoices to Swedish customers using Swedish Bankgiro
So that Swedish customers can pay via Bankgiro with automatic matching in our Swedish bank account

Setup:

1. Open the Payment Method for Swedish Bankgiro payments and set SCB Payment ID Type to BGMAX.
2. Manually enter the SCB Payment Reference Mask according to your Bankgiro agreement. Use D for document number digits, C for customer number digits, B for the Bankgiro number, and M for the check digit. Enclose the base for modulus calculation in {...}.
3. Set SCB Payment Modulus Algorithm to Mod 10 or Mod 11 as required by your Bankgiro provider.
4. Set SCB Payment Bank No. to the bank account holding the Bankgiro number in SCB Bank Creditor No.
5. Test the mask with a real invoice number and verify the generated reference string matches your Bankgiro provider's specification.

As a IT Manager
I want to define a payment reference format specific to a business partner's payment portal that uses a proprietary reference structure not covered by FIK, KID, or BGMAX
So that the printed reference can be scanned or entered at the partner's payment portal for automated processing

Setup:

1. Open the Payment Method for this partner and set SCB Payment ID Type to Custom.
2. Enter the SCB Payment Reference Mask manually. Use the placeholder characters:
   • D = one digit of the document number (right-aligned, zero-padded to the number of D's)
   • C = one digit of the customer number
   • T = document type digit
   • B = the full bank creditor number (replaced as a whole, not digit by digit)
   • M = the calculated check digit (placed outside {...})
   • {...} = encloses the portion of the mask used as input to the modulus calculation
3. Set SCB Payment Modulus Algorithm to the algorithm required by the payment portal.
4. Use the Test Calculation function (if available) or post a test invoice to verify the generated reference.

Note: The {...} delimiters are required for the modulus check digit to be calculated. If your format has no check digit, omit the modulus characters; however, a validation error will occur if { and } are present in the wrong order.

As a Business Manager
I want to print the FIK reference prominently in the footer of every invoice, formatted as a payment slip block
So that customers can clearly see and use the reference for their payment

Setup:

1. Open the Extended Footer for the Sales Invoice footer code.
2. In HTML Lines, enter the footer HTML with a %1 placeholder at the position for the FIK reference:
   <p><strong>FIK reference: %1</strong></p>
3. Open HTML Parameters for the footer code. Add Parameter No. 1 and set Return Parameter = 1. (Return Parameter 1 passes the pre-calculated Payment ID from the report to the parameter resolver.)
4. Save. When the invoice is printed, %1 is replaced with the stored Payment ID value.

Note: The Payment ID is pre-calculated and stored on the posted invoice when the Payment Method is validated. It is passed to the footer rendering engine as a runtime parameter (p1). This is why Return Parameter = 1 is used rather than a direct field lookup.

As a Accountant
I want to recalculate the Payment ID on a posted invoice after our bank creditor number was updated, so that the reprinted invoice carries the correct reference
So that customers who receive a reprint pay to the correct account with the updated reference

Setup:

1. Open the Posted Sales Invoice for the document that needs updating.
2. In the Navigation or Processing action area, use the action Update Payment ID (visible when Document Customizer is active).
3. The system recalculates the Payment ID using the current bank account and payment method setup and updates the SCB Payment ID field on the invoice.
4. Reprint the invoice. The footer will now show the updated reference.

Note: The Update Payment ID action re-runs the same calculation triggered by validating the Payment Method Code. If the payment method or bank account has been changed since the invoice was posted, the new values are used.

As a Accountant
I want to override the bank account used for the FIK reference on a specific posted invoice — for example, when a customer should pay to a collection agency account rather than the standard bank
So that the FIK reference on that invoice embeds the correct creditor number for the intended payee

Setup:

1. On the Posted Sales Invoice, set the field Payment Bank No. (SCB Payment Bank No.) to the alternative bank account. This field is visible on the Posted Sales Invoice page when Document Customizer is active.
2. Use the action Update Payment ID to recalculate the reference using the overriding bank account's creditor number.
3. Reprint the invoice. The FIK reference will now carry the creditor number from the overriding bank account rather than the default from the Payment Method.

Note: The per-invoice bank account override takes priority over the bank account configured on the Payment Method. This allows exceptional cases to be handled without changing the global payment method setup.

As a IT Manager
I want to check that the reference mask configured on a Payment Method produces valid references — correct length, correct modulus calculation, and the right format prefix
So that I can verify the setup is correct before the first real invoices are issued

Setup:

1. Open the Payment Method and review the SCB Payment Reference Mask. Confirm:
   • The number of D characters matches or exceeds the expected document number length (shorter document numbers are zero-padded to fill the D slots).
   • The {...} block contains exactly 14 characters for FIK 71, 15 for FIK 75, or 2–24 characters for KID.
   • The M placeholder is placed immediately after the closing }.
   • The B placeholder is present if the creditor number should appear in the reference.
2. Post a test invoice with a simple document number (e.g. INV00001) and open the Posted Sales Invoice to inspect the SCB Payment ID field.
3. Verify the generated string against a manual FIK/KID calculation or your bank's reference validator tool.
4. If the Bank Account has no creditor number, the Payment ID field will remain blank — ensure SCB Bank Creditor No. is populated before testing.