Version: 1.0
XDPeople Soba Invoice API v1
API for managing the entire lifecycle of sales documents including quotes, orders, proforma invoices, sales invoices, receipts, and credit notes.
Overview
The Invoice API is an XDPeople.Soba microservice responsible for complete lifecycle management of sales documents, including:
- 📝 Quotes - Commercial proposals
- 📦 Orders - Customer orders with optional stock reservation
- 📄 Proforma Invoices - Advance billing documents
- 🧾 Sales Invoices - Official fiscal documents
- 💰 Receipts - Payment vouchers
- ↩️ Credit Notes - Returns and corrections
Key Features
- ✅ Create, update, and query documents
- ✅ Advanced filters (status, dates, customer, document type)
- ✅ Result pagination
- ✅ JWT authentication
- ✅ Multi-tenancy support
- ✅ Clean Architecture with CQRS pattern
- ✅ Swagger/OpenAPI documentation
Quick Links
- Usage Guide - Complete API usage guide
- Guides Index - Specialized guides by document type
- Quotes Guide - Creating commercial proposals
- Orders Guide - Processing customer orders
- Invoices Guide - Issuing sales invoices
- Receipts Guide - Registering payments
- Credit Notes Guide - Handling returns
Authentication
- HTTP: Bearer Auth
JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token in the text input below.
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Bearer format: | JWT |