# Create Order

A post of the Order Request for the ERP or OMS,Read more about the how to implement a receiver here

Endpoint: POST /webhooks
Version: 4.0

## Request fields (*/*):

  - `AdditionalInfo` (array)
    Client specific information on the order

  - `AdditionalInfo.Code` (string)
    Configurable identifier in Norce Commerce. This has erroneous behaviour.

  - `AdditionalInfo.Code2` (string)
    Configurable identifier in Norce Commerce.

  - `AdditionalInfo.Id` (integer)
    Norce Commerce internal id for the info type (use code instead)

  - `AdditionalInfo.Value` (string)
    The value set to the item from an integrated system to Norce Commerce.

  - `BillTo` (object)
    Represents customer, either a person or a company.

  - `BillTo.Company` (object)
    Represents a company.

  - `BillTo.Company.AdditionalInfo` (array)
    Always null, deprecated.

  - `BillTo.Company.Addresses` (array)
    Always null, deprecated.

  - `BillTo.Company.Addresses.Box` (string)
    Box information. Max length: 100

  - `BillTo.Company.Addresses.CareOf` (string)
    Care of information. Max length: 100

  - `BillTo.Company.Addresses.City` (string)
    City. Max length: 50

  - `BillTo.Company.Addresses.Country` (string)
    Country code in ISO 3166-1 alpha-2 format, e.g. SE, BY. Max length: 2

  - `BillTo.Company.Addresses.Line1` (string)
    First line of address. Max length: 100

  - `BillTo.Company.Addresses.Line2` (string)
    Second line of address. Max length: 100

  - `BillTo.Company.Addresses.Region` (string)
    Region. Max length: 50

  - `BillTo.Company.Addresses.Type` (string)
    Always null. Deprecated

  - `BillTo.Company.Addresses.ZipCode` (string)
    Zip code. Max length: 50

  - `BillTo.Company.Code` (string)
    Company code. If exists the company is already in ERP. Max length: 50

  - `BillTo.Company.DeliveryCodeLimit` (boolean)
    Always false, deprecated.

  - `BillTo.Company.DeliveryCodes` (array)
    Always null, deprecated.

  - `BillTo.Company.Email` (string)
    Always null, deprecated.

  - `BillTo.Company.Fax` (string)
    Always null, deprecated.

  - `BillTo.Company.IsActive` (boolean)
    Always false, deprecated.

  - `BillTo.Company.Name` (string)
    Company name. Max length: 100

  - `BillTo.Company.PaymentCodeLimit` (boolean)
    Always false, decprecated.

  - `BillTo.Company.PaymentCodes` (array)
    Always null, deprecated.

  - `BillTo.Company.Phone` (string)
    Always null, deprecated.

  - `BillTo.Company.PriceListCodes` (array)
    Always null, deprecated.

  - `BillTo.Company.PriceListLimit` (boolean)
    Always false, deprecated.

  - `BillTo.Company.VatNo` (string)
    VAT number. Max length: 50

  - `BillTo.Person` (object)
    Represents information about person related to an order.

  - `BillTo.Person.Address` (object)
    Represents person or company address.

  - `BillTo.Person.CellPhone` (string)
    Mobile phone number. Max length: 50

  - `BillTo.Person.CompanyCode` (string)
    Always null, deprecated.

  - `BillTo.Person.CustomerCode` (string)
    Customer code. If exists the person is already in ERP. Max length: 50

  - `BillTo.Person.Email` (string)
    Personal email. Max length: 255

  - `BillTo.Person.FirstName` (string)
    Person name. Max length: 50

  - `BillTo.Person.IsActive` (boolean)
    Deprecated

  - `BillTo.Person.JobTitle` (string)
    Person job title. Max length: 10

  - `BillTo.Person.LastName` (string)
    Person surname. Max length: 50

  - `BillTo.Person.PrivatePhone` (string)
    Private phone number. Max length: 50

  - `BillTo.Person.SSN` (string)
    Social security number. Max length: 50

  - `BillTo.Person.WorkPhone` (string)
    Work phone number. Max length: 50

  - `ClientOrderRef` (string)
    Usually weborder number (basket id in Norce Commerce). For orders from external source this is their number. Max length: 50

  - `CurrencyCode` (string)
    Currency code in ISO 4217 format, e.g. "SEK", "EUR", "USD". Max length: 3

  - `CustomerOrderComment` (string)
    Comment field

  - `CustomerOrderRef` (string)
    Buyers reference, usually added in the checkout for B2B orders. Max length: 50

  - `Discounts` (array)
    List of order discounts that are not represented on order lines. Not commonly used.

  - `Discounts.Amount` (number)
    Discount amount.

  - `Discounts.Code` (string)
    Discount code. Used for discount matching in Norce Commerce.

  - `Discounts.Type` (string)
    Discount type

  - `DoHold` (boolean)
    True if web solution thinks that this order should be manually validated before processed

  - `ErpOrderNo` (string)
    Usually empty. If exists this is a suggestion from web solution which order number the order should have in ERP. Max length: 50

  - `Fees` (array)
    Collection of fees on the order. Not commonly used, the fees are mostly implemented as order items with TypeGroup "Fee".

  - `Fees.Amount` (number)
    Fee amount.

  - `Fees.Description` (string)
    Fee description.

  - `Fees.Type` (integer)
    Fee type.0 = Shipping1 = Invoice

  - `Fees.VatRate` (number)
    VAT in percent.

  - `Header` (object)
    Header information about order.

  - `Header.ApplicationKey` (string)
    Application from where the order is created.

  - `Items` (array)
    Collection of order rows. Other than the articles this collection can also contain fees such as freight.

  - `Items.Discount` (number, required)
    Discount

  - `Items.LineNo` (integer, required)
    Norce Commerce generated row identifier. Unique within the order.

  - `Items.PartNo` (string, required)
    Article number (Part No) in Norce Commerce.

  - `Items.Quantity` (integer, required)
    Number of items ordered.

  - `Items.Quantity2` (number, required)
    Item quantity for non-integer values.

  - `Items.Type` (string, required)
    Type of product.
    Enum: "Undefined", "ErpStandard", "Refurbished", "Freight", "Insurance", "GiftCertificate", "Bid", "Download", "Structure", "Invoice", "Demo", "Service", "Installation", "Accumulation", "Standard", "StandardAfterCreated", "Donation", "Brand", "EnvironmentalFee", "PackingFee"

  - `Items.TypeGroup` (string, required)
    Product type group.
    Enum: "Undefined", "Physical", "Virtual", "Fee", "Service", "AddedFee"

  - `Items.UnitPrice` (number, required)
    Sale price for one item only excluding VAT (to get the row amount you multiply with quantity).

  - `Items.UnitPriceOriginal` (number, required)
    Sale price before discounts.

  - `Items.UnitVat` (number, required)
    VAT amount for one item (to get the row VAT multiply with quantity).

  - `Items.UnitPriceOriginalVat` (number)
    VAT amount for one item before discounts (to get the row VAT multiply with quantity).

  - `Items.VatRate` (number, required)
    VAT in percent

  - `Items.AdditionalInfo` (array)
    Client specific information on order item.

  - `Items.Comment` (string)
    Row comment.

  - `Items.Description` (string)
    Product description (ERP name in Norce Commerce).

  - `Items.ErpPartNo` (string)
    Article number in ERP (usually same as PartNo, different for SKU type 13 'Accumulation').

  - `Items.InternalProductId` (integer)
    Internal product id in Norce Commerce.

  - `Items.ParentLineNo` (integer)
    Exists if the row is a child to another row, e.g. in case of service articles or items in a package/bundle.

  - `Items.PriceListNo` (integer)
    Price list from which the price is derived.

  - `Items.PriceLists` (array)
    All price lists that the unit price original is based on. This is a list of all pricelists in the hierarchy.

  - `Items.PriceLists.IsActive` (boolean)
    Sets item in price list to active or inactive.

  - `Items.PriceLists.IsStandardPriceList` (boolean)
    Determines if price list is standard.

  - `Items.PriceLists.PriceListName` (string)
    Name of price list. Max length: 50

  - `Items.PriceLists.QtyBreak` (integer)
    Threshold value for applying price list based on item quantity.

  - `Items.PriceLists.UnitPrice` (number)
    Sale price for one item only, excluding VAT.

  - `Items.PriceLists.UnitPriceVat` (number)
    VAT amount for one item only, excluding discounts.

  - `Items.Promotions` (array)
    List of all promotions applied to the order item.

  - `Items.Promotions.AppliedAmount` (number)
    Amount applied to the order item from this promotion.

  - `Items.Promotions.DiscountCode` (string)
    External code for the promotion (if configured in Norce Commerce). Max length: 50

  - `Items.Promotions.Id` (integer)
    Norce Commerce internal id for the promotion.

  - `Items.Promotions.Name` (string)
    Name of the promotion. Max length: 255

  - `Items.UnitOfMeasure` (string)
    Unit of measurement, e.g. pieces, mm, g.

  - `OrderType` (integer)
    Order type:1 = Order3 = Subscription/Recurring order5 = External order

  - `Payments` (array)
    An order can have several payments. Usually this is only one, but sometime there are an additional payment method like giftcard or a voucher.

  - `Payments.PaymentCode` (integer, required)
    Payment code. Used for payment matching.

  - `Payments.PaymentMethodCode` (string, required)
    Payment method that should be sent in to the ERP, the code is configurable in Norce Commerce.

  - `Payments.PaymentRef` (string, required)
    Transaction identifier from 3rd party, like payment service provider.

  - `Payments.AdditionalInfo` (array)
    3rd party specific information abount payment (client and PSP decides what this can contain).

  - `Payments.Amount` (number)
    Amount paid or reserved including VAT after rounding rules.

  - `Payments.PaymentName` (string)
    Name of the payment selected at the provider, e.g. "Card", "BankAccount", "Swish". Names are PSP dependent.

  - `ReferId` (integer)
    If order is created from a referral like an ad

  - `SalesContactCode` (string)
    Code of sales contact if a sales rep should be marked as seller. Max length: 50

  - `SalesContactDivision` (string)
    Code of sales department if a sales dep should be marked as seller. Max length: 50

  - `SellTo` (object)
    Represents customer, either a person or a company.

  - `ShipTo` (object)
    Represents customer, either a person or a company.

  - `ShippingAdvice` (object)
    Represents order shipping information

  - `ShippingAdvice.DeliveryMethodCode` (string)
    Delivery method sent to ERP, configurable in Norce Commerce

  - `ShippingAdvice.DoSMSNotify` (boolean)
    True if buyer expects SMS notifications when delivery is ready.

  - `ShippingAdvice.IsComplete` (boolean)
    True if it is expected that the order is shipped only once, no partial deliveries.

  - `ShippingAdvice.IsFeeChargedOnce` (boolean)
    True if it is expected that the freight fee should be charged one time even if order is delivered in several dispatches.

  - `ShippingAdvice.PickupStore` (object)
    Represents pickup store for an order

  - `ShippingAdvice.PickupStore.AdditionalInfo` (array)
    3rd party specific information on pickup point (client and transporter decides what this can contain).

  - `ShippingAdvice.PickupStore.Code` (string)
    Transporter code for store.

  - `ShippingAdvice.PickupStore.IsDropPoint` (boolean)
    Determines if store is pick up point.

  - `ShippingAdvice.PickupStore.Name` (string)
    Store name

  - `ShippingAdvice.ShipAdvisorOrderCode` (string)
    Code of the order from the shipping advisor (if Norce Commerce has integration to it).

  - `ShippingAdvice.TmsReference` (string)
    Shipping reference from PSP or other TMS if available.

  - `Source` (string)
    Order source. Should be WEB for all orders created from client web sites.

  - `SubmitDate` (string)
    Timestamp when order was created in Norce Commerce.

## Response 200 fields (*/*):

  - `HasErpOrderNo` (boolean, required)
    True if ErpOrder number is provided.

  - `StatusCode` (string, required)
    Order response status. Allowed values are "OK" or "Failed". Max length: 50
    Enum: "OK", "Failed"

  - `Description` (string)
    Use this for a more information if status code is failed. Max length: 255

  - `ErpOrderNo` (string)
    Order number from the ERP, if available. Can be sent in with SendOrderStatus as well. Max length: 50