@onreadydesa/vtex-node-sdk

VTEX NODE SDK

• :hammer: Built 100% with Typescript.
• :muscle: 0 dependencies. It uses the native https Node module.
• :tada: Promise based.
• :dizzy: Type definitions for many VTEX requests and responses.

Note: This is not a VTEX official package, we are VTEX Partners since 2017 and we developed this to collaborate with VTEX Community.

Requirements

• Node version >= 8

Installation

npm install @onreadydesa/vtex-node-sdk --save

or

yarn add @onreadydesa/vtex-node-sdk

Basic usage example

First, import the SDK:

const { VTEX } = require('@onreadydesa/vtex-node-sdk');

Using ES6 imports

import { VTEX } from '@onreadydesa/vtex-node-sdk';

Then, use the SDK like this:

const vtex = new Vtex('store name', 'app key', 'app token');

// Get order by id
vtex.oms.orders.getOrder('orderId')
  .then((response) => {
    console.log(response.status); // 200
    console.log(response.body); // { orderId: 'orderId', ... }
  })
  .catch((error) => {
    console.log(error.status);
    console.log(error.body);
  })

Using async/await

try {
  const response = await vtex.oms.orders.getOrder('orderId');
  console.log(response);
} catch (error) {
  console.log(error);
}

VTEX Environments

By default, the SDK makes all requests to vtexcommercestable environment. If you want to use another environment (For example, vtexcommercebeta), you can pass an extra argument like this:

const { VTEX } = require('@onreadydesa/vtex-node-sdk')

const vtex = new Vtex('store name', 'app key', 'app token', 'beta');

Current implemented APIS

The final goal is to implement all VTEX Rest Apis. Feel free to contribute.

API	Implemented
OMS	:white_check_mark:
Logistics	:white_check_mark:
Pricing	:white_check_mark:
Master Data (V2)	:white_check_mark: (*) Attachments API pending
Catalog	:white_check_mark:
Search	:white_check_mark:
Payments Gateway	:white_check_mark:
Suggestions	:white_check_mark:
VTEX DO	:white_check_mark:
CMS	:white_check_mark:
Session Manager	:white_check_mark:
License Manager	:white_check_mark:
Customer Credit	:white_check_mark:
Subscriptions (V2)	:white_check_mark:
Rates and Benefits	:white_check_mark:
Checkout	:white_check_mark:
Giftcard Hub	:white_check_mark:
Antifraud Provider	:x:
Giftcard	:x:
Giftcard Provider Protocol	:x:
Payment Provider Protocol	:x: