PUT
/
api
/
v3
/
expenseTempItems
/
{expenseTempItemId}
curl --request PUT \
  --url https://example.ilucca.net/api/v3/expenseTempItems/{expenseTempItemId} \
  --header 'Content-Type: application/json' \
  --data '{
  "purchasedOn": "2023-11-07T05:31:56Z",
  "originalTransaction": {
    "grossAmount": 123,
    "currencyId": "<string>",
    "isExpenseAbroad": true,
    "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": "<string>"
    }
  ],
  "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>"
  }
}'
{
  "data": {
    "id": 2,
    "purchasedOn": "2023-11-07T05:31:56Z",
    "originalTransaction": {
      "grossAmount": 123,
      "currencyId": "<string>",
      "isExpenseAbroad": true,
      "currency": {
        "id": "<string>",
        "name": "<string>",
        "url": "<string>"
      }
    },
    "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": "<string>"
      }
    ],
    "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>"
    }
  }
}

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.

​
expenseNatureId
integer
required

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

Required range: x >= 1
​
originalTransaction
object

Expense amount in original currency.

​
mileage
object | null

Additional information when the expense type is mileage.

​
quantity
integer
default:1

The quantity when the expense type is 'Quantity'.

Required range: x >= 1
​
attendees
object | null

Additional information when the expense type is 'Invitation'.

​
axisSections
object[] | null

Axis sections values.

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 original receipt (PDF file, image, ...).

An expense's receipt.

​
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
​
ownerId
integer

Unique identifier of the user that made this expense.

​
paymentMethodId
enum<number>

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