Início|
AuditaRef/API B2B para Software Houses & ERPs
Portal do Contador ➔
Auto-Onboarding Instantâneo

Quer gerar sua API Key com 1.000 créditos gratuitos agora mesmo?

Acesse a nova Área de Desenvolvedores, informe o CNPJ do seu ERP e receba a chave sk_live_... na hora, com snippets dinâmicos em Delphi, C#, PHP e Node.

Gerar Chave em /developers ➔
Autenticação B2B • Integração de ERPs à LC 214/2025

Documentação da API REST — Motor cClassTrib

Conecte seu software emissor (NF-e/NFC-e) via HTTP REST. O motor AuditaRef processa lotes de até 500 SKUs em milissegundos com desambiguação semântica e tolerância a falhas.

Como Autenticar suas Requisições

Todas as chamadas para a API exigem o cabeçalho HTTP Authorization: Bearer <API_KEY>. Cada requisição desconta os SKUs processados da franquia do parceiro.

// Headers obrigatórios em cada chamada:
POST /api/v1/classify/batch HTTP/1.1
Authorization: Bearer sk_live_sua_chave_aqui
Content-Type: application/json

Obtenha sua Chave de Homologação

Disponibilizamos chaves com franquia gratuita de 1.000 requisições para homologação do seu ERP. A emissão oficial e gestão de saldo é realizada pelo Painel Administrativo.

Precisa de uma chave de teste?

Fale com a equipe comercial do AuditaRef para ativação imediata da sua franquia de parceiro ERP.

Integração para Software Houses

Exemplos de Código Prontos & Playground de Homologação

Observe no Playground como o mesmo NCM 9619.00.00 recebe Alíquota Zero (200013 - Saúde Menstrual, Art. 147) para absorvente e Redução de 60% (200035 - Anexo VIII, Art. 136) para fralda infantil.

// Integração Nativa Delphi (botão "Classificar IBS/CBS com IA" no Cadastro de Produtos)
uses
  System.JSON, REST.Client, REST.Types;

procedure TFormCadastroProduto.BtnClassificarIBSCBSClick(Sender: TObject);
var
  RESTClient: TRESTClient;
  RESTRequest: TRESTRequest;
  RESTResponse: TRESTResponse;
  Payload, ItemObj, RespObj, ResultItem: TJSONObject;
  ItensArr: TJSONArray;
begin
  RESTClient := TRESTClient.Create('https://seu-dominio.com.br/api/v1/classify/batch');
  RESTRequest := TRESTRequest.Create(nil);
  RESTResponse := TRESTResponse.Create(nil);
  try
    RESTRequest.Client := RESTClient;
    RESTRequest.Response := RESTResponse;
    RESTRequest.Method := rmPOST;
    RESTRequest.Params.AddHeader('Authorization', 'Bearer sk_live_erp_partner').Options := [poDoNotEncode];

    Payload := TJSONObject.Create;
    Payload.AddPair('cnpj_emitente', EdtCNPJ.Text);
    Payload.AddPair('regime_emitente', 'LUCRO_PRESUMIDO');
    Payload.AddPair('uf_origem', 'PR');

    ItensArr := TJSONArray.Create;
    ItemObj := TJSONObject.Create;
    ItemObj.AddPair('id_externo', EdtCodigoSKU.Text);
    ItemObj.AddPair('descricao', EdtDescricaoProduto.Text);
    ItemObj.AddPair('ncm', EdtNCM.Text);
    ItensArr.AddElement(ItemObj);
    Payload.AddPair('itens', ItensArr);

    RESTRequest.AddBody(Payload.ToString, ctAPPLICATION_JSON);
    RESTRequest.Execute;

    if RESTResponse.StatusCode = 200 then
    begin
      RespObj := TJSONObject.ParseJSONValue(RESTResponse.Content) as TJSONObject;
      ResultItem := (RespObj.GetValue('resultados') as TJSONArray).Items[0] as TJSONObject;

      EdtCST_IBS_CBS.Text := ResultItem.GetValue<string>('cst_ibs_cbs');
      EdtCClassTrib.Text  := ResultItem.GetValue<string>('cClassTrib');
      MemoBaseLegal.Text  := ResultItem.GetValue<string>('fundamentacao_legal');
    end;
  finally
    RESTResponse.Free;
    RESTRequest.Free;
    RESTClient.Free;
  end;
end;

Testar Endpoint Autenticado

POST /api/v1/classify/batch