---
title: "Resultado por linha"
method: GET
path: "/v1/lotes/{id}/itens"
tags: ["Emissão em lote"]
---

# Resultado por linha

`GET /v1/lotes/{id}/itens`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/lotes/{id}/itens`
- Auth: HTTP bearer

Um item por linha (número da linha na planilha, cabeçalho = 1; ou a
posição no array JSON, começando em 1), por cursor. Os erros vêm no
mesmo formato do 422 de `POST /v1/nfse`. Os `ajustes` aparecem nas notas
já mandadas emitir.

## Path parameters

- `id` string, required

## Query parameters

- `status` 'transmitindo' | 'autorizada' | 'rejeitada' | 'cancelada' | 'falha_transmissao' | 'descartada' | 'aguardando_confirmacao' | 'com_erro_validacao' | 'aguardando_emissao' | 'ja_existente'
- `limite` integer
- `cursor` string

## Response `200`

OK

- object
  - `dados` ItemLote[]
    - `linha` integer: Linha da planilha (cabeçalho = 1) ou posição no array JSON (a partir de 1).
    - `referencia` string, nullable
    - `nfse_id` string, nullable
    - `status` 'transmitindo' | 'autorizada' | 'rejeitada' | 'cancelada' | 'falha_transmissao' | 'descartada' | 'aguardando_confirmacao' | 'com_erro_validacao' | 'aguardando_emissao' | 'ja_existente'
    - `numero` string, nullable
    - `chave_acesso` string, nullable
    - `erros` ErroCampo[]
      - `type` string: `https://sudrel.com.br/docs/erros/<codigo>`. Não vem nos itens de `erros` do 422 de `POST /v1/lotes`.
      - `codigo` string: Estável: programe em cima dele.
      - `codigo_oficial` string, nullable: Regra do Sistema Nacional antecipada, quando houver (ex.: E0202).
      - `campo` string, nullable: JSON Pointer no payload.
      - `mensagem` string
      - `correcao` string, nullable
      - `retentavel` boolean: Repetir a MESMA requisição pode dar certo?
    - `ajustes` Ajuste[]
      - `campo` string: JSON Pointer.
      - `acao` 'preenchido' | 'omitido' | 'derivado' | 'exigido'
      - `motivo` string
      - `regra` string: Identificador estável da regra.
    - `divergente` boolean: Só em `ja_existente`: o conteúdo da linha difere da nota que já existe.
    - `status_nfse` string: Só em `ja_existente`: o status atual da nota que já existe.
  - `proximo_cursor` string, nullable

## Other responses

- `401`: `nao_autenticado`: chave de API ausente, inválida ou revogada.
- `404`: `lote_nao_encontrado`.
- `429`: `limite_de_requisicoes` (`retentavel: true`): 120 requisições por minuto por chave, janela fixa de 60 s. Sem `Retry-After`: espere a virada do minuto e repita a MESMA requisição (com a mesma `Idempotency-Key`).

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)