SDKs Oficiais

Mantemos bibliotecas cliente oficiais para 3 linguagens. Todas cobrem as mesmas 17 operações da API e seguem o mesmo padrão: um client único, autenticado pela Chave de Acesso da sua conta e pela chave de API da empresa, sem necessidade de lidar com certificado digital ou tenant id.

Para exemplos método a método, veja a página de Referência de cada endpoint — cada uma já traz o código pronto nas 4 linguagens (cURL, Node, Python, Java).

Instalação

Node.js

npm install @tenzanlabs/nfe-node-sdk

Python

pip install tenzan-nfe-python-sdk

Java

<dependency>
    <groupId>io.github.tenzan-labs</groupId>
    <artifactId>nfe-java-sdk</artifactId>
    <version>2.0.0</version>
</dependency>

Instanciando o client

Node.js

import { NFeClient } from '@tenzanlabs/nfe-node-sdk';

const client = new NFeClient('nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', 'nfe_test_SUA_CHAVE_AQUI');
// 3º argumento opcional: baseUrl (padrão: process.env.NFE_SAAS_URL || 'https://app.nfe.tenzanlabs.com')

Python

from nfe_sdk import NFeClient

client = NFeClient(access_key='nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', api_key='nfe_test_SUA_CHAVE_AQUI')
# base_url opcional: variável de ambiente NFE_SAAS_URL, padrão https://app.nfe.tenzanlabs.com

Java

import br.com.saascore.nfe.NFeClient;

NFeClient client = new NFeClient("nfe_access_SUA_CHAVE_DE_ACESSO_AQUI", "nfe_test_SUA_CHAVE_AQUI");
// construtor com 3 args aceita uma baseUrl customizada

Tratamento de erro

Todo erro HTTP (4xx/5xx) vira uma exceção própria, com o status HTTP e o corpo cru da resposta disponíveis para inspeção — veja os 3 formatos de erro que a API pode devolver.

Node.js

import { NFeApiError } from '@tenzanlabs/nfe-node-sdk';

try {
  await client.emit({ mod: '55', /* ... */ });
} catch (err) {
  if (err instanceof NFeApiError) {
    console.error(err.httpStatus, err.message, err.body);
  }
}

Python

from nfe_sdk import NFeApiError

try:
    client.emit({"mod": "55"})
except NFeApiError as err:
    print(err.http_status, err, err.body)

Java

import br.com.saascore.nfe.NFeApiException;

try {
    client.emit(data);
} catch (NFeApiException err) {
    System.out.println(err.httpStatus + " " + err.getMessage());
}