PUT /v1/invoice/settings
const url = 'https://api.asap.cool/v1/invoice/settings';const options = { method: 'PUT', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"acompte_prefix":"example","auto_convert_signed_quotes":true,"auto_finalize_signed_invoices":true,"auto_send_signed_invoices":true,"avoir_prefix":"example","bic":"example","default_discount_terms":"example","default_payment_terms":"example","default_validity_days":1,"default_vat_exigibility":"example","devis_prefix":"example","einvoicing_enabled":true,"ereporting_prefs":"example","facture_prefix":"example","footer_mentions":"example","iban":"example","pdp_config":"example","penalty_rate":"example","recovery_fee":1}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.asap.cool/v1/invoice/settings \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "acompte_prefix": "example", "auto_convert_signed_quotes": true, "auto_finalize_signed_invoices": true, "auto_send_signed_invoices": true, "avoir_prefix": "example", "bic": "example", "default_discount_terms": "example", "default_payment_terms": "example", "default_validity_days": 1, "default_vat_exigibility": "example", "devis_prefix": "example", "einvoicing_enabled": true, "ereporting_prefs": "example", "facture_prefix": "example", "footer_mentions": "example", "iban": "example", "pdp_config": "example", "penalty_rate": "example", "recovery_fee": 1 }'Authorizations
Section intitulée « Authorizations »Request Body required
Section intitulée « Request Body required »Body of PUT /v1/invoice/settings. Prefixes and the few non-nullable
fields default to sensible French values; omitted optionals reset.
object
Number prefix for deposit invoices (defaults to AC).
Whether to auto-convert a signed quote to a draft facture on
acceptance (defaults to false).
Whether to also finalize (NF203) the auto-created invoice. Implies
auto_convert_signed_quotes; the cascade is normalized server-side.
Whether to also email the auto-finalized invoice to the client. Implies
auto_finalize_signed_invoices; the cascade is normalized server-side.
Number prefix for credit notes (defaults to AV).
Settlement BIC.
Default discount terms.
Default payment terms.
Default quote validity, in days (defaults to 30).
Default VAT exigibility (debits/encaissements, defaults to debits).
Number prefix for quotes (defaults to DEV).
Whether to opt into the e-invoicing flow (defaults to false).
E-reporting preferences (JSONB).
Number prefix for invoices (defaults to FAC).
Footer mentions.
Settlement IBAN.
PDP config (JSONB).
Late-payment penalty rate as a percentage token.
Fixed recovery indemnity, in cents (defaults to 4000 = 40 EUR).
Example generated
{ "acompte_prefix": "example", "auto_convert_signed_quotes": true, "auto_finalize_signed_invoices": true, "auto_send_signed_invoices": true, "avoir_prefix": "example", "bic": "example", "default_discount_terms": "example", "default_payment_terms": "example", "default_validity_days": 1, "default_vat_exigibility": "example", "devis_prefix": "example", "einvoicing_enabled": true, "ereporting_prefs": "example", "facture_prefix": "example", "footer_mentions": "example", "iban": "example", "pdp_config": "example", "penalty_rate": "example", "recovery_fee": 1}Responses
Section intitulée « Responses »Upserted invoice settings.
Public projection of [InvoiceSettings]. Amounts are in cents.
object
Number prefix for deposit invoices.
Whether a signed quote is auto-converted to a draft facture on acceptance.
Whether an invoice auto-created from a signed quote is also finalized
(NF203) automatically. Implies auto_convert_signed_quotes.
Whether an auto-finalized invoice is also emailed to the client.
Implies auto_finalize_signed_invoices.
Number prefix for credit notes.
Settlement BIC.
RFC3339 creation timestamp.
Default early-payment discount terms.
Default payment terms.
Default quote validity, in days.
Default VAT chargeability basis.
Number prefix for quotes.
Whether this org opted into the e-invoicing flow.
E-reporting preferences.
Number prefix for invoices.
Footer mentions / legal notes.
Settlement IBAN.
Owning org id.
Partner dematerialization-platform (PDP) config.
Late-payment penalty rate as a percentage token.
Fixed recovery indemnity, in cents.
RFC3339 last-update timestamp.
Example generated
{ "acompte_prefix": "example", "auto_convert_signed_quotes": true, "auto_finalize_signed_invoices": true, "auto_send_signed_invoices": true, "avoir_prefix": "example", "bic": "example", "created_at": "example", "default_discount_terms": "example", "default_payment_terms": "example", "default_validity_days": 1, "default_vat_exigibility": "example", "devis_prefix": "example", "einvoicing_enabled": true, "ereporting_prefs": "example", "facture_prefix": "example", "footer_mentions": "example", "iban": "example", "org_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "pdp_config": "example", "penalty_rate": "example", "recovery_fee": 1, "updated_at": "example"}No active org.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}Missing invoice:write scope.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}Invalid settings payload.
Generic error body returned by API handlers when they fail. code is a
stable machine-readable token; message is human-friendly and meant for
surfacing to end users.
object
Stable machine token (e.g. invalid_credentials).
Offending request field for validation errors, when known.
Human-readable message.
Example generated
{ "code": "example", "field": "example", "message": "example"}