다음을 통해 공유

ShipStation(미리 보기)

ShipStation은 온라인 소매업체가 판매하는 곳과 배송을 통해 주문 이행을 간소화하는 데 도움이 되는 선도적인 웹 기반 배송 소프트웨어입니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 지역
논리 앱 표준 다음을 제외한 모든 Logic Apps 지역 :
     - Azure Government 지역
     - Azure 중국 지역
     - 미국 국방부(DoD)
연락처
이름 마이크로소프트 다이내믹스
URL https://dynamics.microsoft.com/en-us/support/
전자 메일 iomdri@microsoft.com
커넥터 메타데이터
Publisher 마이크로소프트
웹 사이트 https://www.shipstation.com/
개인 정보 보호 정책 https://www.shipstation.com/privacy-policy/
카테고리 Productivity

이 커넥터는 Dynamics 365 Intelligent Order Management의 ShipStation 공급자 통합에 사용하도록 특별히 개발되었습니다.

사전 요구 사항

ShipStation 개발자 계정이 필요합니다. 없는 경우 .에서 https://www.shipstation.com/docs/api/requirements/만들 수 있습니다. 참고: 이 커넥터를 사용하여 Dynamics 365 Intelligent Order Management ShipStation 공급자를 설정하는 것이 좋습니다.

자격 증명을 가져오는 방법

ShipStation에는 인증을 위해 API 키 및 비밀이 필요합니다. 토큰 https://ship13.shipstation.com/settings/api 을 생성하고 이를 사용하여 커넥터를 구성할 수 있습니다.

커넥터 시작

API 키 및 비밀을 사용하여 연결을 구성합니다. ShipStation의 API에 대한 자세한 내용은 공개 설명서를 참조하세요. https://www.shipstation.com/docs/api/

알려진 문제 및 제한 사항

이 커넥터는 Dynamics 365 Intelligent Order Management의 ShipStation 공급자 통합에 사용하도록 특별히 개발되었습니다. Dynamics 365 Intelligent Order Management 이외의 용도에 대한 지원은 제한됩니다.

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유할 수 없음

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.

이름 유형 설명 필수
사용자 이름 시큐어스트링 (보안 문자열) 이 API의 사용자 이름 진실
암호 시큐어스트링 (보안 문자열) 이 API의 암호 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 100 60초

동작

주문 가져오기

데이터베이스에서 단일 순서를 검색합니다.
주문 레이블 만들기

지정된 주문에 대한 배송 레이블을 만듭니다. 응답에 반환된 labelData 필드는 base64로 인코딩된 PDF 값입니다. 출력을 디코딩하고 PDF 파일로 저장하면 인쇄 가능한 레이블을 검색할 수 있습니다.
주문 만들기 또는 업데이트

orderKey를 지정하면 메서드가 idempotent가 되고 해당 키가 있는 기존 순서가 업데이트됩니다. 참고: ShipStation(awaiting_payment, awaiting_shipment 및 on_hold)에서 열려 있는 상태의 주문만 이 방법을 통해 업데이트할 수 있습니다. 취소되고 배송된 항목은 API를 통해 수정할 수 없습니다.

주문 가져오기

작업 ID:
GetOrderById

데이터베이스에서 단일 순서를 검색합니다.

매개 변수

Name 키 필수 형식 Description
주문 가져오기
 orderId True double

주문에 대한 시스템 생성 식별자입니다.

반환

몸
GetOrderResponse

주문 레이블 만들기

작업 ID:
CreateLabelForOrder

지정된 주문에 대한 배송 레이블을 만듭니다. 응답에 반환된 labelData 필드는 base64로 인코딩된 PDF 값입니다. 출력을 디코딩하고 PDF 파일로 저장하면 인쇄 가능한 레이블을 검색할 수 있습니다.

반환

몸
CreateLabelforOrderResponse

주문 만들기 또는 업데이트

작업 ID:
CreateUpdateOrder

orderKey를 지정하면 메서드가 idempotent가 되고 해당 키가 있는 기존 순서가 업데이트됩니다. 참고: ShipStation(awaiting_payment, awaiting_shipment 및 on_hold)에서 열려 있는 상태의 주문만 이 방법을 통해 업데이트할 수 있습니다. 취소되고 배송된 항목은 API를 통해 수정할 수 없습니다.

반환

몸
CreateUpdateOrderResponse

트리거

웹후크 구독

특정 유형의 웹후크를 구독합니다. store_id 전달되는 경우 웹후크는 해당 특정 store_id 대해서만 트리거됩니다. 전달되는 이벤트 유형에 따라 전송할 웹후크 유형이 결정됩니다. ORDER_NOTIFY, ITEM_ORDER_NOTIFY, SHIP_NOTIFY, ITEM_SHIP_NOTIFY, API_TRACK 값 중 하나를 포함해야 합니다.

웹후크 구독

작업 ID:
WebhookSubscribe

특정 유형의 웹후크를 구독합니다. store_id 전달되는 경우 웹후크는 해당 특정 store_id 대해서만 트리거됩니다. 전달되는 이벤트 유형에 따라 전송할 웹후크 유형이 결정됩니다. ORDER_NOTIFY, ITEM_ORDER_NOTIFY, SHIP_NOTIFY, ITEM_SHIP_NOTIFY, API_TRACK 값 중 하나를 포함해야 합니다.

매개 변수

Name 키 필수 형식 Description
friendly_name
 friendly_name True string
store_id
 store_id string
이벤트
 event True string

정의

GetOrderResponse

Name 경로 형식 Description
주문 ID
 orderId integer
주문번호
 orderNumber string
orderKey
 orderKey string
orderDate
 orderDate string
createDate
 createDate string
