Skip to main content

Invoicing & Waybills

Create and manage invoices, receipts, credit notes, debit notes, and transport documents (waybills) through the MagniFinance API.

REST vs SOAP: Which Should I Use?​

Quick Answer

Choose REST for new integrations. It's simpler, uses JSON, and has better tooling support.

CriteriaREST APISOAP API
Data FormatJSONXML
Best ForNew integrations, modern appsLegacy systems, enterprise environments
Learning CurveEasierSteeper
ToolingExcellent (Postman, curl, etc.)Requires SOAP clients
Feature ParityFull supportFull support
RecommendationRecommendedMaintained for compatibility

Choose REST if:​

  • You're building a new integration
  • Your tech stack is modern (Node.js, Python, React, etc.)
  • You prefer working with JSON
  • You want simpler debugging with standard HTTP tools

Choose SOAP if:​

  • You have existing SOAP infrastructure
  • Your enterprise requires SOAP/XML protocols
  • You're integrating with legacy systems that only support SOAP

Available Operations​

Both APIs support the same document operations:

OperationDescription
Create DocumentCreate invoices, receipts, credit/debit notes
Get DocumentRetrieve document details and download PDF
Cancel DocumentCancel a closed document
Create WaybillCreate transport documents
Get Document PropertyRetrieve specific document properties
Get a ClientGet a company registered in your subscription

Get Started​

Postman Try it in Postman​

The quickest way to try the operations is a ready-made Postman collection with every operation on this page and a sample body already filled in. There is one for each API:

  • REST: download the collection, or paste this URL in Postman's Import:
    https://developer.magnifinance.com/finance/postman/invoicing-waybills-rest.json
  • SOAP: download the collection, or paste this URL in Postman's Import:
    https://developer.magnifinance.com/finance/postman/invoicing-waybills-soap.json
  1. Import the collection.
  2. Open its Variables tab and fill in email and token (see Authentication).
  3. Send Create Document. It stores the new DocumentId in the collection, so Get Document, Get Document Property and Cancel Document work right after it.

Dates are filled in when you press Send, so the sample documents are always dated today.

Document Types​

CodeTypePortuguese NameCreated with
TInvoice/ReceiptFatura-ReciboCreate Document
IInvoiceFaturaCreate Document
SSimplified InvoiceFatura SimplificadaCreate Document
CCredit NoteNota de CréditoCreate Document
DDebit NoteNota de DébitoCreate Document
BQuoteOrçamentoCreate Document
PPro-forma InvoicePro-formaCreate Document
ZPurchase OrderNota de EncomendaCreate Document
WWaybillGuia de TransporteCreate Waybill
YDelivery NoteGuia de RemessaCreate Waybill

Your account needs an active series for a type before it can issue it. Number prefixes, SAF-T codes, which documents can reference which, and the limits per type are in the Appendix.

Authentication​

Both APIs require authentication credentials. See Authentication for setup instructions.