Troubleshooting

Logging

The module automatically logs important events for easier problem diagnosis.

Viewing Logs in Admin

Logs are available directly in WordPress admin:

WPify Woo → WPify Logs

Here you can:

• Select log by plugin and date
• View details of individual entries

Log Location on FTP

Logs are also stored on the server:

wp-content/uploads/logs/

What Gets Logged

Event	Description
VIES validation	Tax ID verification results, including errors
ARES validation	Company ID verification results, including errors
VAT Exempt decision	Complete information about decision when order is created

Example Log

[2024-01-15 10:30:45] INFO: Order VAT Exempt Decision
{
    "order_id": 1234,
    "billing_country": "DE",
    "shipping_country": "DE",
    "shop_country": "CZ",
    "submitted_dic": "DE123456789",
    "calculated_vat_exempt": true,
    "vat_exempt_reason": "reverse_charge",
    "validations": {
        "vies_result": "valid"
    }
}

Admin Diagnostics

Order Information

In order detail, an information box “VAT Exemption Status” is displayed with:

• Exemption status (Yes/No)
• Exemption reason

Common Problems and Solutions

VAT is Not Deducted Despite Customer Having Tax ID

Possible causes:

1. Tax ID fails VIES validation

   • Check logs - look for VIES ERROR or vies_result: invalid
   • Verify Tax ID manually on VIES portal

2. Customer is from same country as shop

   • Reverse Charge only applies to other EU countries
   • Check shop country in WooCommerce settings

3. VIES service is unavailable

   • Check logs for VIES ERROR
   • VIES service has occasional outages - try later

4. Reverse Charge feature is not enabled

   • Check settings: WPify Woo > VAT ID in Checkout
   • Enable “Enable EU Reverse Charge”

5. Destination country is incorrectly determined

   • Check WooCommerce settings: Settings > Taxes > Calculate taxes based on
   • For goods use “Shipping address”
   • For services use “Billing address”

---

VIES Service is Unavailable

Symptoms:

• Error message during Tax ID validation
• VIES ERROR or ViesServiceException in log

Solutions:

1. Temporary outage - wait and try again
2. Enable bypass - Enable “Submit order even if VIES verification fails”
   • Note: VAT will not be deducted, but order will go through

---

Company ID Not Found in ARES

Symptoms:

• Error message “Company ID not found in ARES”
• Automatic filling doesn’t work

Possible causes:

1. Incorrectly entered Company ID - check format (8 digits without spaces)
2. Newly established company - may take several days to appear in ARES
3. Foreign company - ARES contains only Czech entities
4. ARES service is unavailable - check logs

Solutions:

• Verify Company ID on justice.cz
• For new companies, wait a few days

---

Company ID/Tax ID Fields Not Displayed

Possible causes:

1. Module is not active

   • Check: WPify → WPify Woo
   • Enable “VAT ID in Checkout” module

2. Conflict with another plugin

   • Deactivate other plugins and test
   • Common conflicts: checkout customizer plugins

3. Blocked by theme

   • Try default theme (Storefront)

---

Differences Between Classic and Block Checkout

WooCommerce block checkout uses a different system for field display. Some visual settings from classic checkout cannot be applied the same way on block checkout:

Settings available only for classic checkout:

• Move Tax ID fields to form beginning
• Half-width fields
• Placeholder as example number
• Company ID/Tax ID format validation
• Some ARES autofill positions

Features working on both checkout types:

• Company ID, Tax ID, VAT ID fields
• VIES validation
• ARES validation and autofill (basic)
• VAT exemption (Reverse Charge, Export)
• “I’m buying as a company” checkbox

Note

This is not a bug - block checkout has its own styling and field layout system. Basic module functionality works on both checkout types.

---

Tax ID Validation Works, But VAT is Not Deducted

Checklist:

• Is “Enable EU Reverse Charge” enabled?
• Is customer from a different EU country than the shop?
• Did Tax ID pass VIES validation? (check logs)
• Is “vies_fails” enabled with invalid Tax ID?
• Is “Calculate taxes based on” correctly set in WooCommerce?

---

Slovak VAT ID

Slovakia specifics:

For Slovak customers, the module uses billing_dic_dph field (VAT ID) instead of standard billing_dic.

Slovak Tax ID and VAT ID:

• Tax ID (DIČ): 10 digits (e.g., 1234567890)
• VAT ID (IČ DPH): SK + 10 digits (e.g., SK1234567890)

The module automatically checks that SK + Tax ID = VAT ID.

Contact Support

If the problem persists, contact support at support@wpify.io.

Prepare this information:

• WordPress version
• WooCommerce version
• WPify Woo plugin version
• Log excerpt (WPify Woo → WPify Logs)
• Optionally fatal errors excerpt from WooCommerce → Status → Logs