Update a billing entity | Solvimon

curl -X PATCH https://test.api.solvimon.com/v1/billing-entities/ \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "reference": "Expense_NL",
  "default_customer_country_selector": [
    "NL"
  ],
  "default_billing_currency_selector": [
    "EUR"
  ],
  "legal_name": "ExpenseIt B.V.",
  "tax_id": "NL123456789B01",
  "registered_address": {
    "line1": "Daalsesingel 51",
    "line2": "Suite 3A",
    "city": "Utrecht",
    "postal_code": "3511SW",
    "state": "Utrecht",
    "country": "NL"
  },
  "email": "info@expense.nl",
  "tax_registrations": [
    {
      "description": "Frederiksplein Amsterdam Tax Registration",
      "tax_id": "NL000099998B57",
      "registration_number": "86385879",
      "registered_address": {
        "line1": "Frederiksplein 61",
        "line2": "Floor 2",
        "city": "Amsterdam",
        "postal_code": "1017XL",
        "state": "Noord-Holland",
        "country": "NL"
      }
    }
  ]
}'

{
  "reference": "Expense_NL",
  "default_customer_country_selector": [
    "NL"
  ],
  "default_billing_currency_selector": [
    "EUR"
  ],
  "object_type": "billing_entity",
  "id": "be_7f8e9d2c-4a3b-4f1a-9c2d-123456789abc",
  "created_at": "2024-04-20T10:15:30Z",
  "status": "active",
  "timezone": "Europe/Amsterdam",
  "legal_name": "ExpenseIt B.V.",
  "tax_id": "NL123456789B01",
  "tax_ids": [
    {
      "id": "txid_001",
      "type": "VAT"
    }
  ],
  "registration_number": "12345678",
  "registered_address": {
    "line1": "Daalsesingel 51",
    "line2": "Suite 3A",
    "city": "Utrecht",
    "postal_code": "3511SW",
    "state": "Utrecht",
    "country": "NL"
  },
  "email": "info@expense.nl",
  "tax_settings": {
    "apply_local_vat_for_missing_tax_id": true
  },
  "tax_registrations": [
    {
      "id": "tr_001",
      "description": "Frederiksplein Amsterdam Tax Registration",
      "tax_id": "NL000099998B57",
      "tax_ids": [
        {
          "id": "txid_002",
          "type": "VAT"
        }
      ],
      "registration_number": "86385879",
      "registered_address": {
        "line1": "Frederiksplein 61",
        "line2": "Floor 2",
        "city": "Amsterdam",
        "postal_code": "1017XL",
        "state": "Noord-Holland",
        "country": "NL"
      }
    }
  ],
  "custom_fields": [
    {
      "id": "cf_001",
      "reference": "custom_field_1",
      "value": "Preferred Payment Method",
      "values": [
        "Credit Card",
        "Bank Transfer"
      ],
      "integration_details": {
        "payment_gateway_variant": "ADYEN",
        "id": "int_001",
        "reference": "integration_ref_001",
        "adyen": {
          "recurring_detail_reference": "recurring_12345"
        },
        "stripe": {
          "payment_method_id": "pm_1GqIC8Lz0qyl6XeWl3a1b2c3"
        }
      }
    }
  ],
  "linked_integrations": [
    {
      "id": "li_001",
      "link_details": [
        {
          "url": "https://dashboard.expenseit.nl/integrations/stripe",
          "custom_field_name": "Stripe Account"
        }
      ]
    }
  ]
}

Requires the BILLING_ENTITY.UPDATE permission.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

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

Path parameters

versionstringRequiredDefaults to 1

version

resourceIdOrReferencestringRequiredDefaults to

The ID or reference of the resource.

Request

This endpoint expects an object.

referencestringRequiredformat: "^\S+$"0-256 characters

default_customer_country_selectorlist of enumsRequired

default_billing_currency_selectorlist of enumsRequired

statusstring or nullOptional

timezonestring or nullOptional

legal_namestring or nullOptional

The legal name of the billing entity.

tax_idstring or nullOptionalformat: "^[a-zA-Z0-9\-]*"0-256 characters

The ID used for tax purposes of the billing entity.

tax_idslist of objects or nullOptional

Tax IDs used for tax purposes of the billing entity

registration_numberstring or nullOptional

The registration number of the billing entity.

registered_addressobjectOptional

The address of this tax registration, if different from the billing entity. Currently, only the address will be used for tax calculations

emailstring or nullOptionalformat: "(\S*@\S*\..*)"0-256 characters

The email address of the billing entity.

tax_settingsobjectOptional

Customise tax settings for this Billing Entity

tax_registrationslist of objects or nullOptional

Extra tax registrations for this billing entity

custom_fieldslist of objects or nullOptional

linked_integrationslist of objects or nullOptional

Response

referencestringformat: "^\S+$"0-256 characters

default_customer_country_selectorlist of enums

default_billing_currency_selectorlist of enums

object_typestring or nullRead-only

idstring or nullRead-only

created_atstring or nullRead-only

statusstring or null

timezonestring or null

legal_namestring or null

The legal name of the billing entity.

tax_idstring or nullformat: "^[a-zA-Z0-9\-]*"0-256 characters

The ID used for tax purposes of the billing entity.

tax_idslist of objects or null

Tax IDs used for tax purposes of the billing entity

registration_numberstring or null

The registration number of the billing entity.

registered_addressobject

The address of this tax registration, if different from the billing entity. Currently, only the address will be used for tax calculations

emailstring or nullformat: "(\S*@\S*\..*)"0-256 characters

The email address of the billing entity.

tax_settingsobject

Customise tax settings for this Billing Entity

tax_registrationslist of objects or null

Extra tax registrations for this billing entity

custom_fieldslist of objects or null

linked_integrationslist of objects or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

Authentication

Path parameters

Headers

Request

Response

Errors