COMMERCE SERVICES

Shopping Service

Update buyer information

Norce Commerce Shopping v1.1 service (1.1)

Entities and methods to handle baskets and payments. The Shopping service is used to create and manage baskets, and prepare them for the checkout process. Commonly the checkout process is handled by the Norce Checkout API, only the legacy checkout process is handled here. For product or pricing data, use the Product service. For order history, use the Order service. To change or manage promotions use the Management API.

Download OpenAPI description

openapi-v1.json

openapi-v1.yaml

Servers

Playground

https://{slug}.api-se.playground.norce.tech/commerce/

Stage

https://{slug}.api-se.stage.norce.tech/commerce/

Production

https://{slug}.api-se.norce.tech/commerce/

Basket

Contains endpoints for manage baskets and their lifecycle, see more information here.

Operations

Checkout

Contains endpoints for initialized the checkout process, read more about it here. There is also the old legacy purchase endpoints, still used by older solutions and Non-PSP purchases.

Operations

Purchase a basket (extended, v2)

Request

PurchaseEx2 works as Purchase with the additional parameter paymentParameters. This method should be used when overriding the configured values for selected payment methods. See <a target="_blank" href="https://docs.norce.io/developer-portal/app-development/working-with-the-checkout-process/#purchase-and-payments">Payments</a> for more information about the checkout process.

Query

ipAddressstring

The user's ipAddress.

userAgentstring

The user agent of the user's browser.

pricelistSeedstring

(Optional) A comma separated list of internal pricelist ids to use, if any. PriceLists supplied must be valid, either from the application's public priceList or any customer or company priceLists or any valid client priceLists. For clients configured to use priceListSeed exclusively in the API only the supplied priceLists will be used. If this is not configured, the supplied priceLists will be appended to the valid priceLists. If none is supplied, the default value for the application will be used in combination with any customer or company priceLists. This applies to both configurations.

cultureCodestring

(Optional) Specifies in which language to display culture specific information. If none is supplied, value is resolved from Application.

Bodyapplication/json

Extended data object to the PSP for this purchase.

Checkoutobject or null

Used to connect a specific basket with customer information, payment and delivery options.

PaymentParametersArray of objects or null(NameValue)

General: 'test'=true to enable tests. When 'test' is used no payments will be processed for real. Payments may interpret supplied values such as cardNumber or ssn to simulate failures. Not implemented. Klarna: 'sessionId'=id. Used to provide a sessionId to Klarna payments. Not implemented. Payex and Dibs. Supported values are 'returnUrl' and 'cancelUrl'. Values should point to where the payment service should go in case of success/failure.

