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')}")

4. Emissão de NF-e / NFC-e com Autocura SEFAZ

from pairus_product_data import PairusProductData

client = PairusProductData()

# Emissão de NF-e (Modelo 55) com correção automática pré-transmissão
nfe = client.emissao.emitir_nfe(
    natureza_operacao="VENDA DE MERCADORIAS",
    autocura=True,
    itens=[
        {
            "cProd": "SKU-001",
            "xProd": "Refrigerante Coca-Cola 350ml",
            "NCM": "22021000",
            "CFOP": "5102",
            "uCom": "UN",
            "qCom": 10.0,
            "vUnCom": 5.0,
            "vProd": 50.0,
        }
    ]
)

print(f"Status: {nfe.cStat} - {nfe.xMotivo}")
print(f"Chave de Acesso: {nfe.chave_acesso}")
print(f"DANFE PDF: {nfe.danfe_url}")

# Simulação com Custo ZERO de créditos para testes
simulacao = client.emissao.simular(
    natureza_operacao="TESTE PREVIO",
    itens=[{"cProd": "TEST", "xProd": "Item Teste", "NCM": "22021000", "CFOP": "5102", "uCom": "UN", "qCom": 1.0, "vUnCom": 10.0, "vProd": 10.0}]
)
print(f"Simulação concluída: DANFE disponível em {simulacao.danfe_url}")

# Governança de Eventos SEFAZ: Cancelamento, CC-e e Inutilização
client.emissao.cancelar(
    chave_acesso=nfe.chave_acesso,
    justificativa="Desistência da compra pelo cliente dentro do prazo legal"
)

🛡️ Licença

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