FedEx Dataworks(미리 보기)
FedEx Corp.는 전 세계 고객과 비즈니스에 광범위한 운송, 전자 상거래 및 비즈니스 서비스 포트폴리오를 제공합니다. 교통 선택 서비스 API에 연결하여 운송 계획에 대한 순위 및 서비스 권장 사항을 받습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | 지역 |
|---|---|---|
| 논리 앱 | 표준 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | 마이크로소프트 다이내믹스 |
| URL | https://aka.ms/iomsupport |
| 전자 메일 | iomdri@microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| Publisher | 마이크로소프트 |
| 웹 사이트 | https://www.fedex.com/ |
| 개인 정보 보호 정책 | https://www.fedex.com/en-us/trust-center.html |
| 카테고리 | 상업; 비즈니스 관리 |
FedEx Dataworks 커넥터는 Dynamics 365 Intelligent Order Management의 공급자 통합에 사용하도록 특별히 개발되었습니다.
사전 요구 사항
온보딩 프로세스는 FedEx에 문의하세요.
참고: 이 커넥터를 사용하여 Dynamics 365 Intelligent Order Management FedEx 공급자를 설정하는 것이 좋습니다.
자격 증명을 가져오는 방법
- 온보딩 프로세스의 일환으로 Dataworks 개발 팀이 Microsoft Entra ID 자격 증명을 암호화할 수 있도록 각 브랜드가 PGP 키 쌍을 생성해야 합니다. 암호화를 수행하려면 공개 키를 Dataworks 개발 팀에 보내야 합니다.
- GnuPG를 사용하여 PGP 키 쌍을 생성할 수 있습니다. 지정된 링크에서 다운로드할 수 있습니다. https://gpg4win.org/get-gpg4win.html
- Dataworks 개발 팀에서 클라이언트 암호를 프로비전한 후에는 키가 브랜드로 전송됩니다. 브랜드가 키를 소유하고 있으면 해독할 수 있습니다.
- 추가 세부 정보는 온보딩 프로세스의 일부로 공유됩니다.
커넥터 시작
클라이언트 자격 증명을 사용하여 FedEx 공급자를 사용하도록 설정하려면 다음을 수행 https://docs.microsoft.com/en-us/dynamics365/intelligent-order-management/work-providers#set-up-a-provider 합니다.
알려진 문제 및 제한 사항
이 커넥터는 Dynamics 365 Intelligent Order Management의 FedEx 공급자 통합에 사용하도록 특별히 개발되었습니다. Dynamics 365 Intelligent Order Management 이외의 사용 사례에 대한 지원은 제한됩니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | 설명 | 필수 |
|---|---|---|---|
| 클라이언트 ID | 문자열 | FedEx Dataworks 클라이언트 ID | 진실 |
| 클라이언트 암호 | 시큐어스트링 (보안 문자열) | FedEx Dataworks 클라이언트 암호 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
| 트리거 폴링 빈도 | 1 | 15초 |
동작
| 교통 계획 점수 가져오기 |
교통 계획 점수를 가져옵니다. |
| 예측 배달 예측 가져오기 |
예측 배달 예상을 가져옵니다. |
| 웹후크 알림 HMACSHA256 서명 유효성 검사 |
웹후크 알림 HMACSHA256 서명의 유효성을 검사합니다. |
| 이벤트별 지정된 회사에 대한 웹후크 구독 |
이벤트별로 지정된 회사에 대한 웹후크 구독입니다. |
| 이벤트별로 지정된 회사에 대한 웹후크 구독 삭제 |
이벤트별로 지정된 회사에 대한 웹후크 구독을 삭제합니다. |
| 이벤트별로 지정된 회사에 대한 웹후크 등록 삭제 |
이벤트별로 지정된 회사에 대한 웹후크 등록을 삭제합니다. |
| 지정된 회사에 대한 이벤트별 웹후크 등록 목록에 대한 정보 가져오기 |
지정된 회사에 대한 이벤트별 웹후크 등록 목록에 대한 정보를 가져옵니다. |
| 지정된 회사의 웹후크 구독 목록에 대한 정보 가져오기 |
지정된 회사의 웹후크 구독 목록에 대한 정보를 가져옵니다. |
교통 계획 점수 가져오기
교통 계획 점수를 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
httpStatusCode
|
httpStatusCode | integer |
응답의 Http 상태 코드입니다. |
|
responseDateTime
|
data.responseDateTime | string |
응답 날짜 시간입니다. |
|
transportationPlanScores
|
data.transportationPlanScores | array of object |
점수가 있는 교통 계획 목록입니다. |
|
planId
|
data.transportationPlanScores.planId | string |
계획의 고유 식별자입니다. |
|
value
|
data.transportationPlanScores.score.value | string |
정수의 서수 오름차순입니다. |
|
신뢰 수준
|
data.transportationPlanScores.score.confidence | string |
신뢰도 세부 정보입니다. |
|
shipmentServiceConditions
|
data.transportationPlanScores.shipmentServiceConditions | array of object |
배송 배달 서비스 조건. |
|
shipmentId
|
data.transportationPlanScores.shipmentServiceConditions.shipmentId | string |
배송의 고유 식별자입니다. |
|
serviceCode
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.serviceCode | string |
배송 배달을 위한 서비스 코드입니다. |
|
carrier
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.carrier | string |
운송업체 정보입니다. |
|
estimatedDeliveryDate
|
data.transportationPlanScores.shipmentServiceConditions.recommendedTransportationService.estimatedDeliveryDate | string |
예상 배송 날짜입니다. |
|
results
|
results | array of object |
상태를 포함하는 결과 목록입니다. |
|
상태
|
results.status | array of object | |
|
코드
|
results.status.code | string |
응답에 대한 오류 또는 정보 코드입니다. |
|
severity
|
results.status.severity | string |
응답 상태의 심각도는 ERROR/FATAL/INFO일 수 있습니다. |
|
메시지
|
results.status.message | string |
위의 코드를 설명하는 메시지입니다. |
|
경로
|
results.status.path | string |
상태가 제공되는 필드의 경로입니다. |
|
Helpurl
|
results.status.helpUrl | string |
코드 및 메시지에 대한 자세한 정보를 가져오기 위한 URL입니다. |
|
recommendedRetryMinutes
|
results.status.recommendedRetryMinutes | integer |
동일한 요청을 다시 시도할 수 있는 재시도 시간(분)입니다. |
|
version
|
version | string |
API의 버전입니다. |
|
requestTimeStamp
|
requestTimeStamp | string |
요청 날짜 시간입니다. |
예측 배달 예측 가져오기
예측 배달 예상을 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
originofpackage
|
responsebody.originofpackage | string |
패키지의 원본 |
|
destinationofpackage
|
responsebody.destinationofpackage | string |
패키지 대상 |
|
datetimeofpossession
|
responsebody.datetimeofpossession | string |
소유 날짜/시간 |
|
edds
|
responsebody.edds | array of object |
edds |
|
requestid
|
responsebody.metadata.requestid | string |
Requestid |
|
shipperId
|
responsebody.metadata.shipperId | string |
ShipperId |
웹후크 알림 HMACSHA256 서명 유효성 검사
웹후크 알림 HMACSHA256 서명의 유효성을 검사합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
메시지 서명
|
MessageSignature | True | string |
유효성을 검사할 메시지 서명입니다. |
|
비밀 키
|
SecretKey | True | string |
HMAC에 대한 비밀 키입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
isValid
|
isValid | boolean |
isValid |
이벤트별 지정된 회사에 대한 웹후크 구독
이벤트별로 지정된 회사에 대한 웹후크 구독입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이벤트
|
event | True | string |
이벤트 유형- EDD_CHANGED 또는 EDTW_CHANGED. |
|
등록ID
|
registrationId | True | string |
웹후크에 등록할 때 생성된 WebhookId입니다. |
|
콜백 URL
|
callbackUrl | string |
등록에 사용된 항목을 재정의하도록 선택한 경우 업데이트를 보내는 데 사용되는 클라이언트의 콜백 URL입니다. |
|
|
key
|
key | True | string |
회사에서 정보를 추적할 수 있는 허용 방법- trackingNumber. |
|
values
|
values | True | array of string |
상태 업데이트를 수신하는 데 관심이 있는 ID 추적 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공한
|
successful | boolean |
참 또는 거짓 |
|
오류 코드
|
errorCode | string |
오류 코드입니다. |
|
errorMessage
|
errorMessage | string |
오류 메시지입니다. |
|
subscriptionId
|
subscriptionId | array of string |
삽입된 구독 ID 목록입니다. |
이벤트별로 지정된 회사에 대한 웹후크 구독 삭제
이벤트별로 지정된 회사에 대한 웹후크 구독을 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
아래 첨자 ID
|
subscriptionId | True | string |
삭제할 아래 첨자 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공한
|
successful | boolean |
참 또는 거짓 |
|
오류 코드
|
errorCode | string |
오류 코드입니다. |
|
errorMessage
|
errorMessage | string |
오류 메시지입니다. |
|
subscriptionId
|
subscriptionId | string |
구독 ID가 삭제되었습니다. |
이벤트별로 지정된 회사에 대한 웹후크 등록 삭제
이벤트별로 지정된 회사에 대한 웹후크 등록을 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
등록 ID
|
registrationId | string |
삭제할 등록 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공한
|
successful | boolean |
참 또는 거짓 |
|
오류 코드
|
errorCode | string |
오류 코드입니다. |
|
errorMessage
|
errorMessage | string |
오류 메시지입니다. |
지정된 회사에 대한 이벤트별 웹후크 등록 목록에 대한 정보 가져오기
지정된 회사에 대한 이벤트별 웹후크 등록 목록에 대한 정보를 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공한
|
successful | boolean |
참 또는 거짓 |
|
오류 코드
|
errorCode | string |
오류 코드입니다. |
|
errorMessage
|
errorMessage | string |
오류 메시지입니다. |
|
events
|
events | array of object |
지정된 회사가 등록한 이벤트를 나열합니다. |
|
인증 URL
|
events.authUrl | string |
클라이언트의 OAuth2 권한 부여 엔드포인트입니다. |
|
콜백 URL
|
events.callbackUrl | string |
업데이트를 보내는 데 사용되는 클라이언트의 콜백 URL입니다. |
|
callbackClientId
|
events.callbackClientId | string |
클라이언트 환경 권한 부여에 사용되는 클라이언트 ID입니다. |
|
callbackSignatureAlgorithm
|
events.callbackSignatureAlgorithm | string |
서명 algorithim은 hmac-sha256을 사용하여 이 페이로드에 대한 서명을 생성하는 데 사용됩니다. |
|
등록ID
|
events.registrationId | string |
지정된 등록을 고유하게 식별하는 식별자입니다. |
지정된 회사의 웹후크 구독 목록에 대한 정보 가져오기
지정된 회사의 웹후크 구독 목록에 대한 정보를 가져옵니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
성공한
|
successful | boolean |
참 또는 거짓 |
|
오류 코드
|
errorCode | string |
오류 코드입니다. |
|
errorMessage
|
errorMessage | string |
오류 메시지입니다. |
|
subscriptionId
|
subscriptionId | array of string |
페치된 구독 ID 목록입니다. |
트리거
| 이벤트별로 지정된 회사에 대한 웹후크 등록 |
이벤트별로 지정된 회사에 대한 웹후크 등록입니다. |
이벤트별로 지정된 회사에 대한 웹후크 등록
이벤트별로 지정된 회사에 대한 웹후크 등록입니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
이벤트
|
event | True | string |
이벤트 유형- EDD_CHANGED 또는 EDTW_CHANGED. |
|
callbackSignatureSecretKey
|
callbackSignatureSecretKey | True | string |
클라이언트는 콜백을 사용하여 서명을 생성하는 비밀을 제공합니다. |
|
callbackAuthUrl
|
callbackAuthUrl | string |
클라이언트의 OAuth2 권한 부여 엔드포인트입니다. |
|
|
callbackClientId
|
callbackClientId | string |
클라이언트 환경 권한 부여에 사용되는 클라이언트 ID입니다. |
|
|
callbackClientSecret
|
callbackClientSecret | string |
클라이언트 환경 권한 부여에 사용되는 암호화된 클라이언트의 비밀입니다. |
|
|
callbackSignatureAlgorithm
|
callbackSignatureAlgorithm | True | string |
서명 algorithim은 hmac-sha256을 사용하여 이 페이로드에 대한 서명을 생성하는 데 사용됩니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
ftmTrackingNumber
|
ftmTrackingNumber | string |
배송 식별자입니다. |
|
ftmTrackingQualifier
|
ftmTrackingQualifier | string |
한정자는 OpCo 내에서 배송을 고유하게 식별하는 데 사용됩니다. |
|
ftmTrackingCarrier
|
ftmTrackingCarrier | string |
패키지 캐리어 OpCo. |
|
eddTime
|
eddTime | string |
GDPP의 예상 배달 날짜 예측입니다. |
|
eddPrevTime
|
eddPrevTime | string |
이전 EDD. |
|
eddStatus
|
eddStatus | string |
초기 또는 ONTIME 또는 DELAYED. |
|
eddChanged
|
eddChanged | string |
EDD 예측이 변경되었음을 나타내는 플래그입니다. 1은 EDD 변경이 있음을 나타냅니다. |
|
eddDelaysRiskScore
|
eddDelaysRiskScore | string |
소비자가 예측 정보를 사용하는 방법을 결정할 수 있는 EDD 위험 점수입니다. |
|
eddDelayTypeCode
|
eddDelayTypeCode | string |
지연 이유 코드입니다. OP 예제 – 작동, WE – 날씨. |
|
edtwBegin
|
edtwBegin | string |
예상 배달 시간 기간의 시작입니다. |
|
edtwEnd
|
edtwEnd | string |
예상 배달 시간 기간의 끝입니다. |
|
edtwPrevBegin
|
edtwPrevBegin | string |
이전 예상 배달 시간 창 시작 값입니다. |
|
edtwPrevEnd
|
edtwPrevEnd | string |
이전 예상 배달 시간 기간 종료 값입니다. |
|
edtwChanged
|
edtwChanged | string |
EDTW 예측이 변경되었음을 나타내는 플래그입니다. 1은 EDTW 변경이 있음을 나타냅니다. |
|
edtwDelaysRiskScore
|
edtwDelaysRiskScore | string |
다운스트림 소비자 임계값에 대한 EDTW 위험 점수입니다. |