📚 Guias

Arquitetura Base

• RESTful: Utilizamos recursos bem definidos, verbos HTTP padronizados (GET, POST, PUT, DELETE) e respostas JSON.
• Assíncrono: O processamento de grandes cargas de dados (ex: milhões de transações) ocorre em background após o recebimento via API.
• Segurança: Todas as rotas (exceto `/health`) exigem token JWT emitido pelo nosso Identity Provider via endpoint de Login.

# Quick Start — Proffer Parceiros API (Python)
#
# ⚠️ Sandbox e Produção são ambientes distintos:
#   Sandbox: https://sandbox.apiproffer.com/parceiros  ← testes, credenciais sandbox
#   Produção: https://parceiros.apiproffer.com/parceiros ← dados reais, credenciais do parceiro

import requests

# Troque para a URL de produção quando estiver pronto
BASE = "https://sandbox.apiproffer.com/parceiros"

# 1. Autenticar (use as credenciais fornecidas pela Proffer para cada ambiente)
response = requests.post(
    f"{BASE}/v2/auth/login",
    json={"email": "erp+sandbox@proffer.com.br", "password": "erpsandbox"}
)
token = response.json()["access_token"]

# 2. Enviar mix de produtos
headers = {"Authorization": f"Bearer {token}"}

produtos = [
    {
        "codproduto": 5155,
        "codloja": 23,
        "ean": 7891058011222,
        "descricao": "NOVALGINA 1G 4CPR",
        "imprimeetiqueta": "S",
        "custo": 4.82,
        "customedio": 4.83,
        "pmc": 7.00,
        "precoregular": 5.80,
        "estoque": 150,
        "estado": "SP"
    }
]

r = requests.post(f"{BASE}/v2/integracao/produto", json=produtos, headers=headers)
print(r.json())  # {"success": true, "data": {"aceitos": 1, ...}}

# 3. Ler recomendações de preço
r = requests.get(
    f"{BASE}/v2/otimizacao/recomendacoes",
    headers=headers,
    params={"per_page": 10}
)
for rec in r.json()["data"]:
    print(f"{rec['descricao']}: R$ {rec['precosugerido']}")