Skip to main content
POST
/
v1
/
counterparty
Create counterparty
curl --request POST \
  --url http://localhost:3001/v1/counterparty \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[email protected]",
  "name": "John Doe",
  "description": "Supplier for monthly raw material",
  "vat": "GB123456789",
  "accountsPayableNumber": 30001,
  "accountsReceivableNumber": 10001,
  "street": "Main Street 123",
  "city": "Vienna",
  "zip": "1010",
  "country": "AT",
  "paymentTermsDays": 30,
  "skontoPercentage": 2.5,
  "skontoDays": 10,
  "defaultLedgerAccount": "0000 - Ledger Account Name",
  "paymentReminderEmails": "<string>"
}
'
{
  "email": "<string>",
  "name": "<string>",
  "description": "<string>",
  "vat": "<string>",
  "accountsPayableNumber": "22 0391919",
  "street": "<string>",
  "city": "<string>",
  "zip": "<string>",
  "country": "<string>",
  "paymentTermsDays": 123,
  "skontoPercentage": 123,
  "skontoDays": 123,
  "organization": {
    "name": "<string>",
    "slug": "<string>",
    "logoFileName": "<string>",
    "country": "<string>",
    "vatNumber": "<string>",
    "featureFlags": [
      {
        "featureName": "<string>",
        "isEnabled": true,
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      }
    ],
    "baseCurrency": "EUR",
    "paymentRunBatchBooking": true,
    "paymentRunVerificationOfPayee": true,
    "invoiceExportIncludeForeignCurrencies": true,
    "allowDirectInvoiceApproval": true,
    "allowDirectPaymentRunApproval": true,
    "customExportFormats": [
      "custom_experta"
    ],
    "autoPopulateCustomerEmailFromMetadata": true,
    "autoPopulateSupplierEmailFromMetadata": true,
    "excludedEmailDomains": "<string>",
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "inCaseOfLawCustomerId": "<string>",
    "cardCommonBookingTargetName": "<string>",
    "cardCommonBookingTargetAccountsPayableNumber": "<string>",
    "cardFxDifferenceLedgerAccount": "<string>"
  },
  "bankAccount": {
    "name": "<string>",
    "iban": "<string>",
    "bic": "<string>",
    "countryCode": "<string>",
    "address": "<string>",
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "transactions": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "amount": 123,
    "remittanceInformation": "<string>",
    "requestedExecutionDate": "2023-11-07T05:31:56Z",
    "skontoAmount": 123,
    "skontoDate": "2023-11-07T05:31:56Z",
    "ignoreSkontoDeadline": true,
    "express": true,
    "creditor": {
      "name": "<string>",
      "iban": "<string>",
      "bic": "<string>",
      "countryCode": "<string>",
      "address": "<string>",
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "debitor": {
      "name": "<string>",
      "iban": "<string>",
      "bic": "<string>",
      "countryCode": "<string>",
      "address": "<string>",
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "analysis": {
      "analysisRules": {
        "markedOk": true,
        "markedOkReason": "<string>",
        "markedOkDate": "2023-11-07T05:31:56Z",
        "value": "<string>",
        "markedOkUser": {
          "email": "<string>",
          "name": "<string>",
          "authId": "<string>",
          "role": "<string>",
          "hasPushNotification": true,
          "organization": {
            "name": "<string>",
            "slug": "<string>",
            "logoFileName": "<string>",
            "country": "<string>",
            "vatNumber": "<string>",
            "featureFlags": [
              {
                "featureName": "<string>",
                "isEnabled": true,
                "id": "<string>",
                "createdAt": "2023-11-07T05:31:56Z",
                "updatedAt": "2023-11-07T05:31:56Z"
              }
            ],
            "baseCurrency": "EUR",
            "paymentRunBatchBooking": true,
            "paymentRunVerificationOfPayee": true,
            "invoiceExportIncludeForeignCurrencies": true,
            "allowDirectInvoiceApproval": true,
            "allowDirectPaymentRunApproval": true,
            "customExportFormats": [
              "custom_experta"
            ],
            "autoPopulateCustomerEmailFromMetadata": true,
            "autoPopulateSupplierEmailFromMetadata": true,
            "excludedEmailDomains": "<string>",
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z",
            "inCaseOfLawCustomerId": "<string>",
            "cardCommonBookingTargetName": "<string>",
            "cardCommonBookingTargetAccountsPayableNumber": "<string>",
            "cardFxDifferenceLedgerAccount": "<string>"
          },
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "featureFlags": []
        },
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z"
      },
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    },
    "archived": true,
    "archivedDate": "2023-11-07T05:31:56Z",
    "archivedByUser": {
      "email": "<string>",
      "name": "<string>",
      "authId": "<string>",
      "role": "<string>",
      "hasPushNotification": true,
      "organization": {
        "name": "<string>",
        "slug": "<string>",
        "logoFileName": "<string>",
        "country": "<string>",
        "vatNumber": "<string>",
        "featureFlags": [
          {
            "featureName": "<string>",
            "isEnabled": true,
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          }
        ],
        "baseCurrency": "EUR",
        "paymentRunBatchBooking": true,
        "paymentRunVerificationOfPayee": true,
        "invoiceExportIncludeForeignCurrencies": true,
        "allowDirectInvoiceApproval": true,
        "allowDirectPaymentRunApproval": true,
        "customExportFormats": [
          "custom_experta"
        ],
        "autoPopulateCustomerEmailFromMetadata": true,
        "autoPopulateSupplierEmailFromMetadata": true,
        "excludedEmailDomains": "<string>",
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "inCaseOfLawCustomerId": "<string>",
        "cardCommonBookingTargetName": "<string>",
        "cardCommonBookingTargetAccountsPayableNumber": "<string>",
        "cardFxDifferenceLedgerAccount": "<string>"
      },
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "featureFlags": []
    },
    "paymentRun": {
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "createdById": "<string>",
      "createdByName": "<string>",
      "organizationId": "<string>",
      "sumAmount": 123,
      "sumAmountWithSkonto": 123,
      "sumBookedAmount": 123,
      "transactionCount": 123,
      "batchBooking": true
    },
    "counterparty": "<unknown>",
    "invoice": {
      "id": "<string>",
      "invoiceNumber": "<string>",
      "status": "<string>",
      "totalAmount": 123,
      "dueDate": "2023-11-07T05:31:56Z",
      "invoiceDate": "2023-11-07T05:31:56Z",
      "currency": "<string>"
    }
  },
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "apBalance": {
    "openInvoiceAmount": 123,
    "approvedOpenCreditNoteAmount": 123,
    "manualCreditAmount": 123,
    "totalAvailableCredit": 123,
    "netPayableAmount": 123,
    "remainingCreditBalance": 123,
    "scheduledBankTransferAmount": 123,
    "remainingToScheduleAmount": 123,
    "unapprovedCreditNoteAmount": 123,
    "appliedInvoiceCreditAmount": 123,
    "balancesByCurrency": [
      {
        "approvedOpenCreditNoteAmount": 123,
        "manualCreditAmount": 123,
        "totalAvailableCredit": 123,
        "appliedInvoiceCreditAmount": 123,
        "remainingCreditBalance": 123
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
email
string

The email of the counterparty.

Example:

"[email protected]"

​
name
string

Name of the counterparty.

Example:

"John Doe"

​
description
string

Description of the counterparty to.

Example:

"Supplier for monthly raw material"

​
vat
string

VAT number used in the EU if the counterparty is a company

Example:

"GB123456789"

​
accountsPayableNumber
string

Accounts payable number of the counterparty. Used in bookkeeping.

Example:

30001

​
accountsPayableMode
enum<string>

How to set the accounts payable number for this counterparty.

Available options:
AUTO,
MANUAL,
NONE
​
accountsReceivableNumber
string

Accounts receivable number of the counterparty. Used in bookkeeping.

Example:

10001

​
street
string

Street name and number of the counterparty.

Example:

"Main Street 123"

​
city
string

City of the counterparty.

Example:

"Vienna"

​
zip
string

ZIP or postal code of the counterparty.

Example:

"1010"

​
country
string

Country of the counterparty using ISO 3166-1 alpha-2 code.

Example:

"AT"

​
paymentTermsDays
number

Payment term in days

Example:

30

​
skontoPercentage
number

Early payment discount percentage

Example:

2.5

​
skontoDays
number

Days for early payment discount

Example:

10

​
defaultLedgerAccount
string

Default ledger account of the counterparty. Used in invoices.

Example:

"0000 - Ledger Account Name"

​
bankAccount
object

Bank account of the counterparty

​
paymentReminderEmails
string

Email addresses for payment reminders, separated by commas

​
cardBookingPreference
enum<string>

Default bookkeeping behavior for card-paid invoices of this counterparty.

Available options:
INVOICE_COUNTERPARTY,
ORG_CARD_COMMON

Response

​
email
string
required

The email of the counterparty.

​
name
string
required

The name of the counterparty.

​
description
string
required

The description of the counterparty.

​
vat
string
required

The EU VAT number of the counterparty.

​
accountsPayableNumber
string
required

Accounts payable number of the counterparty. Used in bookkeeping.

Example:

"22 0391919"

​
accountsPayableMode
enum<string>
required

How accounts payable number is managed for this counterparty.

Available options:
AUTO,
MANUAL,
NONE
​
street
string
required

Street name and number of the counterparty.

​
city
string
required

City of the counterparty.

​
zip
string
required

ZIP or postal code of the counterparty.

​
country
string
required

Country of the counterparty using ISO 3166-1 alpha-2 code.

​
paymentTermsDays
number
required

Payment term in days

​
skontoPercentage
number
required

Early payment discount percentage

​
skontoDays
number
required

Days for early payment discount

​
organization
object
required

The organization of the counterparty.

​
bankAccount
object
required

The bank account of the counterparty.

​
transactions
object
required

The transactions of the counterparty.

​
cardBookingPreference
enum<string>
required

Default booking preference for card-paid invoices of this counterparty.

Available options:
INVOICE_COUNTERPARTY,
ORG_CARD_COMMON
​
id
string

The unique identifier of the entity.

​
createdAt
string<date-time>

The date and time the entity was created.

​
updatedAt
string<date-time>

The date and time the entity was last updated.

​
apBalance
object

Derived AP balance for this counterparty.