Your first invoice
Prepare a draft
Section titled “Prepare a draft”Create the customer, tax rate, and invoice series in the same authorized environment. Submit a complete draft request with the intended customer, issue date, currency, lines, and series. Read the response to confirm server-calculated totals.
Do not issue from an unvalidated draft
Call the draft validation endpoint, show errors to the responsible user, and issue only after your application has confirmed the intended action.
Issue and read the independent fiscal result
Section titled “Issue and read the independent fiscal result”-
Issue with a stable idempotency key and the required invoice-issue scope.
-
Persist the returned invoice ID and invoice number.
-
Poll/read the dedicated fiscal status or fiscal operation resource using backoff chosen by your application.
-
Treat an ambiguous network outcome as unknown; do not resend an issuance or fiscal mutation blindly.
-
Download the generated document through the authenticated document API when it is Ready.