Partner Invoicing (IPPN)

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.

TL;DR

1. Add a partner with their tax ID
2. Get the partner's access token
3. 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

1. Onboard partners - Add partners to your network with their fiscal data
2. Get access tokens - Obtain tokens to act on behalf of partners
3. Issue documents - Create invoices using the partner's identity
4. Manage documents - Retrieve and manage partner documents

Partner Lifecycle

Status	Description
pending_verification	Partner registration is being verified by MagniFinance
active	Partner is verified and can issue documents
suspended	Partner access is temporarily suspended
inactive	Partner has been deactivated

info

New partners require verification before they can start issuing documents. This typically takes 1-2 business days.

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

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
Client Get	Retrieve partner information
TaxId Validation	Validate a partner's tax identification number

Getting Started

1. Contact MagniFinance to enable IPPN for your account
2. Integrate the API using your preferred method (REST or SOAP)
3. Add your first partner using the Add Partner endpoint
4. Obtain partner tokens via Get Partner Access Tokens
5. Start issuing documents using the standard document creation endpoints with the partner's token

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 Company 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. Can I test the IPPN service?

Yes. MagniFinance provides a 30-day trial period for the IPPN service, allowing you to run all invoicing tests before going to production.