---
title: "POST /v1/orders"
method: POST
path: "/v1/orders"
tags: ["Order"]
---

# POST /v1/orders

`POST /v1/orders`

## Request body

- Order
  - `OrderID` integer
  - `CompanyID` integer
  - `OrderPDF` File
    - `FileID` string, uuid
    - `FileName` string
    - `MimeType` string
    - `FileContent` string, byte
  - `Attachments` File[]
    - `FileID` string, uuid
    - `FileName` string
    - `MimeType` string
    - `FileContent` string, byte
  - `OrderNumber` string
  - `CustomerID` integer
  - `SupplierID` integer
  - `CounterPartyID` integer
  - `Customer` Party
    - `PartyID` integer
    - `BookYearStart` string, date-time
    - `Nr` string
    - `Name` string
    - `CommercialName` string
    - `Addresses` PartyAddress[]
      - `AddressType` string
      - `Tav` string
      - `Name` string
      - `Street` string
      - `StreetNumber` string
      - `Box` string
      - `Zipcode` string
      - `City` string
      - `CountryCode` string
      - `Phone` string
    - `Street` string
    - `StreetNumber` string
    - `Box` string
    - `Zipcode` string
    - `City` string
    - `CountryCode` string
    - `IBAN` string
    - `BIC` string
    - `Mobile` string
    - `Phone` string
    - `Fax` string
    - `Email` string
    - `Website` string
    - `Contact` string
    - `ContactFirstName` string
    - `ContactLastName` string
    - `VATNumber` string
    - `PeppolIdentifier` string
    - `RPR` string
    - `LastModified` string, date-time
    - `Created` string, date-time
    - `PartyType` 'Customer' | 'Supplier'
    - `VATLiable` boolean
    - `AccountantCode` integer
    - `GLAccountCode` integer
    - `Language` string
    - `VentilationCode` string
    - `ExternalProviderID` string
    - `ExternalProviderTC` string
    - `BankAccounts` BankAccount[]
      - `CompanyID` integer
      - `BankAccountID` integer
      - `IBAN` string
      - `BIC` string
      - `Currency` string
      - `Verified` boolean
      - `Name` string
      - `SaldoDate` string, date-time
      - `Saldo` number, double
      - `ExternalProviderID` string
      - `LogoFileID` string, uuid
      - `LogoFileUrl` string
      - `CountryCode` string
      - `CodaByINGUser` boolean
      - `BankAccountName` string
      - `BillBankReceived` boolean
    - `DefaultPaymentMethodTC` string
    - `DefaultPaid` boolean
    - `DisplayName` string
    - `DefaultTransportTypeTC` string
    - `FinancialReductionPercentageDefault` number, double
    - `FinancialReductionDaysDefault` integer
    - `DefaultExpiryOffset` integer
    - `GLDefaultExpiryOffset` integer
    - `Role` string
    - `InternalInfo` string
    - `VATDeductable` boolean
    - `DefaultReductionPercentage` number, double
    - `Identifiers` PartyIdentifier[]
      - `IdentifierType` string
      - `Identifier` string
  - `Supplier` Party
    - `PartyID` integer
    - `BookYearStart` string, date-time
    - `Nr` string
    - `Name` string
    - `CommercialName` string
    - `Addresses` PartyAddress[]
      - `AddressType` string
      - `Tav` string
      - `Name` string
      - `Street` string
      - `StreetNumber` string
      - `Box` string
      - `Zipcode` string
      - `City` string
      - `CountryCode` string
      - `Phone` string
    - `Street` string
    - `StreetNumber` string
    - `Box` string
    - `Zipcode` string
    - `City` string
    - `CountryCode` string
    - `IBAN` string
    - `BIC` string
    - `Mobile` string
    - `Phone` string
    - `Fax` string
    - `Email` string
    - `Website` string
    - `Contact` string
    - `ContactFirstName` string
    - `ContactLastName` string
    - `VATNumber` string
    - `PeppolIdentifier` string
    - `RPR` string
    - `LastModified` string, date-time
    - `Created` string, date-time
    - `PartyType` 'Customer' | 'Supplier'
    - `VATLiable` boolean
    - `AccountantCode` integer
    - `GLAccountCode` integer
    - `Language` string
    - `VentilationCode` string
    - `ExternalProviderID` string
    - `ExternalProviderTC` string
    - `BankAccounts` BankAccount[]
      - `CompanyID` integer
      - `BankAccountID` integer
      - `IBAN` string
      - `BIC` string
      - `Currency` string
      - `Verified` boolean
      - `Name` string
      - `SaldoDate` string, date-time
      - `Saldo` number, double
      - `ExternalProviderID` string
      - `LogoFileID` string, uuid
      - `LogoFileUrl` string
      - `CountryCode` string
      - `CodaByINGUser` boolean
      - `BankAccountName` string
      - `BillBankReceived` boolean
    - `DefaultPaymentMethodTC` string
    - `DefaultPaid` boolean
    - `DisplayName` string
    - `DefaultTransportTypeTC` string
    - `FinancialReductionPercentageDefault` number, double
    - `FinancialReductionDaysDefault` integer
    - `DefaultExpiryOffset` integer
    - `GLDefaultExpiryOffset` integer
    - `Role` string
    - `InternalInfo` string
    - `VATDeductable` boolean
    - `DefaultReductionPercentage` number, double
    - `Identifiers` PartyIdentifier[]
      - `IdentifierType` string
      - `Identifier` string
  - `CounterParty` Party
    - `PartyID` integer
    - `BookYearStart` string, date-time
    - `Nr` string
    - `Name` string
    - `CommercialName` string
    - `Addresses` PartyAddress[]
      - `AddressType` string
      - `Tav` string
      - `Name` string
      - `Street` string
      - `StreetNumber` string
      - `Box` string
      - `Zipcode` string
      - `City` string
      - `CountryCode` string
      - `Phone` string
    - `Street` string
    - `StreetNumber` string
    - `Box` string
    - `Zipcode` string
    - `City` string
    - `CountryCode` string
    - `IBAN` string
    - `BIC` string
    - `Mobile` string
    - `Phone` string
    - `Fax` string
    - `Email` string
    - `Website` string
    - `Contact` string
    - `ContactFirstName` string
    - `ContactLastName` string
    - `VATNumber` string
    - `PeppolIdentifier` string
    - `RPR` string
    - `LastModified` string, date-time
    - `Created` string, date-time
    - `PartyType` 'Customer' | 'Supplier'
    - `VATLiable` boolean
    - `AccountantCode` integer
    - `GLAccountCode` integer
    - `Language` string
    - `VentilationCode` string
    - `ExternalProviderID` string
    - `ExternalProviderTC` string
    - `BankAccounts` BankAccount[]
      - `CompanyID` integer
      - `BankAccountID` integer
      - `IBAN` string
      - `BIC` string
      - `Currency` string
      - `Verified` boolean
      - `Name` string
      - `SaldoDate` string, date-time
      - `Saldo` number, double
      - `ExternalProviderID` string
      - `LogoFileID` string, uuid
      - `LogoFileUrl` string
      - `CountryCode` string
      - `CodaByINGUser` boolean
      - `BankAccountName` string
      - `BillBankReceived` boolean
    - `DefaultPaymentMethodTC` string
    - `DefaultPaid` boolean
    - `DisplayName` string
    - `DefaultTransportTypeTC` string
    - `FinancialReductionPercentageDefault` number, double
    - `FinancialReductionDaysDefault` integer
    - `DefaultExpiryOffset` integer
    - `GLDefaultExpiryOffset` integer
    - `Role` string
    - `InternalInfo` string
    - `VATDeductable` boolean
    - `DefaultReductionPercentage` number, double
    - `Identifiers` PartyIdentifier[]
      - `IdentifierType` string
      - `Identifier` string
  - `OrderDate` string, date-time
  - `ExpiryDate` string, date-time
  - `OrderType` string
  - `LastModified` string, date-time
  - `Created` string, date-time
  - `OrderDirection` string
  - `OrderLines` OrderLine[]
    - `Quantity` number, double
    - `UnitPriceExcl` number, double
    - `AccountCode` integer
    - `Reference` string
    - `Description` string
    - `TotalExcl` number, double
    - `TotalVAT` number, double
    - `VATPercentage` number, double
    - `VentilationCode` string
    - `ProductID` integer
    - `Unit` string
    - `CustomFields` object
    - `ExternalProviderReferences` ExternalProviderReference[]
      - `ExternalProvider` string
      - `Category` string
      - `Value` string
      - `EntityType` string
      - `EntityID` integer
    - `InclLeading` boolean
    - `UnitPriceIncl` number, double
    - `TotalIncl` number, double
    - `AnalyticCostBearer` string
    - `AnalyticCostCenter` string
    - `ReductionPercentage` number, double
    - `DescriptionExtended` string
  - `BookingEntries` BookingEntry[]
    - `BookingEntryID` integer
    - `OrderID` integer
    - `AccountCode` integer
    - `Amount` number, double
    - `DebetOrCredit` string
    - `VAT1` integer
    - `VAT2` integer
    - `VAT3` integer
  - `Journal` string
  - `OrderTitle` string
  - `PaymentDiscountPercentage` number, double
  - `PaymentDiscountAmount` number, double
  - `PaymentDiscountDate` string, date-time
  - `VatGroups` VatGroup[]
    - `VentilationCode` string
    - `VATPercentage` number, double
    - `TotalExcl` number, double
    - `TotalVAT` number, double
    - `TotalIncl` number, double
    - `Mtvh` number, double
    - `FinancialReductionAmount` number, double
  - `VentilationCode` string
  - `TotalExcl` number, double
  - `TotalIncl` number, double
  - `TotalVAT` number, double
  - `Reference` string
  - `Tags` string[]
  - `DepartmentID` integer
  - `PaymentReference` string
  - `AboutInvoiceNumber` string
  - `Paid` boolean
  - `PaidDate` string, date-time
  - `ExternalProviderID` string
  - `ExternalProvider` string
  - `ExternalProviderReferences` ExternalProviderReference[]
    - `ExternalProvider` string
    - `Category` string
    - `Value` string
    - `EntityType` string
    - `EntityID` integer
  - `Comments` string
  - `Currency` string
  - `VatDeduction` number, double
  - `InternalInfo` string
  - `IsSent` boolean
  - `Invoiced` boolean
  - `CustomFields` object
  - `PeriodFrom` string, date-time
  - `PeriodTill` string, date-time
  - `AccountCode` integer
  - `LastReminder` string, date-time
  - `RemindersSent` integer
  - `ToPay` number, double
  - `OrderStatus` string
  - `ApprovalStatus` string
  - `Overdue` boolean
  - `DaysOverdue` integer
  - `FXRateToForeign` number, double
  - `PaymentMethod` string
  - `DeliveryDate` string, date-time
  - `ExportedToConnector` boolean
  - `PaymentLinks` PaymentLink[]
    - `ExternalProvider` string
    - `ClickUrl` string
    - `QRImageUrl` string
  - `TemplateID` integer
  - `AnalyticCostBearer` string
  - `AnalyticCostCenter` string
  - `AccountantVerificationNeeded` boolean
  - `CurrentDocumentDeliveryDetails` DocumentDeliveryDetails
    - `DocumentRefusedDate` string, date-time
    - `DocumentDeliveryDate` string, date-time
    - `DocumentDeliveryInfo` string
    - `DocumentRefusedReasonTC` string
    - `DocumentRefusedInfo` string
    - `IsDocumentDelivered` boolean
  - `Messages` OrderMessage[]
    - `Description` string
    - `FileID` string, uuid
    - `CreationDate` string, date-time
    - `TransportType` string
    - `Success` boolean
    - `Trials` integer
    - `Destination` string
    - `MessageDirection` string
  - `AdditionalDocumentReference` AdditionalDocuments[]
    - `DocumentDescription` string
    - `ID` string
    - `DocumentType` string
    - `Attachment` File
      - `FileID` string, uuid
      - `FileName` string
      - `MimeType` string
      - `FileContent` string, byte
  - `PaymentTerms` string
  - `ContractDocumentReference` ContractDocumentReference[]
    - `ID` string

## Response `200`

Save an order

- integer

---

[API](https://skmtc.dev/billit/apis/billit-api.md) · [All operations](https://skmtc.dev/billit/apis/billit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/billit/billit-api/revisions/9e12d6c1c3ff/schema)
