---
title: "Close bill"
method: POST
path: "/api/connector/v1/bills/close"
tags: ["Bills"]
---

# Close bill

`POST /api/connector/v1/bills/close`

Closes a bill so no further modification to it is possible. Note this operation supports [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property).

## Request body

- BillCloseParameters
  - `ClientToken` string, required — Token identifying the client application.
  - `AccessToken` string, required — Access token of the client application.
  - `Client` string, required — Name and version of the client application.
  - `EnterpriseId` string, uuid, nullable — Unique identifier of the enterprise. Required when using [Portfolio Access Tokens](https://mews-systems.gitbook.io/connector-api/concepts/multi-property), ignored otherwise.
  - `BillId` string, uuid, required — Unique identifier of the [Bill](https://mews-systems.gitbook.io/connector-api/operations/#bill) to be closed.
  - `Type` 'Receipt' | 'Invoice', required — After a bill is closed, the Bill Type is set to `Receipt` or `Invoice`. `Receipt` indicates that the bill has been fully paid and the balance is zero. `Invoice` indicates that the bill has not yet been fully paid but an invoice has been issued. Prior to closing, Bill Type should not be used.
  - `BillCounterId` string, uuid, nullable — Unique identifier of the [Counter](https://mews-systems.gitbook.io/connector-api/operations/counters/#counter) to be used for closing. Default one is used when no value is provided.
  - `FiscalMachineId` string, uuid, nullable — Unique identifier of the [Fiscal Machine](https://mews-systems.gitbook.io/connector-api/operations/devices/#device) to be used for closing. Default one is used when no value is provided.
  - `Options` BillOptionsParameters
    - `DisplayCustomer` BooleanUpdateValue, required
      - `Value` boolean — Value which is to be updated.
    - `DisplayTaxation` BooleanUpdateValue, required
      - `Value` boolean — Value which is to be updated.
  - `TaxedDate` StringUpdateValue
    - `Value` string, nullable — Value which is to be updated.
  - `DueDate` StringUpdateValue
    - `Value` string, nullable — Value which is to be updated.
  - `VariableSymbol` StringUpdateValue
    - `Value` string, nullable — Value which is to be updated.
  - `TaxIdentifier` StringUpdateValue
    - `Value` string, nullable — Value which is to be updated.
  - `AccountTaxIdentifier` StringUpdateValue
    - `Value` string, nullable — Value which is to be updated.
  - `CompanyTaxIdentifier` StringUpdateValue
    - `Value` string, nullable — Value which is to be updated.
  - `PurchaseOrderNumber` StringUpdateValue
    - `Value` string, nullable — Value which is to be updated.
  - `Notes` StringUpdateValue
    - `Value` string, nullable — Value which is to be updated.
  - `Address` AddressParameters — New address details.
    - `Line1` string, nullable — First line of the address.
    - `Line2` string, nullable — Second line of the address.
    - `City` string, nullable — The city.
    - `PostalCode` string, postal-code, nullable — Postal code.
    - `CountryCode` string, nullable — ISO 3166-1 code of the Country.
    - `CountrySubdivisionCode` string, nullable — ISO 3166-2 code of the administrative division, e.g. DE-BW
  - `AccountAddress` AddressParameters — New address details.
    - `Line1` string, nullable — First line of the address.
    - `Line2` string, nullable — Second line of the address.
    - `City` string, nullable — The city.
    - `PostalCode` string, postal-code, nullable — Postal code.
    - `CountryCode` string, nullable — ISO 3166-1 code of the Country.
    - `CountrySubdivisionCode` string, nullable — ISO 3166-2 code of the administrative division, e.g. DE-BW
  - `AssociatedAccountData` BillCloseAccountParameters[], nullable — Account data of the associated account on a bill. Currently one object is supported and only populated when the bill is closed.
    - `Id` string, uuid, required — Unique identifier of the associated account (`Customer` or `Company`) the bill is associated to.
    - `TaxIdentifier` StringUpdateValue
      - `Value` string, nullable — Value which is to be updated.
    - `Address` AddressParameters — New address details.
      - `Line1` string, nullable — First line of the address.
      - `Line2` string, nullable — Second line of the address.
      - `City` string, nullable — The city.
      - `PostalCode` string, postal-code, nullable — Postal code.
      - `CountryCode` string, nullable — ISO 3166-1 code of the Country.
      - `CountrySubdivisionCode` string, nullable — ISO 3166-2 code of the administrative division, e.g. DE-BW

## Response `200`

OK

- BillsCloseResult
  - `Bills` Bill[], required — The closed bills.
    - `Id` string, uuid, required — Unique identifier of the bill.
    - `Name` string, nullable — Name of the bill.
    - `EnterpriseId` string, uuid, required — Unique identifier of the `Enterprise`.
    - `AccountId` string, uuid, required — Unique identifier of the account (`Customer` or `Company`) the bill is issued to.
    - `AccountType` 'Company' | 'Customer', required — A discriminator specifying the account type, e.g. `Customer` or `Company` Company Customer
    - `CustomerId` string, uuid, nullable — Unique identifier of the `Customer` the bill is issued to.
    - `CompanyId` string, uuid, nullable — Unique identifier of the `Company` specified in `CompanyDetails` or the `Company` the bill is issued to.
    - `AssociatedAccountIds` string[], nullable, required — Unique identifiers of the `Customers` or `Companies` that are associated to the bill.
    - `CounterId` string, uuid, nullable — Unique identifier of the bill `Counter`.
    - `State` 'Open' | 'Closed', required — Whether the bill is `Open` or `Closed`.
    - `Type` 'Receipt' | 'Invoice', required — After a bill is closed, the Bill Type is set to `Receipt` or `Invoice`. `Receipt` indicates that the bill has been fully paid and the balance is zero. `Invoice` indicates that the bill has not yet been fully paid but an invoice has been issued. Prior to closing, Bill Type should not be used.
    - `Number` string, nullable — Number of the bill.
    - `VariableSymbol` string, nullable — Variable symbol of the bill.
    - `CreatedUtc` string, date-time, required — Date and time of the bill creation in UTC timezone in ISO 8601 format.
    - `IssuedUtc` string, date-time, nullable — Date and time of the bill issuance in UTC timezone in ISO 8601 format.
    - `TaxedUtc` string, date-time, nullable — Taxation date of the bill in UTC timezone in ISO 8601 format.
    - `PaidUtc` string, date-time, nullable — Date when the bill was paid in UTC timezone in ISO 8601 format.
    - `DueUtc` string, date-time, nullable — Bill due date and time in UTC timezone in ISO 8601 format.
    - `LastReminderDateUtc` string, date-time, nullable — Date and time when an email reminder to pay an invoice was last sent, in UTC timezone in ISO 8601 format.
    - `UpdatedUtc` string, date-time, required — Date and time when the bill was last updated, in UTC timezone in ISO 8601 format.
    - `PurchaseOrderNumber` string, nullable — Unique number of the purchase order from the buyer.
    - `Notes` string, nullable — Additional notes.
    - `Options` BillOptions — Options of the bill.
      - `DisplayCustomer` boolean — Display customer information on a bill.
      - `DisplayTaxation` boolean — Display taxation detail on a bill.
      - `TrackReceivable` boolean — Tracking of payments is enabled for bill, only applicable for `BillType` of `Invoice`.
      - `DisplayCid` boolean — Display CID number on bill, only applicable for `BillType` of `Invoice`.
      - `Rebated` boolean — Whether the bill is rebated (both fully or partially).
    - `Revenue` AccountingItem[], nullable, required
      - `Id` string, uuid
      - `AccountId` string, uuid
      - `CustomerId` string, uuid, nullable
      - `OrderId` string, uuid, nullable
      - `ServiceId` string, uuid, nullable
      - `ProductId` string, uuid, nullable
      - `BillId` string, uuid, nullable
      - `InvoiceId` string, uuid, nullable
      - `AccountingCategoryId` string, uuid, nullable
      - `CreditCardId` string, uuid, nullable
      - `Type` string, nullable
      - `SubType` string, nullable
      - `Name` string, nullable
      - `Notes` string, nullable
      - `ConsumptionUtc` string, nullable
      - `ClosedUtc` string, nullable
      - `State` string, nullable
      - `SubState` string, nullable
      - `Amount` ExtendedAmount
        - `Currency` string, currency, required — ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency).
        - `NetValue` number, double, required — Net value without taxes.
        - `GrossValue` number, double, required — Gross value including all taxes.
        - `TaxValues` TaxValue[], required — The tax values applied.
          - `Code` string, nullable — Code corresponding to tax type.
          - `Value` number, double, required — Amount of tax applied.
        - `Breakdown` TaxBreakdown, required
          - `Items` TaxBreakdownItem[], required — Tax breakdown items per each tax rate applied.
            - `TaxRateCode` string, nullable — Tax rate code for the item. `null` for untaxed amounts.
            - `NetValue` number, double, required — The net value that the tax is calculated from.
            - `TaxValue` number, double, required — The value of the tax.
        - `Value` number, double, nullable
        - `Net` number, double, nullable
        - `Tax` number, double, nullable
        - `TaxRate` number, double, nullable
      - `TaxExemptionReasonCode` string, nullable — Code of tax exemption reason. **Restricted!** This property is currently intended for Mews' internal usage and may be subject to change.
    - `Payments` AccountingItem[], nullable, required
      - `Id` string, uuid
      - `AccountId` string, uuid
      - `CustomerId` string, uuid, nullable
      - `OrderId` string, uuid, nullable
      - `ServiceId` string, uuid, nullable
      - `ProductId` string, uuid, nullable
      - `BillId` string, uuid, nullable
      - `InvoiceId` string, uuid, nullable
      - `AccountingCategoryId` string, uuid, nullable
      - `CreditCardId` string, uuid, nullable
      - `Type` string, nullable
      - `SubType` string, nullable
      - `Name` string, nullable
      - `Notes` string, nullable
      - `ConsumptionUtc` string, nullable
      - `ClosedUtc` string, nullable
      - `State` string, nullable
      - `SubState` string, nullable
      - `Amount` ExtendedAmount
        - `Currency` string, currency, required — ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency).
        - `NetValue` number, double, required — Net value without taxes.
        - `GrossValue` number, double, required — Gross value including all taxes.
        - `TaxValues` TaxValue[], required — The tax values applied.
          - `Code` string, nullable — Code corresponding to tax type.
          - `Value` number, double, required — Amount of tax applied.
        - `Breakdown` TaxBreakdown, required
          - `Items` TaxBreakdownItem[], required — Tax breakdown items per each tax rate applied.
            - `TaxRateCode` string, nullable — Tax rate code for the item. `null` for untaxed amounts.
            - `NetValue` number, double, required — The net value that the tax is calculated from.
            - `TaxValue` number, double, required — The value of the tax.
        - `Value` number, double, nullable
        - `Net` number, double, nullable
        - `Tax` number, double, nullable
        - `TaxRate` number, double, nullable
      - `TaxExemptionReasonCode` string, nullable — Code of tax exemption reason. **Restricted!** This property is currently intended for Mews' internal usage and may be subject to change.
    - `OrderItems` OrderItemOld[], nullable, required — The order items (consumed items such as nights or products) on the bill.
      - `Id` string, uuid, required — Unique identifier of the item.
      - `AccountId` string, uuid, required — Unique identifier of the account (for example `Customer`) the item belongs to.
      - `OrderId` string, uuid, required — Unique identifier of the order (or `Reservation` which is a special type of order) the item belongs to.
      - `BillId` string, uuid, nullable — Unique identifier of the `Bill` the item is assigned to.
      - `AccountingCategoryId` string, uuid, nullable — Unique identifier of the `AccountingCategory` the item belongs to.
      - `UnitCount` integer — Unit count of item, i.e. the number of sub-items or units, if applicable.
      - `UnitAmount` Amount, required
        - `Currency` string, currency, required — ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency).
        - `NetValue` number, double, required — Net value without taxes.
        - `GrossValue` number, double, required — Gross value including all taxes.
        - `TaxValues` TaxValue[], required — The tax values applied.
          - `Code` string, nullable — Code corresponding to tax type.
          - `Value` number, double, required — Amount of tax applied.
        - `Breakdown` TaxBreakdown, required
          - `Items` TaxBreakdownItem[], required — Tax breakdown items per each tax rate applied.
            - `TaxRateCode` string, nullable — Tax rate code for the item. `null` for untaxed amounts.
            - `NetValue` number, double, required — The net value that the tax is calculated from.
            - `TaxValue` number, double, required — The value of the tax.
      - `Amount` ExtendedAmount, required
        - `Currency` string, currency, required — ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency).
        - `NetValue` number, double, required — Net value without taxes.
        - `GrossValue` number, double, required — Gross value including all taxes.
        - `TaxValues` TaxValue[], required — The tax values applied.
          - `Code` string, nullable — Code corresponding to tax type.
          - `Value` number, double, required — Amount of tax applied.
        - `Breakdown` TaxBreakdown, required
          - `Items` TaxBreakdownItem[], required — Tax breakdown items per each tax rate applied.
            - `TaxRateCode` string, nullable — Tax rate code for the item. `null` for untaxed amounts.
            - `NetValue` number, double, required — The net value that the tax is calculated from.
            - `TaxValue` number, double, required — The value of the tax.
        - `Value` number, double, nullable
        - `Net` number, double, nullable
        - `Tax` number, double, nullable
        - `TaxRate` number, double, nullable
      - `OriginalAmount` ExtendedAmount, required
        - `Currency` string, currency, required — ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency).
        - `NetValue` number, double, required — Net value without taxes.
        - `GrossValue` number, double, required — Gross value including all taxes.
        - `TaxValues` TaxValue[], required — The tax values applied.
          - `Code` string, nullable — Code corresponding to tax type.
          - `Value` number, double, required — Amount of tax applied.
        - `Breakdown` TaxBreakdown, required
          - `Items` TaxBreakdownItem[], required — Tax breakdown items per each tax rate applied.
            - `TaxRateCode` string, nullable — Tax rate code for the item. `null` for untaxed amounts.
            - `NetValue` number, double, required — The net value that the tax is calculated from.
            - `TaxValue` number, double, required — The value of the tax.
        - `Value` number, double, nullable
        - `Net` number, double, nullable
        - `Tax` number, double, nullable
        - `TaxRate` number, double, nullable
      - `RevenueType` string, required — Revenue type of the item.
      - `CreatorProfileId` string, uuid, required — Unique identifier of the user who created the item.
      - `UpdaterProfileId` string, uuid, required — Unique identifier of the user who updated the item.
      - `CreatedUtc` string, date, required — Creation date and time of the item in UTC timezone in ISO 8601 format.
      - `UpdatedUtc` string, date, required — Last update date and time of the item in UTC timezone in ISO 8601 format.
      - `ConsumedUtc` string, date, nullable — Date and time of the item consumption in UTC timezone in ISO 8601 format.
      - `CanceledUtc` string, date, nullable — Cancellation date and time of the item in UTC timezone in ISO 8601 format.
      - `ClosedUtc` string, date, nullable — Date and time of the item bill closure in UTC timezone in ISO 8601 format.
      - `StartUtc` string, date, nullable — Start date and time of the item in UTC timezone in ISO 8601 format.
      - `AccountingState` string, required — Accounting state of the item.
      - `Data` object, required — Additional data specific to particular order item.
        - `Discriminator` 'CancellationFee' | 'Rebate' | 'Deposit' | 'ExchangeRateDifference' | 'CustomItem' | 'Surcharge' | 'SurchargeDiscount' | 'SpaceOrder' | 'ProductOrder' | 'Other' | 'TaxCorrection' | 'ResourceUpgradeFee' | 'InvoiceFee'
        - `Value` union — Based on order item discriminator or `null` for types without any additional data.
          - RebateOrderItemData
            - `RebatedItemId` string, uuid, required — Unique identifier of `OrderItem` which has been rebated by current item.
          - ProductOrderItemData
            - `ProductId` string, uuid, required — Unique identifier of the `Product`.
            - `AgeCategoryId` string, uuid, nullable — Unique identifier of the `AgeCategory`.
    - `PaymentItems` PaymentItemOld[], nullable, required — The payment items (such as cash, credit card payments or invoices) on the bill.
      - `Id` string, uuid, required — Unique identifier of the item.
      - `AccountId` string, uuid, required — Unique identifier of the account (for example `Customer`) the item belongs to.
      - `BillId` string, uuid, nullable — Unique identifier of the `Bill` the item is assigned to.
      - `AccountingCategoryId` string, uuid, nullable — Unique identifier of the `AccountingCategory` the item belongs to.
      - `Amount` ExtendedAmount, required
        - `Currency` string, currency, required — ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency).
        - `NetValue` number, double, required — Net value without taxes.
        - `GrossValue` number, double, required — Gross value including all taxes.
        - `TaxValues` TaxValue[], required — The tax values applied.
          - `Code` string, nullable — Code corresponding to tax type.
          - `Value` number, double, required — Amount of tax applied.
        - `Breakdown` TaxBreakdown, required
          - `Items` TaxBreakdownItem[], required — Tax breakdown items per each tax rate applied.
            - `TaxRateCode` string, nullable — Tax rate code for the item. `null` for untaxed amounts.
            - `NetValue` number, double, required — The net value that the tax is calculated from.
            - `TaxValue` number, double, required — The value of the tax.
        - `Value` number, double, nullable
        - `Net` number, double, nullable
        - `Tax` number, double, nullable
        - `TaxRate` number, double, nullable
      - `OriginalAmount` ExtendedAmount, required
        - `Currency` string, currency, required — ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency).
        - `NetValue` number, double, required — Net value without taxes.
        - `GrossValue` number, double, required — Gross value including all taxes.
        - `TaxValues` TaxValue[], required — The tax values applied.
          - `Code` string, nullable — Code corresponding to tax type.
          - `Value` number, double, required — Amount of tax applied.
        - `Breakdown` TaxBreakdown, required
          - `Items` TaxBreakdownItem[], required — Tax breakdown items per each tax rate applied.
            - `TaxRateCode` string, nullable — Tax rate code for the item. `null` for untaxed amounts.
            - `NetValue` number, double, required — The net value that the tax is calculated from.
            - `TaxValue` number, double, required — The value of the tax.
        - `Value` number, double, nullable
        - `Net` number, double, nullable
        - `Tax` number, double, nullable
        - `TaxRate` number, double, nullable
      - `AmountDefault` ExtendedAmount
        - `Currency` string, currency, required — ISO-4217 code of the [Currency](https://mews-systems.gitbook.io/connector-api/operations/currencies/#currency).
        - `NetValue` number, double, required — Net value without taxes.
        - `GrossValue` number, double, required — Gross value including all taxes.
        - `TaxValues` TaxValue[], required — The tax values applied.
          - `Code` string, nullable — Code corresponding to tax type.
          - `Value` number, double, required — Amount of tax applied.
        - `Breakdown` TaxBreakdown, required
          - `Items` TaxBreakdownItem[], required — Tax breakdown items per each tax rate applied.
            - `TaxRateCode` string, nullable — Tax rate code for the item. `null` for untaxed amounts.
            - `NetValue` number, double, required — The net value that the tax is calculated from.
            - `TaxValue` number, double, required — The value of the tax.
        - `Value` number, double, nullable
        - `Net` number, double, nullable
        - `Tax` number, double, nullable
        - `TaxRate` number, double, nullable
      - `Notes` string, nullable — Additional notes.
      - `SettlementId` string, nullable — Identifier of the settled payment from the external system (ApplePay/GooglePay).
      - `ConsumedUtc` string, required — Date and time of the item consumption in UTC timezone in ISO 8601 format.
      - `ClosedUtc` string, nullable — Date and time of the item bill closure in UTC timezone in ISO 8601 format.
      - `AccountingState` string, required — Accounting state of the item.
      - `State` string, required — Payment state of the item.
      - `Identifier` string, nullable — External payment identifier.
      - `Data` object, required — Additional data specific to particular payment item.
        - `Discriminator` 'CreditCard' | 'Invoice' | 'Cash' | 'Unspecified' | 'BadDebts' | 'WireTransfer' | 'ExchangeRateDifference' | 'ExchangeRoundingDifference' | 'BankCharges' | 'Cheque' | 'Other'
        - `Value` union — Based on payment item data discriminator or `null` for types without any additional data.
          - PaymentCardPaymentData
            - `PaymentCardId` string, uuid, nullable — Unique identifier of the `CreditCard`.
          - InvoicePaymentData
            - `InvoiceId` string, uuid, required — Unique identifier of the invoice `Bill`.
    - `AssigneeData` object, nullable
      - `Discriminator` 'BillCustomerData' | 'BillCompanyData' — Determines type of value.
      - `Value` union
        - BillCompanyData
          - `Id` string, nullable, required — ID of the `Company`.
          - `Address` Address
            - `Line1` string, nullable
            - `Line2` string, nullable
            - `City` string, nullable
            - `PostalCode` string, nullable
            - `SubdivisionCode` string, nullable
            - `CountryCode` string, nullable
          - `LegalIdentifiers` object, nullable — The set of `LegalIdentifiers` for the company.
          - `BillingCode` string, nullable — A unique code for Mews to list on invoices it sends to the company.
          - `Name` string, required — Name of the company.
          - `FiscalIdentifier` string, nullable — Fiscal identifier of the company.
          - `AdditionalTaxIdentifier` string, nullable — Additional tax identifier of the company.
          - `DUNS` string, nullable — DUNS (Data Universal Numbering System) number of the company.
          - `Telephone` string, nullable — Company telephone number.
          - `TaxIdentifier` string, nullable — Tax identifier of the company.
          - `InvoicingEmail` string, nullable — Invoicing email of the company.
          - `Department` string, nullable — Department of the company.
        - BillCustomerData
          - `Id` string, required — ID of the `Customer` to whom the bill was assigned.
          - `Address` Address
            - `Line1` string, nullable
            - `Line2` string, nullable
            - `City` string, nullable
            - `PostalCode` string, nullable
            - `SubdivisionCode` string, nullable
            - `CountryCode` string, nullable
          - `LegalIdentifiers` object, nullable — The set of `LegalIdentifiers` for the customer.
          - `BillingCode` string, nullable — A unique code for Mews to list on invoices it sends to the customer.
          - `LastName` string, required — Last name of the customer.
          - `FirstName` string, nullable — First name of the customer.
          - `SecondLastName` string, nullable — Second last name of the customer.
          - `TitlePrefix` 'Mister' | 'Miss' | 'Misses' — Type of the title prefix of the customer. Note that the value should not be used as-is, but localized. For example, the value `Misses` should be displayed as `Mrs.` in English and `Fr.` in German. Mister (Mr.) Miss (Ms.) Misses (Mrs.)
          - `TaxIdentifier` string, nullable — Tax identifier of the customer.
    - `OwnerData` object, nullable — Additional information about owner of the bill. Can be a `Customer` or `Company`. Persisted at the time of closing of the bill.
      - `Discriminator` 'BillCustomerData' | 'BillCompanyData' — Determines type of value.
      - `Value` union
        - BillCompanyData
          - `Id` string, nullable, required — ID of the `Company`.
          - `Address` Address
            - `Line1` string, nullable
            - `Line2` string, nullable
            - `City` string, nullable
            - `PostalCode` string, nullable
            - `SubdivisionCode` string, nullable
            - `CountryCode` string, nullable
          - `LegalIdentifiers` object, nullable — The set of `LegalIdentifiers` for the company.
          - `BillingCode` string, nullable — A unique code for Mews to list on invoices it sends to the company.
          - `Name` string, required — Name of the company.
          - `FiscalIdentifier` string, nullable — Fiscal identifier of the company.
          - `AdditionalTaxIdentifier` string, nullable — Additional tax identifier of the company.
          - `DUNS` string, nullable — DUNS (Data Universal Numbering System) number of the company.
          - `Telephone` string, nullable — Company telephone number.
          - `TaxIdentifier` string, nullable — Tax identifier of the company.
          - `InvoicingEmail` string, nullable — Invoicing email of the company.
          - `Department` string, nullable — Department of the company.
        - BillCustomerData
          - `Id` string, required — ID of the `Customer` to whom the bill was assigned.
          - `Address` Address
            - `Line1` string, nullable
            - `Line2` string, nullable
            - `City` string, nullable
            - `PostalCode` string, nullable
            - `SubdivisionCode` string, nullable
            - `CountryCode` string, nullable
          - `LegalIdentifiers` object, nullable — The set of `LegalIdentifiers` for the customer.
          - `BillingCode` string, nullable — A unique code for Mews to list on invoices it sends to the customer.
          - `LastName` string, required — Last name of the customer.
          - `FirstName` string, nullable — First name of the customer.
          - `SecondLastName` string, nullable — Second last name of the customer.
          - `TitlePrefix` 'Mister' | 'Miss' | 'Misses' — Type of the title prefix of the customer. Note that the value should not be used as-is, but localized. For example, the value `Misses` should be displayed as `Mrs.` in English and `Fr.` in German. Mister (Mr.) Miss (Ms.) Misses (Mrs.)
          - `TaxIdentifier` string, nullable — Tax identifier of the customer.
    - `CompanyDetails` BillCompanyData
      - `Id` string, nullable, required — ID of the `Company`.
      - `Address` Address
        - `Line1` string, nullable
        - `Line2` string, nullable
        - `City` string, nullable
        - `PostalCode` string, nullable
        - `SubdivisionCode` string, nullable
        - `CountryCode` string, nullable
      - `LegalIdentifiers` object, nullable — The set of `LegalIdentifiers` for the company.
      - `BillingCode` string, nullable — A unique code for Mews to list on invoices it sends to the company.
      - `Name` string, required — Name of the company.
      - `FiscalIdentifier` string, nullable — Fiscal identifier of the company.
      - `AdditionalTaxIdentifier` string, nullable — Additional tax identifier of the company.
      - `DUNS` string, nullable — DUNS (Data Universal Numbering System) number of the company.
      - `Telephone` string, nullable — Company telephone number.
      - `TaxIdentifier` string, nullable — Tax identifier of the company.
      - `InvoicingEmail` string, nullable — Invoicing email of the company.
      - `Department` string, nullable — Department of the company.
    - `AssociatedAccountData` BillAccountData[], nullable — Additional information about the associated account of the bill. Can be a `Customer` or `Company`. Persisted at the time of closing of the bill. Currently only one account can be associated with a bill, but this may be extended in future.
      - `Discriminator` 'BillCustomerData' | 'BillCompanyData', required — Determines type of value.
      - `BillCustomerData` BillCustomerData
        - `Id` string, required — ID of the `Customer` to whom the bill was assigned.
        - `Address` Address
          - `Line1` string, nullable
          - `Line2` string, nullable
          - `City` string, nullable
          - `PostalCode` string, nullable
          - `SubdivisionCode` string, nullable
          - `CountryCode` string, nullable
        - `LegalIdentifiers` object, nullable — The set of `LegalIdentifiers` for the customer.
        - `BillingCode` string, nullable — A unique code for Mews to list on invoices it sends to the customer.
        - `LastName` string, required — Last name of the customer.
        - `FirstName` string, nullable — First name of the customer.
        - `SecondLastName` string, nullable — Second last name of the customer.
        - `TitlePrefix` 'Mister' | 'Miss' | 'Misses' — Type of the title prefix of the customer. Note that the value should not be used as-is, but localized. For example, the value `Misses` should be displayed as `Mrs.` in English and `Fr.` in German. Mister (Mr.) Miss (Ms.) Misses (Mrs.)
        - `TaxIdentifier` string, nullable — Tax identifier of the customer.
      - `BillCompanyData` BillCompanyData
        - `Id` string, nullable, required — ID of the `Company`.
        - `Address` Address
          - `Line1` string, nullable
          - `Line2` string, nullable
          - `City` string, nullable
          - `PostalCode` string, nullable
          - `SubdivisionCode` string, nullable
          - `CountryCode` string, nullable
        - `LegalIdentifiers` object, nullable — The set of `LegalIdentifiers` for the company.
        - `BillingCode` string, nullable — A unique code for Mews to list on invoices it sends to the company.
        - `Name` string, required — Name of the company.
        - `FiscalIdentifier` string, nullable — Fiscal identifier of the company.
        - `AdditionalTaxIdentifier` string, nullable — Additional tax identifier of the company.
        - `DUNS` string, nullable — DUNS (Data Universal Numbering System) number of the company.
        - `Telephone` string, nullable — Company telephone number.
        - `TaxIdentifier` string, nullable — Tax identifier of the company.
        - `InvoicingEmail` string, nullable — Invoicing email of the company.
        - `Department` string, nullable — Department of the company.
    - `EnterpriseData` BillEnterpriseData — Additional information about the enterprise issuing the bill, including bank account details. Persisted at the time of closing of the bill.
      - `AdditionalTaxIdentifier` string, nullable — Enterprise additional tax identifier.
      - `CompanyName` string, nullable — Enterprise company name.
      - `BankAccount` string, nullable — Enterprise bank account.
      - `BankName` string, nullable — Enterprise bank name.
      - `Iban` string, nullable — Enterprise IBAN (International Bank Account Number).
      - `Bic` string, nullable — Enterprise BIC (Bank Identifier Code).
    - `CorrectionState` 'Bill' | 'CorrectiveBill', required — Bill (Regular bill.) CorrectiveBill (Corrective bill, i.e. the `CorrectionType` is either `Edit`, `Cancellation`, or `ReceivablePaymentsBalance`.)
    - `CorrectionType` 'Cancellation' | 'Edit' | 'CreditNote' | 'Reinstatement' | 'ReceivablePaymentsBalance' — Cancellation Edit CreditNote Reinstatement ReceivablePaymentsBalance
    - `CorrectedBillId` string, uuid, nullable — The ID of the bill that the corrective bill corrects. If the corrected bill was deleted, this field is `null`.

## Other responses

- `204` — Server has successfully fulfilled the request and there is no additional information to send back.
- `400` — Error caused by the client app, e.g. in case of malformed request or invalid identifier of a resource. In most cases, such an error signifies a bug in the client app (consumer of the API).
- `401` — Error caused by usage of invalid ClientToken, AccessToken, or you may not have the necessary permission to use the endpoint.
- `403` — Server error that should be reported to the end user of the client app. Happens for example when the server-side validation fails or when a business-logic check is violated.
- `408` — Error caused by heavy request that takes too long to process (typically tens of seconds). To get around this, request data in smaller batches. For more information, see [Request timeouts](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-timeouts)
- `429` — Error caused by too many requests sent in a given amount of time. Response contains `Retry-After` header indicating how long the user agent should wait before making a follow-up request. For more information, see [Request limits](https://mews-systems.gitbook.io/connector-api/guidelines/requests#request-limits).
- `500` — Unexpected error on the Mews side. This may be due to a software fault. If such a situation occurs, the error will be logged and the development team notified, however you can raise an issue through GitHub on our [documentation repository](https://github.com/MewsSystems/gitbook-connector-api).

---

[API](https://skmtc.net/mews/apis/connector-api.md) · [All operations](https://skmtc.net/mews/apis/connector-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mews/connector-api/versions/81933a8ff730/schema)