Item — Custom Fields
The extension adds 3 fields to the standard Item table. These fields are used for custom invoice text and credit card settlement integration.
Field Reference
| Field ID | Field Name | Data Type | Description |
|---|---|---|---|
| 50001 | Invoice Text | Text[100] | Custom description that appears on the printed invoice instead of the standard item description. If blank, the standard Description field is used |
| 51322 | FirstCard Article Code | Code[10] | Article code sent to FirstCard in settlement files. Required for all items that appear on orders for FirstCard customers |
| 51323 | Diners Article Code | Code[10] | NSL article number sent to Diners Club in settlement files — see Diners Article Codes below. Required for all items that appear on orders for Diners customers |
Diners Article Codes
The Diners Article Code is an NSL article number — the product classification used by SEB Kort's Transaction Record Layout to describe what the cardholder was charged for. The authoritative list is NSL Article Numbers, Version 2 (SEB Kort). The codes relevant to travel items are:
| Code | NSL description | Typical items |
|---|---|---|
| 1001 / 1050 | International / Domestic Airlines | FLIGHT-NOR, FLIGHT-EUR, FLIGHT-INT / FLIGHT-DOM |
| 2001 / 2050 | International / Domestic Train | TRAIN-INT / TRAIN-DOM |
| 2501 / 2550 | International / Domestic Ferry Service | BOAT-INT / BOAT-DOM |
| 3001 / 3050 | International / Domestic Car Rental | CAR-RENT-INT / CAR-RENT-DOM |
| 3101 / 3150 | International / Domestic Coach | BUS-INT / BUS-DOM |
| 3110 / 3160 | International / Domestic Transfer | GROUND-TRANSPORT-INT / GROUND-TRANSPORT-DOM |
| 3501 / 3550 | International / Domestic Hotel | HOTEL-INT / HOTEL-DOM |
| 4001 / 4050 | International / Domestic Arrangement | ARR-INT / ARR-DOM-* |
| 4602 / 4652 | International / Domestic Other Services | Markup items |
| 4715 | Transaction Fee | All service fee items (SERV-*) |
The full NSL list also covers helicopter, serial tickets, cruises, fuel, road toll, limousine, congress, fairs, groups, incentive and package tours, insurance, discount, commission pay back, gift vouchers, VAT and visa. Ask the customer's SEB Kort contact for the current version if an item does not fit the codes above.
Domestic means the company's own country. For a Norwegian company only Norway-to-Norway travel is domestic — Nordic, Europe and the rest of the world all use the international code. For a Swedish company, only Sweden-to-Sweden.
NSL contains both 4714 Service Fee and 4715 Transaction Fee. SEB Kort's field review directed the agency to 4715, and that is what has been accepted in the settlement files since. Do not use 4711 Delivery Fee — an early TBC design used it and it was rejected in field review.
Defaults on New Items
The extension hooks the Item Card's New action. A newly created item is pre-filled with:
- Type = Service (always — travel products are not inventory items)
- Base Unit of Measure from AIR Setup field 60
- Gen. Prod. Posting Group from AIR Setup field 61
- VAT Prod. Posting Group from AIR Setup field 62
Blank AIR Setup fields apply no default. Configure AIR Setup fields 60–62 before the customer starts creating items, otherwise every item has to be corrected by hand.
Note this applies to items created interactively from the Item Card. Items brought in by a configuration package are not affected — the package must carry Type, Base Unit of Measure and the posting groups itself.
Config Package Mapping
Include these fields from the Item table (table ID 27):
| Include in Package | Field ID | Notes |
|---|---|---|
| Yes | 50001 | Only needed for items where the invoice should show a different text than the standard description |
| Conditional | 51322 | Required only if any customer uses FirstCard as credit card provider |
| Conditional | 51323 | Required only if any customer uses Diners as credit card provider |
Which Items Need These Fields
The items that need credit card article codes are those referenced in:
- AIR Order Item Mapping — The Booking Item and Service Fee Item for each product type/region combination
- Any other items that might appear on sales orders for credit card customers
If a FirstCard or Diners article code is missing on an item that appears on a credit card customer's order, the credit card settlement will fail validation. Make sure all relevant items have the correct codes before go-live.
Where settlement validation happens
Business Central exposes the settlement transactions through API pages; the validation of the settlement files themselves is performed by the external middleware, not by this extension. Failures are written back into Business Central as records in Travel Card Validation Error (table 51322), viewable on the Travel Card Validation Errors page and in the Travel Business Cue.
Practical consequence for onboarding: a missing or wrong article code will not surface as an error in BC at import or posting time. It appears later, as a validation error pushed back by the middleware. Budget a round-trip test with the middleware before go-live rather than assuming a clean posting means clean settlement.
Typical Item Setup for Travel
A travel agency typically needs items for each combination of product type and region. For example:
| Item | Description | Purpose |
|---|---|---|
| FLIGHT-DOM | Domestic Flight | Booking item for domestic flights |
| FLIGHT-NOR | Nordic Flight | Booking item for Nordic flights |
| FLIGHT-EUR | European Flight | Booking item for European flights |
| FLIGHT-INT | International Flight | Booking item for international flights |
| SVC-FEE | Service Fee | Service fee item (may vary by region) |
| HOTEL-DOM | Domestic Hotel | Booking item for domestic hotels |
| HOTEL-EUR | European Hotel | Booking item for European hotels |
| CAR-RENTAL | Car Rental | Booking item for car rentals |
| GROUND | Ground Transport | Booking item for ground transport |
The exact items depend on the customer's needs and are configured in the AIR Order Item Mapping table.