Specialized Guides by Document Type
These guides explain how to create each document nature supported by the Invoice API via POST /gateway/invoice/invoices.
📚 Available Guides
📝 Quotes Guide — ORC
Commercial proposals; stock behaviour comes from document type configuration.
📦 Orders Guide — NE
Customer orders; conversion to invoices with line references.
🧾 Sales Invoices Guide — FT, FS
Definitive sales and simplified invoices; payments required.
🧾 Invoice-Receipt Guide — FR
Sales with payment on the same document (replaces separate receipt in many flows).
↩️ Credit Notes Guide — NC
Returns and corrections with mandatory references and emissionReason.
📋 Debit Notes Guide — ND
Additional charges linked to origin documents.
🚚 Transport Guides — GT, GR, GA, GC, GD
Shipping documents with transport fields: load/unload place, dates, and carrier.
💰 Receipts Guide — RE
Nature RE is not available via the Invoice API. See Invoice-Receipt Guide for FR.
📊 Quick Comparison
| Nature | Code | Payments | Stock | Fiscal |
|---|---|---|---|---|
| Quote | ORC | ✅ | From type config | ❌ |
| Order | NE | ✅ | From type config | ❌ |
| Sales invoice | FT | ✅ | Per document type | ✅ |
| Simplified invoice | FS | ✅ | Per document type | ✅ |
| Invoice-receipt | FR | ✅ | Per document type | ✅ |
| Credit note | NC | ✅ | Per document type | ✅ |
| Debit note | ND | ✅ | Per document type | ✅ |
| Transport guides | GT…GD | Optional | Per document type | ✅ |
| Receipt | RE | — | Not available | — |
Stock is never set on lines in the request — it follows the document type and item configuration.
Payments requirement depends on document type configuration. Any document type with both CashierFlow and CheckingAccountFlow set to zero allows optional payments; GT…GD, NE, and ORC are typically configured this way.
Document type IDs
Resolve documentTypeId via Usage Guide — document type IDs.
⚠️ Error Reference
Complete reference of all validation and runtime error codes returned by the Invoice API, grouped by category with conditions and resolutions.
🎯 Where to Start?
- Usage Guide — endpoints, data model, supported natures
- Invoices Guide — typical sales flow
- Credit Notes Guide — returns
- Error Reference — error codes and resolutions
🔗 Related Resources
- API Reference — OpenAPI
- Usage Guide — general reference
Last Updated: June 12, 2026