REST API for Partner Invoicing

The REST API provides JSON-based endpoints for managing partners in your IPPN network.

TL;DR - Quick Start

# 1. Add a partner
curl -X POST https://bo.magnifinance.com/api/v1.1/partner \
  -H "email: your-api@email.com" \
  -H "token: your-subscription-token" \
  -d '{"TaxId": "123456789", "Name": "Partner Company"}'

# 2. Get partner token
curl https://bo.magnifinance.com/api/v1.1/partner/tokens?taxId=123456789 \
  -H "email: your-api@email.com" \
  -H "token: your-subscription-token"

# 3. Use partner token to create invoices
curl -X POST https://bo.magnifinance.com/api/v1.1/document \
  -H "email: your-api@email.com" \
  -H "token: PARTNER_TOKEN" \
  -d '{"IsToClose": true, ...}'

Base URL

https://bo.magnifinance.com/api/v1.1

Available Endpoints

Endpoint	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

Workflow

1. Add a partner using Add Partner with their Tax ID and company name
2. Wait for verification - Partner receives an email and must accept the partnership
3. Get their token using Get Partner Access Tokens
4. Create documents using the Create Document endpoint with the partner's token

Authentication

Include these headers in every request:

Header	Description
email	Your IPPN account API email
token	Your IPPN subscription token

When creating documents on behalf of a partner, use the partner's token instead of your own.

Web Interface

You can also manage partners through the MagniFinance web interface: Config -> IPPN -> Partnership Management

Access Partnership Management