다음을 통해 공유

아발라라(미리 보기)

Avalara의 엔터프라이즈 세금 서비스인 AvaTax에 대한 REST 인터페이스로, 세금을 계산하고 주소를 확인합니다.

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

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

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

사전 요구 사항

지침에 https://developer.avalara.com/communications/dev-guide_rest_v2/getting-started/account-creation/ 따라 Avalara 계정을 만듭니다.

참고: 이 커넥터를 사용하여 Dynamics 365 Intelligent Order Management Avalara 공급자를 설정하는 것이 좋습니다.

자격 증명을 가져오는 방법

Avalara는 사용자 이름 및 암호로 기본 인증을 사용합니다. 자세한 내용은 참조 https://developer.avalara.com/communications/dev-guide_rest_v2/getting-started/authentication/ 하세요.

커넥터 시작

사용자 이름, 암호 및 클라이언트 ID를 사용하여 연결을 구성합니다. Avalara의 API에 대한 자세한 내용은 공개 설명서를 참조하세요. https://developer.avalara.com/api-reference/avatax/rest/v2/

알려진 문제 및 제한 사항

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

연결을 만드는 중

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

기본값

적용 가능: 모든 지역

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

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

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

제한 한도

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

동작

주소 확인

이 작업은 주소를 확인합니다.
트랜잭션 만들기

이 작업은 새 트랜잭션을 만듭니다.

주소 확인

작업 ID:
ResolveAddress

이 작업은 주소를 확인합니다.

매개 변수

Name 키 필수 형식 Description
object

반환

주소 확인 모델

몸
AddressResolutionModel

트랜잭션 만들기

작업 ID:
CreateTransaction

이 작업은 새 트랜잭션을 만듭니다.

매개 변수

Name 키 필수 형식 Description
object

반환

response
array of TransactionModel

정의

TransactionModel

단일 트랜잭션 ( 예: 판매 송장 또는 구매 주문)

Name 경로 형식 Description
아이디
 id integer

이 트랜잭션의 고유 ID 번호
코드
 code string

이 트랜잭션을 식별하는 고유한 고객 제공 코드
날짜
 date string

이 트랜잭션이 발생한 날짜
taxDate
 taxDate string

이 트랜잭션의 세금 날짜
결제일
 paymentDate string

이 트랜잭션에 대해 결제한 날짜입니다.
상태
 status string

트랜잭션의 상태입니다.
유형
 type string

트랜잭션의 형식
companyId
 companyId integer

이 트랜잭션을 기록한 회사의 고유 ID 번호
batchCode
 batchCode string

이 트랜잭션이 일괄 처리의 일부로 만들어진 경우 이 코드는 어떤 일괄 처리가 있는지를 나타냅니다.
통화 코드
 currencyCode string

이 트랜잭션에 대한 결제에 사용된 3자 ISO 4217 통화 코드
customerUsageType
 customerUsageType string

이 트랜잭션의 고객 사용 유형
customerVendorCode
 customerVendorCode string

이 트랜잭션에 대한 고객 코드
exemptNo
 exemptNo string

인증서와 연결된 tax_number(고객 세금 ID 번호)
화해
 reconciled boolean

이 트랜잭션이 회사의 원장과 조정된 경우 이 값은 true로 설정됩니다.
locationCode
 locationCode string

보고 위치 코드
purchaseOrderNo
 purchaseOrderNo string

이 트랜잭션의 고객이 제공한 구매 주문 번호
referenceCode
 referenceCode string

이 트랜잭션에 대한 사용자 정의 참조 코드
salespersonCode
 salespersonCode string

이 트랜잭션을 제공한 영업 사원입니다. 필요하지 않음
taxOverrideType
 taxOverrideType string

이 거래에 세금 재정의가 적용된 경우 적용된 세금 재정의 유형을 나타냅니다.
taxOverrideAmount
 taxOverrideAmount float

f 이 거래에 세금 재정의가 적용되었습니다. 고객이 요청한 세금의 양을 나타냅니다.
taxOverrideReason
 taxOverrideReason string

이 거래에 세금 재정의가 적용된 경우 세금 재정의 이유를 나타냅니다.
총액
 totalAmount float

이 트랜잭션의 총 금액
totalExempt
 totalExempt float

제외된 이 트랜잭션의 양
totalTax
 totalTax float

이 트랜잭션의 모든 줄에 대한 총 세금입니다.
totalTaxable
 totalTaxable float

과세된 이 트랜잭션의 총 금액 부분입니다.
totalTaxCalculated
 totalTaxCalculated float

AvaTax가 트랜잭션에 대해 계산한 세금의 양입니다.
adjustmentReason
 adjustmentReason string

