Contracts

Upsert usage records for contract obligations

Changed on

Create or update usage records in batch. Items with an 'id' field are updated; items without are created. Generates revenue recognitions and invoices.

post/public/v1/contracts/{contract_id}/usage/bulk-upsert/

Request

  • Base URL: https://api.dualentry.com
  • URL: https://api.dualentry.com/public/v1/contracts/{contract_id}/usage/bulk-upsert/
  • Auth: none declared

Path parameters

contract_idinteger required

Headers

Idempotency-Keystring

Optional. A unique value (a UUID works well) identifying this operation. If the request is repeated with the same key, the original response is replayed instead of the operation running again, so a retry cannot create a duplicate record. Results are replayable for 48 hours. Reusing a key with a different request body returns 422.

Request body

Response

OK

idinteger required
contract_idinteger required
obligation_idinteger required
usage_datestring date required
quantitystring required
ratestring nullable
amountstring required
effective_ratestring required
revenue_recognition_idinteger nullable
status'draft' | 'invoiced' | 'archived' required
invoice_statusstring nullable
memostring
created_atstring date-time required
updated_atstring date-time required

Changes

  • 074797834e54Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • af0ec77e5277Revision changes
    • info

      added the new optional header request parameter Idempotency-Key