IPPN – Partner Invoicing
IPPN (Invoicing Platform for Partners Network) enables platforms, marketplaces, and aggregators to issue legally compliant invoices on behalf of their partners using the partner's own fiscal identity.
- Add a partner with their tax ID
- Get the partner's access token
- Use that token to create invoices on their behalf
What is IPPN?
IPPN enables your platform to act as an invoicing intermediary for your network of partners. Instead of each partner managing their own invoicing system, you can centralize the invoicing process while ensuring each document is issued under the correct partner's tax identity.
graph LR
A[Your Platform] --> B[MagniFinance IPPN]
B --> C[Partner 1]
B --> D[Partner 2]
B --> E[Partner N]
Key Benefits
- Centralized Management - Handle all partner invoicing from a single integration
- Legal Compliance - Documents are issued using the partner's fiscal identity and are AT (Portuguese Tax Authority) compliant
- Scalability - Easily onboard new partners without additional integration work
- Real-time Processing - Issue invoices immediately as transactions occur
Use Cases
- Marketplaces - Issue invoices for sellers when customers make purchases
- Franchises - Centralized invoicing for your entire franchise network
- Service aggregators - Invoice on behalf of service providers (e.g., food delivery, ride-sharing)
- Property management - Issue invoices for multiple property owners
- Accounting platforms - Provide invoicing services to your clients
How It Works
- Onboard partners - Add partners to your network with their fiscal data
- Get access tokens - Obtain tokens to act on behalf of partners
- Issue documents - Create invoices using the partner's identity
- Manage documents - Retrieve and manage partner documents
Partner Lifecycle
| State | What it means |
|---|---|
| Access requested | You added the partner and it already uses MagniFinance. It has received an email and hasn't answered yet. |
| Access granted | The partnership is active: you can get the partner's tokens and issue documents on its behalf. |
| Access rejected | The partner declined the request. |
| Access revoked | The partner ended the partnership from its own MagniFinance account. Its tokens no longer work. |
A company that isn't on MagniFinance yet goes straight to access granted: MagniFinance creates its account and links it to your IPPN network automatically. This runs a few times per business day, not instantly, so the partner's tokens are available shortly after the AddPartner call rather than in its response.
The state isn't available through the API. You can see it in the web interface under Config → IPPN → Partnership Management. Through the API, Get Partner Access Tokens returns the error NoPartnerFoundWithTaxId for every partner that isn't in the access granted state, whatever the reason.
API Implementation Options
IPPN is available through both REST and SOAP APIs:
- REST API - JSON-based, recommended for new integrations
- SOAP API - XML-based, for legacy system integration
Try it in Postman
The quickest way to run the kick-off is a ready-made Postman collection with the three calls in order - Add Partner, Get Partner Access Tokens and Communicate Partner Series - and the bodies already filled in. There is one for each API:
- REST: download the collection, or paste this URL in Postman's Import:
https://developer.magnifinance.com/ippn/postman/ippn-rest.json
- SOAP: download the collection, or paste this URL in Postman's Import:
https://developer.magnifinance.com/ippn/postman/ippn-soap.json
- Import the collection.
- Open its Variables tab and fill in
emailandtokenwith your IPPN account's main user and token,passwordwith that user's password (only Get Partner Access Tokens sends it) andpartnerTaxId. - Send Add Partner, then, once access is granted, Get Partner Access Tokens: it stores the partner's token in
partnerToken, which Communicate Partner Series sends. Communicate Partner Series exists only over SOAP, so the REST collection carries it as a SOAP request with the envelope already set. - Issue documents with the Finance API collections, sending
partnerTokenas the token.
Available Operations
| Operation | Description |
|---|---|
| Add Partner | Register a new partner in your network |
| Get Partner Access Tokens | Obtain tokens to act on behalf of a partner |
| TaxId Validation | Check a partner's tax id before adding it (documented in Tax Compliance) |
Getting Started
The full onboarding sequence - from enabling IPPN on your account to the first document issued on a partner's behalf - is on the Getting Started page. In short:
- Contact MagniFinance to enable IPPN for your account
- Integrate the API using your preferred method (REST or SOAP)
- Add your first partner using the Add Partner endpoint
- Obtain partner tokens via Get Partner Access Tokens
- Start issuing documents using the standard document creation endpoints with the partner's token
Partners can also be managed through the web interface at https://bo.magnifinance.com/Partnership/Invoicing. Use it to manually add, view, and manage partners without API calls.
Document Types Allowed
The default allowed document types on the API in the IPPN service are:
- Invoice/Receipt (
T) - Credit Note (
C)
Other document types are disabled by default to prevent incorrect document creation that may cause issues with partner tax compliance. Contact us if you need additional document types enabled.
FAQ
1. What are the benefits of using IPPN?
With IPPN you can automate the invoicing process. If your company works with a network of suppliers, you can reduce manual steps, eliminate errors, and increase scale:
- Centralize issuance of invoices
- Provide partners an interface to view and validate documents
- Automate partner tax communication to the government
- Speed up payment time
- Increase transparency between partners and your company
2. How does partner registration work?
Register the tax id and name of each partner. Partners receive an email from MagniFinance to set a password and access the platform to consult documents and export SAF-T files. If the partner already has a MagniFinance account, they'll receive an email to authorize document issuance on their behalf.
3. Who can be a partner?
A company or an individual: sole traders (empresários em nome individual) and self-employed workers (trabalhadores independentes, category B) can be partners too. For an individual, send their NIF in CompanyTaxId and their name in CompanyLegalName.
Currently, document generation is only available for Portuguese tax entities, so the partner's country must be Portugal (PT).
4. How do I stop using a partner's token?
There's no API call to revoke a token. Revoke it in the web interface under Config → IPPN → Partnership Management. The partner can also end the whole partnership from its own MagniFinance account, which revokes all of your tokens for that partner.