Create 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. 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. 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. - 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.