Consultar em lote

Classifica até 100 itens numa requisição, com admissão e resultado item a item.

post/v1/classifications/batch

Autenticação: Authorization: Bearer <sua chave>. Como obter a chave

Classifica até 100 itens numa requisição, um por um, na ordem enviada, e responde tudo na mesma resposta. Feito para carga e revisão de catálogo. Cada item tem os mesmos campos e regras da consulta unitária, e cada result tem o mesmo formato da resposta dela.

Admissão item a item#

Um item inválido (GTIN com dígito verificador errado, setor desconhecido, campo não previsto) volta como REJECTED com INVALID_REQUEST, sem consumir franquia e sem derrubar os demais.
O lote inteiro só é recusado (HTTP 400) quando o envelope é inválido: items vazio ou com mais de 100 itens, campo além de items, ou item sem gtin e cfop em texto.
index aponta a posição do item no array enviado. Use-o para casar cada resultado com o seu item.

Franquia#

Cada item admitido consome uma unidade, GTIN repetido inclusive. No exemplo abaixo, o lote consome 2 unidades: o item de índice 1 foi recusado.
Se a franquia acabar no meio do lote, os itens já admitidos são mantidos e resolvidos; deste ponto em diante, todos voltam como REJECTED com QUOTA_EXCEEDED. O mesmo vale para INVALID_API_KEY e SERVICE_UNAVAILABLE na admissão: o item em que o erro ocorreu e todos os seguintes recebem esse erro.
Uma falha ao resolver um item já admitido afeta só aquele item (SERVICE_UNAVAILABLE); a unidade dele já foi consumida.

O lote não busca na GS1#

GTIN fora do catálogo volta PENDING com LOCAL_PRODUCT_MISSING e entra na fila de busca; consulte de novo mais tarde. Para tentar a GS1 na hora, use a consulta unitária. No lote não há NOT_FOUND por GTIN desconhecido.

O que reenviar#

Reenvie só os itens REJECTED com SERVICE_UNAVAILABLE (com backoff) ou com QUOTA_EXCEEDED (depois da virada do mês). Itens RESOLVED já foram cobrados: reenviá-los consome de novo. Itens com INVALID_REQUEST precisam ser corrigidos antes.

Nota

Os valores fiscais dos exemplos são ilustrativos.

Requisição

Corpo JSON (Content-Type: application/json).

itemsarray<object>obrigatório
Itens a classificar, de 1 a 100. Cada item é validado sozinho.
mínimo de 1 item · máximo de 100 itens
›4 campos
- gtinstringobrigatório
  Código de barras do produto, com as mesmas regras da consulta unitária. Precisa ser texto: item sem gtin em texto invalida o lote inteiro (400).
- cfopstringobrigatório
  CFOP da operação, com 4 dígitos. Precisa ser texto: item sem cfop em texto invalida o lote inteiro (400).
- sectorstring
  Setor do cliente final, opcional. Valor fora da lista recusa só este item, com INVALID_REQUEST.
- referenceDatestring
  Data (AAAA-MM-DD) para regras e alíquotas vigentes, opcional. Padrão: hoje, no fuso de São Paulo.

Exemplos

Terminal

1curl -sS -X POST "$GETTAX_URL/v1/classifications/batch" \
2  -H "Authorization: Bearer $GETTAX_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5  "items": [
6    {
7      "gtin": "7891000315507",
8      "cfop": "5102"
9    },
10    {
11      "gtin": "7891000315508",
12      "cfop": "5102"
13    },
14    {
15      "gtin": "7891000315521",
16      "cfop": "5102",
17      "sector": "VAREJO_GERAL"
18    }
19  ]
20}'

gettax.mjs

1// Node 18+ (fetch nativo). Rode com: node gettax.mjs
2const response = await fetch(`${process.env.GETTAX_URL}/v1/classifications/batch`, {
3  method: "POST",
4  headers: {
5    Authorization: `Bearer ${process.env.GETTAX_KEY}`,
6    "Content-Type": "application/json",
7  },
8  body: JSON.stringify({
9    items: [
10      {
11        gtin: "7891000315507",
12        cfop: "5102",
13      },
14      {
15        gtin: "7891000315508",
16        cfop: "5102",
17      },
18      {
19        gtin: "7891000315521",
20        cfop: "5102",
21        sector: "VAREJO_GERAL",
22      },
23    ],
24  }),
25});
26 
27const data = await response.json();
28if (!response.ok) throw new Error(`GetTax ${response.status}: ${data.error}`);
29console.log(data);

