SDK Python

import httpx


class EngineApiClient:
    def __init__(
        self,
        base_url: str,
        api_key: str | None = None,
        token: str | None = None,
        timeout: float = 30.0,
    ):
        headers = {"x-api-key": api_key} if api_key else {"Authorization": f"Bearer {token}"}
        self.http = httpx.Client(
            base_url=f"{base_url.rstrip('/')}/v1",
            headers=headers,
            timeout=timeout,
        )

    def login(self, email: str, senha: str) -> dict:
        response = self.http.post("/auth/login", json={"email": email, "password": senha})
        response.raise_for_status()
        return response.json()

def emitir_nfe(client: EngineApiClient, dados: dict) -> dict:
    response = client.http.post("/nfe", json=dados)
    response.raise_for_status()
    return response.json()


nfe = emitir_nfe(client, {
    "naturezaOperacao": "VENDA DE MERCADORIA",
    "destinatario": {
        "cnpjCpf": "99888777000100",
        "nome": "Cliente Exemplo SA",
        "indicadorIE": 1,
        "endereco": {
            "logradouro": "Av Brasil", "numero": "500",
            "bairro": "Centro", "codigoMunicipio": "3550308",
            "municipio": "São Paulo", "uf": "SP", "cep": "01001000",
        },
    },
    "items": [{
        "codigo": "PROD001",
        "descricao": "Camiseta Azul M", "ncm": "61091000",
        "cfop": "5102", "unidade": "UN", "quantidade": 1,
        "valorUnitario": 89.90,
        "icms": {"origem": 0, "csosn": "400"},
    }],
    "pagamentos": [{"forma": "01", "valor": 89.90}],
})

print(f"NFe autorizada: {nfe['data']['accessKey']} ({nfe['data']['status']})")

# Cancelar: campo justificativa, mínimo 15 caracteres
chave = "35260211222333000181550010000000011000000019"

client.http.post(
    f"/nfe/{chave}/cancelar",
    json={"justificativa": "Erro nos dados do destinatário informado na venda"},
).raise_for_status()

# Carta de Correção: campo correcao, mínimo 15 caracteres
client.http.post(
    f"/nfe/{chave}/carta-correcao",
    json={"correcao": "Corrijo o endereço do destinatário para Av Brasil, 500"},
).raise_for_status()

# Downloads
pdf_bytes = client.http.get(f"/nfe/pdf/{chave}").content
xml_bytes = client.http.get(f"/nfe/xml/{chave}").content

empresa = client.http.post("/companies", json={
    "cnpj": "11222333000181",
    "name": "Empresa Exemplo Ltda",
    "crt": 1,
}).json()

with open("certificado.pfx", "rb") as f:
    client.http.post(
        f"/companies/{empresa['data']['id']}/certificate",
        files={"file": ("certificado.pfx", f, "application/x-pkcs12")},
        data={"password": "senhaDoCertificado"},
    ).raise_for_status()

login = client.login("usuario@partner.com", "senha")
print(login["access_token"])

import httpx

try:
    nfe = emitir_nfe(client, dados)
except httpx.HTTPStatusError as e:
    body = e.response.json()
    if e.response.status_code == 400:
        # Validação OU rejeição SEFAZ: ver body["error"]["erros"]
        print("Erro:", body["error"]["detail"])
    elif e.response.status_code == 422:
        print("Emissão assistida: campo não resolvido:", body["error"])
    elif e.response.status_code == 429:
        print("Rate limit. Aguarde e tente novamente")
    else:
        print(f"Erro {e.response.status_code}: {body}")