NewZealand (NZ)

BC29 · country layer against W1 · Learn: local functionality · narrative reviewed (checked by Opus)

Overview

The NZ layer uses a shared APAC code base. Object names such as AU/NZ Statement and Enable GST (Australia) show the link to Australia, so many objects and fields carry ABN, BAS and GST names. It adds 170 objects of its own and changes W1 objects, adding 459 fields, 210 procedures and 21 events. The main areas are GST and BAS (BAS Management, BAS setup pages, GST entry pages, settlement fields on VAT Entry), withholding tax (WHTManagement, WHT posting groups, WHT Entry, certificates and settlement), and tax invoices and tax credit memos (TaxInvoiceManagement, posted tax document pages and reports).

Posting is extended through procedures added to Gen. Jnl.-Post Line, Sales-Post, Purch.-Post, the prepayment codeunits and the invoice posting codeunits. These handle WHT, full GST on prepayments and ACY amounts. Adjustment applies-to logic is added to Gen. Journal Line, Sales Header, Purchase Header and Cust. Entry-Edit. Setup is in General Ledger Setup (Enable GST (Australia), Enable WHT, Enable IRD No., Enable Tax Invoices, Full GST on Prepayment), Sales & Receivables Setup and Purchases & Payables Setup.

Banking adds EFT Management, EFT Register, the Transfer EFT Register and Create EFT File reports, and post-dated checks. Learn covers these local features: addresses in New Zealand, withholding tax setup and settlement, IRD numbers and adjustment notes, GST posting and prepayments, EFT, cost-plus pricing, statutory financial reports, and e-invoicing with Peppol PINT A-NZ.

Key points

• GST posting with BAS: BAS Management codeunit, BAS setup and calculation sheet pages, BAS fields on G/L Entry and VAT Entry, and the Calculate GST Settlement report.
• Withholding tax: WHT business and product posting groups, WHT revenue types and posting setup, WHT Entry, WHT certificate reports, and the Calc. and Post WHT Settlement report.
• IRD numbers and adjustment notes: IRD No. on Company Information, Customer, Vendor and Contact, plus Adjustment, BAS Adjustment and Adjustment Applies-to fields on journal lines, documents and ledger entries.
• Full GST on prepayments and ACY VAT amounts: extra fields on sales and purchase lines, plus procedures in the prepayment posting codeunits.
• Tax invoices and tax credit memos: TaxInvoiceManagement, posted tax invoice and credit memo pages, and the tax invoice reports.
• EFT payments: EFT fields on Bank Account, Vendor and journal lines, EFT Register, Transfer EFT Register and Create EFT File.
• Post-dated checks, check installments, and the AU/NZ Statement and back-dated aged receivables and payables reports.
• Cost-plus pricing fields (Published Price, Cost, Cost-plus %) on price list lines, and NZ address handling with AMAS and counties.

Narrative written by Sonnet from the code diff and 26 Learn page summaries. In numbers: NewZealand (NZ) localization of Business Central in BC29: 170 objects of its own, 109 W1 objects changed (459 fields and 21 events added). From the code; country apps outside the Base Application are not included yet.

By area

Finance

Adds GST and BAS handling, with BAS Management, the BAS setup, calculation sheet and ATO receipt pages, and GST sales and purchase entry pages. Adds withholding tax (WHTManagement, WHT posting groups, revenue types, posting setup, WHT Entry), tax invoice management and the posted tax document pages. W1 tables get BAS, WHT, adjustment and ACY fields, and General Ledger Setup gets the enable switches. Posting codeunits get WHT and GST procedures and a few events. Many local reports are added, including GST settlement, WHT certificates, balance sheet and income statement.

Why: Learn describes GST as reported in the Business Activity Statement. WHT is withheld from vendors without IRD numbers and remitted through the BAS. Adjustment notes adjust GST claims when consideration changes.

Objects: codeunit/12 “Gen. Jnl.-Post Line”, table/98 “General Ledger Setup”, table/254 “VAT Entry”, codeunit/11601 “BAS Management” (own), codeunit/28040 “WHTManagement” (own), table/81 “Gen. Journal Line”, page/28044 “WHT Entry” (own), report/11603 “Calculate GST Settlement” (own).

