SAP TDF in Brazil: what the Tax Declaration Framework delivers and how to run it

The path of the data to the tax authority

See the detail in How a SPED report is born in TDF.

1. 01

   Document and posting in the ERP

   Invoices, accounting, assets and master data feed the report.

2. 02

   Legal report in TDF

   EFD ICMS IPI, Contribuições, Reinf, ECD and ECF, for example through transaction /TMF/EFD.

3. 03

   Obligations monitor

   The Tax Obligation Monitor keeps the run, its status and the file (/TMF/TOM02).

4. 04

   Receita Federal and state tax authorities

   The file is validated and sent; the proof of delivery comes back to the monitor.

What SAP TDF is, on one screen

TDF is an SAP product for the declaration layer: it reads what the ERP has already recorded and produces what the tax authority asks for, in the structure of blocks, records and fields of each obligation.

TDF, ACR and DRC: three names, three scopes

Confusion between the names is the most common reason a project starts from the wrong assumption. The table shows what the official documentation of each one says.

The most useful cross-check for anyone who works with SPED is this: the ACR help lists technical objects of the SPED reports with the /TMF/ prefix (for example /TMF/EFD_REPORT and /TMF/ECD_REPORT), the same namespace as TDF. Source: SAP Help Portal, alphanumeric CNPJ in the SPED reports. In practice, anyone who knows the TDF structure will recognize the logic of the S/4HANA SPED reports, and the question of which path applies to your environment is answered by release and model (own installation or cloud), not by name.

How to find out what your environment uses today

Why this difference matters in operation

The trail of each run lives in different places. In TDF, the Tax Obligation Monitor keeps the run, its status and the proof of delivery. In the Run Statutory Reports app of S/4HANA Cloud, after sending the file to the authority the team updates the submission status in the run itself and, if the authority answered, marks the run as accepted or rejected. Sources: Tax Obligation Monitor; EFD ICMS IPI in the Cloud.

Whoever audits the close needs to know where to look for evidence: run parameters, generated file, submission status and the authority's answer. If the group has more than one path, the evidence is scattered, and the first governance gain is an index that says, per company and per obligation, where each trail is kept.

What TDF delivers in Brazil

Five SPED files and a messages layer. Each card shows what the SAP help describes and the description from the SPED portal. Deadlines appear as the SAP help describes them: always check the current legislation of your state and of the Receita.

Around the reports there are support tools, such as the Nota Fiscal Viewer, the execution log and the PIS and COFINS credit suite, covered in support tools. The link between each obligation and the document that feeds it, state by state and sphere by sphere, is in SPED and ancillary obligations in SAP.

How a SPED report is born in TDF

The path is the same in every obligation: configuration, run, official run in the monitor, validation, submission and proof of delivery. What changes is the content of each block.

• 01ERP dataLoaded invoices, accounting postings, materials, assets and partners. The report only sees what is already in the system.
• 02ConfigurationOrganizational structure (company, establishment, registration), layout version and TDF Customizing tables.
• 03Preliminary runRuns the report without recording it as official (draft mode). The execution log shows parameters, time and records read.
• 04Official runRuns as official and is recorded in the Tax Obligation Monitor. An approved preliminary run can be promoted to official.
• 05Validation and submissionThe file is downloaded from the monitor, checked in the government validator program and sent to the Receita or to the state tax authority.
• 06Proof of deliveryThe receipt comes back to the monitor. Without it, the period has no trail.

Sources: SAP Help Portal, ReportingTax Obligation Monitor, promote runRectificationEFD Contribuições, PVA validator

What each step asks of the team

The fiscal period has a life cycle

TDF controls the fiscal period status by company and establishment. SAP offers an enterprise service that changes this status, with the allowed transitions described below. Anyone who integrates an external system with TDF needs to respect this order.

Source: SAP Help Portal, Change Fiscal Period Status. The service requires company, establishment, year, month and status, and returns success or failure to the calling system.

Rectify without losing the trail

TDF rectification only applies to a SPED file that already has status Completed in the Tax Obligation Monitor. The design keeps the original official run and creates a new one with type Rectified.

1. Identify what is wrongBlock 0 data (master data) or transactional data (documents and postings of the other blocks). The correction path is different for each.
2. Correct at the sourceBlock 0 records are changed with the report Maintain SPED Reports Master Data for Rectification (transaction /TMF/EDIT_SPED_MD). Data of the other blocks is changed through shadow tables. The correction must never be made only in the text file.
3. Run again with the same parametersUse the same organizational structure and the same run data as the official run being rectified.
4. Confirm the rectificationThe system asks whether the file should be rectified. On confirmation, it generates a file whose run type is Rectified.
5. Send the file to the Receita FederalThe company sends the rectified file, which TDF generates but does not transmit by itself.
6. Record the proof of deliveryAfter the Receita confirms, load the proof-of-delivery file into the monitor.

Source: SAP Help Portal, Rectification of SPED Reports. The help lists rectification for EFD ICMS IPI, EFD Contribuições, ECD and ECF.

eSocial, EFD-Reinf and e-Financeira: the Messaging Framework

EFD-Reinf and eSocial work by events, not by a single file. TDF handles this difference with its own layer, which receives the events, validates them, stores them and sends them to the government.

What exists around the report

Besides the files, TDF has tools that support operation and audit. Many teams only find out they exist when they need them.