curl -i -X POST \
  https://customer-slug.api-se.playground.norce.tech/commerce/shopping/1.1/PurchaseEx2 \
  -H 'ApplicationId: YOUR_API_KEY_HERE' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "Checkout": {
      "Basket": {
        "Id": 0,
        "CustomerId": 0,
        "CompanyId": 0,
        "SalesContactId": 0,
        "StatusId": 0,
        "CurrencyId": 0,
        "CurrencyCode": "str",
        "Comment": "string",
        "OrderReference": "string",
        "DiscountCode": "string",
        "ReferId": 0,
        "ReferUrl": "string",
        "ValidTo": "2019-08-24T14:15:22Z",
        "IsEditable": true,
        "Items": [
          {
            "Id": 0,
            "LineNo": 0,
            "ParentLineNo": 0,
            "ProductId": 0,
            "PartNo": "string",
            "ManufacturerPartNo": "string",
            "Name": "string",
            "SubHeader": "string",
            "ThumbnailImage": "string",
            "FlagIdSeed": "string",
            "Type": 0,
            "PriceDisplay": 0,
            "Price": 0,
            "PriceOriginal": 0,
            "Cost": 0,
            "VatRate": 0,
            "Quantity": 0,
            "Uom": "string",
            "UomCount": 0,
            "Comment": "string",
            "PriceListId": 0,
            "ReferId": 0,
            "ReferUrl": "string",
            "IsEditable": true,
            "IsDiscountable": true,
            "Info": [
              {
                "TypeId": 0,
                "Value": "string",
                "Code": "string"
              }
            ],
            "OptionalItems": [
              {}
            ],
            "OnHandValue": 0,
            "IncomingValue": 0,
            "NextDeliveryDate": "2019-08-24T14:15:22Z",
            "LeadtimeDayCount": 0,
            "PromotionIdSeed": "string",
            "ImageKey": "9afa8b7e-ca15-438f-a9d6-f679c437e59c",
            "ManufacturerName": "string",
            "CategoryId": 0,
            "OnHand": {
              "Value": 0,
              "IncomingValue": 0,
              "NextDeliveryDate": "2019-08-24T14:15:22Z",
              "LeadtimeDayCount": 0,
              "LastChecked": "2019-08-24T14:15:22Z",
              "IsActive": true,
              "IsReturnable": true,
              "Info": [
                {}
              ]
            },
            "OnHandSupplier": {
              "Value": 0,
              "IncomingValue": 0,
              "NextDeliveryDate": "2019-08-24T14:15:22Z",
              "LeadtimeDayCount": 0,
              "LastChecked": "2019-08-24T14:15:22Z",
              "IsActive": true,
              "IsReturnable": true,
              "Info": [
                {}
              ]
            },
            "PriceRecommended": 0,
            "ManufacturerId": 0,
            "UniqueName": "string",
            "StatusId": 0,
            "StockDisplayBreakPoint": 0,
            "PriceCatalog": 0,
            "IsBuyable": true,
            "SubDescription": "string",
            "CategoryIdSeed": "string",
            "RecommendedQuantity": 0,
            "IsRecommendedQuantityFixed": true,
            "AppliedPromotions": [
              {
                "Id": 0,
                "Name": "string",
                "DiscountCode": "string",
                "AppliedAmount": 0,
                "AppliedAmountIncVat": 0
              }
            ],
            "RequirementPromotionIdSeed": "string",
            "IsSubscribable": true,
            "DescriptionHeader": "string",
            "IsPriceManual": true,
            "PriceStandard": 0,
            "EanCode": "string",
            "CostUnit": 0,
            "PriceDisplayIncVat": 0,
            "PriceListLocked": true,
            "PriceOriginalIncVat": 0,
            "PriceRecommendedIncVat": 0,
            "PriceCatalogIncVat": 0,
            "PriceStandardIncVat": 0,
            "Weight": 0,
            "Height": 0,
            "Width": 0,
            "Length": 0,
            "IsDropShipOnly": true
          }
        ],
        "Info": [
          {
            "TypeId": 0,
            "Value": "string",
            "Code": "string"
          }
        ],
        "Summary": {
          "Items": {
            "Amount": 0,
            "Vat": 0,
            "AmountIncVat": 0
          },
          "Freigt": {
            "Amount": 0,
            "Vat": 0,
            "AmountIncVat": 0
          },
          "Fees": {
            "Amount": 0,
            "Vat": 0,
            "AmountIncVat": 0
          },
          "Total": {
            "Amount": 0,
            "Vat": 0,
            "AmountIncVat": 0
          }
        },
        "AppliedPromotions": [
          {
            "Id": 0,
            "Name": "string",
            "Header": "string",
            "ShortDescription": "string",
            "Description1": "string",
            "Description2": "string",
            "StartDate": "2019-08-24T14:15:22Z",
            "EndDate": "2019-08-24T14:15:22Z",
            "ImageKey": "9afa8b7e-ca15-438f-a9d6-f679c437e59c",
            "RequirementSeed": "string",
            "DiscountCode": "string",
            "IsExcludedFromPriceCalculation": true,
            "AllowProductListing": true,
            "Images": [
              {
                "Id": 0,
                "Type": 0,
                "Name": "string",
                "Description": "string",
                "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd"
              }
            ],
            "ProductFilters": [
              {
                "ManufacturerId": 0,
                "CategorySeed": "string",
                "TypeId": 0,
                "ProductId": 0,
                "VariantProductId": 0,
                "PartNo": "string",
                "PricelistId": 0,
                "FlagId": 0
              }
            ],
            "AppliedAmount": 0,
            "EffectSeed": "string",
            "FreightDiscountPct": 0,
            "IsStackable": true,
            "AppliedAmountIncVat": 0,
            "ExclusivityType": 0,
            "ExternalCode": "string"
          }
        ],
        "IpAddress": "string",
        "AttestedBy": 0,
        "TypeId": 0,
        "DoHold": true,
        "IsBuyable": true,
        "InvoiceReference": "string",
        "PaymentMethodId": 0,
        "DeliveryMethodId": 0,
        "SalesAreaId": 0,
        "ExternalDiscountCode": "string"
      },
      "Buyer": {
        "Id": 0,
        "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
        "Code": "string",
        "Email": "string",
        "Ssn": "string",
        "FirstName": "string",
        "LastName": "string",
        "Phone": "string",
        "CellPhone": "string",
        "ReferId": 0,
        "ReferUrl": "string",
        "Account": {
          "Id": 0,
          "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
          "LoginName": "string",
          "Name": "string",
          "Roles": [
            0
          ],
          "Authorizations": [
            {
              "Id": 0,
              "Value": "string",
              "Code": "string"
            }
          ],
          "IsActive": true,
          "NewPassword": "string"
        },
        "Companies": [
          {
            "Id": 0,
            "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
            "Code": "string",
            "Name": "string",
            "OrgNo": "string",
            "Phone": "string",
            "ReferId": 0,
            "ReferUrl": "string",
            "DeliveryAddresses": [
              {
                "Id": 0,
                "CareOf": "string",
                "Line1": "string",
                "Line2": "string",
                "Zip": "string",
                "City": "string",
                "CountryId": 0,
                "Country": "string",
                "Region": "string",
                "IsValidated": true,
                "GlobalLocationNo": "string",
                "ShippingPhoneNumber": "string",
                "Code": "string"
              }
            ],
            "InvoiceAddress": {
              "Id": 0,
              "CareOf": "string",
              "Line1": "string",
              "Line2": "string",
              "Zip": "string",
              "City": "string",
              "CountryId": 0,
              "Country": "string",
              "Region": "string",
              "IsValidated": true,
              "GlobalLocationNo": "string",
              "ShippingPhoneNumber": "string",
              "Code": "string"
            },
            "UseInvoiceAddressAsDeliveryAddress": true,
            "Info": [
              {
                "Id": 0,
                "Value": "string",
                "Code": "string"
              }
            ],
            "PricelistIds": [
              0
            ],
            "ParentId": 0,
            "DeliveryMethodIds": [
              0
            ],
            "PaymentMethodIds": [
              0
            ],
            "Email": "string",
            "Flags": [
              {
                "Id": 0,
                "Name": "string",
                "Group": 0,
                "IsSelected": true
              }
            ],
            "VatNo": "string"
          }
        ],
        "DeliveryAddresses": [
          {
            "Id": 0,
            "CareOf": "string",
            "Line1": "string",
            "Line2": "string",
            "Zip": "string",
            "City": "string",
            "CountryId": 0,
            "Country": "string",
            "Region": "string",
            "IsValidated": true,
            "GlobalLocationNo": "string",
            "ShippingPhoneNumber": "string",
            "Code": "string"
          }
        ],
        "InvoiceAddress": {
          "Id": 0,
          "CareOf": "string",
          "Line1": "string",
          "Line2": "string",
          "Zip": "string",
          "City": "string",
          "CountryId": 0,
          "Country": "string",
          "Region": "string",
          "IsValidated": true,
          "GlobalLocationNo": "string",
          "ShippingPhoneNumber": "string",
          "Code": "string"
        },
        "Flags": [
          {
            "Id": 0,
            "Name": "string",
            "Group": 0,
            "IsSelected": true
          }
        ],
        "UseInvoiceAddressAsDeliveryAddress": true,
        "Info": [
          {
            "Id": 0,
            "Value": "string",
            "Code": "string"
          }
        ],
        "PricelistIds": [
          0
        ],
        "CrmId": "string",
        "IsActive": true,
        "Created": "2019-08-24T14:15:22Z",
        "Updated": "2019-08-24T14:15:22Z"
      },
      "Payer": {
        "Id": 0,
        "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
        "Code": "string",
        "Email": "string",
        "Ssn": "string",
        "FirstName": "string",
        "LastName": "string",
        "Phone": "string",
        "CellPhone": "string",
        "ReferId": 0,
        "ReferUrl": "string",
        "Account": {
          "Id": 0,
          "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
          "LoginName": "string",
          "Name": "string",
          "Roles": [
            0
          ],
          "Authorizations": [
            {
              "Id": 0,
              "Value": "string",
              "Code": "string"
            }
          ],
          "IsActive": true,
          "NewPassword": "string"
        },
        "Companies": [
          {
            "Id": 0,
            "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
            "Code": "string",
            "Name": "string",
            "OrgNo": "string",
            "Phone": "string",
            "ReferId": 0,
            "ReferUrl": "string",
            "DeliveryAddresses": [
              {
                "Id": 0,
                "CareOf": "string",
                "Line1": "string",
                "Line2": "string",
                "Zip": "string",
                "City": "string",
                "CountryId": 0,
                "Country": "string",
                "Region": "string",
                "IsValidated": true,
                "GlobalLocationNo": "string",
                "ShippingPhoneNumber": "string",
                "Code": "string"
              }
            ],
            "InvoiceAddress": {
              "Id": 0,
              "CareOf": "string",
              "Line1": "string",
              "Line2": "string",
              "Zip": "string",
              "City": "string",
              "CountryId": 0,
              "Country": "string",
              "Region": "string",
              "IsValidated": true,
              "GlobalLocationNo": "string",
              "ShippingPhoneNumber": "string",
              "Code": "string"
            },
            "UseInvoiceAddressAsDeliveryAddress": true,
            "Info": [
              {
                "Id": 0,
                "Value": "string",
                "Code": "string"
              }
            ],
            "PricelistIds": [
              0
            ],
            "ParentId": 0,
            "DeliveryMethodIds": [
              0
            ],
            "PaymentMethodIds": [
              0
            ],
            "Email": "string",
            "Flags": [
              {
                "Id": 0,
                "Name": "string",
                "Group": 0,
                "IsSelected": true
              }
            ],
            "VatNo": "string"
          }
        ],
        "DeliveryAddresses": [
          {
            "Id": 0,
            "CareOf": "string",
            "Line1": "string",
            "Line2": "string",
            "Zip": "string",
            "City": "string",
            "CountryId": 0,
            "Country": "string",
            "Region": "string",
            "IsValidated": true,
            "GlobalLocationNo": "string",
            "ShippingPhoneNumber": "string",
            "Code": "string"
          }
        ],
        "InvoiceAddress": {
          "Id": 0,
          "CareOf": "string",
          "Line1": "string",
          "Line2": "string",
          "Zip": "string",
          "City": "string",
          "CountryId": 0,
          "Country": "string",
          "Region": "string",
          "IsValidated": true,
          "GlobalLocationNo": "string",
          "ShippingPhoneNumber": "string",
          "Code": "string"
        },
        "Flags": [
          {
            "Id": 0,
            "Name": "string",
            "Group": 0,
            "IsSelected": true
          }
        ],
        "UseInvoiceAddressAsDeliveryAddress": true,
        "Info": [
          {
            "Id": 0,
            "Value": "string",
            "Code": "string"
          }
        ],
        "PricelistIds": [
          0
        ],
        "CrmId": "string",
        "IsActive": true,
        "Created": "2019-08-24T14:15:22Z",
        "Updated": "2019-08-24T14:15:22Z"
      },
      "ShipTo": {
        "Id": 0,
        "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
        "Code": "string",
        "Email": "string",
        "Ssn": "string",
        "FirstName": "string",
        "LastName": "string",
        "Phone": "string",
        "CellPhone": "string",
        "ReferId": 0,
        "ReferUrl": "string",
        "Account": {
          "Id": 0,
          "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
          "LoginName": "string",
          "Name": "string",
          "Roles": [
            0
          ],
          "Authorizations": [
            {
              "Id": 0,
              "Value": "string",
              "Code": "string"
            }
          ],
          "IsActive": true,
          "NewPassword": "string"
        },
        "Companies": [
          {
            "Id": 0,
            "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
            "Code": "string",
            "Name": "string",
            "OrgNo": "string",
            "Phone": "string",
            "ReferId": 0,
            "ReferUrl": "string",
            "DeliveryAddresses": [
              {
                "Id": 0,
                "CareOf": "string",
                "Line1": "string",
                "Line2": "string",
                "Zip": "string",
                "City": "string",
                "CountryId": 0,
                "Country": "string",
                "Region": "string",
                "IsValidated": true,
                "GlobalLocationNo": "string",
                "ShippingPhoneNumber": "string",
                "Code": "string"
              }
            ],
            "InvoiceAddress": {
              "Id": 0,
              "CareOf": "string",
              "Line1": "string",
              "Line2": "string",
              "Zip": "string",
              "City": "string",
              "CountryId": 0,
              "Country": "string",
              "Region": "string",
              "IsValidated": true,
              "GlobalLocationNo": "string",
              "ShippingPhoneNumber": "string",
              "Code": "string"
            },
            "UseInvoiceAddressAsDeliveryAddress": true,
            "Info": [
              {
                "Id": 0,
                "Value": "string",
                "Code": "string"
              }
            ],
            "PricelistIds": [
              0
            ],
            "ParentId": 0,
            "DeliveryMethodIds": [
              0
            ],
            "PaymentMethodIds": [
              0
            ],
            "Email": "string",
            "Flags": [
              {
                "Id": 0,
                "Name": "string",
                "Group": 0,
                "IsSelected": true
              }
            ],
            "VatNo": "string"
          }
        ],
        "DeliveryAddresses": [
          {
            "Id": 0,
            "CareOf": "string",
            "Line1": "string",
            "Line2": "string",
            "Zip": "string",
            "City": "string",
            "CountryId": 0,
            "Country": "string",
            "Region": "string",
            "IsValidated": true,
            "GlobalLocationNo": "string",
            "ShippingPhoneNumber": "string",
            "Code": "string"
          }
        ],
        "InvoiceAddress": {
          "Id": 0,
          "CareOf": "string",
          "Line1": "string",
          "Line2": "string",
          "Zip": "string",
          "City": "string",
          "CountryId": 0,
          "Country": "string",
          "Region": "string",
          "IsValidated": true,
          "GlobalLocationNo": "string",
          "ShippingPhoneNumber": "string",
          "Code": "string"
        },
        "Flags": [
          {
            "Id": 0,
            "Name": "string",
            "Group": 0,
            "IsSelected": true
          }
        ],
        "UseInvoiceAddressAsDeliveryAddress": true,
        "Info": [
          {
            "Id": 0,
            "Value": "string",
            "Code": "string"
          }
        ],
        "PricelistIds": [
          0
        ],
        "CrmId": "string",
        "IsActive": true,
        "Created": "2019-08-24T14:15:22Z",
        "Updated": "2019-08-24T14:15:22Z"
      },
      "PaymentMethods": [
        {
          "Id": 0,
          "Name": "string",
          "TypeId": 0,
          "TypeName": "string",
          "Description": "string",
          "PartNo": "string",
          "Price": 0,
          "VatRate": 0,
          "ImagePath": "string",
          "IsSelected": true,
          "Service": {
            "Id": 0,
            "Name": "string",
            "Description": "string",
            "ImagePath": "string",
            "ImageKey": "9afa8b7e-ca15-438f-a9d6-f679c437e59c"
          },
          "ImageKey": "9afa8b7e-ca15-438f-a9d6-f679c437e59c",
          "IsForCompanyOnly": true,
          "IsForPersonOnly": true
        }
      ],
      "DeliveryMethods": [
        {
          "Id": 0,
          "Name": "string",
          "TypeId": 0,
          "TypeName": "string",
          "Description": "string",
          "PartNo": "string",
          "Price": 0,
          "VatRate": 0,
          "IsNotifiable": true,
          "ImagePath": "string",
          "IsSelected": true,
          "ImageKey": "9afa8b7e-ca15-438f-a9d6-f679c437e59c",
          "IsForCompanyOnly": true,
          "IsForPersonOnly": true,
          "Cost": 0,
          "StoreId": 0,
          "WarehouseId": 0,
          "LocationId": 0,
          "DropPoints": [
            {
              "Code": "string",
              "RoutingCode": "string",
              "Depot": "string",
              "Name1": "string",
              "Name2": "string",
              "Address1": "string",
              "Address2": "string",
              "PostalCode": "string",
              "City": "string",
              "CountryCode": "string",
              "Contact": "string",
              "Phone": "string",
              "Fax": "string",
              "Email": "string",
              "Latitude": 0.1,
              "Longitude": 0.1,
              "Distance": 0.1,
              "OpeningHours": [
                {}
              ],
              "IsSelected": true
            }
          ],
          "Code": "string",
          "Carrier": "string"
        }
      ],
      "Payments": [
        {
          "PaymentCode": 0,
          "Amount": 0,
          "CardNo": "string",
          "PaymentMethodId": 0,
          "PaymentServiceId": 0
        }
      ]
    },
    "PaymentParameters": [
      {
        "Name": "string",
        "Value": "string"
      }
    ]
  }'

