Skip to main content
PUT
/
api
/
v3
/
expenseTempItems
/
{expenseTempItemId}
Update an ExpenseTempItem by id
curl --request PUT \
  --url https://{host}/api/v3/expenseTempItems/{expenseTempItemId} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "purchasedOn": "2023-12-25",
  "originalTransaction": {
    "grossAmount": 123,
    "currencyId": "<string>",
    "isExpenseAbroad": false
  },
  "processedAmounts": {
    "grossAmount": 123,
    "currencyId": "<string>",
    "currency": {
      "id": "<string>",
      "name": "<string>",
      "url": "<string>"
    }
  },
  "expenseNatureId": 2,
  "quantity": 1,
  "ownerId": 123,
  "paymentMethodId": 0,
  "deviceId": "<string>",
  "mileage": {
    "distance": 123,
    "power": 123,
    "waypoints": [
      "<unknown>"
    ]
  },
  "attendees": {
    "internal": [
      {
        "id": 123,
        "name": "<string>",
        "url": "<string>",
        "displayName": "<string>",
        "modifiedOn": "<string>",
        "lastName": "<string>",
        "firstName": "<string>",
        "login": "<string>",
        "mail": "<string>",
        "dtContractStart": "<string>",
        "birthDate": "<string>",
        "employeeNumber": "<string>",
        "calendar": {
          "id": 123,
          "url": "<string>",
          "name": "<string>"
        },
        "culture": {
          "id": 123,
          "name": "<string>",
          "url": "<string>"
        },
        "picture": {
          "id": "<string>",
          "url": "<string>",
          "name": "<string>"
        },
        "applicationData": {
          "profile_figgo": {
            "id": 123,
            "name": "<string>",
            "url": "<string>"
          },
          "profile_utime": {
            "id": 123,
            "name": "<string>",
            "url": "<string>"
          }
        },
        "legalEntity": {
          "id": 123,
          "name": "<string>",
          "url": "<string>"
        },
        "department": {
          "id": 123,
          "name": "<string>",
          "url": "<string>"
        },
        "manager": {
          "id": 123,
          "name": "<string>",
          "url": "<string>"
        },
        "rolePrincipal": {
          "id": 123,
          "name": "<string>",
          "url": "<string>"
        },
        "habilitedRoles": [
          {
            "id": 123,
            "name": "<string>",
            "url": "<string>"
          }
        ],
        "userWorkCycles": [
          {
            "Id": 123,
            "OwnerID": 123,
            "WorkCycleID": 123,
            "StartsOn": "<string>",
            "EndsOn": "<string>"
          }
        ],
        "dtContractEnd": "<unknown>"
      }
    ],
    "external": [
      {
        "id": 2,
        "displayName": "<string>"
      }
    ]
  },
  "axisSections": [
    {
      "id": 2
    }
  ],
  "customFields": {},
  "merchant": "<string>",
  "comment": "<string>",
  "expenseReceipts": [
    {
      "id": "f0d01fd0-5f27-4061-8dca-bee6318b0103",
      "originalReceipt": {
        "id": "cb0aae89-56c9-48db-9052-48981660e0f7",
        "name": "receipt-f0d01fd0-5f27-4061-8dca-bee6318b0103.pdf",
        "href": "https://example.ilucca.net/api/v3/ExpenseReceipts/f0d01fd0-5f27-4061-8dca-bee6318b0103/originalReceiptFile",
        "extension": ".pdf"
      },
      "receiptPreview": {
        "id": "cb0aae89-56c9-48db-9052-48981660e0f7",
        "name": "receipt-f0d01fd0-5f27-4061-8dca-bee6318b0103-preview.pdf",
        "href": "https://example.ilucca.net/api/v3/ExpenseReceipts/f0d01fd0-5f27-4061-8dca-bee6318b0103/receiptPreviewFile",
        "extension": ".pdf"
      }
    }
  ],
  "sourceId": {
    "id": "<string>"
  },
  "source": {
    "id": 123,
    "code": "<string>"
  },
  "paymentMethod": {
    "id": 123,
    "code": "<string>"
  },
  "statusId": {
    "id": 0
  },
  "status": {
    "id": 123,
    "code": "<string>"
  }
}
'
{
  "data": {
    "id": 2,
    "purchasedOn": "2023-12-25",
    "originalTransaction": {
      "grossAmount": 123,
      "currencyId": "<string>",
      "isExpenseAbroad": false
    },
    "processedAmounts": {
      "grossAmount": 123,
      "currencyId": "<string>",
      "currency": {
        "id": "<string>",
        "name": "<string>",
        "url": "<string>"
      },
      "netAmount": 123,
      "vatBases": [
        {
          "countryVatRateId": 2,
          "countryVatRate": {
            "id": 2,
            "name": "<string>",
            "url": "<string>"
          },
          "vatAmount": 123,
          "amountExcludingVat": 123
        }
      ]
    },
    "expenseNatureId": 2,
    "quantity": 1,
    "ownerId": 123,
    "paymentMethodId": 0,
    "deviceId": "<string>",
    "mileage": {
      "distance": 123,
      "power": 123,
      "waypoints": [
        "<unknown>"
      ]
    },
    "effectiveQuantity": 2,
    "attendees": {
      "internal": [
        {
          "id": 123,
          "name": "<string>",
          "url": "<string>",
          "displayName": "<string>",
          "modifiedOn": "<string>",
          "lastName": "<string>",
          "firstName": "<string>",
          "login": "<string>",
          "mail": "<string>",
          "dtContractStart": "<string>",
          "birthDate": "<string>",
          "employeeNumber": "<string>",
          "calendar": {
            "id": 123,
            "url": "<string>",
            "name": "<string>"
          },
          "culture": {
            "id": 123,
            "name": "<string>",
            "url": "<string>"
          },
          "picture": {
            "id": "<string>",
            "url": "<string>",
            "name": "<string>"
          },
          "applicationData": {
            "profile_figgo": {
              "id": 123,
              "name": "<string>",
              "url": "<string>"
            },
            "profile_utime": {
              "id": 123,
              "name": "<string>",
              "url": "<string>"
            }
          },
          "legalEntity": {
            "id": 123,
            "name": "<string>",
            "url": "<string>"
          },
          "department": {
            "id": 123,
            "name": "<string>",
            "url": "<string>"
          },
          "manager": {
            "id": 123,
            "name": "<string>",
            "url": "<string>"
          },
          "rolePrincipal": {
            "id": 123,
            "name": "<string>",
            "url": "<string>"
          },
          "habilitedRoles": [
            {
              "id": 123,
              "name": "<string>",
              "url": "<string>"
            }
          ],
          "userWorkCycles": [
            {
              "Id": 123,
              "OwnerID": 123,
              "WorkCycleID": 123,
              "StartsOn": "<string>",
              "EndsOn": "<string>"
            }
          ],
          "dtContractEnd": "<unknown>"
        }
      ],
      "external": [
        {
          "id": 2,
          "displayName": "<string>"
        }
      ]
    },
    "axisSections": [
      {
        "id": 2,
        "code": "<string>",
        "name": "<string>",
        "multilingualName": "<string>",
        "description": "<string>",
        "ownerId": 2,
        "startOn": "2023-11-07T05:31:56Z",
        "endOn": "2023-11-07T05:31:56Z",
        "active": true,
        "axisId": 123,
        "parentAxisSections": [
          {}
        ],
        "childrenAxisSections": [
          {}
        ]
      }
    ],
    "customFields": {},
    "merchant": "<string>",
    "comment": "<string>",
    "expenseReceipts": [
      {
        "id": "f0d01fd0-5f27-4061-8dca-bee6318b0103",
        "originalReceipt": {
          "id": "cb0aae89-56c9-48db-9052-48981660e0f7",
          "name": "receipt-f0d01fd0-5f27-4061-8dca-bee6318b0103.pdf",
          "href": "https://example.ilucca.net/api/v3/ExpenseReceipts/f0d01fd0-5f27-4061-8dca-bee6318b0103/originalReceiptFile",
          "extension": ".pdf"
        },
        "receiptPreview": {
          "id": "cb0aae89-56c9-48db-9052-48981660e0f7",
          "name": "receipt-f0d01fd0-5f27-4061-8dca-bee6318b0103-preview.pdf",
          "href": "https://example.ilucca.net/api/v3/ExpenseReceipts/f0d01fd0-5f27-4061-8dca-bee6318b0103/receiptPreviewFile",
          "extension": ".pdf"
        }
      }
    ],
    "authorizedActions": {
      "isCancellable": true,
      "isEditable": true
    },
    "sourceId": {
      "id": "<string>"
    },
    "source": {
      "id": 123,
      "name": "<string>",
      "code": "<string>"
    },
    "paymentMethod": {
      "id": 123,
      "name": "<string>",
      "code": "<string>"
    },
    "statusId": {
      "id": 0
    },
    "status": {
      "id": 123,
      "name": "<string>",
      "code": "<string>"
    }
  }
}

Headers

​
Authorization
string
required

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

Path Parameters

​
expenseTempItemId
integer
required

Unique identifier of the ExpenseTempItem.

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, ...). Technically, there could be more than one, but in reality, there’s usually just one.

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