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