이 트랜잭션이 조정된 경우 트랜잭션이 조정된 이유의 고유 ID 번호를 나타냅니다.
adjustmentDescription
 adjustmentDescription string

이 트랜잭션이 조정된 경우 트랜잭션이 조정된 이유에 대한 설명을 나타냅니다.
잠금
 locked boolean

이 트랜잭션이 세무 기관에 보고된 경우 이 트랜잭션은 잠긴 것으로 간주되며 보고 후 조정되지 않을 수 있습니다.
지역
 region string

이 트랜잭션에 대한 지역의 2~3자 ISO 지역 코드
country
 country string

이 트랜잭션에 대한 국가의 두 문자 ISO 3166 코드
version
 version integer

이 트랜잭션이 조정된 경우 이 트랜잭션의 버전 번호를 나타냅니다. 트랜잭션이 조정될 때마다 증가합니다.
softwareVersion
 softwareVersion string

이 트랜잭션을 계산하는 데 사용되는 소프트웨어 버전
originAddressId
 originAddressId integer

이 트랜잭션에 대한 원본 주소의 고유 ID 번호
destinationAddressId
 destinationAddressId integer

이 트랜잭션에 대한 대상 주소의 고유 ID 번호
exchangeRateEffectiveDate
 exchangeRateEffectiveDate string

이 트랜잭션에 외화 교환이 포함된 경우 환율이 계산된 날짜입니다.
exchangeRate
 exchangeRate float

이 트랜잭션에 외화 교환이 포함된 경우 사용된 환율입니다.
isSellerImporterOfRecord
 isSellerImporterOfRecord boolean

true이면 이 판매자는 국제적으로 배송된 제품의 레코드를 수입하는 것으로 간주되었습니다.
묘사
 description string

이 트랜잭션에 대한 설명입니다. 필드에서 유니코드 값을 허용합니다.
전자 메일
 email string

이 트랜잭션과 연결된 전자 메일 주소
brBuyerType
 brBuyerType string

구매자 유형
brBuyer_IsExemptOrCannotWH_IRRF
 brBuyer_IsExemptOrCannotWH_IRRF boolean

구매자가 IRRF의 원천징수에서 면제되는지 여부
brBuyer_IsExemptOrCannotWH_PISRF
 brBuyer_IsExemptOrCannotWH_PISRF boolean

구매자가 PIS 원천징수에서 제외되는지 여부
brBuyer_IsExemptOrCannotWH_COFINSRF
 brBuyer_IsExemptOrCannotWH_COFINSRF boolean

구매자가 COFINS의 원천징수에서 면제되는지 여부
brBuyer_IsExemptOrCannotWH_CSLLRF
 brBuyer_IsExemptOrCannotWH_CSLLRF boolean

구매자가 CSLL 원천징수에서 제외되는지 여부
brBuyer_IsExempt_PIS
 brBuyer_IsExempt_PIS boolean

구매자가 PIS의 과세 및 원천징수에서 면제되는지 여부
brBuyer_IsExempt_COFINS
 brBuyer_IsExempt_COFINS boolean

구매자가 COFINS의 과세 및 원천징수에서 면제되는지 여부
brBuyer_IsExempt_CSLL
 brBuyer_IsExempt_CSLL boolean

구매자가 CSLL의 과세 및 원천징수에서 면제되는지 여부
modifiedDate
 modifiedDate string

이 레코드가 마지막으로 수정된 날짜/시간(읽기 전용)
modifiedUserId
 modifiedUserId integer

이 레코드를 마지막으로 수정한 사용자의 사용자 ID(읽기 전용)
라인
 lines array of TransactionLineModel

이 트랜잭션의 줄 목록
addresses
 addresses array of TransactionAddressModel

이 트랜잭션에 사용되는 주소 목록

TransactionLineModel

이 트랜잭션의 한 줄 항목

Name 경로 형식 Description
아이디
 id integer

이 트랜잭션 줄 항목의 고유 ID 번호
거래 ID
 transactionId integer

이 품목이 속한 트랜잭션의 고유 ID 번호
행 번호
 lineNumber string

이 청구서 또는 영수증 또는 문서의 줄을 나타내는 줄 번호 또는 코드
method
 method string

회계 방법
boundaryOverrideId
 boundaryOverrideId integer

이 줄 항목에 적용된 경계 재정의의 고유 ID 번호
customerUsageType
 customerUsageType string

이 품목의 고객 사용 유형
묘사
 description string

이 줄로 표시되는 항목 또는 서비스에 대한 설명입니다.
destinationAddressId
 destinationAddressId integer

