FedEx-ով ինտեգրման օրինակ

Այս ուսուցողական դասում մենք ցույց կտանք, թե ինչպես ինտեգրել FedEx

1. Նախապատրաստական աշխատանքներ

1.1. Ստեղծեք հաշիվ FedEx-ում

Ստեղծեք հաշիվ մշակողների պորտալում

1.2. Ստեղծեք նախագծեր և ստացեք տոքեններ

Ստեղծեք 2 նախագիծ իմ նախագծեր բաժնում և պահպանեք client id և client secret

Առաջին նախագիծը առաքումների կառավարման համար

Երկրորդ նախագիծը առաքումների հետևման համար

1.3. Ստեղծեք առաքման կարգավիճակներ

Պատվերների պահեստի կարգավիճակների вкладка ստեղծեք կարգավիճակներ:

order_delivery
order_delivery_started
ready_for_pickup

1.4. Ստեղծեք իրադարձություն կարգավիճակների հետևելու համար

Events մոդուլում ստեղծեք իրադարձություն պատվերի կարգավիճակի փոփոխության հետևելու համար order_delivery.

1.5. Ստեղծեք առաքման հավաքածու

Integration Collections մոդուլում ստեղծեք առաքման հավաքածու հետևյալ հատկություններով:

name (string)
address (string)
phone_number (string)
city (string)
state_code (string)
postal_code (string)
country_code (string)
tracking_number (string)
transaction_id (string)
ship_datestamp (string)
delivery_datestamp (string)

1.6. Ստեղծեք փորձնական պատվեր

Ստեղծեք պատվեր և գրառում այս պատվերի համար հավաքածուում:

2. Առաքման ստեղծում

2.1. Առաքման իրադարձության հետևում

Տեղափոխեք events նոդը աշխատանքային տարածք:
Մուտքագրեք նոդի անունը
Փոխեք "Set" դաշտի արժեքը "orderEvent" վրա:
Իրադարձությունը կպահպանվի "msg.orderEvent" օբյեկտում և այն կարելի է օգտագործել այլ նոդերում:
Ընտրեք ստեղծված "order delivery" իրադարձությունը և սեղմեք "submit"

2.2. Տոքեն ստանալ

Տեղափոխեք function նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Վերցրեք օրինակից կոդը "Function" դաշտում:
Փոխարինեք YOUR_CLIENT_ID և OUR_CLIENT_SECRET ձերով

msg.payload = {
    'grant_type': 'client_credentials',
    'client_id': 'YOUR_CLIENT_ID',
    'client_secret': 'YOUR_CLIENT_SECRET'
}
msg.headers = {
    'Content-Type': 'application/x-www-form-urlencoded'
}

return msg;

Ավելին պարամետրերի մասին կարող եք իմանալ FedEx-ի փաստաթղթերում

Տեղափոխեք http request նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ընտրեք "POST" մեթոդը "Method" դաշտում:
Ընտրեք "Send as request body" "Data" դաշտում:
"Link" դաշտում մուտքագրեք https://apis-sandbox.fedex.com/oauth/token հղումը:
Ընտրեք "Object JSON" "Return" դաշտում:

Տեղափոխեք function նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Վերցրեք օրինակից կոդը "Function" դաշտում:

msg.access_token = msg.payload.access_token;

return msg;

2.3. Առաքման ստեղծում

Տեղափոխեք api նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ընտրեք "Find collection rows" մեթոդը և "Data" դաշտում մուտքագրեք ստորև ներկայացված կոդը:

{
  "collectionIdentifier": "delivery",
  "entityId": "{{orderEvent.order.id}}",
  "entityType": "orders",
  "langCode": "en_US",
  "limit": 1,
  "offset": 0
}

Տեղափոխեք function նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Վերցրեք օրինակից կոդը "Function" դաշտում:

// ստանում ենք նախապես պահպանված տոքենը
const token = msg.access_token;

// սահմանում ենք վերնագրերը
msg.headers = {
    'Content-Type': 'application/json',
    'authorization': `Bearer ${token}`
};

