SOAP API for Invoicing & Waybills

The SOAP API uses XML for data exchange. It's maintained for backward compatibility with legacy systems.

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:DocumentCreate>
      <inv:Authentication><inv:Email>...</inv:Email><inv:Token>...</inv:Token></inv:Authentication>
      <inv:Client>...</inv:Client>
      <inv:Document>...</inv:Document>
    </inv:DocumentCreate>
  </soapenv:Body>
</soapenv:Envelope>

WSDL

https://bo.magnifinance.com/MagniFinanceWS.asmx?WSDL

Endpoint

https://bo.magnifinance.com/MagniAPI/Invoicing.asmx

Authentication

Include credentials in the SOAP body:

<inv:Authentication>
  <inv:Email>your-api@email.com</inv:Email>
  <inv:Token>your-subscription-token</inv:Token>
</inv:Authentication>

Available Operations

Operation	Description
DocumentCreate	Create invoices, receipts, credit/debit notes
DocumentGet	Retrieve document details and PDF
DocumentCancel	Cancel a closed document
Create Waybill	Create transport documents
Get Document Property	Get specific document properties

Response Format

Success Response

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <DocumentCreateResponse xmlns="http://MagniAPI/Invoicing/">
      <Response>
        <RequestId>a004f883-f2a3-4af6-810a-6b28bde12503</RequestId>
        <Type>Success</Type>
        <Object>
          <DocumentId>67220</DocumentId>
        </Object>
      </Response>
    </DocumentCreateResponse>
  </soap:Body>
</soap:Envelope>

Error Response

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <DocumentCreateResponse xmlns="http://MagniAPI/Invoicing/">
      <Response>
        <RequestId>45bb3204-4a4d-4e06-9f91-f4b6d4bcf1a0</RequestId>
        <Type>Error</Type>
        <ErrorValue>
          <Value>14</Value>
          <Name>SaveFailed</Name>
        </ErrorValue>
        <ErrorHumanReadable>ValidationError</ErrorHumanReadable>
        <ValidationErrors>
          <ValidationError>
            <Type>MustBePosteriorToMostCurrentClosedDocument</Type>
            <Field>DocumentDetailDate</Field>
            <Detail>A closed document already exists with a date after this...</Detail>
          </ValidationError>
        </ValidationErrors>
      </Response>
    </DocumentCreateResponse>
  </soap:Body>
</soap:Envelope>

Namespaces

Prefix	Namespace URI
soapenv	http://schemas.xmlsoap.org/soap/envelope/
inv	http://MagniAPI/Invoicing/

See Error Codes for a complete list of error types.