이 줄이 배달되거나 판매된 대상 주소의 고유 ID 번호입니다.
discountAmount
 discountAmount float

이 품목에 적용된 할인 금액
discountTypeId
 discountTypeId integer

이 품목에 적용된 할인 유형(있는 경우)
exemptAmount
 exemptAmount float

제외된 이 품목의 양입니다.
exemptCertId
 exemptCertId integer

이 품목에 적용된 예외 인증서의 고유 ID 번호
exemptNo
 exemptNo string

인증서와 연결된 tax_number(고객 세금 ID 번호)
isItemTaxable
 isItemTaxable boolean

이 항목이 과세되는 경우 True입니다.
isSSTP
 isSSTP boolean

True이면 이 항목이 간소화된 판매세 품목입니다.
itemCode
 itemCode string

이 줄 항목이 나타내는 항목의 코드 문자열입니다.
lineAmount
 lineAmount float

과세 및 면제를 포함한 총 거래 금액
originAddressId
 originAddressId integer

원본 주소 ID
수량
 quantity float

이 품목에 판매된 제품의 수량
ref1
 ref1 string

이 트랜잭션 줄 항목에 대한 사용자 정의 참조 식별자
ref2
 ref2 string

이 트랜잭션 줄 항목에 대한 사용자 정의 참조 식별자
reportingDate
 reportingDate string

이 트랜잭션을 보고해야 하는 날짜입니다.
revAccount
 revAccount string

이 품목의 수익 계정 번호
소싱
 sourcing string

이 품목이 원본 또는 대상에 따라 과세되었는지 여부를 나타냅니다.
세금
 tax float

이 트랜잭션의 이 줄에 대한 세금
taxableAmount
 taxableAmount float

이 품목의 과세 금액
taxCalculated
 taxCalculated float

AvaTax가 트랜잭션에 대해 계산한 세금의 양
taxCode
 taxCode string

이 줄 항목을 계산하는 데 사용된 세금 코드의 코드 문자열입니다.
taxCodeId
 taxCodeId integer

이 품목을 계산하는 데 사용된 세금 코드의 고유 ID 번호입니다.
taxDate
 taxDate string

이 품목에 대한 세금 금액을 계산하는 데 사용된 날짜입니다.
taxEngine
 taxEngine string

이 품목을 계산하는 데 사용된 세금 엔진 식별자입니다.
taxOverrideType
 taxOverrideType string

세금 재정의를 지정한 경우 세금 재정의 유형을 나타냅니다.
taxOverrideAmount
 taxOverrideAmount float

세금 재정의를 지정한 경우 요청된 세금의 양을 나타냅니다.
taxOverrideReason
 taxOverrideReason string

세금 재정의를 지정한 경우 세금 재정의 이유를 나타냅니다.
taxIncluded
 taxIncluded boolean

이 줄의 금액에 세금이 이미 포함되어 있는지 여부를 나타냅니다.
details
 details array of TransactionLineDetailModel

이 품목에 대한 세금 세부 정보 목록

TransactionAddressModel

이 트랜잭션 내에서 사용되는 주소

Name 경로 형식 Description
아이디
 id integer

이 주소의 고유 ID 번호
거래 ID
 transactionId integer

이 주소가 속한 문서의 고유 ID 번호입니다.
boundaryLevel
 boundaryLevel string

이 주소의 유효성을 검사한 경계 수준
line1
 line1 string

주소의 첫 번째 줄
line2
 line2 string

주소의 두 번째 줄
line3
 line3 string

주소의 세 번째 줄
city
 city string

주소의 도시
지역
 region string

ISO 3166 지역 코드입니다. 예: ISO 3166-2의 두 번째 부분
postalCode
 postalCode string

주소의 우편 번호 또는 우편 번호
country
 country string

ISO 3166 국가 코드
taxRegionId
 taxRegionId integer

이 주소에 대한 세금 지역의 고유 ID 번호

TransactionLineDetailModel

이 줄의 개별 세금 세부 정보 요소

Name 경로 형식 Description
아이디
 id integer

이 세금 세부 정보의 고유 ID 번호
transactionLineId
 transactionLineId integer

이 트랜잭션 내 줄의 고유 ID 번호
거래 ID
 transactionId integer

이 트랜잭션의 고유 ID 번호
addressId
 addressId integer

이 세금 세부 정보에서 사용되는 주소의 고유 ID 번호
country
 country string

이 세금 세부 정보가 할당된 국가의 두 문자 ISO 3166 국가 코드
지역
 region string

이 세금 세부 정보가 할당된 지역에 대한 2~3자 ISO 지역 코드
countyFIPS
 countyFIPS string