Responses

Success

Bodyapplication/json

Statusstring or null

String response. OK if successful, otherwise may have different values depending on PSP.

StatusDescriptionstring or null

Descriptive text for the status.

BasketIdinteger or null(int32)

Internal id of the associated basket.

OrderNostring or null

Order number if order's been created.

PaymentCodestring or null

Internal identifier of this specific payment attempt.

PaymentReferencestring or null

External identifier of this specific payment attempt, usually from the PSP.

HostedPaymentPagestring or null

Used when a payment should be finalized on a different platform, e.g. sending a link by SMS to customer.

RedirectUrlstring or null

Configurated redirection URL after successful payment.

RedirectParametersArray of objects or null(NameValue)

PSP specific data returned for the payment. See PSP documentation.

IsSyncronousboolean or null

Indicates if the payment attempt was synchronous or not.

PaymentServiceIdinteger or null(int32)

Internal id of the payment service used.

Response

application/json

{
  "Status": "string",
  "StatusDescription": "string",
  "BasketId": 0,
  "OrderNo": "string",
  "PaymentCode": "string",
  "PaymentReference": "string",
  "HostedPaymentPage": "string",
  "RedirectUrl": "string",
  "RedirectParameters": [
    { … }
  ],
  "IsSyncronous": true,
  "PaymentServiceId": 0
}

