Python 앱에 zip.zax Sales Tax API 통합

정확한 판매세 계산이 필요한 애플리케이션을 구축하는 경우 zip.tax API는 통합할 수 있는 훌륭한 도구입니다. 이 가이드는 Python 애플리케이션에서 zip.tax API를 설정하고 사용하는 방법을 안내합니다.

전제조건

시작하기 전에 다음 사항을 확인하세요.

• 파이썬에 대한 기본 지식
• Python 개발 환경 설정
• zip.tax의 API 키

1단계: 필수 라이브러리 설치

HTTP 요청을 위해 Python의 표준 요청 패키지를 사용합니다. 또한 JSON 응답을 구문 분석하는 데 json을 사용합니다.

2단계: Python 프로젝트 설정

새 프로젝트 디렉토리를 생성하고 새 모듈을 초기화합니다.

mkdir ziptax-python && cd ziptax-python

3단계: 코드 작성

다음은 판매세 정보를 위해 zip.tax API를 쿼리하는 간단한 Python 애플리케이션의 전체 예입니다.

import requests
import json

class Response:
    def __init__(self, data):
        self.version = data.get("version")
        self.r_code = data.get("rCode")
        self.results = [Result(result) for result in data.get("results", [])]
        self.address_detail = AddressDetail(data.get("addressDetail", {}))

class Result:
    def __init__(self, data):
        self.geo_postal_code = data.get("geoPostalCode")
        self.geo_city = data.get("geoCity")
        self.geo_county = data.get("geoCounty")
        self.geo_state = data.get("geoState")
        self.tax_sales = data.get("taxSales")
        self.tax_use = data.get("taxUse")
        self.txb_service = data.get("txbService")
        self.txb_freight = data.get("txbFreight")
        self.state_sales_tax = data.get("stateSalesTax")
        self.state_use_tax = data.get("stateUseTax")
        self.city_sales_tax = data.get("citySalesTax")
        self.city_use_tax = data.get("cityUseTax")
        self.city_tax_code = data.get("cityTaxCode")
        self.county_sales_tax = data.get("countySalesTax")
        self.county_use_tax = data.get("countyUseTax")
        self.county_tax_code = data.get("countyTaxCode")
        self.district_sales_tax = data.get("districtSalesTax")
        self.district_use_tax = data.get("districtUseTax")
        self.district1_code = data.get("district1Code")
        self.district1_sales_tax = data.get("district1SalesTax")
        self.district1_use_tax = data.get("district1UseTax")
        self.district2_code = data.get("district2Code")
        self.district2_sales_tax = data.get("district2SalesTax")
        self.district2_use_tax = data.get("district2UseTax")
        self.district3_code = data.get("district3Code")
        self.district3_sales_tax = data.get("district3SalesTax")
        self.district3_use_tax = data.get("district3UseTax")
        self.district4_code = data.get("district4Code")
        self.district4_sales_tax = data.get("district4SalesTax")
        self.district4_use_tax = data.get("district4UseTax")
        self.district5_code = data.get("district5Code")
        self.district5_sales_tax = data.get("district5SalesTax")
        self.district5_use_tax = data.get("district5UseTax")
        self.origin_destination = data.get("originDestination")

class AddressDetail:
    def __init__(self, data):
        self.normalized_address = data.get("normalizedAddress")
        self.incorporated = data.get("incorporated")
        self.geo_lat = data.get("geoLat")
        self.geo_lng = data.get("geoLng")

def get_sales_tax(address, api_key):
    try:
        api_url = f"https://api.zip-tax.com/request/v50?key={api_key}&address={requests.utils.quote(address)}"
        response = requests.get(api_url)

        if response.status_code != 200:
            raise Exception(f"Unexpected status code: {response.status_code}")

        response_data = response.json()
        return Response(response_data)
    except Exception as e:
        print(f"Error fetching sales tax: {e}")
        return None

def main():
    api_key = "your_api_key_here"  # Replace with your actual API key
    address = "200 Spectrum Center Dr, Irvine, CA 92618"  # Example Address

    tax_info = get_sales_tax(address, api_key)

    if tax_info:
        print(f"Normalized Address: {tax_info.address_detail.normalized_address}")
        print(f"Address Lat/Lng: {tax_info.address_detail.geo_lat}, {tax_info.address_detail.geo_lng}")
        if tax_info.results:
            print(f"Rate: {tax_info.results[0].tax_sales * 100:.2f}%")

if __name__ == "__main__":
    main()

코드 설명

1. API 요청: get_sales_tax 함수는 API 키와 주소로 URL을 구성하고 GET 요청을 한 후 응답을 구문 분석합니다.
2. 응답 구문 분석: 판매세 세부정보에 쉽게 액세스할 수 있도록 응답 JSON이 마샬링 해제되었습니다.
3. 표시 결과: 기본 기능은 지정된 주소 코드에 대한 정규화된 주소, 위도/경도 및 판매세율을 인쇄합니다. 여기에 있는 응답 값 중 하나를 사용하여 필요한 데이터를 출력할 수 있습니다.

4단계: 애플리케이션 실행

코드를 파일(예: main.py)에 저장한 후 프로그램을 실행하세요.

python main.py

다음과 유사한 출력이 표시됩니다.

Normalized Address: 200 Spectrum Center Dr, Irvine, CA 92618-5003, United States
Address Lat/Lng: 33.652530, -117.747940
Rate: 7.75%

결론

zip.tax API를 Python 애플리케이션에 통합하는 것은 간단합니다. 이 가이드를 따르면 주소에 따른 정확한 판매세 정보로 신청서를 개선할 수 있습니다. 자세한 내용은 공식문서를 참고하세요.

질문이나 의견이 있으시면 아래에 댓글을 남겨주세요. 즐거운 코딩하세요!

위 내용은 Python 앱에 zip.zax Sales Tax API 통합의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!