The WooCommerce NRA Audit File Generator plugin enables WooCommerce stores to create standardized XML reports for e-commerce transactions, meeting the regulatory requirements of the Bulgarian National Revenue Agency (NRA). It extracts data from completed and processing orders within a selected month, including order details, product prices, VAT, discounts, shipping, and payment methods, and formats them into file compliant with NRA specifications.
The plugin provides an admin interface for configuring settings such as company UIC, e-shop number, and refund methods, and integrates with WooCommerce payment gateways to capture NRA-specific fields like payment type, virtual POS terminal number, and transaction reference keys. It supports dynamic retrieval of post meta keys for transaction IDs, validates payment method configurations, and handles refunds with configurable payment types. Secure, user-friendly, and localized, this plugin simplifies NRA compliance for Bulgarian online stores.
Features of WooCommerce NRA Audit File Generator
- NRA-Compliant reports: Generates audit files for WooCommerce orders, including products, VAT, discounts, shipping, and refunds, formatted for NRA requirements.
- Monthly report generation: Allows admins to select a month and generate a report for orders in “Completed” or “Processing” status.
- Payment method integration: Adds NRA-specific fields to WooCommerce payment gateway settings, including payment type, virtual POS number, provider ID, and transaction meta key with dynamic suggestions.
- Refund handling: Tracks refunds within the selected month, supporting configurable refund payment types (original or specific payment type).
- Admin settings page: Provides a user-friendly interface to configure UIC, e-shop number, and refund method, with validation for required fields.
- Dynamic meta key detection: Automatically retrieves and suggests post meta keys for transaction IDs based on the payment method used in orders.
- Error validation: Checks for missing payment method settings and displays actionable error messages with links to configuration pages.
- Localization support: Uses its own text domain for translatable strings, with Bulgarian translations included.
- WooCommerce dependency check: Displays an admin notice if WooCommerce is not active, ensuring proper functionality.
Installation
- Upload the plugin folder to the
/wp-content/plugins/
directory. - Activate the Mobileship WooCommerce NRA Audit File Generator plugin through the WordPress admin panel.
- Ensure WooCommerce is installed and activated.
- Navigate to WooCommerce > NRA Report in the admin panel to configure settings and generate reports.
- Configure payment method settings under WooCommerce > Settings > Payments for each gateway to include NRA-specific fields.
Usage of WooCommerce NRA Audit File Generator
- Configure settings: Go to WooCommerce > NRA Report to enter your company’s UIC, e-shop number, and preferred refund method. Save the settings.
- Set up payment methods: Navigate to WooCommerce > Settings > Payments, select each payment gateway, and configure NRA-specific fields (payment type, POS number, provider ID, transaction meta key) under the “NRA Data” section.
- Generate reports: In the NRA Report admin page, select a month from the dropdown and click “Generate Report” to download an XML file for the selected period.
- Handle errors: If errors occur (e.g., missing payment method settings), follow the provided links to configure the required fields.
- Review refunds: Ensure the refund payment type is set correctly to align with NRA requirements for reporting refunded orders.
- Customize styling: Style the admin settings section by targeting the
.nra-settings-section
class in your theme’s CSS if needed. - Translate strings: Use the
nra-ecommerce-report
text domain to translate plugin strings via Polylang or other translation plugins.
Requirements
- WordPress 5.0 or higher
- PHP 7.0 or higher
- WooCommerce 4.0 or higher
- Configured WooCommerce payment gateways with NRA-specific settings
- Valid company EIK and e-shop number for NRA compliance