NAV Navbar
cURL
  • 概要
  • 認可
  • 出荷
  • 料金
  • 共通定義
  • エラー
  • 概要

    Ship&Co APIドキュメントへようこそ!このドキュメントではShip&CoのAPIの使い方について説明します。

    Ship&Coのアカウント登録はこちら

    APIの使い方はとても簡単です。以下の2ステップで完了です。

    1. 認可
    2. API コール

    認可

    全てのAPIコールに以下のHTTPヘッダーを追加してください

    curl "EACH_API_END_POINT" \
      -H "x-access-token: YOUR_API_TOKEN_FROM_DASHBOARD" \
      -H "Content-Type: application/json"
    

    `YOUR_API_TOKEN_FROM_DASHBOARD`を取得したAPIトークンで置き換えてください

    Ship&Co APIは、APIダッシュボードから発行できるAPIトークンをHTTPヘッダーに指定することで認可され、利用できます。

    APIトークンの取得方法は以下です。

    1. Ship&Coダッシュボードにログインする
    2. [設定]メニューをクリックし、[API Settings]の[Token]に表示されているテキストをコピーする

    Dashboard

    コピーしたAPIトークンを以下のようにHTTPヘッダーに追加することでAPIを利用することができます。

    x-access-token: YOUR_API_TOKEN_FROM_DASHBOARD

    出荷

    出荷情報の作成

    curl -v -X POST "https://app.shipandco.com/api/v1/shipments" \
      -H "x-access-token: YOUR_API_TOKEN_FROM_DASHBOARD" \
      -H "Content-Type: application/json" \
      -d '{
        "to_address": {
          "full_name": "John Doe",
          "company": "ACME",
          "email": "john@doe.io",
          "phone": "0901231234",
          "country": "PT",
          "address1": "Rua Maria Matos, 32",
          "address2": "",
          "province": "SETUBAL",
          "zip": "2820-344",
          "city": "CHARNECA DA CAPARICA"
        },
        "from_address": {
          "full_name": "Yamada Taro",
          "company": "World Company",
          "email": "ytaro@worldcompany.com",
          "phone": "08012341234",
          "country": "JP",
          "address1": "OSAKAFU",
          "address2": "OTECHO",
          "province": "OSAKA",
          "zip": "5670883",
          "city": "IBARAKI SHI"
        },
        "products": [
          {
            "name": "Basket ball",
            "quantity": 2,
            "price": 4850,
            "hs_code": "HS9988",
            "hs_description": "Sports ball",
            "origin_country": "JP"
          }
        ],
        "parcels": [
          {
            "weight": 200,
            "amount": 1,
            "width": 10,
            "height": 10,
            "depth": 10
          }
        ],
        "customs": {
          "duty_paid": false,
          "content_type": "MERCHANDISE"
        },
        "setup": {
          "carrier": "japanpost",
          "service": "japanpost_ems",
          "currency": "JPY",
          "date": "2019-01-08",
          "insurance": 0,
          "ref_number": "",
          "delivery_note": "",
          "discount": 0,
          "signature": false
        }
    }'
    

    上記のリクエストは以下のようなレスポンスを返します。

    {
      "id": "API-O8APFNW9S8",
      "state": "active",
      "created_at": "2019-01-07T14:15:01.151Z",
      "to_address": {
        "full_name": "John Doe",
        "company": "ACME",
        "address1": "Rua Maria Matos, 32",
        "country": "PT",
        "email": "john@doe.io",
        "phone": "0901231234",
        "address2": "",
        "city": "CHARNECA DA CAPARICA",
        "province": "SETUBAL",
        "zip": "2820-344"
      },
      "from_address": {
        "full_name": "Yamada Taro",
        "company": "World Company",
        "address1": "OSAKAFU",
        "country": "JP",
        "email": "ytaro@worldcompany.com",
        "phone": "08012341234",
        "address2": "OTECHO",
        "city": "IBARAKI SHI",
        "province": "OSAKA",
        "zip": "5670883"
      },
      "products": [
        {
          "name": "Basket ball",
          "quantity": 2,
          "price": 4850,
          "hs_code": "HS9988",
          "hs_description": "Sports ball",
          "origin_country": "JP"
        }
      ],
      "parcels": [
        {
          "weight": 200,
          "amount": 1,
          "width": 10,
          "height": 10,
          "depth": 10
        }
      ],
      "customs": {
        "duty_paid": false,
        "content_type": "MERCHANDISE"
      },
      "setup": {
        "currency": "JPY",
        "insurance": 0,
        "ref_number": "",
        "delivery_note": "",
        "discount": 0,
        "return_label": false,
        "signature": false
      },
      "delivery": {
        "carrier": "japanpost",
        "method": "japanpost_ems",
        "tracking_numbers": ["EN027977320JP"],
        "label": "https://storage.googleapis.com/dev-shipandco/labels/201901/k3wWYYwk8Q8h46NcM/adbmyPqo7ev9sNkpu.pdf"
      }
    }
    

    指定した荷受人住所や荷物、製品情報、運送会社の情報を元に配送ラベル付きの出荷情報を作成します。

    リクエスト

    POST https://app.shipandco.com/api/v1/shipments

    項目 説明 必須情報
    to_address 荷受人住所です。 full_name, country, address1, city
    from_address 発送人住所です。 full_name, phone, country, address1, province
    parcels 荷物情報です。 国際の場合は最低1つの荷物情報が必要
    products 製品情報です。 name, quantity, price, hs_description, origin_country
    customs カスタム情報です。
    setup 設定情報です。
    詳細は運送業者とサービスを参照してください。
    料金の一覧を利用して最適な`service`を探すこともできます。
    carrier, service, currency

    レスポンス

    項目 説明
    id 出荷情報の一意のIDです。GETで利用できます。
    options 出荷情報のオプション情報です。
    delivery.carrier 指定した運送会社の名称です。
    delivery.tracking_numbers 出荷の追跡番号です。
    delivery.label 作成されたラベルのイメージ情報です。

    出荷情報の一覧

    curl -v -X GET "https://app.shipandco.com/api/v1/shipments?state=active&limit=2&page=1&created_after=2018-12-01T00:00:00.000Z&created_before=2019-01-30T00:00:00.000Z" \
      -H "x-access-token: YOUR_API_TOKEN_FROM_DASHBOARD" \
      -H "Content-Type: application/json"
    

    上記のリクエストは以下のようなレスポンスを返します。

    {
      "shipments": [
        {
          "id": "API-O8APFNW9S8",
          "state": "active",
          "created_at": "2019-01-07T14:15:01.151Z",
          "to_address": {
            "full_name": "John Doe",
            "company": "ACME",
            "address1": "Rua Maria Matos, 32",
            "country": "PT",
            "email": "john@doe.io",
            "phone": "0901231234",
            "address2": "",
            "city": "CHARNECA DA CAPARICA",
            "province": "SETUBAL",
            "zip": "2820-344"
          },
          "from_address": {
            "full_name": "Yamada Taro",
            "company": "World Company",
            "address1": "OSAKAFU",
            "country": "JP",
            "email": "ytaro@worldcompany.com",
            "phone": "08012341234",
            "address2": "OTECHO",
            "city": "IBARAKI SHI",
            "province": "OSAKA",
            "zip": "5670883"
          },
          "products": [
            {
              "name": "Basket ball",
              "quantity": 2,
              "price": 4850,
              "hs_code": "HS9988",
              "hs_description": "Sports ball",
              "origin_country": "JP"
            }
          ],
          "parcels": [
            {
              "weight": 200,
              "amount": 1,
              "width": 10,
              "height": 10,
              "depth": 10
            }
          ],
          "customs": {
            "duty_paid": false,
            "content_type": "MERCHANDISE"
          },
          "setup": {
            "currency": "JPY",
            "insurance": 0,
            "ref_number": "",
            "delivery_note": "",
            "discount": 0,
            "return_label": false,
            "signature": false
          },
          "delivery": {
            "carrier": "japanpost",
            "method": "japanpost_ems",
            "tracking_numbers": ["EN027977320JP"],
            "label": "https://storage.googleapis.com/dev-shipandco/labels/201901/k3wWYYwk8Q8h46NcM/undefined.pdf"
          }
        },
        {
          "id": "API-K3EDGXX9SF",
          "state": "active",
          "created_at": "2019-01-07T14:09:24.828Z",
          "to_address": {
            "full_name": "太郎山田",
            "address1": "京都市東山区",
            "country": "JP",
            "email": "yamada.taro@demo.com",
            "phone": "08012341234",
            "address2": "西海子町",
            "address3": "神宮道",
            "province": "京都府",
            "zip": "6050012"
          },
          "from_address": {
            "company": "株式会社ACME",
            "address1": "中央区",
            "country": "JP",
            "email": "yamada.hanako@acme.com",
            "phone": "08012341234",
            "address2": "日本橋堀留町",
            "address3": "タワー #1001",
            "province": "東京都",
            "zip": "1030012"
          },
          "products": [
            {
              "name": "Basket ball",
              "quantity": 2,
              "price": 4850,
              "hs_code": ""
            }
          ],
          "setup": {
            "currency": "JPY",
            "insurance": 0,
            "ref_number": "",
            "delivery_note": "",
            "discount": 0,
            "pack_size": "60",
            "pack_amount": 1,
            "date": "2019-01-08",
            "time": "16-18",
            "care": {
              "fragile": false,
              "side_up": false,
              "valuable_goods": false
            },
            "pick_up": false,
            "print_start_location": "4"
          },
          "delivery": {
            "carrier": "yamato",
            "method": "yamato_regular",
            "tracking_numbers": ["436966892191"],
            "label": "https://storage.googleapis.com/dev-shipandco/labels/201901/k3wWYYwk8Q8h46NcM/undefined.pdf"
          }
        }
      ],
      "count": 3,
      "pages": 2,
      "current_page": 1
    }
    

    作成した出荷情報を一覧表示します。

    リクエスト

    GET https://app.shipandco.com/api/v1/shipments

    項目 説明
    state 初期値 `active`, 指定可能な値: `active, voided, any`

    その他の項目はGETパラメータを参照してください。

    レスポンス

    作成した出荷情報の配列です。出荷情報の詳細は出荷情報の作成を参照してください。

    その他の項目はGETレスポンスを参照してください。

    出荷情報の取得

    curl -v -X GET "https://app.shipandco.com/api/v1/shipments/API-H8TNUMIUBL" \
      -H "x-access-token: YOUR_API_TOKEN_FROM_DASHBOARD" \
      -H "Content-Type: application/json"
    

    上記のリクエストは以下のようなレスポンスを返します。

    {
      "id": "API-O8APFNW9S8",
      "state": "active",
      "created_at": "2019-01-07T14:15:01.151Z",
      "to_address": {
        "full_name": "John Doe",
        "company": "ACME",
        "address1": "Rua Maria Matos, 32",
        "country": "PT",
        "email": "john@doe.io",
        "phone": "0901231234",
        "address2": "",
        "city": "CHARNECA DA CAPARICA",
        "province": "SETUBAL",
        "zip": "2820-344"
      },
      "from_address": {
        "full_name": "Yamada Taro",
        "company": "World Company",
        "address1": "OSAKAFU",
        "country": "JP",
        "email": "ytaro@worldcompany.com",
        "phone": "08012341234",
        "address2": "OTECHO",
        "city": "IBARAKI SHI",
        "province": "OSAKA",
        "zip": "5670883"
      },
      "products": [
        {
          "name": "Basket ball",
          "quantity": 2,
          "price": 4850,
          "hs_code": "HS9988",
          "hs_description": "Sports ball",
          "origin_country": "JP"
        }
      ],
      "parcels": [
        {
          "weight": 200,
          "amount": 1,
          "width": 10,
          "height": 10,
          "depth": 10
        }
      ],
      "customs": {
        "duty_paid": false,
        "content_type": "MERCHANDISE"
      },
      "setup": {
        "currency": "JPY",
        "insurance": 0,
        "ref_number": "",
        "delivery_note": "",
        "discount": 0,
        "return_label": false,
        "signature": false
      },
      "delivery": {
        "carrier": "japanpost",
        "method": "japanpost_ems",
        "tracking_numbers": ["EN027977320JP"],
        "label": "https://storage.googleapis.com/dev-shipandco/labels/201901/k3wWYYwk8Q8h46NcM/undefined.pdf"
      }
    }
    

    出荷情報をIDで取得します。

    リクエスト

    GET https://app.shipandco.com/api/v1/shipments/:id

    レスポンス

    1つの出荷情報を返します。出荷情報の詳細は出荷情報の作成を参照してください。

    料金

    料金の一覧

    curl -v -X POST "https://app.shipandco.com/api/v1/rates" \
      -H "x-access-token: YOUR_API_TOKEN_FROM_DASHBOARD" \
      -H "Content-Type: application/json" \
      -d '{
        "to_address": {
          "full_name": "John Doe",
          "company": "ACME",
          "email": "john@doe.io",
          "phone": "0901231234",
          "country": "PT",
          "address1": "Rua Maria Matos, 32",
          "address2": "",
          "province": "SETUBAL",
          "zip": "2820-344",
          "city": "CHARNECA DA CAPARICA"
        },
        "from_address": {
          "full_name": "Yamada Taro",
          "company": "World Company",
          "email": "ytaro@worldcompany.com",
          "phone": "08012341234",
          "country": "JP",
          "address1": "OSAKAFU",
          "address2": "OTECHO",
          "province": "OSAKA",
          "zip": "5670883",
          "city": "IBARAKI SHI"
        },
        "products": [
          {
            "name": "Basket ball",
            "quantity": 2,
            "price": 4850,
            "hs_code": "HS9988",
            "hs_description": "Sports ball",
            "origin_country": "JP"
          }
        ],
        "parcels": [
          {
            "weight": 200,
            "amount": 1,
            "width": 10,
            "height": 10,
            "depth": 10
          }
        ],
        "customs": {
          "duty_paid": false,
          "content_type": "MERCHANDISE"
        },
        "setup": {
          "carrier": "japanpost",
          "currency": "JPY",
          "date": "2019-01-08",
          "insurance": 0,
          "ref_number": "",
          "delivery_note": "",
          "discount": 0,
          "signature": false
        }
    }'
    

    上記のリクエストは以下のようなレスポンスを返します。

    [
      {
        "carrier": "japanpost",
        "service": "japanpost_ems",
        "currency": "JPY",
        "price": 2200,
        "surcharges": []
      },
      {
        "carrier": "japanpost",
        "service": "japanpost_registered_mail",
        "currency": "JPY",
        "price": 690,
        "surcharges": []
      },
      {
        "carrier": "japanpost",
        "service": "japanpost_epacket",
        "currency": "JPY",
        "price": 785,
        "surcharges": []
      },
      {
        "carrier": "japanpost",
        "service": "japanpost_epacket_light",
        "currency": "JPY",
        "price": 620,
        "surcharges": []
      },
      {
        "carrier": "japanpost",
        "service": "airparcel",
        "currency": "JPY",
        "price": 2500,
        "surcharges": []
      },
      {
        "carrier": "japanpost",
        "service": "salparcel",
        "currency": "JPY",
        "price": 2700,
        "surcharges": []
      },
      {
        "carrier": "japanpost",
        "service": "seaparcel",
        "currency": "JPY",
        "price": 1800,
        "surcharges": []
      }
    ]
    

    作成する出荷情報を元に指定した運送業者のサービスごとの料金を一覧表示します。

    リクエスト

    POST https://app.shipandco.com/api/v1/rates

    `service`を除いた出荷情報の作成と同じです。詳細は、出荷情報の作成を参照してください。

    レスポンス

    各サービスの料金の配列です。詳細は、運送業者とサービスを参照してください。

    共通定義

    運送業者とサービス

    運送業者 サービスの値 海外 / 国内
    日本郵便 海外 japanpost japanpost_ems, japanpost_epacket, japanpost_epacket_light, japanpost_registered_mail, japanpost_economy_air, japanpost_airmail 海外
    日本郵便 国内(ゆうパック) yuupack yuupack_regular, yuupack_fresh, yuupack_frozen, regular 国内
    UPS ups ups_saver, ups_worldwide_express, ups_worldwide_express_plus, ups_worldwide_expedited 海外
    DHL dhl dhl_express_worldwide, dhl_express_1200, dhl_express_0900, dhl_express_jumbo 海外
    DHL eCommerce Asia dhlecasia dhlec_asia_pps, dhlec_asia_pkd, dhlec_asia_ple, dhlec_asia_plt, dhlec_asia_pld, dhlec_asia_pkg 海外
    FedEx fedex fedex_international_economy, fedex_international_first, fedex_international_priority 海外
    佐川急便 sagawa sagawa_fresh, sagawa_frozen, sagawa_plane, sagawa_regular 国内
    ヤマト運輸 yamato yamato_regular, yamato_collect, yamato_direct_mail, yamato_time, yamato_freight_on_delivery, yamato_nekopos, yamato_taqbin, yamato_taqbin_collect 国内
    ペガサス pegasus pegasus_dhl, pegasus_ups, pegasus_ems 海外
    運送業者 荷物サイズの値 配達時間の値
    ----------------- ---------------- ----------------
    佐川急便 60, 80, 100, 140, 160 not-specified, before-noon, 12-14, 14-16, 16-18, 18-20, 19-21, 18-21
    日本郵便 国内(ゆうパック) 60, 80, 100, 120, 140, 160, 170 not-specified, before-noon, 12-14, 14-16, 16-18, 18-20, 19-21, 20-21
    ヤマト運輸 not-specified, before-noon, 14-16, 16-18, 18-20, 19-21
    項目 説明 海外 / 国内
    carrier 文字列。 出荷情報に使う配送業者の種類。指定可能は値は`japanpost`、`ups`、`fedex`、`dhl`、`dhlecasia`、`sagawa`、`yamato`、`yuupack`。 海外, 国内
    service 文字列。 選択した運送業者のサービスの名称。上記リストの運送業者ごとの指定可能な値を参照。 海外, 国内
    currency 文字列。 出荷情報の通貨。ISO 4217の値のみ有効。 海外, 国内
    date 文字列。 出荷情報の日付。ISO 8601書式。例:`2018-09-20T00:00:00.000Z` 海外, 国内
    time 文字列。 運送業者依存の配達時間。`yamato`、`sagawa`、`yuupack`にのみ有効。上記リストを参照。 国内
    insurance 数値。 出荷情報と同じ通貨での保険金額。`japanpost`、`dhl`、`dhlecasia`、`ups`、`fedex`にのみ有効。 海外
    ref_number 文字列。 配送ラベルへの参照番号が必要な時に指定。 海外, 国内
    delivery_note 文字列。 配送に関するメモが必要な場合に指定。 海外, 国内
    signature ブーリアン型。 いくつかの運送業者の有料サービス。 海外
    cool_options 文字列。 指定可能な値は`regular`、`fresh`、`frozen`. 国内
    care オブジェクト。 `fragile`: (boolean), `side_up`: (boolean), `valuable_goods`: (boolean) 国内
    pack_size 文字列。 運送業者依存の荷物サイズ。上記リストを参照。 国内
    cash_on_delivery オブジェクト。 `amount`: (integer), `tax`: (integer) 国内

    GETパラメータ

    項目 説明
    limit 初期値 `50`, 最大値 `250`
    page 初期値 `1`
    created_after 書式 `2018-09-20T00:00:00.000Z`
    created_before 初期値 `today` 書式 `2018-09-20T00:00:00.000Z`

    GETレスポンス

    項目 説明
    count データ数
    pages レスポンスのページ数(GETパラメータで指定可能)
    current_page レスポンスの現在ページ(GETパラメータで指定可能)

    エラー

    Ship&Co APIには以下のエラーコードがあります。

    正常時には200を返します。

    エラーコード 説明
    400 不正な入力または入力不足によるエラー
    403 APIトークンが未指定か間違っています
    404 指定されたデータが見つかりません
    500 内部エラー