All 163 objects of Finance in the diff

Purchases

Vendor, purchase document and posted document tables get ABN, IRD No., WHT group, adjustment, tax document and ACY amount fields. Purchases & Payables Setup gets GST groups, WHT certificate numbering, tax invoice number series and post-dated check settings. Purch.-Post and the prepayment codeunits get WHT and full GST procedures. Adds the Items Received & Not Invoiced and Purchase Receipts reports.

Why: Learn explains that vendors without IRD numbers have WHT withheld according to WHT Posting Setup.

Objects: table/38 “Purchase Header”, table/39 “Purchase Line”, codeunit/90 “Purch.-Post”, codeunit/444 “Purchase-Post Prepayments”, table/312 “Purchases & Payables Setup”, table/23 “Vendor”, table/25 “Vendor Ledger Entry”, codeunit/816 “Purch. Post Invoice”.

All 30 objects of Purchases in the diff

Sales

Customer and sales document tables get IRD No., sales tax exemption, WHT, adjustment, tax document type and ACY fields. Sales-Post, prepayment and invoice posting codeunits get WHT and full GST procedures. Sales & Receivables Setup gets tax invoice number series and post-dated check settings. Adds the AU/NZ Statement report.

Why: Learn covers GST on prepayments and adjustment notes (credit memos) for sales.

Objects: table/36 “Sales Header”, table/37 “Sales Line”, codeunit/80 “Sales-Post”, codeunit/442 “Sales-Post Prepayments”, table/311 “Sales & Receivables Setup”, table/18 “Customer”, table/21 “Cust. Ledger Entry”, report/17110 “AU/NZ Statement” (own).

All 27 objects of Sales in the diff

Foundation

Company Information gets ABN, IRD No., WHT Registration ID, RDO Code and tax period fields. Address handling adds counties, address buffer and ID tables, AMAS and address validation settings on Country/Region, and barcode and tax document address procedures in Format Address. DateFilter-Calc gets period verification procedures.

Why: Learn explains that NZ postal codes can have multiple cities and that addresses use the Delivery Point Identifier (DPID) for validation and barcodes.

Objects: table/79 “Company Information”, codeunit/365 “Format Address”, table/28004 “County” (own), table/9 “Country/Region”, codeunit/358 “DateFilter-Calc”, codeunit/28020 “Report Management APAC” (own), table/28002 “Address Buffer” (own), table/242 “Source Code Setup”.

All 19 objects of Foundation in the diff

Bank

Adds EFT: EFT fields on Bank Account, EFT Management, EFT Register and the reports to transfer and create EFT files. Adds post-dated check fields on bank ledger entries, a deposit slip report, bank reconciliation and cash flow compare reports, and back-dated aged balance reports. Bank Acc. Reconciliation Post gets unrealized WHT posting.

Why: Learn documents EFT for vendor payments, compare bank cash flow, and the bank reconciliation and deposit slip reports.

Objects: codeunit/11603 “EFT Management” (own), table/11609 “EFT Register” (own), report/11608 “Create EFT File” (own), report/11607 “Transfer EFT Register” (own), table/270 “Bank Account”, table/272 “Check Ledger Entry”, report/28021 “Bank Account Reconciliation” (own), codeunit/370 “Bank Acc. Reconciliation Post”.

All 15 objects of Bank in the diff

Inventory

Item, Item Template, Item Charge and Item Journal Line get a WHT Product Posting Group or ACY exchange rate field. ItemCostManagement gets cost-plus price update procedures and an event. Adds the Stock Card and Stock Movement reports.

Why: not explained by a Learn page in the input; the code shows the change, not the requirement.

Objects: codeunit/5804 “ItemCostManagement”, table/27 “Item”, table/1382 “Item Templ.”, table/5800 “Item Charge”, report/14311 “Stock Card” (own), report/28022 “Stock Movement” (own), table/83 “Item Journal Line”.

All 8 objects of Inventory in the diff

Text