gettax.py

1import os
2 
3import requests  # pip install requests
4 
5response = requests.post(
6    f"{os.environ['GETTAX_URL']}/v1/classifications/batch",
7    headers={"Authorization": f"Bearer {os.environ['GETTAX_KEY']}"},
8    json={
9        "items": [
10            {
11                "gtin": "7891000315507",
12                "cfop": "5102",
13            },
14            {
15                "gtin": "7891000315508",
16                "cfop": "5102",
17            },
18            {
19                "gtin": "7891000315521",
20                "cfop": "5102",
21                "sector": "VAREJO_GERAL",
22            },
23        ],
24    },
25    timeout=30,
26)
27response.raise_for_status()
28print(response.json())

Program.cs

1// .NET 7+ (top-level statements). Rode com: dotnet run
2using System.Net.Http.Headers;
3using System.Text;
4 
5var baseUrl = Environment.GetEnvironmentVariable("GETTAX_URL");
6var apiKey = Environment.GetEnvironmentVariable("GETTAX_KEY");
7 
8using var http = new HttpClient();
9http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);
10 
11var body = """
12    {
13      "items": [
14        {
15          "gtin": "7891000315507",
16          "cfop": "5102"
17        },
18        {
19          "gtin": "7891000315508",
20          "cfop": "5102"
21        },
22        {
23          "gtin": "7891000315521",
24          "cfop": "5102",
25          "sector": "VAREJO_GERAL"
26        }
27      ]
28    }
29    """;
30using var content = new StringContent(body, Encoding.UTF8, "application/json");
31using var response = await http.PostAsync($"{baseUrl}/v1/classifications/batch", content);
32 
33Console.WriteLine((int)response.StatusCode);
34Console.WriteLine(await response.Content.ReadAsStringAsync());

GetTax.java

1// Java 17+. Rode com: java GetTax.java
2import java.net.URI;
3import java.net.http.HttpClient;
4import java.net.http.HttpRequest;
5import java.net.http.HttpResponse;
6 
7public class GetTax {
8    public static void main(String[] args) throws Exception {
9        var baseUrl = System.getenv("GETTAX_URL");
10        var apiKey = System.getenv("GETTAX_KEY");
11 
12        var body = """
13            {
14              "items": [
15                {
16                  "gtin": "7891000315507",
17                  "cfop": "5102"
18                },
19                {
20                  "gtin": "7891000315508",
21                  "cfop": "5102"
22                },
23                {
24                  "gtin": "7891000315521",
25                  "cfop": "5102",
26                  "sector": "VAREJO_GERAL"
27                }
28              ]
29            }
30            """;
31 
32        var request = HttpRequest.newBuilder(URI.create(baseUrl + "/v1/classifications/batch"))
33            .header("Authorization", "Bearer " + apiKey)
34            .header("Content-Type", "application/json")
35            .POST(HttpRequest.BodyPublishers.ofString(body))
36            .build();
37 
38        var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
39        System.out.println(response.statusCode());
40        System.out.println(response.body());
41    }
42}

gettax.php

1<?php
2// PHP 8+ com a extensão curl. Rode com: php gettax.php
3$ch = curl_init(getenv('GETTAX_URL') . '/v1/classifications/batch');
4curl_setopt_array($ch, [
5    CURLOPT_RETURNTRANSFER => true,
6    CURLOPT_POST => true,
7    CURLOPT_HTTPHEADER => [
8        'Authorization: Bearer ' . getenv('GETTAX_KEY'),
9        'Content-Type: application/json',
10    ],
11    CURLOPT_POSTFIELDS => json_encode([
12        'items' => [
13            [
14                'gtin' => '7891000315507',
15                'cfop' => '5102',
16            ],
17            [
18                'gtin' => '7891000315508',
19                'cfop' => '5102',
20            ],
21            [
22                'gtin' => '7891000315521',
23                'cfop' => '5102',
24                'sector' => 'VAREJO_GERAL',
25            ],
26        ],
27    ]),
28]);
29 
30$body = curl_exec($ch);
31if ($body === false) {
32    throw new RuntimeException(curl_error($ch));
33}
34 
35echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), PHP_EOL, $body, PHP_EOL;

