SOAP API for Partner Invoicing
The SOAP API provides XML-based operations for managing partners in your IPPN network.
Note
For new integrations, we recommend using the REST API instead.
TL;DR - Quick Start
POST https://bo.magnifinance.com/MagniAPI/Invoicing.asmx
Content-Type: application/soap+xml; charset=utf-8
<soapenv:Envelope xmlns:soapenv="..." xmlns:inv="http://MagniAPI/Invoicing/">
<soapenv:Body>
<inv:AddPartner>
<inv:Authentication><inv:Email>...</inv:Email><inv:Token>...</inv:Token></inv:Authentication>
<inv:TaxId>123456789</inv:TaxId>
<inv:Name>Partner Company</inv:Name>
</inv:AddPartner>
</soapenv:Body>
</soapenv:Envelope>
WSDL
https://bo.magnifinance.com/MagniFinanceWS.asmx?WSDL
Available Operations
| Operation | Description |
|---|---|
| AddPartner | Register a new partner in your network |
| GetPartnerAccessTokens | Obtain tokens to act on behalf of a partner |
| Client Get | Retrieve partner information |
| TaxId Validation | Validate a partner's tax identification number |
Workflow
- Add a partner using AddPartner with their Tax ID and company name
- Wait for verification - Partner receives an email and must accept the partnership
- Get their token using GetPartnerAccessTokens
- Create documents using the DocumentCreate operation with the partner's token
Authentication
Include credentials in the SOAP body:
<inv:Authentication>
<inv:Email>your-ippn@email.com</inv:Email>
<inv:Token>your-ippn-subscription-token</inv:Token>
</inv:Authentication>
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