- Começando
- Primeiros passos
Começando
Primeiros passos
Da API Key à primeira NF-e em homologação.
Confira o emissor
No emissor da Treeunfe, confira se a empresa tem certificado A1 válido e se as configurações de NF-e estão preenchidas para homologação.
O certificado também pode ser enviado pela API. Veja Enviar certificado A1.
Gere a API Key
Em Integrações, clique em Nova e escolha Api-Key. Veja Autenticação.
Confira o checklist e as regras fiscais
Com a chave, consulte a empresa atual para obter o id e depois o checklist de NF-e. Ele mostra se falta certificado, configuração de série e numeração ou regra fiscal.
A emissão com cálculo usa as regras fiscais da empresa. Se não houver regra própria para o NCM, valem as regras padrão do sistema.
Cadastre o cliente (opcional)
Para reaproveitar o destinatário em várias notas, cadastre-o antes. Com CNPJ, basta o documento e o indicador de IE. Veja Cadastros.
Emita a NF-e
Envie a nota em homologação com calculateTaxes: true. Basta mandar os dados comerciais de cada item; a Treeunfe calcula os tributos. Depois, use Buscar NF-e para conferir se foi autorizada.
curl -X POST https://api.treeunfe.com.br/api/v1/nfe \
-H "x-api-key: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d @nota.json
O payload completo está em Emissão de NF-e.