GetTax.dpr

1// Delphi XE8+ (System.Net.HttpClient, sem componentes de terceiros).
2program GetTax;
3 
4{$APPTYPE CONSOLE}
5 
6uses
7  System.SysUtils, System.Classes, System.Net.HttpClient, System.Net.URLClient;
8 
9const
10  Body =
11    '{' +
12    '  "items": [' +
13    '    {' +
14    '      "gtin": "7891000315507",' +
15    '      "cfop": "5102"' +
16    '    },' +
17    '    {' +
18    '      "gtin": "7891000315508",' +
19    '      "cfop": "5102"' +
20    '    },' +
21    '    {' +
22    '      "gtin": "7891000315521",' +
23    '      "cfop": "5102",' +
24    '      "sector": "VAREJO_GERAL"' +
25    '    }' +
26    '  ]' +
27    '}';
28 
29var
30  Client: THTTPClient;
31  Content: TStringStream;
32  Response: IHTTPResponse;
33begin
34  Client := THTTPClient.Create;
35  Content := TStringStream.Create(Body, TEncoding.UTF8);
36  try
37    Response := Client.Post(GetEnvironmentVariable('GETTAX_URL') + '/v1/classifications/batch', Content, nil, [
38      TNetHeader.Create('Authorization', 'Bearer ' + GetEnvironmentVariable('GETTAX_KEY')),
39      TNetHeader.Create('Content-Type', 'application/json')
40    ]);
41    Writeln(Response.StatusCode);
42    Writeln(Response.ContentAsString(TEncoding.UTF8));
43  finally
44    Content.Free;
45    Client.Free;
46  end;
47end.

Respostas

200Lote processado, inclusive quando há itens recusados. O lote não responde 429: franquia esgotada aparece por item.›

resultsarray<um de>obrigatório
Uma entrada por item enviado, na mesma ordem.
›2 formas possíveis
outcome = RESOLVED
- outcomestringobrigatório
  RESOLVED: o item foi admitido e traz result. REJECTED: o item foi recusado e traz error.
  Valores:RESOLVED
- indexintegerobrigatório
  Posição do item no array enviado, começando em 0.
  mínimo 0
