Tax Communication (SOAP)
The Tax Communication API allows you to manage the communication of fiscal documents with tax authorities. This includes activating tax communication, retrieving activation status, listing communicated documents, and communicating partner series through IPPN.
Overview
Tax communication in Portugal is mandatory for businesses that issue fiscal documents. The MagniFinance API provides endpoints to:
- Activate tax communication for your account
- Check activation status to verify if tax communication is properly configured
- List communicated documents to track which documents have been sent to tax authorities
- Communicate partner series through IPPN (Integrated Platform for Public Notification)
Available Operations
| Operation | Description |
|---|---|
| Activation Set | Enable or configure tax communication for your account |
| Activation Get | Retrieve current tax communication activation status |
| List Documents | Get a list of documents that have been communicated |
| Communicate Partner Series | Communicate document series through IPPN |
SOAP Endpoint
https://api.magnifinance.com/soap/v2.1/TaxCommunication
WSDL
https://api.magnifinance.com/soap/v2.1/TaxCommunication?wsdl
Authentication
All tax communication operations require authentication using your client credentials in the SOAP header:
<soapenv:Header>
<auth:Credentials>
<auth:ClientId>your_client_id</auth:ClientId>
<auth:ClientSecret>your_client_secret</auth:ClientSecret>
</auth:Credentials>
</soapenv:Header>
Requirements
Before using tax communication features, ensure that:
- Your account has been properly configured with the Portuguese Tax Authority (AT)
- You have valid credentials for the AT web services
- Your company's tax identification number (NIF) is correctly registered