Update buyer information

Request

Updates Buyer information on a basket. If no Payer is associated with the Basket or the Payer is the same as the Buyer then Payer will also be updated. The same applies to ShipTo.

Query

basketIdinteger(int32)

The internal id of the basket to update.

updatedByinteger(int32)

Account internal id of current user.

pricelistSeedstring

cultureCodestring

(Optional) Specifies in which language to display culture specific information. If none is supplied, value is resolved from Application.

currencyIdstring

(Optional) Internal id that specifies in which currency to display prices. If none is supplied, value is resolved from Application.

Bodyapplication/json

The actual Customer to use as Buyer. The Customer can optionally have one Company. If more than one Company is specified, the first will be used. Addresses will be resolve by first looking at the Company and then on the Customer. See UpdatePayer and UpdateShip on details regarding updating these address types.

Idinteger or null(int32)

The internal Norce Id of the Customer. When creating a new Customer leave this blank as Norce will generate the Id.

Keystring or null(uuid)

The system wide unique Key of the Customer.

Codestring or null[ 0 .. 50 ] characters

The external code. Usually the id in the erp system. MaxLength: 50

Emailstring or null[ 0 .. 255 ] characters

The Email address of the Customer. MaxLength: 255

Ssnstring or null[ 0 .. 50 ] characters