// ստանում ենք հավաքածուները նախորդ քայլից
const collection = msg.payload.items[0];
// վերածում ենք զանգվածը օբյեկտի
const formData = collection.formData.reduce((acc, item) => {
  acc[item.marker] = item.value;
  return acc;
}, {});
// սահմանում ենք ստացողի պարամետրերը ձևից
const recipient = {
  "address": {
    "streetLines": [
      formData.address
    ],
    "city": formData.city,
    "stateOrProvinceCode": formData.state_code,
    "postalCode": formData.postal_code,
    "countryCode": formData.country_code
  },
  "contact": {
    "personName": formData.name,
    "phoneNumber": formData.phone_number
  }
}
// սահմանում ենք հավաքածուի տվյալները msg-ում, որպեսզի օգտագործենք ապագայում
msg.collection = collection;
// սահմանում ենք FedEx-ի համար հարցման պարամետրերը
msg.payload = {
  "labelResponseOptions": "URL_ONLY",
  "accountNumber": {
    "value": "510087020"
  },
  "requestedShipment": {
    "shipper": {
      "contact": {
        "personName": "SENDER NAME",
        "phoneNumber": "9018328595"
      },
      "address": {
        "streetLines": [
          "SENDER ADDRESS 1"
        ],
        "city": "MEMPHIS",
        "stateOrProvinceCode": "TN",
        "postalCode": "38116",
        "countryCode": "US"
      }
    },
    "recipients": [
      recipient
    ],
    "serviceType": "STANDARD_OVERNIGHT",
    "packagingType": "YOUR_PACKAGING",
    "pickupType": "DROPOFF_AT_FEDEX_LOCATION",
    "shippingChargesPayment": {
      "paymentType": "SENDER",
      "payor": {
        "responsibleParty": {
          "accountNumber": {
            "value": "510087020",
            "key": ""
          }
        },
        "address": {
          "streetLines": [
            "SENDER ADDRESS 1"
          ],
          "city": "MEMPHIS",
          "stateOrProvinceCode": "TN",
          "postalCode": "38116",
          "countryCode": "US"
        }
      }
    },
    "labelSpecification": {},
    "requestedPackageLineItems": [
      {
        "customerReferences": [
          {
            "customerReferenceType": "CUSTOMER_REFERENCE",
            "value": `Collection${collection.id}`
          }
        ],
        "weight": {
          "units": "LB",
          "value": "20"
        }
      }
    ]
  }
};

return msg;

Ավելին պարամետրերի մասին կարող եք իմանալ FedEx-ի փաստաթղթերում

Տեղափոխեք http request նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ընտրեք "POST" մեթոդը "Method" դաշտում:
Ընտրեք "Send as request body" "Data" դաշտում:
"Link" դաշտում մուտքագրեք https://apis-sandbox.fedex.com/ship/v1/shipments հղումը:
Ընտրեք "Object JSON" "Return" դաշտում:

Տեղափոխեք debug նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:

Տեղափոխեք function նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Վերցրեք օրինակից կոդը "Function" դաշտում:

// ստանում ենք առաքման տվյալները
const shipment = msg.payload.output.transactionShipments[0];
// ստանում ենք հավաքածուի տվյալները, որոնք պահպանվել են նախկինում
const collection = msg.collection;

// գրանցում ենք ձևի հատկություններում առաքման տվյալները
const newFormData = [
  ...collection.formData
    .filter(item => !['transaction_id', 'ship_datestamp', 'delivery_datestamp', 'tracking_number'].includes(item.marker)),
  {
    marker: 'transaction_id',
    value: msg.payload.transactionId,
    type: 'string'
  },
  {
    marker: 'ship_datestamp',
    value: shipment.shipDatestamp,
    type: 'string'
  },
  {
    marker: 'delivery_datestamp',
    value: shipment.pieceResponses[0].deliveryDatestamp,
    type: 'string'
  },
  {
    marker: 'tracking_number',
    value: shipment.masterTrackingNumber,
    type: 'string'
  }
]

// սահմանում ենք հավաքածուի թարմացման պարամետրերը
msg.payload = {
  id: collection.id,
  collectionIdentifier: 'delivery',
  formData: {
    en_US: newFormData
  },
  formIdentifier: 'delivery_form',
  entityId: collection.entityId,
  entityType: collection.entityType,
  langCode: 'en_US',
}

// պահպանում ենք հավաքածուի տվյալները, որպեսզի օգտագործենք հետագայում
msg.collection = msg.payload;

return msg;

Տեղափոխեք api նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ընտրեք "Update collection row" մեթոդը:

2.4. Պատվերի կարգավիճակի թարմացում

Տեղափոխեք api նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ընտրեք "Update order status" մեթոդը և "Data" դաշտում մուտքագրեք ստորև ներկայացված կոդը:

{
  "orderId": "{{collection.entityId}}",
  "storageId": "test_order_storage",
  "statusIdentifier": "order_delivery_started"
}

Տեղափոխեք debug նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:

3. Առաքման կարգավիճակի հետևում

3.1. Պատվերների ստացում հետևելու համար

Տեղափոխեք interval նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Մուտքագրեք րոպեների միջակայքը:

Տեղափոխեք api նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ընտրեք "Find orders by status" մեթոդը և "Data" դաշտում մուտքագրեք ստորև ներկայացված կոդը:

{
  "storageId": "test_order_storage",
  "statusIdentifier": "order_delivery_started"
}

Տեղափոխեք function նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Վերցրեք օրինակից կոդը "Function" դաշտում:

msg.payload = msg.payload.items;

return msg;

Տեղափոխեք split նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Մուտքագրեք երկարությունը:

Տեղափոխեք api նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ընտրեք "Find collection row" մեթոդը և "Data" դաշտում մուտքագրեք ստորև ներկայացված կոդը:

{
  "collectionIdentifier": "delivery",
  "entityId": "{{payload.id}}",
  "entityType": "orders",
  "langCode": "en_US",
  "limit": 1,
  "offset": 0
}

Տեղափոխեք function նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Վերցրեք օրինակից կոդը "Function" դաշտում:

msg.payload = msg.payload.items[0]

return msg;

Տեղափոխեք switch նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին.
Ավելացրեք կանոն ստուգման համար: Ընտրեք "not empty" պայմանը:

Տեղափոխեք function նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Վերցրեք օրինակից կոդը "Function" դաշտում:

msg.trackingNumber = msg.payload
  .formData
  .find(item => item.marker === 'tracking_number')
  .value;

msg.collection = msg.payload;

return msg;

3.2. Տոքեն ստանալ

Տեղափոխեք function նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Վերցրեք օրինակից կոդը "Function" դաշտում:
Փոխարինեք YOUR_CLIENT_ID և OUR_CLIENT_SECRET ձերով

msg.payload = {
    'grant_type': 'client_credentials',
    'client_id': 'YOUR_CLIENT_ID',
    'client_secret': 'YOUR_CLIENT_SECRET'
}
msg.headers = {
    'Content-Type': 'application/x-www-form-urlencoded'
}

return msg;

Ավելին պարամետրերի մասին կարող եք իմանալ FedEx-ի փաստաթղթերում

Տեղափոխեք http request նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ընտրեք "POST" մեթոդը "Method" դաշտում:
Ընտրեք "Send as request body" "Data" դաշտում:
"Link" դաշտում մուտքագրեք https://apis-sandbox.fedex.com/oauth/token հղումը:
Ընտրեք "Object JSON" "Return" դաշտում:

3.3. Առաքման կարգավիճակի ստացում

Տեղափոխեք function նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Վերցրեք օրինակից կոդը "Function" դաշտում:

const token = msg.payload.access_token;

msg.headers = {
    'content-type': 'application/json',
    'authorization': `Bearer ${token}`
};

msg.payload = {
  "trackingInfo": [
    {
      "trackingNumberInfo": {
        "trackingNumber": msg.trackingNumber
      }
    }
  ],
  "includeDetailedScans": true
}

return msg;

Ավելին պարամետրերի մասին կարող եք իմանալ FedEx-ի փաստաթղթերում

Տեղափոխեք http request նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ընտրեք "POST" մեթոդը "Method" դաշտում:
Ընտրեք "Send as request body" "Data" դաշտում:
"Link" դաշտում մուտքագրեք https://apis-sandbox.fedex.com/track/v1/trackingnumbers հղումը:
Ընտրեք "Object JSON" "Return" դաշտում:

Տեղափոխեք function նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Վերցրեք օրինակից կոդը "Function" դաշտում:

msg.payload = msg.payload.output.completeTrackResults[0].trackResults[0].latestStatusDetail.statusByLocale;

return msg;

3.4. Պատվերի կարգավիճակի թարմացում

Տեղափոխեք switch նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ավելացրեք կանոն ստուգման համար: Ընտրեք "==" պայմանը, արժեքում մուտքագրեք "Ready for pickup"

Տեղափոխեք api նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:
Ընտրեք "Update order status" մեթոդը և "Data" դաշտում մուտքագրեք ստորև ներկայացված կոդը:

{
  "orderId": "{{collection.entityId}}",
  "storageId": "test_order_storage",
  "statusIdentifier": "ready_for_pickup"
}

Տեղափոխեք debug նոդը աշխատանքային տարածք և միացրեք նախորդ քայլի նոդին:

FedEx-ով ինտեգրման օրինակ

1. Նախապատրաստական աշխատանքներ​

2. Առաքման ստեղծում​

3. Առաքման կարգավիճակի հետևում​

1. Նախապատրաստական աշխատանքներ

2. Առաքման ստեղծում

3. Առաքման կարգավիճակի հետևում