- resultobjectobrigatório
  Resposta do item, no mesmo formato da consulta unitária.
  ›10 campos
  decisionVersionstringobrigatório
  Identificador da decisão, gravada em trilha de auditoria imutável. Cada consulta gera um novo, mesmo com a mesma entrada. Guarde junto do documento fiscal e informe ao reportar um problema.
  UUID
  statusstringobrigatório
  Resultado da consulta: CLASSIFIED, PENDING, IN_REVIEW ou NOT_FOUND. Ver Status e alternativas.
  Valores:CLASSIFIEDPENDINGIN_REVIEWNOT_FOUND
  retryAfterSecondsinteger
  Só em PENDING, quando a busca do produto foi adiada pelo limite diário de consultas do GetTax à GS1: segundos até esse limite reiniciar. Não consulte o mesmo GTIN antes disso. Ausente nos demais casos.
  mínimo 0
  reasonstringobrigatóriopode ser null
  Motivo do status: LOCAL_PRODUCT_MISSING (produto fora do catálogo), MISSING_NCM, MISSING_RULE ou INCOMPLETE_CLASSIFICATION. null em CLASSIFIED e NOT_FOUND.
  Valores:LOCAL_PRODUCT_MISSINGMISSING_NCMMISSING_RULEINCOMPLETE_CLASSIFICATION
  gtinstringobrigatório
  GTIN normalizado com 14 dígitos (zeros à esquerda).
  cfopstringobrigatório
  CFOP consultado.
  sectorstringobrigatóriopode ser null
  Setor enviado; null quando a consulta não informou setor.
  Valores:VAREJO_GERALBAR_RESTAURANTEPRODUTOR_RURALGOVERNOATACADOZONA_FRANCA
  referenceDatestringobrigatório
  Data de referência efetivamente usada: a enviada ou a data de hoje em São Paulo.
  data AAAA-MM-DD
  productobjectobrigatóriopode ser null
  Produto no catálogo do GetTax. null quando o GTIN não está no catálogo (PENDING e NOT_FOUND).
  ›10 campos
  idstringobrigatório
  Identificador interno do produto.
  UUID
  gtinAsProvidedstringobrigatóriopode ser null
  GTIN na forma em que entrou no catálogo, antes da normalização para 14 dígitos.
  descriptionstringobrigatóriopode ser null
  Descrição do produto, quando a origem informa.
  brandstringobrigatóriopode ser null
  Marca, quando a origem informa.
  ncmstringobrigatóriopode ser null
  NCM de 8 dígitos, sem pontuação. null quando a origem não informou. Sem NCM, só se aplicam regras que não dependem dele (por operação ou exceção por GTIN).
  ncmSourcestringobrigatóriopode ser null
  Origem do NCM (hoje, GS1). null quando não há NCM.
  ceststringobrigatóriopode ser null
  CEST, quando a origem informa.
  gpcCodestringobrigatóriopode ser null
  Código de categoria GPC da GS1, quando informado.
  imageUrlstringobrigatóriopode ser null
  URL de imagem do produto, quando informada.
  sourceKindstringobrigatório
  Como o produto entrou no catálogo: BULK (carga de arquivo da GS1) ou PROVIDER (busca individual na GS1).
  classificationsarray<object>obrigatório
  Alternativas de enquadramento. Vazio quando não há alternativa. A ordem é técnica e estável, não recomendação: não escolha a primeira automaticamente.
  ›11 campos
  stagestringobrigatório
  Etapa do motor que produziu a alternativa: OPERATION, COHERENCE, PRODUCT ou FALLBACK. Ver Etapas do motor.
  Valores:OPERATIONCOHERENCEPRODUCTFALLBACK
  ruleobjectobrigatório
  Regra curada que produziu a alternativa, com versão, vigência e escopo.
  ›7 campos
  idstringobrigatório
  Identificador da regra.
  UUID
  versionintegerobrigatório
  Versão da regra. Junto com rule.id, identifica exatamente o que foi aplicado.
  effectiveFromstringobrigatório
  Início da vigência da regra (inclusivo).
  data AAAA-MM-DD
  effectiveTostringobrigatóriopode ser null
  Fim da vigência da regra (exclusivo). null = sem data de término.
  data AAAA-MM-DD
  ncmstringobrigatóriopode ser null
  Escopo de NCM da regra: família de 4 dígitos, NCM completo de 8, ou null quando a regra não depende de NCM.
  gtinstringobrigatóriopode ser null
  GTIN (14 dígitos) quando a regra é exceção para um produto específico; senão null.
  sectorstringobrigatóriopode ser null
  Setor da regra. null = regra genérica, vale para qualquer setor.
  Valores:VAREJO_GERALBAR_RESTAURANTEPRODUTOR_RURALGOVERNOATACADOZONA_FRANCA
  cststringobrigatório
  CST a informar no documento fiscal. É o mesmo para CBS e IBS.
  cClassTribstringobrigatório
  Código de classificação tributária a informar no documento fiscal. É o mesmo para CBS e IBS.
  applicabilitystringobrigatóriopode ser null
  Condição em que a alternativa se aplica, em texto. null quando não há condição. Quem confirma se a condição vale para a operação é o emissor.
  observationstringobrigatóriopode ser null
  Observação da curadoria fiscal, em texto, ou null.
  legalBasisstringobrigatóriopode ser null
  Fundamento legal da alternativa: o da regra, quando a curadoria cadastrou um próprio; senão o do cClassTrib na fonte oficial (ex.: LC 214/2025, Art. 135). null quando nenhum dos dois existe.
  taxClassificationobjectobrigatóriopode ser null
  Linha da tabela oficial de cClassTrib usada no cálculo. null quando não há linha vigente para o código (o cálculo fica UNAVAILABLE).
  ›12 campos
  idstringobrigatório
  Identificador da linha na tabela de cClassTrib.
  UUID
  sourceVersionstringobrigatório
  Versão da fonte de onde a linha foi carregada.
  effectiveFromstringobrigatório
  Início da vigência da linha (inclusivo).
  data AAAA-MM-DD
  effectiveTostringobrigatóriopode ser null
  Fim da vigência da linha (exclusivo). null = sem data de término.
  data AAAA-MM-DD
  cststringobrigatório
  CST do código na tabela oficial. Se divergir do CST da regra, o cálculo fica UNAVAILABLE com CST_MISMATCH.
  cClassTribstringobrigatório
  Código cClassTrib da linha.
  reductionPctIbsstringobrigatório
  Redução do IBS (vale para IBS_UF e IBS_MUN), fração decimal em string, com 6 casas: 0.600000 = 60%.
  reductionPctCbsstringobrigatório
  Redução da CBS, fração decimal em string, com 6 casas: 0.600000 = 60%.
  gTribRegularbooleanobrigatório
  Indicador gTribRegular do código, como publicado na tabela oficial de cClassTrib.
  isApplicablebooleanobrigatório
  Indicador de aplicabilidade do código, como publicado na tabela oficial de cClassTrib.
  calculationModestringobrigatório
  Como o código é calculado: STANDARD (alíquota × (1 − redução)), NOT_DUE (sem tributo devido) ou UNSUPPORTED (mecânica que o motor ainda não calcula, como diferimento e monofasia).
  Valores:STANDARDNOT_DUEUNSUPPORTED
  legalBasisstringobrigatóriopode ser null
  Fundamento legal do código na fonte oficial. O que vale para a alternativa é o legalBasis dela.
  ratesarray<object>obrigatório
  Linhas da tabela de alíquotas vigentes na data de referência, uma por componente.
  ›6 campos
  idstringobrigatório
  Identificador da linha na tabela de alíquotas.
  UUID
  sourceVersionstringobrigatório
  Versão da fonte de onde a alíquota foi carregada.
  effectiveFromstringobrigatório
  Início da vigência da alíquota (inclusivo).
  data AAAA-MM-DD
  effectiveTostringobrigatóriopode ser null
  Fim da vigência da alíquota (exclusivo). null = sem data de término.
  data AAAA-MM-DD
  componentstringobrigatório
  Componente a que a alíquota se refere.
  Valores:CBSIBS_UFIBS_MUN
  ratestringobrigatório
  Alíquota padrão do componente, fração decimal em string, com 6 casas: 0.009000 = 0,9%.
  componentsarray<um de>obrigatóriopode ser null
  Resultado por componente (CBS, IBS_UF, IBS_MUN). null quando o cálculo está indisponível (calculation.status = UNAVAILABLE). Ver Componentes e alíquotas.
  ›2 formas possíveis
  status = STANDARD
  componentstringobrigatório
  Componente: CBS, IBS_UF ou IBS_MUN. Trate a lista como aberta: novos componentes podem surgir.
  Valores:CBSIBS_UFIBS_MUN
  cststringobrigatório
  CST do componente. Igual ao da alternativa.
  cClassTribstringobrigatório
  cClassTrib do componente. Igual ao da alternativa.
  statusstringobrigatório
  STANDARD: tributo devido, com alíquota padrão, redução e alíquota efetiva. NOT_DUE: sem tributo devido; não traz números.
  Valores:STANDARD
  standardRatestringobrigatório
  Alíquota padrão do componente na data de referência, fração decimal em string, com 6 casas.
  reductionPctstringobrigatório
  Redução aplicada ao componente, fração decimal em string, com 6 casas.
  effectiveRatestringobrigatório
  Alíquota efetiva: standardRate × (1 − reductionPct), fração decimal em string, com 6 casas.
  status = NOT_DUE
  componentstringobrigatório
  Componente: CBS, IBS_UF ou IBS_MUN. Trate a lista como aberta: novos componentes podem surgir.
  Valores:CBSIBS_UFIBS_MUN
  cststringobrigatório
  CST do componente. Igual ao da alternativa.
  cClassTribstringobrigatório
  cClassTrib do componente. Igual ao da alternativa.
  statusstringobrigatório
  STANDARD: tributo devido, com alíquota padrão, redução e alíquota efetiva. NOT_DUE: sem tributo devido; não traz números.
  Valores:NOT_DUE
  calculationum deobrigatório
  Estado do cálculo da alternativa. Uma alternativa sem cálculo continua na resposta, com o motivo.
  ›3 formas possíveis
  status = CALCULATED
  statusstringobrigatório
  CALCULATED (componentes STANDARD), NOT_DUE (componentes NOT_DUE) ou UNAVAILABLE (components nulo).
  Valores:CALCULATED
  status = NOT_DUE
  statusstringobrigatório
  CALCULATED (componentes STANDARD), NOT_DUE (componentes NOT_DUE) ou UNAVAILABLE (components nulo).
  Valores:NOT_DUE
  status = UNAVAILABLE
  statusstringobrigatório
  CALCULATED (componentes STANDARD), NOT_DUE (componentes NOT_DUE) ou UNAVAILABLE (components nulo).
  Valores:UNAVAILABLE
  reasonstringobrigatório
  Só em UNAVAILABLE: TAX_CLASSIFICATION_MISSING, CST_MISMATCH, RATE_MISSING ou CALCULATION_UNSUPPORTED.
  Valores:TAX_CLASSIFICATION_MISSINGCST_MISMATCHRATE_MISSINGCALCULATION_UNSUPPORTED
