In this document, you’ll learn how to install and configure the ApiShip fulfillment provider for Medusa.

• Medusa v2.7.1 or later
• Node.js v20 or later
• An ApiShip account - sign in or create one

yarn add @gorgo/medusa-fulfillment-apiship
# or
npm install @gorgo/medusa-fulfillment-apiship

Add the provider configuration in your medusa-config.ts file of the Medusa admin application:

// ...
module.exports = defineConfig({
  // ...
  modules: [
    {
      resolve: "@medusajs/medusa/fulfillment",
      options: {
        providers: [
          {
            resolve: "@gorgo/medusa-fulfillment-apiship/providers/fulfillment-apiship",
            id: "apiship",
            options: {
              token: process.env.APISHIP_TOKEN,
              isTest: false,
              settings: {
                defaultSenderSettings: {
                  countryCode: "RU",
                  addressString: "Москва, улица Лестева, 19к1, офис 306",
                  contactName: "Иванов Иван Иванович",
                  phone: "+79999999900",
                },
                connectionsMap: {
                  cdek: "36253",
                },
                defaultProductSizes: {
                  length: 10,
                  width: 10,
                  height: 10,
                  weight: 20,
                },
                deliveryCostVat: -1,
                isCod: false,
              },
            },
          },
        ],
      },
    },
  ],
  plugins: [
    // ...
    {
      resolve: "@gorgo/medusa-fulfillment-apiship",
      options: {},
    },
  ],
})

Add environment variable with your token from your ApiShip account:

APISHIP_TOKEN=supersecret