Skip to main content

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.

View Complete Guide →


📦 Orders Guide — NE

Customer orders; conversion to invoices with line references.

View Complete Guide →


🧾 Sales Invoices Guide — FT, FS

Definitive sales and simplified invoices; payments required.

View Complete Guide →


🧾 Invoice-Receipt Guide — FR

Sales with payment on the same document (replaces separate receipt in many flows).

View Complete Guide →


↩️ Credit Notes Guide — NC

Returns and corrections with mandatory references and emissionReason.

View Complete Guide →


📋 Debit Notes Guide — ND

Additional charges linked to origin documents.

View Complete Guide →


🚚 Transport Guides — GT, GR, GA, GC, GD

Shipping documents with transport fields: load/unload place, dates, and carrier.

View Complete Guide →


💰 Receipts Guide — RE

Reference only

Nature RE is not available via the Invoice API. See Invoice-Receipt Guide for FR.

View Complete Guide →


📊 Quick Comparison

NatureCodePaymentsStockFiscal
QuoteORCFrom type config
OrderNEFrom type config
Sales invoiceFTPer document type
Simplified invoiceFSPer document type
Invoice-receiptFRPer document type
Credit noteNCPer document type
Debit noteNDPer document type
Transport guidesGT…GDOptionalPer document type
ReceiptRENot 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.

View Error Reference →


🎯 Where to Start?

  1. Usage Guide — endpoints, data model, supported natures
  2. Invoices Guide — typical sales flow
  3. Credit Notes Guide — returns
  4. Error Reference — error codes and resolutions


Last Updated: June 12, 2026