sage-x3-requests-wrapper-custom 0.1.0a13

Internal utility package

Sage X3 Requests Wrapper (ALPHA)

⚠️ AVISO: BIBLIOTECA EM DESENVOLVIMENTO (ALPHA) ⚠️

Esta biblioteca foi publicada para uso pessoal e testes. Não é recomendada para produção. A API pode mudar drasticamente a qualquer momento sem aviso prévio. Use por sua conta e risco.

Instalação

pip install internal-lib-48e662a6

Exemplos de Uso

Configuração

from sage_x3_requests import SageX3Config, SageX3Requester

config = SageX3Config(
    base_url="https://seu-erp.com",
    username="admin",
    password="password",
    folder="SEED"
)

Pedir 5 Registos (Limit)

Pode passar o limite diretamente no método .get_resources(limit=5).

with SageX3Requester(config) as client:
    # Opção 1: Passar limit no get_resources (Maneira mais simples!)
    registos = client.request("CLIENTES", "BPC") \
                     .get_resources(limit=5)
    
    # Opção 2: Usar .count(5) antes
    registos = client.request("CLIENTES", "BPC") \
                     .count(5) \
                     .get_resources()

Pedir TODOS os Registos (Paginação Automática)

Use .get_resources(fetch_all=True) para buscar todos os dados, percorrendo todas as páginas automaticamente.

with SageX3Requester(config) as client:
    # Busca todos os clientes (cuidado com grandes volumes de dados!)
    todos_clientes = client.request("CLIENTES", "BPC") \
                           .get_resources(fetch_all=True)
                           
    print(f"Total encontrado: {len(todos_clientes)}")

Contagem Total

Para saber quantos registos existem sem trazer os dados:

with SageX3Requester(config) as client:
    query = client.request("CLIENTES", "BPC").count(True).execute()
    total = query.get("count") # ou verificar estrutura de retorno