Company Info

Update a company's own settings — name, contact email, default VAT rate, logo, signature, and document defaults. Authenticate with the company's Partner API Key.

Use cases: Configure a newly provisioned company, or keep its details in sync with your own system.

PUT/settings/

Update the authenticated company's settings. All fields are optional; only the fields you send are changed — except logoFileId and signatureFileId (see notes).

logoFileId and signatureFileId use write-null semantics: if you omit them, they are set to null. Always resend their current values unless you intend to clear them. There is no company phone field.

Body Parameters

Name	Type	Description
`name`	string	Company display name (min 1 character).
`taxAmount`	number	Default VAT rate as a decimal (e.g. 0.18).
`email`	string	Company contact email.
`addressId`	number	ID of the address that prints on documents. See the Company Address section.
`logoFileId`	number	File ID of the company logo. WRITE-NULL: omitting this field clears the logo. Resend it to keep the current logo.
`signatureFileId`	number	File ID of the company signature. WRITE-NULL: omitting this field clears the signature. Resend it to keep the current signature.
`type`	string	Company type. One of "MURSHE", "COMPANY", or "PATOOR".
`defaultVatMode`	string	Default VAT mode. One of "before" or "include".
`defaultCashLedgerId`	number \| null	Default ledger for cash payments.
`defaultChecksLedgerId`	number \| null	Default ledger for check payments.
`defaultCreditCardLedgerId`	number \| null	Default ledger for credit-card payments.
`defaultBankLedgerId`	number \| null	Default ledger for bank transfers.
`defaultQuotationValidityDays`	number \| null	Default validity window for quotations, in days.
`defaultOrderDeliveryDays`	number \| null	Default delivery window for orders, in days.
`documentTotalRounding`	string \| null	Rounding applied to document totals. One of "none", "round", "round_up", "round_down".
`prepaidPackagesEnabled`	boolean	Enable prepaid packages.
`hideDeliveryPrices`	boolean	Hide prices on delivery notes.
`hideOrderPrices`	boolean	Hide prices on orders.
`deriveBookingAvailabilityFromShifts`	boolean	Derive booking availability from staff shifts.
`letterheadMarginTopMm`	number \| null	Top letterhead margin in millimetres (0–100).
`letterheadMarginBottomMm`	number \| null	Bottom letterhead margin in millimetres (0–100).
`docTypeMarginOverrides`	object \| null	Per-document-type letterhead margin overrides: a map of document type to { topMm, bottomMm } (each 0–100).

Request

curl -X PUT "https://api.glance.co.il/settings/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "example_name",
  "taxAmount": 0,
  "email": "example_email",
  "addressId": 0,
  "logoFileId": 0,
  "signatureFileId": 0,
  "type": "example_type",
  "defaultVatMode": "example_defaultVatMode",
  "defaultCashLedgerId": "example_defaultCashLedgerId",
  "defaultChecksLedgerId": "example_defaultChecksLedgerId",
  "defaultCreditCardLedgerId": "example_defaultCreditCardLedgerId",
  "defaultBankLedgerId": "example_defaultBankLedgerId",
  "defaultQuotationValidityDays": "example_defaultQuotationValidityDays",
  "defaultOrderDeliveryDays": "example_defaultOrderDeliveryDays",
  "documentTotalRounding": "example_documentTotalRounding",
  "prepaidPackagesEnabled": true,
  "hideDeliveryPrices": true,
  "hideOrderPrices": true,
  "deriveBookingAvailabilityFromShifts": true,
  "letterheadMarginTopMm": "example_letterheadMarginTopMm",
  "letterheadMarginBottomMm": "example_letterheadMarginBottomMm",
  "docTypeMarginOverrides": "example_docTypeMarginOverrides"
}'

Response

{
  "success": true,
  "company": {
    "id": 123,
    "name": "Acme Ltd",
    "email": "info@acme.com",
    "taxAmount": 0.18,
    "type": "COMPANY",
    "addressId": 456
  }
}