ADadfin
Invoices

Preview instalment plan for an invoice

Changed on
post/invoices/{invoiceId}/instalments/preview

Request

  • Base URL
    https://api.adfin.com/api
  • URL
    https://api.adfin.com/api/invoices/{invoiceId}/instalments/preview
  • Auth
    • OAuth 2
      Client credentials
      Token URL: https://api.staging.adfin.com/api/oauth2/token
    • or OAuth 2
      Client credentials
      Token URL: https://api.adfin.com/api/oauth2/token

Path parameters

invoiceIdstring required

Request body

totalAmountnumber

Total amount to distribute across instalments. Defaults to the invoice total if not provided.

Response

The instalment preview was generated successfully.

idstring

The internal id of the invoice

invoiceNostring

The number of the invoice. Can be empty when creating the invoice without an invoice number,but it will be automatically generated when the invoice is pushed to an accounting software. Once set, serves as a unique value that can be used as an idempotency key.

descriptionstring

Short description of the invoice

totalAmountstring

The invoice total amount. Includes tax amount, amount paid or reduced with credit notes)

taxAmountstring

The invoice tax amount.

dueAmountstring

The invoice amount due (remaining to be paid).

creditNotesAmountstring

The total amount that is credited.

dueDatestring date-time

The due date of the invoice

issueDatestring date-time

The issue date date of the invoice

creationTimestring date-time

The date the invoice was created

lastUpdatedTimestring date-time

The date the invoice was last updated

paidTimestring date-time

The date the invoice was paid

status'DRAFT' | 'UNPAID' | 'OVERDUE' | 'SCHEDULED' | 'SUBMITTED' | 'PAID' | 'VOID' | 'SETTLED'

The invoice status

statusReasonCode'MISSING_PAYER_CONTACT_DETAILS' | 'PENDING_ACTIVATION' | 'PENDING_DD_MANDATE' | 'PENDING_DD_CAPABILITY' | 'MARKED_AS_PAID' | 'WORKFLOW_COMPLETED' | 'NOTIFICATION_DELIVERY_FAILED' | 'BULK_PRUNE' | 'STALE_DRAFT_CLEANUP' | 'OTHER' | 'DIRECT_DEBIT_MANDATE_BANK_ACCOUNT_CHANGED' | 'HANDED_OVER_TO_BILLER'

The reason as predefined code why the invoice is in a certain status

statusReasonstring

Custom details on why the invoice is in a certain status

invoiceSource'FILE_UPLOAD' | 'MANUAL' | 'PR' | 'EXTERNAL' | 'SCHEDULE' | 'PLATFORM' | 'EMAIL'

The source of the invoice

itemsTaxType'EXCLUSIVE' | 'INCLUSIVE' | 'NONE'

How tax is applied to line items from the invoice

fileSource'NONE' | 'FILE_UPLOAD' | 'EMAIL' | 'EXTERNAL' | 'ADFIN' | 'PENDING_ADFIN'

The file source of invoice

creditControlStatus'AT_RISK' | 'EXPECTED' | 'CONFIRMED'

The credit control status of the invoice

workflowType'AUTO_COLLECT' | 'ON_DEMAND' | 'NONE'

The workflow type of the invoice

Changes

  • 5eb8e7e1d53cRevision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property // to the response with the status

  • 1a2e874091e2Revision changes
    • info

      added the optional property // to the response with the status