Adds barcode support with BarCode Management and reports for barcode checking and batch jobs, used with address barcodes.

Why: Learn links address barcodes to the DPID.

Objects: codeunit/28001 “BarCode Management” (own), report/28000 “BarCode Checking” (own), report/28001 “BarCode Batch Job” (own).

All 3 objects of Text in the diff

Pricing

Price List Line and Price Worksheet Line get Published Price, Cost, Cost-plus % and Discount Amount fields. Procedures update the unit price from the cost-plus percentage.

Why: Learn documents determining the sales price by cost plus percentage.

Objects: table/7001 “Price List Line”, table/7022 “Price Worksheet Line”.

All 2 objects of Pricing in the diff

Security

The LOCAL and LOCAL READ permission sets are changed to cover the NZ objects.

Why: not explained by a Learn page in the input; the code shows the change, not the requirement.

Objects: permissionset/1001 “LOCAL”, permissionset/1002 “LOCAL READ”.

All 2 objects of Security in the diff

Service

Adds a service document management codeunit for APAC and a Service Manager role center page extension.

Why: not explained by a Learn page in the input; the code shows the change, not the requirement.

Objects: codeunit/11612 “Serv. Document Mgt. APAC” (own), pageextension/28041 “Serv.ServiceMgrRoleCenter APAC” (own).

All 2 objects of Service in the diff

(no namespace)

A table extension on source code setup for APAC adds local source codes.

Why: not explained by a Learn page in the input; the code shows the change, not the requirement.

Objects: tableextension/28160 “SourcecodeAPAC” (own).

All 1 objects of (no namespace) in the diff

CRM

Contact gets ABN, Registered, ABN Division Part No. and IRD No. fields.

Why: Learn covers entering IRD numbers for tax compliance.

Objects: table/5050 “Contact”.

All 1 objects of CRM in the diff

ExpenseAgent

Adds an NZ expense event subscriber codeunit.

Why: not explained by a Learn page in the input; the code shows the change, not the requirement.

Objects: codeunit/6977 “Expense Event Subscriber NZ” (own).

All 1 objects of ExpenseAgent in the diff

FixedAssets

Fixed Asset gets a WHT Product Posting Group field.

Why: not explained by a Learn page in the input; the code shows the change, not the requirement.

Objects: table/5600 “Fixed Asset”.

All 1 objects of FixedAssets in the diff

Integration

The Data Migration Facade Helper gets a procedure to create a county when needed.

Why: not explained by a Learn page in the input; the code shows the change, not the requirement.

Objects: codeunit/1797 “Data Migration Facade Helper”.

All 1 objects of Integration in the diff

IO

The incoming purchase document pre-mapping gets a vendor lookup by ABN and a new event after incoming document header data is set.

Why: not explained by a Learn page in the input; the code shows the change, not the requirement.

Objects: codeunit/1217 “Pre-map Incoming Purch. Doc”.

All 1 objects of IO in the diff

Projects

Resource gets a WHT Product Posting Group field.

Why: not explained by a Learn page in the input; the code shows the change, not the requirement.

Objects: table/156 “Resource”.

All 1 objects of Projects in the diff

Utilities

Adds a CodeUnit Selection page.

Why: not explained by a Learn page in the input; the code shows the change, not the requirement.

Objects: page/28001 “CodeUnit Selection” (own).

All 1 objects of Utilities in the diff

Objects of its own

170 objects only this country has.