outcome = REJECTED
- outcomestringobrigatório
  RESOLVED: o item foi admitido e traz result. REJECTED: o item foi recusado e traz error.
  Valores:REJECTED
- indexintegerobrigatório
  Posição do item no array enviado, começando em 0.
  mínimo 0
- errorstringobrigatório
  Por que o item foi recusado: INVALID_REQUEST (item inválido; não consome), QUOTA_EXCEEDED (franquia esgotada), INVALID_API_KEY (chave deixou de valer) ou SERVICE_UNAVAILABLE (falha temporária).
  Valores:INVALID_REQUESTQUOTA_EXCEEDEDINVALID_API_KEYSERVICE_UNAVAILABLE

Exemplo · 200

1{
2  "results": [
3    {
4      "outcome": "RESOLVED",
5      "index": 0,
6      "result": {
7        "decisionVersion": "4c5d6e7f-8091-4a2b-9c3d-4e5f60718293",
8        "status": "CLASSIFIED",
9        "reason": null,
10        "gtin": "07891000315507",
11        "cfop": "5102",
12        "sector": null,
13        "referenceDate": "2026-10-20",
14        "product": {
15          "id": "5e6f7a8b-9c0d-4e1f-a2b3-c4d5e6f7a8b9",
16          "gtinAsProvided": "7891000315507",
17          "description": "ARROZ BRANCO TIPO 1 5KG",
18          "brand": "MARCA EXEMPLO",
19          "ncm": "10063021",
20          "ncmSource": "GS1",
21          "cest": null,
22          "gpcCode": null,
23          "imageUrl": null,
24          "sourceKind": "BULK"
25        },
26        "classifications": [
27          {
28            "stage": "PRODUCT",
29            "rule": {
30              "id": "3f6b2c1e-8a4d-4f2b-9c7e-1d2a3b4c5d6e",
31              "version": 1,
32              "effectiveFrom": "2026-01-01",
33              "effectiveTo": null,
34              "ncm": "1006",
35              "gtin": null,
36              "sector": null
37            },
38            "cst": "200",
39            "cClassTrib": "200034",
40            "applicability": "Venda para alimentação humana.",
41            "observation": null,
42            "legalBasis": "LC 214/2025, Art. 135",
43            "taxClassification": {
44              "id": "6f7a8b9c-0d1e-4f2a-b3c4-d5e6f7a8b9c0",
45              "sourceVersion": "CCLASSTRIB-2026",
46              "effectiveFrom": "2026-01-01",
47              "effectiveTo": null,
48              "cst": "200",
49              "cClassTrib": "200034",
50              "reductionPctIbs": "0.600000",
51              "reductionPctCbs": "0.600000",
52              "gTribRegular": false,
53              "isApplicable": true,
54              "calculationMode": "STANDARD",
55              "legalBasis": "LC 214/2025, Art. 135"
56            },
57            "rates": [
58              {
59                "id": "0b1c2d3e-4f50-4a61-8b72-c3d4e5f60718",
60                "sourceVersion": "ALIQUOTAS-2026",
61                "effectiveFrom": "2026-01-01",
62                "effectiveTo": null,
63                "component": "CBS",
64                "rate": "0.009000"
65              },
66              {
67                "id": "1c2d3e4f-5061-4b72-9c83-d4e5f6071829",
68                "sourceVersion": "ALIQUOTAS-2026",
69                "effectiveFrom": "2026-01-01",
70                "effectiveTo": null,
71                "component": "IBS_UF",
72                "rate": "0.001000"
73              },
74              {
75                "id": "2d3e4f50-6172-4c83-ad94-e5f60718293a",
76                "sourceVersion": "ALIQUOTAS-2026",
77                "effectiveFrom": "2026-01-01",
78                "effectiveTo": null,
79                "component": "IBS_MUN",
80                "rate": "0.000000"
81              }
82            ],
83            "components": [
84              {
85                "component": "CBS",
86                "cst": "200",
87                "cClassTrib": "200034",
88                "status": "STANDARD",
89                "standardRate": "0.009000",
90                "reductionPct": "0.600000",
91                "effectiveRate": "0.003600"
92              },
93              {
94                "component": "IBS_UF",
95                "cst": "200",
96                "cClassTrib": "200034",
97                "status": "STANDARD",
98                "standardRate": "0.001000",
99                "reductionPct": "0.600000",
100                "effectiveRate": "0.000400"
101              },
102              {
103                "component": "IBS_MUN",
104                "cst": "200",
105                "cClassTrib": "200034",
106                "status": "STANDARD",
107                "standardRate": "0.000000",
108                "reductionPct": "0.600000",
109                "effectiveRate": "0.000000"
110              }
111            ],
112            "calculation": {
113              "status": "CALCULATED"
114            }
115          }
116        ]
117      }
118    },
119    {
120      "outcome": "REJECTED",
121      "index": 1,
122      "error": "INVALID_REQUEST"
123    },
124    {
125      "outcome": "RESOLVED",
126      "index": 2,
127      "result": {
128        "decisionVersion": "7b8c9d0e-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
129        "status": "PENDING",
130        "reason": "LOCAL_PRODUCT_MISSING",
131        "gtin": "07891000315521",
132        "cfop": "5102",
133        "sector": "VAREJO_GERAL",
134        "referenceDate": "2026-10-20",
135        "product": null,
136        "classifications": []
137      }
138    }
139  ]
140}