The social security number of the Customer. Used to identify the Customer for some payment methods. MaxLength: 50

FirstNamestring or null[ 0 .. 50 ] characters

The FirstName of the Customer. MaxLength: 50

LastNamestring or null[ 0 .. 50 ] characters

The LastName of the Customer. MaxLength: 50

Phonestring or null[ 0 .. 50 ] characters

The PhoneNumber of the Customer. MaxLength: 50

CellPhonestring or null[ 0 .. 50 ] characters

The CellPhone number of the Customer. MaxLength: 50

ReferIdinteger or null(int32)

Used to tag a Customer with some external id.

ReferUrlstring or null[ 0 .. 255 ] characters

Used to tag a Customer with an incoming URL. MaxLength: 255

Accountobject or null

An Account is related to a Customer. Each Account can belong to only one Application. When creating Customers you need to define a Customer.Account if you want the customer to be able to login. This is useful when the application supports My page with order history and such.

CompaniesArray of objects or null(Company)

A list of Companies. A Customer can have many Companies. The first will be used as default. In the Checkout process just pass in one Company if any is to be used or the first will be used as default.

DeliveryAddressesArray of objects or null(Address)

A list of delivery Addresses for the Customer. When needed the first address in the list will be used. So it is vital in the checkout process to either sort them or just supply one delivery address. Company addresses will override Customer addresses if both exists in the Checkout process.

InvoiceAddressobject or null

Information about an address. Addresses appear as InvoiceAddress or DeliveryAddresses or when ever an Address is needed

FlagsArray of objects or null(Flag)

A list of Flags for the Customer. See Flag for information about flags. Flags can be used in Promotions or otherwise to provide custom handling of specific Customers.

UseInvoiceAddressAsDeliveryAddressboolean or null

Can be use when updating or inserting addresses on Customer. If set to true the invoice address will be used as a delivery address as well. Then just an invoice address needs to be passed in. The deliveryAddress will be ignored. If set to false both invoice address and delivery address must be specified.

InfoArray of objects or null(IdValue)

Contains a list of id-value pairs specific to the client for this customer. Use ApplicationService.ListCustomerInfoTypes for id lookup.

PricelistIdsArray of integers or null(int32)

Contains a list of priceList ids valid for this customer. It will be empty if no priceLists exist. It can be used to check products lists if they are from a customer specific priceList. No need to pass this into List-methods since they are considered any way in the methods. This property should be considered as ReadOnly as priceLists are maintained else where.

CrmIdstring or null[ 0 .. 50 ] characters

Used to save the Customers external id from a crm-system. MaxLength: 50

IsActiveboolean or null

Specifies if the Customer is active or not.

Createdstring or null(date-time)

When the customer was created.

Updatedstring or null(date-time)

When the customer was last updated.

curl -i -X POST \
  https://customer-slug.api-se.playground.norce.tech/commerce/shopping/1.1/UpdateBuyer \
  -H 'ApplicationId: YOUR_API_KEY_HERE' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "Id": 0,
    "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
    "Code": "string",
    "Email": "string",
    "Ssn": "string",
    "FirstName": "string",
    "LastName": "string",
    "Phone": "string",
    "CellPhone": "string",
    "ReferId": 0,
    "ReferUrl": "string",
    "Account": {
      "Id": 0,
      "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
      "LoginName": "string",
      "Name": "string",
      "Roles": [
        0
      ],
      "Authorizations": [
        {
          "Id": 0,
          "Value": "string",
          "Code": "string"
        }
      ],
      "IsActive": true,
      "NewPassword": "string"
    },
    "Companies": [
      {
        "Id": 0,
        "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
        "Code": "string",
        "Name": "string",
        "OrgNo": "string",
        "Phone": "string",
        "ReferId": 0,
        "ReferUrl": "string",
        "DeliveryAddresses": [
          {
            "Id": 0,
            "CareOf": "string",
            "Line1": "string",
            "Line2": "string",
            "Zip": "string",
            "City": "string",
            "CountryId": 0,
            "Country": "string",
            "Region": "string",
            "IsValidated": true,
            "GlobalLocationNo": "string",
            "ShippingPhoneNumber": "string",
            "Code": "string"
          }
        ],
        "InvoiceAddress": {
          "Id": 0,
          "CareOf": "string",
          "Line1": "string",
          "Line2": "string",
          "Zip": "string",
          "City": "string",
          "CountryId": 0,
          "Country": "string",
          "Region": "string",
          "IsValidated": true,
          "GlobalLocationNo": "string",
          "ShippingPhoneNumber": "string",
          "Code": "string"
        },
        "UseInvoiceAddressAsDeliveryAddress": true,
        "Info": [
          {
            "Id": 0,
            "Value": "string",
            "Code": "string"
          }
        ],
        "PricelistIds": [
          0
        ],
        "ParentId": 0,
        "DeliveryMethodIds": [
          0
        ],
        "PaymentMethodIds": [
          0
        ],
        "Email": "string",
        "Flags": [
          {
            "Id": 0,
            "Name": "string",
            "Group": 0,
            "IsSelected": true
          }
        ],
        "VatNo": "string"
      }
    ],
    "DeliveryAddresses": [
      {
        "Id": 0,
        "CareOf": "string",
        "Line1": "string",
        "Line2": "string",
        "Zip": "string",
        "City": "string",
        "CountryId": 0,
        "Country": "string",
        "Region": "string",
        "IsValidated": true,
        "GlobalLocationNo": "string",
        "ShippingPhoneNumber": "string",
        "Code": "string"
      }
    ],
    "InvoiceAddress": {
      "Id": 0,
      "CareOf": "string",
      "Line1": "string",
      "Line2": "string",
      "Zip": "string",
      "City": "string",
      "CountryId": 0,
      "Country": "string",
      "Region": "string",
      "IsValidated": true,
      "GlobalLocationNo": "string",
      "ShippingPhoneNumber": "string",
      "Code": "string"
    },
    "Flags": [
      {
        "Id": 0,
        "Name": "string",
        "Group": 0,
        "IsSelected": true
      }
    ],
    "UseInvoiceAddressAsDeliveryAddress": true,
    "Info": [
      {
        "Id": 0,
        "Value": "string",
        "Code": "string"
      }
    ],
    "PricelistIds": [
      0
    ],
    "CrmId": "string",
    "IsActive": true,
    "Created": "2019-08-24T14:15:22Z",
    "Updated": "2019-08-24T14:15:22Z"
  }'