• codeunit/355 “Local Navigate Handler”
• codeunit/6977 “Expense Event Subscriber NZ”
• codeunit/11600 “ABN Management”
• codeunit/11601 “BAS Management”
• codeunit/11602 “Import Subsidiary”
• codeunit/11603 “EFT Management”
• codeunit/11612 “Serv. Document Mgt. APAC”
• codeunit/12200 “Tax Invoice Renaming Subscr.”
• codeunit/17100 “Recurring Amount - Distribute”
• codeunit/28000 “Post Code Check”
• codeunit/28001 “BarCode Management”
• codeunit/28002 “Serv. Post Code Check”
• codeunit/28020 “Report Management APAC”
• codeunit/28040 “WHTManagement”
• codeunit/28041 “G/L Reg.-WHT Entries”
• codeunit/28042 “Service Format Address APAC”
• codeunit/28066 “Purch. Cr. Memo Hdr. - Edit”
• codeunit/28070 “TaxInvoiceManagement”
• codeunit/28071 “Purch. Tax Inv.-Printed”
• codeunit/28072 “Sales Tax Inv.-Printed”
• codeunit/28073 “Purch. Tax Cr.Memo-Printed”
• codeunit/28074 “Sales Tax Cr.Memo-Printed”
• codeunit/28090 “PostDatedCheckMgt”
• page/11600 “BAS Setup”
• page/11601 “BAS Calculation Sheet”
• page/11602 “BAS Calc. Schedule Fields”
• page/11603 “BAS Calc. Schedule List”
• page/11604 “BAS Business Units”
• page/11605 “BAS ATO Receipt”
• page/11606 “BAS Calc. Sheet Entries”
• page/11607 “BAS Comment Lines”
• page/11608 “BAS Setup Names”
• page/11609 “BAS Setup Preview”
• page/11610 “BAS Setup Preview Subform”
• page/11611 “BAS - XML Field IDs”
• page/11612 “BAS XML Field Setup Names”
• page/11613 “BAS Business Units-Settlement”
• page/11614 “BAS - XML Field IDs Setup”
• page/11615 “EFT Register”
• page/17101 “Amount Distribution”
• page/28001 “CodeUnit Selection”
• page/28003 “Counties”
• page/28040 “WHT Business Posting Group”
• page/28041 “WHT Product Posting Group”
• page/28042 “WHT Revenue Types”
• page/28043 “WHT Posting Setup”
• page/28044 “WHT Entry”
• page/28066 “Posted Purch. Cr.Memo - Update”
• page/28071 “Posted Sales Tax Invoice”
• page/28072 “Posted Sales Tax Inv. Subform”
• page/28073 “Posted Sales Tax Credit Memo”
• page/28074 “Posted Sales Tax Cr. Memo Sub”
• page/28075 “Posted Purchase Tax Invoice”
• page/28076 “Posted Purch. Tax Inv. Subform”
• page/28077 “Posted Purch. Tax Credit Memo”
• page/28078 “Posted Purch. Tax Cr. Memo Sub”
• page/28079 “Posted Purch. Tax Invoices”
• page/28080 “Posted Purch. Tax Cr. Memos”
• page/28081 “Posted Sales Tax Invoices”
• page/28082 “Posted Sales Tax Cr. Memos”
• page/28090 “Post Dated Checks”
• page/28091 “Post Dated Checks List”
• page/28092 “Post Dated Checks-Purchases”
• page/28093 “Post Dated Checks List-Purch.”
• page/28164 “GST Purchase Entries”
• page/28165 “GST Sales Entries”
• page/28166 “GST Purchase Entries Preview”
• page/28167 “GST Sales Entries Preview”
• pageextension/28040 “SourceCodeSetupAPAC”
• pageextension/28041 “Serv.ServiceMgrRoleCenter APAC”
• report/11600 “Withholding Summary”
• report/11603 “Calculate GST Settlement”
• report/11604 “BAS-Update”
• report/11605 “Export BAS Setup to Excel”
• report/11606 “Print BAS Export File”
• report/11607 “Transfer EFT Register”
• report/11608 “Create EFT File”
• report/14303 “WHT Certificate”
• report/14304 “WHT certificate preprint”
• report/14305 “WHT Certificate TH - Copy”
• report/14306 “WHT certificate preprint Copy”
• report/14307 “WHT PND 1”
• report/14308 “WHT PND 2”
• report/14309 “WHT PND 3”
• report/14310 “WHT Report - PND 53”
• report/14311 “Stock Card”
• report/16626 “Certificate of Creditable tax”
• report/16627 “Monthly Remittance Return WHT”
• report/16628 “Annual Information Return WHT”
• report/16629 “Quarterly VAT Return”
• report/16630 “E-Filing”
• report/16631 “Monthly VAT Declaration”
• report/16632 “WHT E-Filing”
• report/17109 “Transaction Detail Report”
• report/17110 “AU/NZ Statement”
• report/17111 “Items Received & Not Invoiced”
• report/17116 “Aged Acc. Rec. (BackDating)”
• report/17117 “Aged Acc. Pay. (BackDating)”
• report/28000 “BarCode Checking”
• report/28001 “BarCode Batch Job”
• report/28020 “Bank Detail Cashflow Compare”
• report/28021 “Bank Account Reconciliation”
• report/28022 “Stock Movement”
• report/28023 “Deposit Slip”
• report/28024 “Balance Sheet”
• report/28025 “Income Statement”
• report/28026 “Financial Analysis Report”
• report/28027 “VAT Report - Vendor”
• report/28028 “VAT Report - Customer”
• report/28029 “Purchase Receipts”
• report/28040 “WHT Certificate - Other”
• report/28041 “Calc. and Post WHT Settlement”
• report/28043 “WHT Certificate - Other Copy”
• report/28070 “Pending Sales Tax Invoice”
• report/28071 “Purch. - Tax Invoice”
• report/28072 “Sales - Tax Invoice”
• report/28073 “Purch. - Tax Cr. Memo”
• report/28074 “Sales - Tax Cr. Memo”
• report/28090 “Post Dated Checks”
• report/28091 “Create Check Installments”
• report/28092 “PDC Acknowledgement Receipt”
• report/28140 “Adjust Settlement Exch. Rates”
• report/28160 “G/L Journal”
• report/28161 “Journals”
• report/28162 “G/L Trial Balance”
• report/28163 “G/L Detail Trial Balance”
• report/28164 “GST Purchase Report”
• report/28165 “GST Sales Report”
• report/28166 “BAS - Import/Export”
• report/28167 “BAS - Import/Export Setup”
• table/11600 “BAS Setup”
• table/11601 “BAS Calculation Sheet”
• table/11602 “BAS XML Field ID”
• table/11603 “BAS Business Unit”
• table/11604 “BAS Calc. Sheet Entry”
• table/11605 “BAS Comment Line”
• table/11606 “BAS Setup Name”
• table/11607 “BAS XML Field Setup Name”
• table/11608 “BAS XML Field ID Setup”
• table/11609 “EFT Register”
• table/16608 “Temp WHT Entry - EFiling”
• table/28002 “Address Buffer”
• table/28003 “Address ID”
• table/28004 “County”
• table/28040 “WHT Business Posting Group”
• table/28041 “WHT Product Posting Group”
• table/28042 “WHT Revenue Types”
• table/28043 “WHT Posting Setup”
• table/28044 “WHT Entry”
• table/28045 “WHT Certificate Buffer”
• table/28046 “Temp WHT Entry”
• table/28070 “Tax Posting Buffer”
• table/28071 “Sales Tax Invoice Header”
• table/28072 “Sales Tax Invoice Line”
• table/28073 “Sales Tax Cr.Memo Header”
• table/28074 “Sales Tax Cr.Memo Line”
• table/28075 “Purch. Tax Inv. Header”
• table/28076 “Purch. Tax Inv. Line”
• table/28077 “Purch. Tax Cr. Memo Hdr.”
• table/28078 “Purch. Tax Cr. Memo Line”
• table/28079 “Tax Document Buffer Build”
• table/28080 “Tax Document Buffer”
• table/28090 “Post Dated Check Line”
• table/28160 “GST Purchase Entry”
• table/28161 “GST Sales Entry”
• tableextension/28040 “SourceCodeSetupAPAC”
• tableextension/28072 “Serv. Sales Tax Invoice Line”
• tableextension/28074 “Serv. Sales Tax Cr.Memo Line”
• tableextension/28160 “SourcecodeAPAC”
• xmlport/16630 “WHT-EFiling”

Other versions

• BC30: 279 objects differ from W1 (459 fields, 21 events added)

Source: country layer of the Base Application compared with W1 of the same version (data/code/diffs/country/).