Skip to main content
POST
/
api
/
v3
/
expenseTempItems
Create a new temporary expense
curl --request POST \
  --url https://{host}/api/v3/expenseTempItems \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "expenseNatureId": 1,
  "purchasedOn": "2025-01-01",
  "paymentMethodId": 1,
  "quantity": 1,
  "originalTransaction": {
    "currencyId": "EUR",
    "grossAmount": 25
  },
  "processedAmounts": {
    "grossAmount": 25,
    "currencyId": "EUR"
  },
  "deviceId": "Web",
  "ownerId": 1,
  "merchant": "SNCF",
  "comment": "Travel to Paris",
  "expenseReceipts": [
    {
      "id": "f0d01fd0-5f27-4061-8dca-bee6318b0103"
    }
  ]
}
'
{
  "id": 12,
  "purchasedOn": "2025-01-01",
  "originalTransaction": {
    "grossAmount": 25,
    "currencyId": "EUR",
    "isExpenseAbroad": false
  },
  "processedAmounts": {
    "grossAmount": 25,
    "currencyId": "EUR",
    "netAmount\"": 25,
    "vatBases": [
      {
        "countryVatRateId": 2,
        "countryVatRate": {
          "id": "2,",
          "name": "<string>",
          "url": "<string>"
        },
        "vatAmount\"": 25,
        "amountExcludingVat\"": 25
      }
    ]
  },
  "expenseNatureId": 1,
  "quantity": 1,
  "ownerId": 1,
  "paymentMethodId": 1,
  "deviceId": "Web",
  "mileage": null,
  "effectiveQuantity": 1,
  "attendees": {
    "internal": [],
    "external": []
  },
  "axisSections": [],
  "customFields": {},
  "merchant": "SNCF",
  "comment": "Travel to Paris",
  "expenseReceipts": [],
  "authorizedActions": {
    "isCancellable": true,
    "isEditable": true
  },
  "sourceId": {
    "id": 6
  },
  "statusId": {
    "id": 0
  }
}

Headers

​
Authorization
string
required

API key. Value must be formatted like so: lucca application={api_key}.

Body

application/json

The ExpenseTempItem, or "temporary expense" is an expense that has not yet been declared (within an expense report) by its owner (the user who made the expense). Once submitted within an expense report, the expense turns into an ExpenseClaimItem.

​
purchasedOn
string<date>
required

Day the expense was made.

​
originalTransaction
object
required

Expense amount in original currency.

​
processedAmounts
object
required

Various amounts in the establishment's currency.

​
expenseNatureId
integer
required

Nature of the expense: Meals, Train, Taxi, Hotels, Taxi, Mileage... List depends on the app configuration.

Required range: x >= 1
​
quantity
integer
default:1
required

The quantity when the expense type is 'Quantity'.

Required range: x >= 1
​
ownerId
integer
required

Unique identifier of the user that made this expense.

​
paymentMethodId
enum<integer>
required

How this expense was made: the owner used his money, an enterprise debit card, or a Cleemy card:

  • 0: User
  • 1: CorporateCard
  • 3: Cleemy Card
Available options:
0,
1,
3
​
deviceId
string
required
Allowed value: "Web"
​
mileage
object

Additional information when the expense type is mileage.

​
attendees
object

Additional information when the expense type is 'Invitation'.

​
axisSections
The Axis Section resource · object[] | null
​
customFields
object

Values for custom fields.

​
merchant
string | null

Merchant of the expense.

​
comment
string | null
​
expenseReceipts
ExpenseReceipt · object[] | null

The expense receipts (PDF file, image, ...) attached to this expense. Technically, there could be more than one, but in reality, there’s usually just one.

Important: to attach a receipt when creating or updating an expense, you must first upload the file via POST /lucca-files/api/uploads, then create an ExpenseReceipt via POST /api/v3/expenseReceipts (providing the uploadId), and finally reference the receipt by its id here. Passing the file upload ID directly will result in a 403 Forbidden error. See the Attaching receipts guide.

​
sourceId
SourceId · object

The source describes how the expense was created:

  • 0: Legacy
  • 1: OldImport
  • 2: ImportByCb
  • 3: ImportByNature
  • 4: Anytime
  • 5: BudgetInsight
  • 6: Api
  • 7: Ocr
  • 8: Reconciliation
  • 9: InvoiceAggregator
  • 10: EmailAttachments
  • 11: FtpStatementImport
  • 12: CleemyPayment
​
source
Enum · object
​
paymentMethod
Enum · object
​
statusId
StatusId · object

Status of the expense.

  • 0: the expense is not valid.
  • 1: the expense has been completed by the system and review is still pending
  • 2: the expense has been completed and reviewed and it can be declared.
​
status
Enum · object

Response

OK

​
data
The ExpenseTempItem Resource · object

The ExpenseTempItem, or "temporary expense" is an expense that has not yet been declared (within an expense report) by its owner (the user who made the expense). Once submitted within an expense report, the expense turns into an ExpenseClaimItem.