# Get New Document Defaults Returns the defaults and choice lists used to build a new document of the specified invoice type (payment terms, exemption reasons, series of that type, currencies, retention options, taxes and default remarks). Nothing is created. Endpoint: GET /api/v3/{invoices-type}/new Version: 3.1.0 Security: apiKeyAuth ## Path parameters: - `invoices-type` (string, required) The type of the invoice document. Enum: "invoices", "invoice_receipts", "simplified_invoices", "credit_notes", "debit_notes" ## Query parameters: - `client_id` (integer) Id of a client of the account. Its payment days, exemption code, currency and observations are used for the defaults, and its basic data is returned in client. Example: 196600840 - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Response 200 fields (application/json): - `due_date_choices` (array) Payment-term options in days. The client's (or account's) payment days are flagged selected; a value outside the fixed list replaces the custom entry. Example: [{"value":0,"description":"Immediately"},{"value":30,"description":"30 days","selected":true},{"value":"custom","description":"Other"}] - `due_date_choices.value` (any) Days, or custom. - `due_date_choices.description` (string) - `due_date_choices.selected` (boolean) - `exemption_reasons` (array) - `exemption_reasons.code` (string) Example: "M01" - `exemption_reasons.reason` (string) - `sequences` (array) Series of this document type the account can issue in (Portuguese accounts only list series registered with the AT). When there is none, a single placeholder entry is returned with id null, disabled true and serie "Choose a registered Sequence" (or "Choose a Sequence" for foreign accounts). - `sequences.id` (integer,null) Example: 5259451 - `sequences.serie` (string) Example: "2026" - `sequences.disabled` (boolean) - `currencies` (array) - `currencies.name` (string) Example: "Euro" - `currencies.symbol` (string) Example: "€" - `currencies.selected` (boolean) Set on the client's currency when client_id is given. - `retention` (array) Withholding-tax options. The first entry (id and value null, "Not applicable") means no retention. - `retention.value` (number,null) - `remarks` (string) Default observations — the client's (or account's) observations followed by the text of the default exemption reason. - `include_payment_reference` (boolean,null) The account's "add Multibanco reference by default" preference. Null unless the plan includes MB, an MB provider is configured and the document type supports a payment reference. - `has_configured_payment_service` (boolean) - `taxes` (array) - `taxes.region` (string,null) Example: "PT" - `taxes.default_tax` (integer) 1 for the account's default tax. Enum: 0, 1 - `client` (object) Conditional — only present when client_id matches a client. - `client.fiscal_id` (string,null) - `client.address` (string,null) - `client.postal_code` (string,null) - `client.city` (string,null) - `client.country` (string,null) ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Example: [{"error":"No invoice element provided"},{"error":"No items element provided"}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)