미국 거래의 경우 이 세금 세부 정보가 할당된 카운티의 FIPS(연방 정보 처리 표준) 코드입니다.
stateFIPS
 stateFIPS string

미국 거래의 경우 이 세금 세부 정보가 할당된 주에 대한 FIPS(연방 정보 처리 표준) 코드입니다.
exemptAmount
 exemptAmount float

이 세금 세부 정보에서 면제된 것으로 간주된 이 줄의 양
exemptReasonId
 exemptReasonId integer

이 세금 세부 정보의 예외 사유의 고유 ID 번호
임명
 inState boolean

이 세부 정보 요소가 상태 내 트랜잭션을 나타내는 경우 True입니다.
jurisCode
 jurisCode string

이 세금 세부 정보가 적용되는 관할권의 코드
jurisName
 jurisName string

이 세금 세부 정보가 적용되는 관할권의 이름
jurisdictionId
 jurisdictionId integer

이 세금 세부 정보가 적용되는 관할권의 고유 ID 번호
jurisType
 jurisType string

이 세금 세부 정보가 적용되는 관할권의 유형
nonTaxableAmount
 nonTaxableAmount float

이 세금 세부 정보에서 비과세 항목으로 간주된 이 품목의 양입니다.
nonTaxableRuleId
 nonTaxableRuleId integer

이 세부 정보의 어느 부분이 비과세로 간주되었는지에 따른 규칙
nonTaxableType
 nonTaxableType string

이 세금 세부 사항에 적용된 비과세성 유형
비율
 rate float

이 세금 세부 정보가 계산된 비율
rateRuleId
 rateRuleId integer

이 세금 세부 정보가 계산된 규칙의 고유 ID 번호입니다.
rateSourceId
 rateSourceId integer

이 세금 세부 정보가 계산된 비율 원본의 고유 ID 번호입니다.
signatureCode
 signatureCode string

이 세금 세부 정보가 적용되는 관할권의 Avalara 지정 서명 코드
serCode
 serCode string

간소화된 판매세 고객의 경우 이 세금 세부 정보를 적용해야 하는 SST 전자 반환 코드
소싱
 sourcing string

이 세금 세부 정보가 트랜잭션의 원본 또는 대상에 적용되는지 여부를 나타냅니다.
stateAssignedNo
 stateAssignedNo string

이 세금 세부 정보가 적용되는 관할권의 주 할당 번호
세금
 tax float

이 세금 세부 정보의 세금 금액
taxableAmount
 taxableAmount float

이 세금 세부 정보의 과세 금액
taxType
 taxType string

계산된 세금의 유형
taxName
 taxName string

이 세금 금액이 계산된 세금의 이름입니다.
taxAuthorityTypeId
 taxAuthorityTypeId integer

이 세금을 송금할 세무 기관의 유형입니다.
taxRegionId
 taxRegionId integer

세금 지역의 고유 ID 번호
taxCalculated
 taxCalculated float

AvaTax에서 계산한 세금의 양
taxOverride
 taxOverride float

이 세금 선에 대해 지정된 세금 재정의 금액
rateType
 rateType string

이 세금 세부 정보 비율 유형

AddressInfo

확인할 주소를 나타냅니다.

Name 경로 형식 Description
line1
 line1 string

주소의 첫 번째 줄
line2
 line2 string

도로명 주소의 두 번째 줄
line3
 line3 string

거리 주소의 세 번째 줄
city
 city string

주소의 도시 구성 요소
지역
 region string

국가 내 지역을 식별하는 이름 또는 ISO 3166 코드
country
 country string

국가를 식별하는 이름 또는 ISO 3166 코드
postalCode
 postalCode string

주소의 우편 번호/우편 번호 구성 요소
latitude
 latitude float

지리 공간적 위도 측정
경도
 longitude float

지리 공간 경도 측정

AddressResolutionModel

주소 확인 모델

Name 경로 형식 Description
address
 address AddressInfo

확인할 주소를 나타냅니다.
좌표
 coordinates CoordinateInfo

좌표 정보
resolutionQuality
 resolutionQuality string

지리 공간 좌표의 해상도 품질
taxAuthorities
 taxAuthorities array of TaxAuthorityInfo

이 지리 공간적 좌표에 적용되는 세무 기관 목록

CoordinateInfo

좌표 정보

Name 경로 형식 Description
latitude
 latitude float

위도
경도
 longitude float

경도

TaxAuthorityInfo

세무 기관 정보

Name 경로 형식 Description
avalaraId
 avalaraId string

아발라라 ID
jurisdictionName
 jurisdictionName string

관할권 이름
jurisdictionType
 jurisdictionType string

관할 유형
signatureCode
 signatureCode string

서명 코드