Responses

Success

Bodyapplication/json

Basketobject or null

Represents a basket where you can add/remove/update items and information such as discountcodes and pass forward information types.

Buyerobject or null

Information about a Customer.

Payerobject or null

Information about a Customer.

ShipToobject or null

Information about a Customer.

PaymentMethodsArray of objects or null(PaymentMethod)

List of available payment methods for this checkout. May be changed depending on basket contents. Generated by Norce.

DeliveryMethodsArray of objects or null(DeliveryMethod)

List of available delivery methods for this checkout. May be changed depending on basket contents. Generated by Norce.

PaymentsArray of objects or null(Payment)

List of payment attemtps made for this checkout. Each payment method selected will create it's own entry in this list.

Response

application/json

{
  "Basket": {
    "Id": 0,
    "CustomerId": 0,
    "CompanyId": 0,
    "SalesContactId": 0,
    "StatusId": 0,
    "CurrencyId": 0,
    "CurrencyCode": "str",
    "Comment": "string",
    "OrderReference": "string",
    "DiscountCode": "string",
    "ReferId": 0,
    "ReferUrl": "string",
    "ValidTo": "2019-08-24T14:15:22Z",
    "IsEditable": true,
    "Items": [ … ],
    "Info": [ … ],
    "Summary": { … },
    "AppliedPromotions": [ … ],
    "IpAddress": "string",
    "AttestedBy": 0,
    "TypeId": 0,
    "DoHold": true,
    "IsBuyable": true,
    "InvoiceReference": "string",
    "PaymentMethodId": 0,
    "DeliveryMethodId": 0,
    "SalesAreaId": 0,
    "ExternalDiscountCode": "string"
  },
  "Buyer": {
    "Id": 0,
    "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
    "Code": "string",
    "Email": "string",
    "Ssn": "string",
    "FirstName": "string",
    "LastName": "string",
    "Phone": "string",
    "CellPhone": "string",
    "ReferId": 0,
    "ReferUrl": "string",
    "Account": { … },
    "Companies": [ … ],
    "DeliveryAddresses": [ … ],
    "InvoiceAddress": { … },
    "Flags": [ … ],
    "UseInvoiceAddressAsDeliveryAddress": true,
    "Info": [ … ],
    "PricelistIds": [ … ],
    "CrmId": "string",
    "IsActive": true,
    "Created": "2019-08-24T14:15:22Z",
    "Updated": "2019-08-24T14:15:22Z"
  },
  "Payer": {
    "Id": 0,
    "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
    "Code": "string",
    "Email": "string",
    "Ssn": "string",
    "FirstName": "string",
    "LastName": "string",
    "Phone": "string",
    "CellPhone": "string",
    "ReferId": 0,
    "ReferUrl": "string",
    "Account": { … },
    "Companies": [ … ],
    "DeliveryAddresses": [ … ],
    "InvoiceAddress": { … },
    "Flags": [ … ],
    "UseInvoiceAddressAsDeliveryAddress": true,
    "Info": [ … ],
    "PricelistIds": [ … ],
    "CrmId": "string",
    "IsActive": true,
    "Created": "2019-08-24T14:15:22Z",
    "Updated": "2019-08-24T14:15:22Z"
  },
  "ShipTo": {
    "Id": 0,
    "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
    "Code": "string",
    "Email": "string",
    "Ssn": "string",
    "FirstName": "string",
    "LastName": "string",
    "Phone": "string",
    "CellPhone": "string",
    "ReferId": 0,
    "ReferUrl": "string",
    "Account": { … },
    "Companies": [ … ],
    "DeliveryAddresses": [ … ],
    "InvoiceAddress": { … },
    "Flags": [ … ],
    "UseInvoiceAddressAsDeliveryAddress": true,
    "Info": [ … ],
    "PricelistIds": [ … ],
    "CrmId": "string",
    "IsActive": true,
    "Created": "2019-08-24T14:15:22Z",
    "Updated": "2019-08-24T14:15:22Z"
  },
  "PaymentMethods": [
    { … }
  ],
  "DeliveryMethods": [
    { … }
  ],
  "Payments": [
    { … }
  ]
}

Update buyer information (v2)

Request

Updates Buyer information on a basket. If no Payer is associated with the Basket or the Payer is the same as the Buyer then Payer will also be updated. The same applies to ShipTo.

Query

basketIdinteger(int32)

The internal id of the basket to update.

updatedByinteger(int32)

Account internal id of current user.

pricelistSeedstring

cultureCodestring

(Optional) Specifies in which language to display culture specific information. If none is supplied, value is resolved from Application.

