Get entity settings | Monite Documentation

import requests
url = "https://api.sandbox.monite.com/v1/entities/ea837e28-509b-4b6a-a600-d54b6aa0b1f5/settings"
headers = {
    "x-monite-version": "2024-05-25",
    "Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())

{
  "accounting": {
    "ledger_account_ids": {
      "payments": "payments",
      "products": "products"
    },
    "tax_ids": {
      "deductions": "deductions"
    }
  },
  "allow_purchase_order_autolinking": true,
  "currency": {
    "default": "AED",
    "exchange_rates": [
      {
        "base": "AED",
        "rate": 0.98,
        "to": "AED"
      }
    ]
  },
  "document_ids": {
    "document_type_prefix": {
      "credit_note": "credit_note",
      "delivery_note": "delivery_note",
      "invoice": "invoice",
      "purchase_order": "purchase_order",
      "quote": "quote"
    },
    "include_date": true,
    "min_digits": 1,
    "prefix": "prefix",
    "separator": "/"
  },
  "document_rendering": {
    "credit_note": {
      "display_entity_bank_account": true
    },
    "display_entity_bank_account": true,
    "display_line_items": true,
    "invoice": {
      "display_entity_bank_account": true
    },
    "line_items": {
      "discount": {
        "display": true,
        "label": "label"
      },
      "measure_unit": {
        "display": true,
        "label": "label"
      },
      "name": {
        "display": true,
        "label": "label"
      },
      "price": {
        "display": true,
        "label": "label",
        "precision": 1
      },
      "price_after_vat": {
        "display": true,
        "label": "label",
        "precision": 1
      },
      "quantity": {
        "display": true,
        "label": "label"
      },
      "total_price": {
        "display": true,
        "label": "label",
        "precision": 1
      },
      "total_price_after_vat": {
        "display": true,
        "label": "label",
        "precision": 1
      },
      "vat_amount": {
        "display": true,
        "label": "label",
        "precision": 1
      },
      "vat_rate": {
        "display": true,
        "label": "label",
        "precision": 1
      }
    },
    "quote": {
      "display_entity_bank_account": true,
      "display_signature": true
    }
  },
  "generate_paid_invoice_pdf": true,
  "language": "ab",
  "mail": {
    "reply_to": [
      "reply_to"
    ]
  },
  "payables_ocr_auto_tagging": [
    {
      "enabled": true,
      "keywords": [
        "keywords"
      ],
      "tag_id": "tag_id"
    }
  ],
  "payables_skip_approval_flow": true,
  "payment_priority": "working_capital",
  "quote_signature_required": true,
  "receivable_edit_flow": "compliant",
  "reminder": {
    "enabled": true
  },
  "vat_inclusive_discount_mode": "exclusive",
  "vat_mode": "exclusive"
}

Entity settings include configuration options for accounts payable, accounts receivable, accounting integration, and other functionality.

Both partner tokens and entity user tokens can be used for authentication. Entity users must have a role with the entity.read permission.

Related endpoints:

Entity settings include configuration options for accounts payable, accounts receivable, accounting integration, and other functionality. Both partner tokens and entity user tokens can be used for authentication. Entity users must have a role with the `entity.read` permission. Related endpoints: * [Get next document numbers](https://docs.monite.com/api/entities/get-entities-id-settings-next-document-numbers) * [Get partner settings](https://docs.monite.com/api/partner-settings/get-settings)

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

entity_idstringRequired

A unique ID to specify the entity.

Response

Successful Response

accountingobject

allow_purchase_order_autolinkingboolean

Automatically attempt to find a corresponding purchase order for all incoming payables.

currencyobject

document_idsobject

document_renderingobject

Settings for rendering documents in PDF format.

generate_paid_invoice_pdfbooleanDefaults to false

This setting affects how PDF is generated for accounts receivable invoices that are paid, partially paid, or have credit notes applied. If this setting is true:

The totals block in the PDF invoice will include a list of all payments made and credit notes issued.
Once an invoice becomes fully paid, the payment link and QR code are removed.

The PDF invoice gets regenerated at the moment when an invoice payment is recorded or a credit note is issued. This PDF is not issued as a separate document, and the original PDF invoice is no longer available.

This setting affects how PDF is generated for accounts receivable invoices that are paid, partially paid, or have credit notes applied. If this setting is `true`: * The totals block in the PDF invoice will include a list of all payments made and credit notes issued. * Once an invoice becomes fully paid, the payment link and QR code are removed. The PDF invoice gets regenerated at the moment when an invoice payment is recorded or a credit note is issued. This PDF is not issued as a separate document, and the original PDF invoice is no longer available.

languageenum

mailobject

Email settings for the entity

payables_ocr_auto_tagginglist of objects

Auto tagging settings for all incoming OCR payable documents.

payables_skip_approval_flowbooleanDefaults to false

If enabled, the approval policy will be skipped and the payable will be moved to waiting_to_be_paid status.

payment_priorityenum

Payment preferences for entity to automate calculating suggested payment date based on payment terms and entity preferences.

Allowed values:

quote_signature_requiredbooleanDefaults to false

Sets the default behavior of whether a signature is required to accept quotes.

receivable_edit_flowenum

Invoice compliance mode for accounts receivable. Possible values:

compliant - invoices cannot be edited once issued.
non_compliant - issued invoices can still be edited.
partially_compliant - deprecated mode, should not be used.

[Invoice compliance mode](https://docs.monite.com/accounts-receivable/regulatory-compliance/invoice-compliance) for accounts receivable. Possible values: * `compliant` - invoices cannot be edited once issued. * `non_compliant` - issued invoices can still be edited. * `partially_compliant` - deprecated mode, should not be used.

Allowed values:

reminderobject

vat_inclusive_discount_modeenum

Defines whether the amount discounts (for percentage discounts it does not matter) on VAT inclusive invoices will be applied on amounts including VAT or excluding VAT.

Allowed values:

vat_modeenum

Defines whether the prices of products in receivables will already include VAT or not.

Allowed values:

Errors

400

Get Entities ID Settings Request Bad Request Error

401

Get Entities ID Settings Request Unauthorized Error

422

Get Entities ID Settings Request Unprocessable Entity Error

429

Get Entities ID Settings Request Too Many Requests Error

Authentication

Path parameters

Headers

Response

Errors