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.

Criteria	REST API	SOAP API
Data Format	JSON	XML
Best For	New integrations, modern apps	Legacy systems, enterprise environments
Learning Curve	Easier	Steeper
Tooling	Excellent (Postman, curl, etc.)	Requires SOAP clients
Feature Parity	Full support	Full support
Recommendation	Recommended	Maintained 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:

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

Get Started

• REST API Documentation - JSON-based, recommended for new integrations
• SOAP API Documentation - XML-based, for legacy system integration

Document Types

Code	Type	Portuguese Name
T	Invoice/Receipt	Fatura/Recibo
I	Invoice	Fatura
S	Simplified Invoice	Fatura Simplificada
C	Credit Note	Nota de Crédito
D	Debit Note	Nota de Débito

Authentication

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