ADadfin
Invoices

Get an invoice by its id

Changed on
get/invoices/{id}

Request

  • Base URL
    https://api.adfin.com/api
  • URL
    https://api.adfin.com/api/invoices/{id}
  • 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

idstring required

The id of the invoice to get the details for

Response

The Invoice data is successfully retrieved

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