currencyIdstring

(Optional) Internal id that specifies in which currency to display prices. If none is supplied, value is resolved from Application.

Bodyapplication/json

Idinteger or null(int32)

The internal Norce Id of the Customer. When creating a new Customer leave this blank as Norce will generate the Id.

Keystring or null(uuid)

The system wide unique Key of the Customer.

Codestring or null[ 0 .. 50 ] characters

The external code. Usually the id in the erp system. MaxLength: 50

Emailstring or null[ 0 .. 255 ] characters

The Email address of the Customer. MaxLength: 255

Ssnstring or null[ 0 .. 50 ] characters

The social security number of the Customer. Used to identify the Customer for some payment methods. MaxLength: 50

FirstNamestring or null[ 0 .. 50 ] characters

The FirstName of the Customer. MaxLength: 50

LastNamestring or null[ 0 .. 50 ] characters

The LastName of the Customer. MaxLength: 50

Phonestring or null[ 0 .. 50 ] characters

The PhoneNumber of the Customer. MaxLength: 50

CellPhonestring or null[ 0 .. 50 ] characters

The CellPhone number of the Customer. MaxLength: 50

ReferIdinteger or null(int32)

Used to tag a Customer with some external id.

ReferUrlstring or null[ 0 .. 255 ] characters

Used to tag a Customer with an incoming URL. MaxLength: 255

Accountobject or null

CompaniesArray of objects or null(Company)

A list of Companies. A Customer can have many Companies. The first will be used as default. In the Checkout process just pass in one Company if any is to be used or the first will be used as default.

DeliveryAddressesArray of objects or null(Address)

InvoiceAddressobject or null

Information about an address. Addresses appear as InvoiceAddress or DeliveryAddresses or when ever an Address is needed

FlagsArray of objects or null(Flag)

A list of Flags for the Customer. See Flag for information about flags. Flags can be used in Promotions or otherwise to provide custom handling of specific Customers.

UseInvoiceAddressAsDeliveryAddressboolean or null

InfoArray of objects or null(IdValue)

Contains a list of id-value pairs specific to the client for this customer. Use ApplicationService.ListCustomerInfoTypes for id lookup.

PricelistIdsArray of integers or null(int32)

CrmIdstring or null[ 0 .. 50 ] characters

Used to save the Customers external id from a crm-system. MaxLength: 50

IsActiveboolean or null

Specifies if the Customer is active or not.

Createdstring or null(date-time)

When the customer was created.

Updatedstring or null(date-time)

When the customer was last updated.

curl -i -X POST \
  https://customer-slug.api-se.playground.norce.tech/commerce/shopping/1.1/UpdateBuyer2 \
  -H 'ApplicationId: YOUR_API_KEY_HERE' \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "Id": 0,
    "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
    "Code": "string",
    "Email": "string",
    "Ssn": "string",
    "FirstName": "string",
    "LastName": "string",
    "Phone": "string",
    "CellPhone": "string",
    "ReferId": 0,
    "ReferUrl": "string",
    "Account": {
      "Id": 0,
      "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
      "LoginName": "string",
      "Name": "string",
      "Roles": [
        0
      ],
      "Authorizations": [
        {
          "Id": 0,
          "Value": "string",
          "Code": "string"
        }
      ],
      "IsActive": true,
      "NewPassword": "string"
    },
    "Companies": [
      {
        "Id": 0,
        "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
        "Code": "string",
        "Name": "string",
        "OrgNo": "string",
        "Phone": "string",
        "ReferId": 0,
        "ReferUrl": "string",
        "DeliveryAddresses": [
          {
            "Id": 0,
            "CareOf": "string",
            "Line1": "string",
            "Line2": "string",
            "Zip": "string",
            "City": "string",
            "CountryId": 0,
            "Country": "string",
            "Region": "string",
            "IsValidated": true,
            "GlobalLocationNo": "string",
            "ShippingPhoneNumber": "string",
            "Code": "string"
          }
        ],
        "InvoiceAddress": {
          "Id": 0,
          "CareOf": "string",
          "Line1": "string",
          "Line2": "string",
          "Zip": "string",
          "City": "string",
          "CountryId": 0,
          "Country": "string",
          "Region": "string",
          "IsValidated": true,
          "GlobalLocationNo": "string",
          "ShippingPhoneNumber": "string",
          "Code": "string"
        },
        "UseInvoiceAddressAsDeliveryAddress": true,
        "Info": [
          {
            "Id": 0,
            "Value": "string",
            "Code": "string"
          }
        ],
        "PricelistIds": [
          0
        ],
        "ParentId": 0,
        "DeliveryMethodIds": [
          0
        ],
        "PaymentMethodIds": [
          0
        ],
        "Email": "string",
        "Flags": [
          {
            "Id": 0,
            "Name": "string",
            "Group": 0,
            "IsSelected": true
          }
        ],
        "VatNo": "string"
      }
    ],
    "DeliveryAddresses": [
      {
        "Id": 0,
        "CareOf": "string",
        "Line1": "string",
        "Line2": "string",
        "Zip": "string",
        "City": "string",
        "CountryId": 0,
        "Country": "string",
        "Region": "string",
        "IsValidated": true,
        "GlobalLocationNo": "string",
        "ShippingPhoneNumber": "string",
        "Code": "string"
      }
    ],
    "InvoiceAddress": {
      "Id": 0,
      "CareOf": "string",
      "Line1": "string",
      "Line2": "string",
      "Zip": "string",
      "City": "string",
      "CountryId": 0,
      "Country": "string",
      "Region": "string",
      "IsValidated": true,
      "GlobalLocationNo": "string",
      "ShippingPhoneNumber": "string",
      "Code": "string"
    },
    "Flags": [
      {
        "Id": 0,
        "Name": "string",
        "Group": 0,
        "IsSelected": true
      }
    ],
    "UseInvoiceAddressAsDeliveryAddress": true,
    "Info": [
      {
        "Id": 0,
        "Value": "string",
        "Code": "string"
      }
    ],
    "PricelistIds": [
      0
    ],
    "CrmId": "string",
    "IsActive": true,
    "Created": "2019-08-24T14:15:22Z",
    "Updated": "2019-08-24T14:15:22Z"
  }'

