Skip to main content
SAF-T
Search
Search Indirect Tax Support Help and Support.

This article applies to:

  • Product: ONESOURCE Indirect Tax Compliance

SAF-T import warnings

SAF-T import warnings identify data quality issues in your import file before you generate XML or submit your tax return.
When you import a SAF-T file, the system checks it against the tax authority's rules and displays warnings for any data that doesn’t meet those rules. Warnings are advisory — they don’t stop your import from completing, but they help you find and fix issues early.

Warning categories

SAF-T warnings fall into 2 categories with different behavior and configuration options.
Type 1 — Structural Warnings (Always On)
Structural warnings fire when a field is present in your import file but contains bad data. You can't suppress structural warnings because they reflect rules set by the tax authority.
Structural warnings cover the following conditions:
  • Invalid formats — the value is in the wrong format for that field.
  • Invalid enumeration values — the value is not from the allowed list (for example, an invalid country code).
  • Incorrect decimal places — a numeric value has too many or too few decimal places.
  • Invalid date formats — the date is not real or is incorrectly formatted.
  • Invalid character lengths — the value is too long or too short for the field.
Type 2 — Missing Value Warnings (Configuration-Driven)
Missing value warnings fire only when a field is completely absent or empty in your import file. Warnings will display depending on how you configure fields in the SAF-T Warnings Configuration screen.
  • If you mark a field in the configuration, the system raises a warning when that field is missing or empty.
  • If you clear a field in the configuration, the system raises no warning when that field is missing or empty.

Default Field States

The system applies the following default behavior to mandatory and optional fields.
Field Type
Default State
Warning Raised When Missing?
Mandatory
Marked
Yes (by default)
Optional
Cleared
No (by default)
important
Changing the checked state of a field only affects whether the system shows a missing-value warning. It doesn’t affect structural validation — if the field is present in your file, the system still checks its value for correctness.

Settings that control warnings

The following independent settings control how import warnings behave. You can find both in your system settings.
Enable SAF-T Validations during Import
  • On — the system generates and displays SAF-T warnings for your import.
  • Off — the SAF-T Warnings screen remains empty and the system raises no warnings.
Enable SAF-T Import Warning Configuration
  • On — the SAF-T Warnings Configuration screen becomes visible, letting you choose which fields trigger missing-value warnings.
  • Off — the schema defaults apply and you can't customize field-level behavior.
note
The 1st setting controls whether warnings appear at all. The 2nd controls whether you can customize which fields the system checks for missing values. The 2 settings operate independently of each other.

Configure SAF-T import warning settings

Configure missing fields trigger warnings to display during SAF-T import.
Turn on
Enable SAF-T Import Warning Configuration
 in your system settings. The SAF-T Warnings Configuration screen is only available when this setting is on.
Use the SAF-T Warnings Configuration screen to customize missing-value warnings per jurisdiction and import type. The system raises a warning when a configured field is absent from your import file.
You can suppress warnings for mandatory fields you don’t need, or turn on warnings for optional fields you want to monitor.
note
By default, the system configures no warnings for SAF-T.
  1. Go to
    Import Details
    Warnings
    SAF-T Warnings
    .
  2. Open the
    SAF-T Warnings Configuration
     screen.
  3. Select the
    Import Type
     and the
    Jurisdiction
     you want to configure.
    The screen displays all SAF-T fields for your selection, along with their current state in the
    Apply
     column.
  4. In the
    Apply
     column, mark the checkbox to turn on a missing-value warning for a field. Clear the checkbox to suppress a missing-value warning for a field.
    important
    Changing a field's checked state only affects missing-value warnings. If the field is present in your import file, the system always checks its value for structural correctness, regardless of this setting.
  5. Save your changes.
    The system saves your configuration and applies it to future imports for the selected jurisdiction and import type.

Review SAF-T import warnings

Identify and investigate data quality issues in your import file.
  1. Go to
    Import Details
    Warnings
    SAF-T Warnings
    .
    The summary view opens, showing each warning type and the number of occurrences.
  2. Select a row in the summary view to drill down to the detailed view for that warning type.
    The detailed view opens, showing 1 row per warning instance.
  3. Check the
    Source
     column to determine whether you can resolve the warning.
    • Schema
       — the rule comes from the tax authority's official schema. You can't opt out of this warning. Correct the data in your import file.
    • Configuration
       — the rule comes from your configuration settings. Update your configuration to suppress the warning, or correct the data in your import file.
  4. Use the
    Line Number
     column to locate the affected row in your import file and correct the issue.

SAF-T warning column descriptions and scenarios

Review the columns available in the SAF-T Warnings detailed view and common warning scenarios with their types and suppression options.

Detailed view — Column reference

Column
What it shows
Entity
The customer entity the import belongs to
Jurisdiction
The country whose tax authority rules apply to this import
Warning Message
A description of the issue, including the field name and line number
Line Number
The row in your import file where the system found the issue
Source
Where the rule originates:
Schema
 (tax authority) or
Configuration
 (your settings)
Classification
Whether the field is mandatory or optional

Warning scenarios Quick reference

Scenario
Warning type
Can you suppress it?
The field is present but the value is in the wrong format.
Type 1 — Structural
No
The field is present but uses an invalid date.
Type 1 — Structural
No
A mandatory field is missing from the file.
Type 2 — Missing Value
Yes — clear the field in the Warnings Configuration screen.
The optional field is missing from the file.
Type 2 — Missing Value
N/A — the system doesn’t raise this warning by default.
The optional field is missing and you want a warning.
Type 2 — Missing Value
Yes — mark the field in the Warnings Configuration screen to turn on the warning.
note
If a field is present in your file, the system always checks its value for structural correctness — even if you mark the field as optional in your configuration.