For those coming from SAP ERP, the ERP documentation describes what was added for integration with TDF: Customizing, tax incentives, authorization checks and CIAP (the ICMS credit control for fixed assets). Source: SAP Help Portal, SAP ERP.

Versions and layouts by Support Package

TDF evolves through Support Packages (SP). The list shows what the official documentation records. SP07 brought the standard roles and SP08 the installation guide for a new version (RolesInstallation).

Cross-check the SAP help with what the Receita publishes

Layout update routine

Every Receita publication gets an owner, an effective date and a test in the quality environment before the real period.

1. Monitor the Receita publicationsGuias Práticos, technical notes and manuals each have their own effective date. Record the date of each one.
2. Compare with your Support PackageThe TDF What's New section says which layout each SP supports. If the release is behind, the update goes into the plan.
3. Check the SAP Notes cited by the helpSAP delivers legal changes through SAP Notes before a new SP. They require a login to SAP for Me and should be read by whoever has access.
4. Test with a real periodRun the preliminary run of a closed period and compare it with the official file delivered, record by record.
5. Update the standard configurationWith the Layout Builder there are fewer manual steps, but the company's own extensions remain its responsibility.
6. Keep the evidenceFile the comparison, the SP version and the notes applied for the next audit.

Layout UpdatesAlphanumeric CNPJ

Alphanumeric CNPJ and tax reform in SPED

Two changes cut across all SPED reports right now: the new CNPJ format and the arrival of the new consumption-reform taxes in the documents that feed the bookkeeping.

Alphanumeric CNPJ: what SAP delivered

S/4HANA versions with the delivery

• S/4HANA 2025
• S/4HANA 2023 FPS03
• S/4HANA 2022 SPS05
• S/4HANA 2021 SPS07
• S/4HANA 2020 SPS09
• S/4HANA 1909 SPS11
• S/4HANA 1809 SPS13
• Cloud Public Edition 2602

Consumption reform: what the Receita advised

The useful question is not whether the new format has arrived, but which interfaces still assume that the CNPJ is numeric: partner master data, invoice import, in-house validations and management reports.

Ten steps to run TDF

The roadmap works both for someone who inherited a TDF in operation and for someone taking over a fiscal period for the first time. Each step has a result you can check.

Each step touches a layer that has its own page: tax setup, tax master data and ancillary obligations and SPED. What matters is the order you run them in.

Readiness checklist for TDF

Twenty points that a tax or IT lead can check without opening the system from end to end. Each one comes from a behavior documented in the official sources.

Common mistakes, with the source of each

Twelve situations that come up when TDF is operated without knowing what the documentation already says, grouped by where they start.

Data and master data

Run, rectification and proof

Layout and integrations

1. Using Reinf preprocessing with invoices that have several service itemsThe report only supports invoices with one service item, and can only be repeated in the period if the events have not been sent yet. SAP: Reinf
2. Updating the layout without comparing with the Receita effective dateThe SAP help and the SPED portal can cite different versions of the same layout, as happens with ECF. Comparing avoids a surprise in the annual cycle. Receita: ECF layout
3. Integrating HCM without the BAdI and the RFC destinationThe TDF eSocial depends on the logical system, the RFC destination and the event-sending BAdI to receive what HCM generates. SAP: HCM

Ten questions to bring to the integrator

Before any decision on TDF, the answers to these questions tell you whether the environment is under control or depends on one person's memory.

1. Which SPED path does each group company use today?TDF, ACR or other, with the release and deployment model of each one.
2. Which Support Package is installed?And what is the next Receita layout it does not yet cover?
3. Who runs, who approves and who sends?For each obligation, by name and with a backup.
4. Where is the proof of delivery for periods already closed?In the monitor, in another system or in a network folder?
5. Which in-house extensions exist?BAdIs, Z programs and own tables, with an owner and a regression test.
6. How does master data prevent different NCMs across plants?Validation when the material is created, or a check only at the close?
7. What was the last rectification?What caused it, how it was corrected and whether the cause became a master data rule.
8. What does the migration plan foresee for SPED?Keep TDF, change path, or decide after stabilization.
9. Which interfaces have already been assessed for the alphanumeric CNPJ?Master data, invoice import, organizational structure and extensions.
10. Who answers on the tax side when the file is rejected?Someone has to analyze the rejection manually, because TDF does not check the content.

Four scenarios with no real client

Illustrative examples, built from the documented behavior of the tools. None portrays a specific case.

The topic of the second scenario starts in tax master data.

Where DFSpro comes in in this layer

TDF is an SAP product and has its integrator. DFSpro, a consultancy in SAP Tax Governance, works on the tax layer of the project.

• Tax layer. Master data, calculation and report have to say the same thing; that is the tax work.
• ABAP and customization. ABAP development and tax customization, including extensions the client's rule requires.
• General architecture. Stays with the integrator; DFSpro does not replace it.
• GUEPARDO Tax. A product of NTT DATA, with the license sold by DFSpro as an Authorized Channel; the GUEPARDO site lists the SAP DRC and SAP TDF badges (GUEPARDO site).

See also the SAP Tax Governance Program and the migration to S/4HANA. To organize master data, calculation and close around TDF: describe your scenario to DFSpro.

Official sources with links

Every technical fact in the text comes from one of these pages. The SAP help changes by Support Package, and the Receita publishes new layouts often: always check the current version on the project date.

Start with the picture of your environment

The starting point is the same for those who operate and those who decide: which SPED path your SAP uses today, in which release and with which extensions. From that list, layout updates, rectification and fiscal period stop being a surprise.