--- title: "Create Order" method: POST path: "/orders" tags: ["Back-end Order Creation"] --- # Create Order `POST /orders` **Purpose:** Creates an order directly from the backend without buyer interaction. **Preconditions:** - All the order related data is present **Success:** - Response Code: `HTTP 200` - Response body: `state` -> `created` - Response body: `uuid` -> ID of the created order **Attention:** This call should be used when the buyer consent is received by another channel. ## Request body - CreateOrderRequest - `amount` AmountDTO, required — The amount object with split values for net, gross and tax - `gross` number, float, required — Value greater than 0, with max. 2 decimals. It should equal to net + tax. - `net` number, float, required — Value greater than 0, with max. 2 decimals. - `tax` number, float, required — Value greater than or equal to 0, with max. 2 decimals. - `comment` string - `duration` integer, required - `external_code` string - `delivery_address` Address - `house_number` string - `street` string, required - `postal_code` string, required - `city` string, required - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 - `debtor` CreateOrderDebtorCompanyRequest, required - `merchant_customer_id` string, required - `name` string, required - `company_address` AddressStrictPostalCode, required - `house_number` string - `street` string, required - `postal_code` string, required - `city` string, required - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 - `billing_address` Address - `house_number` string - `street` string, required - `postal_code` string, required - `city` string, required - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 - `tax_id` string - `tax_number` string - `registration_court` string - `registration_number` string - `industry_sector` string - `subindustry_sector` string - `employees_number` string - `legal_form` string, required — One of the legal form codes available in the `GET /legal-forms` API endpoint. - `established_customer` boolean - `debtor_person` CreateOrderDebtorPersonRequest, required - `salutation` 'm' | 'f' - `first_name` string - `last_name` string - `phone_number` string - `email` string, email, required - `locale` string - `line_items` CreateOrderLineItemRequest[], required - `external_id` string, required - `title` string, required - `description` string - `quantity` number, required - `category` string - `brand` string - `gtin` string - `mpn` string - `product_url` string - `image_url` string - `type` string - `quantity_unit` string - `tax_rate` number, float — Tax rate of the order line. Non-negative value. The percentage value is represented with two implicit decimals and two i.e. 1900 = 19% - `total_discount_amount` number, float — Value greater than or equal to 0, with max. 2 decimals. - `unit_price` number, float — Value greater than or equal to 0, with max. 2 decimals. - `amount` AmountDTO, required — The amount object with split values for net, gross and tax - `gross` number, float, required — Value greater than 0, with max. 2 decimals. It should equal to net + tax. - `net` number, float, required — Value greater than 0, with max. 2 decimals. - `tax` number, float, required — Value greater than or equal to 0, with max. 2 decimals. - `additional_billing_emails` string[] ## Response `200` Order successfully created - Order - `external_code` string, nullable - `uuid` string, uuid - `state` 'pre_waiting' | 'authorized' | 'waiting' | 'created' | 'declined' | 'shipped' | 'partially_shipped' | 'complete' | 'canceled' - `decline_reason` 'risk_policy' | 'risk_scoring_failed' | 'debtor_not_identified' | 'debtor_address' | 'risk_scoring_failed' | 'debtor_limit_exceeded' - `amount` TaxedMoney - `gross` number, float, required — Value greater than 0, with max. 2 decimals. It should equal to net + tax. - `net` number, float, required — Value greater than 0, with max. 2 decimals. - `tax` number, float, required — Value greater than or equal to 0, with max. 2 decimals. - `unshipped_amount` TaxedMoney - `gross` number, float, required — Value greater than 0, with max. 2 decimals. It should equal to net + tax. - `net` number, float, required — Value greater than 0, with max. 2 decimals. - `tax` number, float, required — Value greater than or equal to 0, with max. 2 decimals. - `duration` integer - `created_at` string, date-time - `delivery_address` Address - `house_number` string - `street` string, required - `postal_code` string, required - `city` string, required - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 - `debtor` Debtor - `name` string - `company_address` Address - `house_number` string - `street` string, required - `postal_code` string, required - `city` string, required - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 - `billing_address` Address - `house_number` string - `street` string, required - `postal_code` string, required - `city` string, required - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 - `bank_account` BankAccount - `iban` string - `bic` string - `external_data` DebtorExternalData - `merchant_customer_id` string - `name` string - `industry_sector` string, nullable - `address` Address - `house_number` string - `street` string, required - `postal_code` string, required - `city` string, required - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 - `invoices` OrderInvoiceResponse[] - `uuid` string, uuid - `invoice_number` string, nullable - `state` string, nullable - `payout_amount` number, float, nullable - `amount` number, float - `amount_net` number, float - `amount_tax` number, float - `outstanding_amount` number, float, nullable - `pending_merchant_payment_amount` number, float, nullable - `pending_cancellation_amount` number, float, nullable - `fee_amount` number, float, nullable - `fee_rate` number, float, nullable - `due_date` string, date - `created_at` string, date - `selected_payment_method` 'bank_transfer' | 'direct_debit', nullable - `payment_methods` PaymentMethod[] - `type` 'bank_transfer' | 'direct_debit' - `data` object — Payment method details - `iban` string - `bic` string - `bank_name` string, nullable — Name of the Bank entity - `bank_giro` string, nullable — Bank giro number (Sweden only) - `sort_code` string, nullable — Bank sort code (GB only) - `account_number` string, nullable — Bank account number (GB, NL and NO) - `bank_account_owner` string — Bank account owner entity - `mandate_reference` string, nullable — Direct Debit SEPA Mandate Reference (for Direct Debit only) - `mandate_execution_date` string, date-time - `creditor_identification` string, nullable — Creditor Identification Code (for Direct Debit only) ## Other responses - `400` — Invalid Request Data - `401` — Unauthorized request or invalid credentials - `500` — Unexpected Server Error --- [API](https://skmtc.net/billie/apis/billie-direct-api.md) · [All operations](https://skmtc.net/billie/apis/billie-direct-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/billie/billie-direct-api/versions/8cce15617825/schema)