400Envelope inválido: lote vazio, mais de 100 itens, campo além de items, item que não é objeto ou item sem gtin/cfop em texto. Nenhum item é processado nem consumido.›

errorstringobrigatório
Código do erro, sem mensagem detalhada. Ver Erros e novas tentativas.
Valores:INVALID_REQUEST

Exemplo · 400

1{
2  "error": "INVALID_REQUEST"
3}

401Chave ausente, malformada, inexistente, revogada ou de cliente desativado. Não consome franquia.›

errorstringobrigatório
Código do erro, sem mensagem detalhada. Ver Erros e novas tentativas.
Valores:INVALID_API_KEY

Exemplo · 401

1{
2  "error": "INVALID_API_KEY"
3}

500Erro inesperado. Repita com backoff exponencial.›

errorstringobrigatório
Código do erro, sem mensagem detalhada. Ver Erros e novas tentativas.
Valores:INTERNAL_ERROR

Exemplo · 500

1{
2  "error": "INTERNAL_ERROR"
3}

503Serviço temporariamente indisponível. Repita com backoff exponencial.›

errorstringobrigatório
Código do erro, sem mensagem detalhada. Ver Erros e novas tentativas.
Valores:SERVICE_UNAVAILABLE

Exemplo · 503

1{
2  "error": "SERVICE_UNAVAILABLE"
3}