Accept the suggestions

{
  "id": "ad8f0b9c-4b1e-4e0e-8b9c-4b1e4e0e8b9c",
  "suggestedInvoice": {
    "id": "00000000-0000-0000-0000-000000000000",
    "customer": {
      "id": "00000000-0000-0000-0000-000000000000",
      "customerNumber": "CUSTOMER-000",
      "timeZone": "Europe/Berlin",
      "firstName": "John",
      "lastName": "Doe",
      "currencyCode": "EUR",
      "companyName": "Acme Inc.",
      "datevId": "123456789",
      "status": "STATUS_ACTIVE"
    },
    "paymentMethod": {
      "id": "c1a2b3c4-d5e6-4f7a-8b9b-0c1d2e3f4a5b",
      "default": true,
      "status": "active",
      "enabled": true,
      "name": "Visa (4242)",
      "creationDate": "2024-01-15T10:30:00+00:00",
      "expirationDate": "2026-12-31T23:59:59+00:00",
      "card": {
        "brand": "Visa",
        "last4": "4242",
        "expMonth": 12,
        "expYear": 2022,
        "cardHolder": "Max Mustermann"
      },
      "sepaDebit": {
        "iban": "DE8937*********3232",
        "bic": "COBADEFFXXX",
        "mandateReference": "MNDT-2021-123456",
        "signingDate": "2021-01-01T00:00:00+00:00"
      },
      "paypal": {
        "email": "max@mustermann.de",
        "billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
      }
    },
    "type": "TYPE_INVOICE",
    "currencyCode": "EUR",
    "number": "RE-0000000001",
    "finalizationDate": "2023-11-07T05:31:56Z",
    "dueDate": "2023-11-07T05:31:56Z",
    "dunningLevel": 123,
    "dunningStatus": "none",
    "payDate": "2023-11-07T05:31:56Z",
    "invoiceAddress": "<unknown>",
    "internalNote": "This invoice is with a special discount.",
    "netAmount": {},
    "grossAmount": {},
    "taxAmount": {},
    "customFields": {
      "field1": "value1",
      "field2": "value2"
    },
    "unpaidAmount": {}
  },
  "suggestedCustomer": {
    "id": "00000000-0000-0000-0000-000000000000",
    "customerNumber": "CUSTOMER-000",
    "timeZone": "Europe/Berlin",
    "firstName": "John",
    "lastName": "Doe",
    "currencyCode": "EUR",
    "companyName": "Acme Inc.",
    "datevId": "123456789",
    "status": "STATUS_ACTIVE"
  },
  "valueDate": "2023-11-07T05:31:56Z",
  "bookingDate": "2023-11-07T05:31:56Z",
  "paymentDate": "2023-11-07T05:31:56Z",
  "usageDescription": "Kundennummer 1234567890 Rechnung 1234567890",
  "endToEndId": "1234567890",
  "counterParty": {
    "id": "ad8f0b9c-4b1e-4e0e-8b9c-4b1e4e0e8b9c",
    "alias": "Girokonto",
    "iban": "DE12500105170648489890",
    "bic": "PBNKDEFFXXX",
    "accountHolder": "Max Mustermann",
    "bankName": "Commerzbank"
  },
  "amount": {},
  "fee": {},
  "receivedAt": "2023-11-07T05:31:56Z",
  "bookedAt": "2023-11-07T05:31:56Z",
  "mandateId": "MAN1234567890",
  "source": "klarna",
  "type": "debit",
  "transactionCode": "RCDT",
  "assignments": [
    {
      "id": "ad8f0b9c-4b1e-4e0e-8b9c-4b1e4e0e8b9c",
      "invoice": {
        "id": "00000000-0000-0000-0000-000000000000",
        "customer": {
          "id": "00000000-0000-0000-0000-000000000000",
          "customerNumber": "CUSTOMER-000",
          "timeZone": "Europe/Berlin",
          "firstName": "John",
          "lastName": "Doe",
          "currencyCode": "EUR",
          "companyName": "Acme Inc.",
          "datevId": "123456789",
          "status": "STATUS_ACTIVE"
        },
        "paymentMethod": {
          "id": "c1a2b3c4-d5e6-4f7a-8b9b-0c1d2e3f4a5b",
          "default": true,
          "status": "active",
          "enabled": true,
          "name": "Visa (4242)",
          "creationDate": "2024-01-15T10:30:00+00:00",
          "expirationDate": "2026-12-31T23:59:59+00:00",
          "card": {
            "brand": "Visa",
            "last4": "4242",
            "expMonth": 12,
            "expYear": 2022,
            "cardHolder": "Max Mustermann"
          },
          "sepaDebit": {
            "iban": "DE8937*********3232",
            "bic": "COBADEFFXXX",
            "mandateReference": "MNDT-2021-123456",
            "signingDate": "2021-01-01T00:00:00+00:00"
          },
          "paypal": {
            "email": "max@mustermann.de",
            "billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
          }
        },
        "type": "TYPE_INVOICE",
        "currencyCode": "EUR",
        "number": "RE-0000000001",
        "finalizationDate": "2023-11-07T05:31:56Z",
        "dueDate": "2023-11-07T05:31:56Z",
        "dunningLevel": 123,
        "dunningStatus": "none",
        "payDate": "2023-11-07T05:31:56Z",
        "invoiceAddress": "<unknown>",
        "internalNote": "This invoice is with a special discount.",
        "netAmount": {},
        "grossAmount": {},
        "taxAmount": {},
        "customFields": {
          "field1": "value1",
          "field2": "value2"
        },
        "unpaidAmount": {}
      },
      "transaction": {
        "id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
        "type": "payment",
        "status": "new",
        "description": "Payment for invoice #123",
        "documentNumber": "123456789",
        "currencyCode": "EUR",
        "amount": 500,
        "refundedAmount": 123,
        "chargedAmount": 500,
        "feeAmount": 50,
        "createdAt": "2023-11-07T05:31:56Z",
        "paidAt": "2023-11-07T05:31:56Z"
      },
      "amount": {},
      "fee": {},
      "matchedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "unassignedAmount": {}
}

PUT

payment

bank-account-transactions

accept-suggestions

{
  "id": "ad8f0b9c-4b1e-4e0e-8b9c-4b1e4e0e8b9c",
  "suggestedInvoice": {
    "id": "00000000-0000-0000-0000-000000000000",
    "customer": {
      "id": "00000000-0000-0000-0000-000000000000",
      "customerNumber": "CUSTOMER-000",
      "timeZone": "Europe/Berlin",
      "firstName": "John",
      "lastName": "Doe",
      "currencyCode": "EUR",
      "companyName": "Acme Inc.",
      "datevId": "123456789",
      "status": "STATUS_ACTIVE"
    },
    "paymentMethod": {
      "id": "c1a2b3c4-d5e6-4f7a-8b9b-0c1d2e3f4a5b",
      "default": true,
      "status": "active",
      "enabled": true,
      "name": "Visa (4242)",
      "creationDate": "2024-01-15T10:30:00+00:00",
      "expirationDate": "2026-12-31T23:59:59+00:00",
      "card": {
        "brand": "Visa",
        "last4": "4242",
        "expMonth": 12,
        "expYear": 2022,
        "cardHolder": "Max Mustermann"
      },
      "sepaDebit": {
        "iban": "DE8937*********3232",
        "bic": "COBADEFFXXX",
        "mandateReference": "MNDT-2021-123456",
        "signingDate": "2021-01-01T00:00:00+00:00"
      },
      "paypal": {
        "email": "max@mustermann.de",
        "billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
      }
    },
    "type": "TYPE_INVOICE",
    "currencyCode": "EUR",
    "number": "RE-0000000001",
    "finalizationDate": "2023-11-07T05:31:56Z",
    "dueDate": "2023-11-07T05:31:56Z",
    "dunningLevel": 123,
    "dunningStatus": "none",
    "payDate": "2023-11-07T05:31:56Z",
    "invoiceAddress": "<unknown>",
    "internalNote": "This invoice is with a special discount.",
    "netAmount": {},
    "grossAmount": {},
    "taxAmount": {},
    "customFields": {
      "field1": "value1",
      "field2": "value2"
    },
    "unpaidAmount": {}
  },
  "suggestedCustomer": {
    "id": "00000000-0000-0000-0000-000000000000",
    "customerNumber": "CUSTOMER-000",
    "timeZone": "Europe/Berlin",
    "firstName": "John",
    "lastName": "Doe",
    "currencyCode": "EUR",
    "companyName": "Acme Inc.",
    "datevId": "123456789",
    "status": "STATUS_ACTIVE"
  },
  "valueDate": "2023-11-07T05:31:56Z",
  "bookingDate": "2023-11-07T05:31:56Z",
  "paymentDate": "2023-11-07T05:31:56Z",
  "usageDescription": "Kundennummer 1234567890 Rechnung 1234567890",
  "endToEndId": "1234567890",
  "counterParty": {
    "id": "ad8f0b9c-4b1e-4e0e-8b9c-4b1e4e0e8b9c",
    "alias": "Girokonto",
    "iban": "DE12500105170648489890",
    "bic": "PBNKDEFFXXX",
    "accountHolder": "Max Mustermann",
    "bankName": "Commerzbank"
  },
  "amount": {},
  "fee": {},
  "receivedAt": "2023-11-07T05:31:56Z",
  "bookedAt": "2023-11-07T05:31:56Z",
  "mandateId": "MAN1234567890",
  "source": "klarna",
  "type": "debit",
  "transactionCode": "RCDT",
  "assignments": [
    {
      "id": "ad8f0b9c-4b1e-4e0e-8b9c-4b1e4e0e8b9c",
      "invoice": {
        "id": "00000000-0000-0000-0000-000000000000",
        "customer": {
          "id": "00000000-0000-0000-0000-000000000000",
          "customerNumber": "CUSTOMER-000",
          "timeZone": "Europe/Berlin",
          "firstName": "John",
          "lastName": "Doe",
          "currencyCode": "EUR",
          "companyName": "Acme Inc.",
          "datevId": "123456789",
          "status": "STATUS_ACTIVE"
        },
        "paymentMethod": {
          "id": "c1a2b3c4-d5e6-4f7a-8b9b-0c1d2e3f4a5b",
          "default": true,
          "status": "active",
          "enabled": true,
          "name": "Visa (4242)",
          "creationDate": "2024-01-15T10:30:00+00:00",
          "expirationDate": "2026-12-31T23:59:59+00:00",
          "card": {
            "brand": "Visa",
            "last4": "4242",
            "expMonth": 12,
            "expYear": 2022,
            "cardHolder": "Max Mustermann"
          },
          "sepaDebit": {
            "iban": "DE8937*********3232",
            "bic": "COBADEFFXXX",
            "mandateReference": "MNDT-2021-123456",
            "signingDate": "2021-01-01T00:00:00+00:00"
          },
          "paypal": {
            "email": "max@mustermann.de",
            "billingAgreementId": "I-1J5gqz2eZvKYlo2C2X2X2X2X"
          }
        },
        "type": "TYPE_INVOICE",
        "currencyCode": "EUR",
        "number": "RE-0000000001",
        "finalizationDate": "2023-11-07T05:31:56Z",
        "dueDate": "2023-11-07T05:31:56Z",
        "dunningLevel": 123,
        "dunningStatus": "none",
        "payDate": "2023-11-07T05:31:56Z",
        "invoiceAddress": "<unknown>",
        "internalNote": "This invoice is with a special discount.",
        "netAmount": {},
        "grossAmount": {},
        "taxAmount": {},
        "customFields": {
          "field1": "value1",
          "field2": "value2"
        },
        "unpaidAmount": {}
      },
      "transaction": {
        "id": "ad8f1c2c-3b1c-4b0a-8b0a-0b0b0b0b0b0b",
        "type": "payment",
        "status": "new",
        "description": "Payment for invoice #123",
        "documentNumber": "123456789",
        "currencyCode": "EUR",
        "amount": 500,
        "refundedAmount": 123,
        "chargedAmount": 500,
        "feeAmount": 50,
        "createdAt": "2023-11-07T05:31:56Z",
        "paidAt": "2023-11-07T05:31:56Z"
      },
      "amount": {},
      "fee": {},
      "matchedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "unassignedAmount": {}
}

Autorisierungen

Authorization

string

header

erforderlich

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Antwort

BankAccountTransaction resource updated

string

read-only

Unique identifier of the bank account

Beispiel:

"ad8f0b9c-4b1e-4e0e-8b9c-4b1e4e0e8b9c"

suggestedInvoice

object | null

Show child attributes

suggestedCustomer

object | null

Show child attributes

valueDate

string<date-time>

bookingDate

string<date-time>

paymentDate

string<date-time>

usageDescription

string

Beispiel:

"Kundennummer 1234567890 Rechnung 1234567890"

endToEndId

string | null

Beispiel:

"1234567890"

counterParty

object | null

Show child attributes

amount

object

fee

object

read-only

status

enum<string>

Verfügbare Optionen:

STATUS_RECEIVED,

STATUS_BOOKED,

STATUS_MANUAL_MATCHING_REQUIRED,

STATUS_IGNORED,

outstanding_amount,

suggestions_available

receivedAt

string<date-time>

read-only

bookedAt

string<date-time> | null

read-only

mandateId

string | null

read-only

Beispiel:

"MAN1234567890"

source

enum<string>

read-only

The source of the bank account transaction.

Verfügbare Optionen:

klarna

Beispiel:

"klarna"

type

enum<string>

The type of the bank account transaction.

Verfügbare Optionen:

debit,

credit

Beispiel:

"debit"

transactionCode

string | null

The transaction code as defined in ISO 20022. See: https://www.iso20022.org/sites/default/files/2020-08/BTC_ExternalCodeListDescription_31Aug2020.doc

Beispiel:

"RCDT"

assignments

object[]

read-only

All assignments to invoices and their transactions. Can be one or multiple, if the bank transaction was split into multiple invoices. Use case: A customer pays multiple invoices with one bank transaction.

Show child attributes

unassignedAmount

object

read-only

The amount that is not assigned to any invoice or transaction. Can be negative if the bank transaction is assigned to invoices and transactions with a higher amount than the bank transaction amount.

Assign invoices to the bank account transaction.Ignore bank account transactions.

API documentation

User

Tenant

Customer

Catalogue

Subscription

Invoice

Payment

Dunning

Offer

Checkout

Feature & Entitlement

Analytics

Accounting

Settings

Accept the suggestions

Autorisierungen

Antwort