Como gerar relatório de todas as inutilizações?

Neste artigo você encontra o passo a passo sobre como obter os dados de todas as inutilizações de uma ou mais empresas, em um determinado período. Além disso, poderá escolher se o relatório deverá ou não retornar o XML das inutilizações.

DICA

Importante lembrar que as inutilizações são possíveis apenas para NFe, NFCe e CTe.

---

Consultar todas as inutilizações

1. Para começar, faça uma requisição tipo POST ao endpoint consultar todas as inutilizações;

   [URL_BASE]/api/relatorios/inutilizacao

2. No corpo da requisição (request body) preencha os seguintes parâmetros:

   • {cnpj}: CNPJ do interessado (pode ser mais de um);
     ATENÇÃO

     Se mais de um CNPJ, separe-os com ponto, vírgula, ponto e vírgula, quebra de linha ou caractere de espaço | . | , | ; | \n |.

   • {comXml}: se deve retornar ou não os XML's. Valores aceitos: true ou false;
   • {dataFinal}*: data final no formato aaaa-mm-dd'T'hh:mm:ssZ. Exemplo: '2023-01-26T12:25:59-03:00';
   • {dataInicial}*: data inicial no formato aaaa-mm-dd;
   • {modelo}*: 55 (NFe), 57 (CTe), 58 (MDFe), 59 (CFe-SAT), 65 (NFCe), 66 (NF3e) ou 99 (NFSe);
   • {pagina}: número da página. Caso não seja preenchido, retornará o valor padrão: 1 (página número um) ;
   • {tipoAmbiente}*: hom ou prod.

3. Informe o x-auth-token no cabeçalho (header parameters) da requisição.

Exemplo de requisição

O exemplo abaixo traz um modelo de requisição preenchido para consulta de inutilizações, sem XMLs.

Observação

A requisição contém dados fictícios, somente para demonstração.

curl -L -X POST 'https://rest-teste.oobj.com.br/api/relatorios/inutilizacao' \
-H 'Content-Type: application/json' \
-H 'Accept: */*' \
-H 'x-auth-token: eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiI3Yjc2OTg1ZGQ2MTNhOWVlYTFiN2RmZTNiZjRhMTRiZiIsImF1ZCI6IndlYiIsImV4cCI6MTYyOTI5MDcwNiwiaWF0IjoxNjI5Mjg4OTA2fQ.-Dj91d6fBZYcZpy1-zKzohAWd5dgW2CAS5BBfwGilemUYcOVDm8CnrDJHbwsFyixI5ohphy-65fqeobXkimtCg' \
--data-raw '{
  "cnpj": "07385111000102",
  "comXml": false,
  "dataFinal": "2023-01-26T12:25:59-03:00",
  "dataInicial": "2023-01-27T12:25:59-03:00",
  "modelo": 55,
  "pagina": 0,
  "tipoAmbiente": "hom"
}'

Exemplo de retorno

{
  "registros": [
      {
          "ambiente": "Homologação",
          "uf": "RS",
          "ano": 2023,
          "cnpjEmitente": "07385111000102",
          "modelo": 55,
          "serie": 503,
          "numeroInicial": 741434,
          "numeroFinal": 741434,
          "protocolo": null,
          "justificativa": "Testando o filtro de furos",
          "dataRecebimento": 1676405411000,
          "conteudo": null,
          "status": "REJ"
      },
      {
            "ambiente": "Homologação",
          "uf": "RS",
          "ano": 2023,
          "cnpjEmitente": "07385111000102",
          "modelo": 55,
          "serie": 503,
          "numeroInicial": 741435,
          "numeroFinal": 741435,
          "protocolo": null,
          "justificativa": "Testando filtro de furos",
          "dataRecebimento": 1676405464000,
          "conteudo": null,
          "status": "REJ"
      }
    ]
}

Pronto! Você acaba de completar a consulta de relatório de inutilizações.