modifyDate
 modifyDate string
결제일
 paymentDate string
shipByDate
 shipByDate string
orderStatus
 orderStatus string
고객 ID
 customerId integer
customerUsername
 customerUsername string
고객 이메일
 customerEmail string
BillTo
 billTo BillTo
ShipTo
 shipTo ShipTo
항목
 items array of Item
orderTotal
 orderTotal double
amountPaid
 amountPaid double
taxAmount
 taxAmount float
shippingAmount
 shippingAmount float
customerNotes
 customerNotes string
internalNotes
 internalNotes string
선물
 gift boolean
giftMessage
 giftMessage string
결제 수단
 paymentMethod string
requestedShippingService
 requestedShippingService string
carrierCode
 carrierCode string
serviceCode
 serviceCode string
packageCode
 packageCode string
확인
 confirmation string
배송 날짜
 shipDate string
holdUntilDate
 holdUntilDate string
무게
 weight Weight
치수
 dimensions Dimensions
InsuranceOptions
 insuranceOptions InsuranceOptions
InternationalOptions
 internationalOptions InternationalOptions
AdvancedOptions
 advancedOptions AdvancedOptions
tagIds
 tagIds string
userId
 userId string
externallyFulfilled
 externallyFulfilled boolean
externallyFulfilledBy
 externallyFulfilledBy string

BillTo

Name 경로 형식 Description
이름
 name string
회사
 company string
street1
 street1 string
street2
 street2 string
street3
 street3 string
city
 city string
주
 state string
postalCode
 postalCode string
country
 country string
phone
 phone string
거주에 관한
 residential string
addressVerified
 addressVerified string

ShipTo

Name 경로 형식 Description
이름
 name string
회사
 company string
street1
 street1 string
street2
 street2 string
street3
 street3 string
city
 city string
주
 state string
postalCode
 postalCode string
country
 country string
phone
 phone string
거주에 관한
 residential boolean
addressVerified
 addressVerified string

Option

Name 경로 형식 Description
이름
 name string
value
 value string

치수

Name 경로 형식 Description
단위
 units string
length
 length float
width
 width float
height
 height float

InsuranceOptions

Name 경로 형식 Description
provider
 provider string
insureShipment
 insureShipment boolean
insuredValue
 insuredValue float

InternationalOptions

Name 경로 형식 Description
contents
 contents string
customsItems
 customsItems array of CustomsItem
배달 못 함
 nonDelivery string

CustomsItem

Name 경로 형식 Description
customsItemId
 customsItemId integer
묘사
 description string
수량
 quantity float
value
 value float
harmonizedTariffCode
 harmonizedTariffCode string
countryOfOrigin
 countryOfOrigin string

AdvancedOptions

Name 경로 형식 Description
warehouseId
 warehouseId integer
nonMachinable
 nonMachinable boolean
saturdayDelivery
 saturdayDelivery boolean
containsAlcohol
 containsAlcohol boolean
mergedOrSplit
 mergedOrSplit boolean
mergedIds
 mergedIds array of string
부모 ID
 parentId string
storeId
 storeId integer
customField1
 customField1 string
customField2
 customField2 string
customField3
 customField3 string
원본
 source string
billToParty
 billToParty string
billToAccount
 billToAccount string
billToPostalCode
 billToPostalCode string
billToCountryCode
 billToCountryCode string

항목

Name 경로 형식 Description
lineItemKey
 lineItemKey string
sku
 sku string
이름
 name string
imageUrl
 imageUrl string
무게
 weight Weight
수량
 quantity float
단가 가격
 unitPrice double
taxAmount
 taxAmount double
shippingAmount
 shippingAmount double
warehouseLocation
 warehouseLocation string
options
 options array of Option
제품 ID
 productId integer
fulfillmentSku
 fulfillmentSku string
조정
 adjustment boolean
upc
 upc string

무게

Name 경로 형식 Description
value
 value float
단위
 units string

CreateLabelforOrderResponse

Name 경로 형식 Description
shipmentId
 shipmentId integer
shipmentCost
 shipmentCost double
insuranceCost
 insuranceCost float
추적 번호
 trackingNumber string
labelData
 labelData string
formData
 formData string

CreateUpdateOrderResponse

Name 경로 형식 Description
주문 ID
 orderId integer
주문번호
 orderNumber string
orderKey
 orderKey string
orderDate
 orderDate string
createDate
 createDate string
modifyDate
 modifyDate string
결제일
 paymentDate string
shipByDate
 shipByDate string
orderStatus
 orderStatus string
고객 ID
 customerId integer
customerUsername
 customerUsername string
고객 이메일
 customerEmail string
BillTo
 billTo BillTo
ShipTo
 shipTo ShipTo
항목
 items array of Item
orderTotal
 orderTotal double
amountPaid
 amountPaid double
taxAmount
 taxAmount float
shippingAmount
 shippingAmount float
customerNotes
 customerNotes string
internalNotes
 internalNotes string
선물
 gift boolean
giftMessage
 giftMessage string
결제 수단
 paymentMethod string
requestedShippingService
 requestedShippingService string
carrierCode
 carrierCode string
serviceCode
 serviceCode string
packageCode
 packageCode string
확인
 confirmation string
배송 날짜
 shipDate string
holdUntilDate
 holdUntilDate string
무게
 weight Weight
치수
 dimensions Dimensions
InsuranceOptions
 insuranceOptions InsuranceOptions
InternationalOptions
 internationalOptions InternationalOptions
AdvancedOptions
 advancedOptions AdvancedOptions
tagIds
 tagIds string
userId
 userId string
externallyFulfilled
 externallyFulfilled boolean
externallyFulfilledBy
 externallyFulfilledBy string