PAIRUS Product Data SDK para Python (pairus-product-data)

SDK oficial da PAIRUS Soluções Tecnológicas para consulta de dados de catálogo (GTIN/EAN) e predição fiscal completa da Reforma Tributária (IBS, CBS e Imposto Seletivo).

📦 Instalação

pip install pairus-product-data

🚀 Início Rápido

1. Consulta de Produto por Código de Barras (GTIN)

from pairus_product_data import PairusProductData

# Inicializa o cliente (lê automaticamente a variável de ambiente PAIRUS_API_KEY se omitido)
client = PairusProductData(api_key="pk_live_sua_chave_aqui")

produto = client.products.get("7891000744703")
print(f"Produto: {produto.xProd}")
print(f"NCM: {produto.ncm} | CEST: {produto.cest}")

2. Predição Fiscal da Reforma Tributária (IBS/CBS/IS)

from pairus_product_data import PairusProductData

client = PairusProductData()

predicao = client.fiscal.predict(
    xProd="Refrigerante Coca-Cola Lata 350ml",
    gtin="7894900010015",
    regime_tributario="simples_nacional",
    uf_origem="SP",
    uf_destino="RJ",
    finalidade="revenda"
)

tributos = predicao.dados_tributarios
print(f"NCM: {tributos.ncm_sugerido} | CFOP: {tributos.cfop}")
print(f"CST IBS/CBS: {tributos.ibscbs.cst} | Classificação: {tributos.ibscbs.cClassTrib}")
print(f"Alíquota Efetiva CBS: {tributos.ibscbs.cbs_aliquota_efetiva}%")
print(f"Alíquota Efetiva IBS: {tributos.ibscbs.ibs_aliquota_efetiva}%")
print(f"Alíquota Unificada: {tributos.aliquota_efetiva_unificada}%")

3. Validação de Webhooks com Assinatura Criptográfica (HMAC-SHA256)

from pairus_product_data.webhooks import Webhooks

# Em um endpoint FastAPI / Flask / Django:
raw_body = request.body
signature_header = request.headers.get("X-Pairus-Signature")
webhook_secret = "whsec_seu_secret"

evento = Webhooks.construct_event(raw_body, signature_header, webhook_secret)
print(f"Evento autêntico recebido: {evento.event} para o GTIN: {evento.data.get('gtin')}")

🛡️ Licença

Distribuído sob a licença MIT. Consulte LICENSE para mais detalhes.