Responses

Success

Bodyapplication/json

Basketobject or null

Represents a basket where you can add/remove/update items and information such as discountcodes and pass forward information types.

Buyerobject or null

Information about a Customer.

Payerobject or null

Information about a Customer.

ShipToobject or null

Information about a Customer.

PaymentMethodsArray of objects or null(PaymentMethod)

List of available payment methods for this checkout. May be changed depending on basket contents. Generated by Norce.

DeliveryMethodsArray of objects or null(DeliveryMethod)

List of available delivery methods for this checkout. May be changed depending on basket contents. Generated by Norce.

PaymentsArray of objects or null(Payment)

List of payment attemtps made for this checkout. Each payment method selected will create it's own entry in this list.

Response

application/json

{
  "Basket": {
    "Id": 0,
    "CustomerId": 0,
    "CompanyId": 0,
    "SalesContactId": 0,
    "StatusId": 0,
    "CurrencyId": 0,
    "CurrencyCode": "str",
    "Comment": "string",
    "OrderReference": "string",
    "DiscountCode": "string",
    "ReferId": 0,
    "ReferUrl": "string",
    "ValidTo": "2019-08-24T14:15:22Z",
    "IsEditable": true,
    "Items": [ … ],
    "Info": [ … ],
    "Summary": { … },
    "AppliedPromotions": [ … ],
    "IpAddress": "string",
    "AttestedBy": 0,
    "TypeId": 0,
    "DoHold": true,
    "IsBuyable": true,
    "InvoiceReference": "string",
    "PaymentMethodId": 0,
    "DeliveryMethodId": 0,
    "SalesAreaId": 0,
    "ExternalDiscountCode": "string"
  },
  "Buyer": {
    "Id": 0,
    "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
    "Code": "string",
    "Email": "string",
    "Ssn": "string",
    "FirstName": "string",
    "LastName": "string",
    "Phone": "string",
    "CellPhone": "string",
    "ReferId": 0,
    "ReferUrl": "string",
    "Account": { … },
    "Companies": [ … ],
    "DeliveryAddresses": [ … ],
    "InvoiceAddress": { … },
    "Flags": [ … ],
    "UseInvoiceAddressAsDeliveryAddress": true,
    "Info": [ … ],
    "PricelistIds": [ … ],
    "CrmId": "string",
    "IsActive": true,
    "Created": "2019-08-24T14:15:22Z",
    "Updated": "2019-08-24T14:15:22Z"
  },
  "Payer": {
    "Id": 0,
    "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
    "Code": "string",
    "Email": "string",
    "Ssn": "string",
    "FirstName": "string",
    "LastName": "string",
    "Phone": "string",
    "CellPhone": "string",
    "ReferId": 0,
    "ReferUrl": "string",
    "Account": { … },
    "Companies": [ … ],
    "DeliveryAddresses": [ … ],
    "InvoiceAddress": { … },
    "Flags": [ … ],
    "UseInvoiceAddressAsDeliveryAddress": true,
    "Info": [ … ],
    "PricelistIds": [ … ],
    "CrmId": "string",
    "IsActive": true,
    "Created": "2019-08-24T14:15:22Z",
    "Updated": "2019-08-24T14:15:22Z"
  },
  "ShipTo": {
    "Id": 0,
    "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
    "Code": "string",
    "Email": "string",
    "Ssn": "string",
    "FirstName": "string",
    "LastName": "string",
    "Phone": "string",
    "CellPhone": "string",
    "ReferId": 0,
    "ReferUrl": "string",
    "Account": { … },
    "Companies": [ … ],
    "DeliveryAddresses": [ … ],
    "InvoiceAddress": { … },
    "Flags": [ … ],
    "UseInvoiceAddressAsDeliveryAddress": true,
    "Info": [ … ],
    "PricelistIds": [ … ],
    "CrmId": "string",
    "IsActive": true,
    "Created": "2019-08-24T14:15:22Z",
    "Updated": "2019-08-24T14:15:22Z"
  },
  "PaymentMethods": [
    { … }
  ],
  "DeliveryMethods": [
    { … }
  ],
  "Payments": [
    { … }
  ]
}

DeliveryMethods

Contains endpoints for viewing metadata about configured delivery methods, when using Norces internal shipping logic.

Operations

InfoTypes

Contains endpoints for viewing metadata for extended fields on the basket and basketitems.

Operations

OnHand

Contains endpoints for looking up availability on baskets.

Operations

OrderRequest

Contains endpoints for viewing orders snapshots.

Operations

Payments

Contains endpoints for legacy purchases, still used by older solutions and Non-PSP purchases.

Operations

Promotions

Contains endpoints for viewing more promotion information.

Operations

Norce Commerce Shopping v1.1 service (1.1)

Basket

Checkout

Purchase a basket (extended, v2)

Request

Responses

Did the information on the page help you?

Update buyer information

Request

Responses

Did the information on the page help you?

Update buyer information (v2)

Request

Responses

Did the information on the page help you?

DeliveryMethods

InfoTypes

OnHand

OrderRequest

Payments

Promotions

Schemas

Norce Commerce Shopping v1.1 service (1.1)

Basket

Checkout

Purchase a basket (extended, v2)

RequestExpand all

Responses

Did the information on the page help you?

Update buyer information

RequestExpand all

Responses

Did the information on the page help you?

Update buyer information (v2)

RequestExpand all

Responses

Did the information on the page help you?

DeliveryMethods

InfoTypes

OnHand

OrderRequest

Payments

Promotions

Schemas

Request

Request

Request