# Tax Data Document (TDD)
A Tax Data Document (TDD) is the report eConnect submits to the tax authority as part of Continuous Transaction Controls (CTC). Both the sender and the receiver of a CTC invoice get their own TDD submitted on their behalf. You don't create or upload it yourself.
# Type codes
| Code | Name | Description |
|---|---|---|
S | Submit | The initial report for an invoice. |
R | Resubmit | A new report after a previous TDD timed out. |
D | Disregard | Withdraws a previously accepted report when delivery to the recipient fails afterwards. |
# In the flow
- The TDD is submitted right after the invoice is sent or received, and its
documentIdis reported astddDocumentIdin theInvoiceSentPending/InvoiceReceivedPendingwebhook. - Like the invoice itself, the TDD requires its own MLS from the tax authority. Once received, its
documentIdis reported astddMlsDocumentIdin the finalInvoiceSent/InvoiceReceivedwebhook. - Both the TDD and its MLS can be downloaded as proof via
GET /api/v1/{partyId}/generic/{documentId}/download.
# Manual submission (advanced)
WARNING
This is not an official flow. eConnect submits the TDD automatically once CTC is enabled. Only use this endpoint if you understand what you're doing and why the automatic flow doesn't apply to your case.
Use POST /api/v1-beta/{partyId}/salesInvoice/{documentId}/tdd (or .../purchaseInvoice/{documentId}/tdd) to submit a TDD yourself for an invoice already uploaded to eConnect, outside of the automatic CTC flow. This is meant for cases such as:
- The invoice does not need to be delivered to the recipient over Peppol.
- You want to report an invoice you received through another channel.
Query parameters:
| Parameter | Description |
|---|---|
code | One of the type codes above. Defaults to S. |
receiverId | Overrides the tax authority party the TDD is sent to. |
A successful call returns the TDD's documentId:
{
"id": "961bb234-4fb7-415b-b659-77e28be8e9e2"
}
# Specification
eConnect's TDD follows the Peppol Tax Data Document specification. Slovakia is the variant currently supported by eConnect's CTC flow; the other country variants are listed here for reference:
- Slovakia (SK) (opens new window)
- Oman (OM) (opens new window)
- United Arab Emirates (AE) (opens new window)
- ViDA (opens new window)
For the broader Slovak e-invoicing solution (not limited to the TDD), see the Financial Administration of the Slovak Republic's Solution Reference Architecture (opens new window).