PUT
/
api
/
v3
/
expenseTempItems
/
{expenseTempItemId}
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,
  "mileage": {
    "distance": 123,
    "power": 123,
    "waypoints": [
      "<any>"
    ]
  },
  "quantity": 1,
  "attendees": {
    "internal": [
      {
        "id": 123,
        "name": "<string>",
        "url": "<string>",
        "displayName": "<string>",
        "modifiedOn": "<string>",
        "lastName": "<string>",
        "firstName": "<string>",
        "login": "<string>",
        "mail": "<string>",
        "dtContractStart": "<string>",
        "dtContractEnd": "<any>",
        "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>"
          }
        ]
      }
    ],
    "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>"
  },
  "ownerId": 123,
  "paymentMethodId": 0,
  "paymentMethod": {
    "id": 123,
    "code": "<string>"
  },
  "statusId": {
    "id": 0
  },
  "status": {
    "id": 123,
    "code": "<string>"
  },
  "deviceId": "<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,
    "mileage": {
      "distance": 123,
      "power": 123,
      "waypoints": [
        "<any>"
      ]
    },
    "quantity": 1,
    "effectiveQuantity": 2,
    "attendees": {
      "internal": [
        {
          "id": 123,
          "name": "<string>",
          "url": "<string>",
          "displayName": "<string>",
          "modifiedOn": "<string>",
          "lastName": "<string>",
          "firstName": "<string>",
          "login": "<string>",
          "mail": "<string>",
          "dtContractStart": "<string>",
          "dtContractEnd": "<any>",
          "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>"
            }
          ]
        }
      ],
      "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>"
    },
    "ownerId": 123,
    "paymentMethodId": 0,
    "paymentMethod": {
      "id": 123,
      "name": "<string>",
      "code": "<string>"
    },
    "statusId": {
      "id": 0
    },
    "status": {
      "id": 123,
      "name": "<string>",
      "code": "<string>"
    },
    "deviceId": "<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
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 | null

Additional information when the expense type is mileage.

​
attendees
object | null

Additional information when the expense type is 'Invitation'.

​
axisSections
object[] | null

You can read more about this resource here.

​
customFields
object | null

Values for custom fields.

​
merchant
string | null

Merchant of the expense.

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

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

An expense's receipt. Can be downloaded, either as an original or preview file, by following the href link. Please note that a 302 Redirect may be returned, in which case you have to follow the URL returned in the Location HTTP header.

​
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
object
​
paymentMethod
object
​
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
object

Response

200
application/json
OK
​
data
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.

Was this page helpful?