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.

info

This service is disabled by default when you subscribe to the API or IPPN service. Contact our team to enable this feature.

Overview

Tax communication in Portugal is mandatory for businesses that issue fiscal documents. This service helps eliminate the work of submitting the SAF-T file every month by automating the communication of invoices directly to the Portuguese Tax Authority (AT).

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 (Invoicing Platform for Partners Network, documented in its own section of the developer portal)

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://bo.magnifinance.com/MagniAPI/taxcommunication.asmx

WSDL

https://bo.magnifinance.com/MagniAPI/taxcommunication.asmx?wsdl

Authentication

All tax communication operations require authentication using your email and token in the SOAP body, with the namespace http://MagniAPI/TaxCommunication/:

<soapenv:Body>
  <tax:YourOperation xmlns:tax="http://MagniAPI/TaxCommunication/">
    <tax:Email>your_email</tax:Email>
    <tax:Token>your_token</tax:Token>
    <!-- other parameters -->
  </tax:YourOperation>
</soapenv:Body>

Requirements

Before using tax communication features, ensure that:

1. Your account has been properly configured with the Portuguese Tax Authority (AT)
2. You have valid credentials for the AT web services
3. Your company's tax identification number (NIF) is correctly registered