Validate a project expense

The project the cost is booked on. Must exist (37014) and be active (37689). Refers to ProjectRead.ProjectID. - ≤ 0 — 400 Code 200 "'Project ID' must be greater than '0'." - unknown ID — 37014 (adapter, before any other business rule). - inactive project — 37689. > Not yet documented: values → lookup op.

The contract of ProjectID the cost is booked on. Required — there is NO default-contract resolution for project expenses. Refers to ContractRead.ContractID. Look up valid values with GET /v1/contract. - ≤ 0 — 400 Code 200. - not a contract of ProjectID — 37042. - contract closed — 37806. - fixed-price contract and IsBillable false — 31140. Valid values come from GET /v1/contract.

The purchase / supplier-invoice date. Date only — no time component. - a time component is sent — NOT truncated: stored in a SMALLDATETIME (minute precision). Send a date without time — the per-day expense totals match on the exact value.

How the cost was paid. A payment method flagged as the employee's own money makes the expense reimbursable to the caller. Refers to PaymentMethodRead.PaymentMethodID. - ≤ 0 — 400 Code 200. - unknown ID — 37018. > Not yet documented: values → lookup op.

The expense type (cost category). Drives the product number on the invoice line when product numbers are active. Refers to ExpenseTypeRead.ExpenseTypeID. Look up valid values with GET /v1/expense-type/all/list. - ≤ 0 — 400 Code 200. - unknown ID — 37019. - type of another legal entity than the project's — Accepted — the legal-entity rule sets violation 37998 but returns true, so it is never raised. Valid values come from GET /v1/expense-type/all/list.

The cost INCLUDING VAT, in the purchase currency ExpenseCurrencyISO. The net cost is this minus VatAmountExpenseCurrency. Unit: currency ExpenseCurrencyISO (purchase currency), VAT included - more decimals than the account's invoice setting — 400 "Number of decimals are wrong on AmountIncludingVatExpenseCurrency…" - 0 — A zero-cost line: the sales price is taken from SalesPriceAmountProjectCurrency as is (pure re-invoicing). No sign rule: negative amounts (credit notes) are not rejected by the API.

The VAT part of AmountIncludingVatExpenseCurrency, in the purchase currency. Unit: currency ExpenseCurrencyISO Not checked against the amount or the expense type's VAT %; VAT is never invoiced (cost and sales price are net).

ISO code of the purchase currency (e.g. "DKK", "EUR") — a currency abbreviation known to the account. Refers to CurrencyRead.CurrencyABB. Look up valid values with GET /v1/currency/{status}. - empty — 400 Code 200. - unknown abbreviation — 30020 "Unknown Currency Abbreviation" (500 Code 102). Valid values come from GET /v1/currency/{status}.

Rate from the purchase currency to the CALLER's legal-entity currency, per 100 units (100 = same value; 745.5 = 100 EUR cost 745.50 DKK). Stored as the expense's base-reference rate and used for the employee-side cost and reimbursement amounts. Null: Omitted / null → looked up in the currency matrix (intercompany exchange rate) for PurchaseDate; none found → 400. Unit: caller legal-entity currency per 100 units of ExpenseCurrencyISO - omitted and no currency-matrix rate exists for the date — 400 "No exchange rate found for the expense date between expense currency and employee legal entity currency." - omitted — Matrix rate (create only — the validate route does not look it up). - omitted and SalesPriceAmountProjectCurrency sent — The profit ratio is computed with a rate of 0 → stored as 0. The project-side conversion (cost and sales price in project currency, project legal-entity cost) does NOT use this value: it uses the account's live / matrix rates for the date.

Whether the cost is re-invoiced to the customer. When false the sales price in project currency is stored as 0. - false on a fixed-price contract — 31140. - omitted — false (non-nullable bool) — the expense is NOT billable unless you send true.

The price to invoice the customer, in the PROJECT's currency, net of VAT. Alternative to ProfitRatio. Conditional. Must be null when ProfitRatio is sent. Null: Null (and ProfitRatio null) → sales price = net cost converted to project currency (no mark-up). Unit: project currency, VAT excluded - sent together with ProfitRatio — 400 "SalesPriceAmountCurrency must be null when ProfitRatio is added." - sent, amount ≠ 0 — ProfitRatio is derived from it ((sales − cost) / cost × 100, in system currency) — only when ProjectExpenseExchangeRate is also sent. - 0 — Treated as not sent: recomputed from cost × (1 + ProfitRatio / 100).

Mark-up in percent on the net cost: sales price = cost × (1 + ProfitRatio / 100). Alternative to SalesPriceAmountProjectCurrency. Conditional. Must be null when SalesPriceAmountProjectCurrency is sent. Null: Null → 0 % (the adapter always sends a ratio, so the account's default ExpenseProfitPercent is NOT applied to API-created project expenses). Unit: percent - sent together with SalesPriceAmountProjectCurrency — 400.

Free-text description of the cost; also used in the invoice line text.

The expense number. Conditional. Used only when the ExpenseNo feature is on, the number series does not auto-generate, and AllowEmptyExpenseNo is on; otherwise ignored (auto number or NULL). - ExpenseNo feature off, or the series auto-generates — Adapter drops the value. - ExpenseNumberSeries on — Next number from the series. > Not yet documented: behaviour.

The supplier — a CRM customer whose status is shown in suppliers. Returned as ProjectExpenseRead.CustomerID. Refers to CustomerRead.CustomerID. Look up valid values with GET /v1/customer. Null: Null or 0 = no supplier. - unknown customer — 37021. - customer without a supplier status — 37940. Valid values come from GET /v1/customer.

The supplier's invoice number. Returned as ProjectExpenseRead.InvoiceNo. - longer than 50 characters — Silently cut to 50.

Your system's identifier for this cost. Stored and returned; not unique, not used for lookups. Key from your own system. Uniqueness is not enforced. - longer than 50 characters — The insert fails → 500 Code 100. Retries are NOT deduplicated on ExternalID — check before re-sending a create whose response was lost.