Skip to main content

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​

OperationDescription
AddPartnerRegister a new partner in your network
GetPartnerAccessTokensObtain tokens to act on behalf of a partner
Client GetRetrieve partner information
TaxId ValidationValidate a partner's tax identification number

Workflow​

  1. Add a partner using AddPartner 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 GetPartnerAccessTokens
  4. 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

Access Partnership Management