@35up/js-sdk-node v1.0.0

35up Javascript SDK - node

This library is designed for node environments providing Javascript APIs to integrate 35up into your online shop.

Installation

You can install this package by executing the following command:

npm i -S @35up/js-sdk-node

How to use

The library exposes initialise function that prepares and returns an Sdk instance that has several methods:

  import { initialise } from '@35up/js-sdk-node';

  const config = {
    seller: 'your_seller_id',
    lang: 'de',
    country: 'de',
    credentials: {
      username: 'example-user',
      password: 'example-password',
    }
  };

  const tfup = initialise(config);
  
  // Getting recommendations
  const result = await tfup.getProductRecommendations({
    baseProduct: {title: 'Samsung Galaxy S20 Cosmic grey'},
  });

Full configuration parameters list:

Methods

In addition to cross-environment methods this package provides the following ones:

createOrder(details, credentials)

Places an order on the 35up marketplace. If credentials where provided in the SDK initialization, they don't need to be provided here.

Input

  interface CreateOrderParams {
    reference: string;
    customer: {
      firstName: string;
      lastName: string;
      email: string;
      phone?: string;
    };
    shippingAddress?: {
      firstName?: string;
      lastName?: string;
      email?: string;
      phone?: string;
      company?: string;
      street: string;
      streetNumber: string;
      extra?: string;
      city: string;
      postcode: string;
      state?: string;
      country: string;
    };
    items: {
      sku: string;
      qty: number;
      config?: Record<string, string>;
    }[];
  }
  
  interface Credentials {
    username: string;
    password: string;
  }

Note that createOrder is an asynchronous function and returns a Promise.

Input example

  const details: CreateOrderDetails = {
    reference: '45883SKU34',
    customer: {
      firstName: 'Peter',
      lastName: 'Pan',
      email: 'peter@pan.com',
    },
    shippingAddress: {
      street: 'Home Unter the Ground',
      streetNumber: '3',
      city: 'Neverland',
      country: 'XX',
      postcode: '1911',
      phone: '+1123123123',
    },
    items: [
      {sku: 'HCI60XX114014XXAPIP60', qty: 9},
      {sku: 'FEI60XX114014XXAPIP80', qty: 1, config: {size: 'M'}},
    ],
  };

  const credentials: Credentials = {
    username: 'example-user',
    password: 'example-password',
  }

Output

  interface CreateOrderResponse {
    id: string;
    // New orders are always placed in "pending" state unless specified
    // in the request.
    status: string;
    updatedAt: string;
    createdAt: string;
  }

Example:

  const response: CreateOrderResponse = {
    id: '42346434',
    status: 'pending',
    createdAt: '1579685580',
    updatedAt: '1579685589',
  }

Requirements

Reference for cross-environment requirements