Consulta ONU

Para que serve

Validar o número ONU declarado num BL ou numa reserva, conferir se a classe e o grupo de embalagem batem com o número, e achar o nome apropriado para embarque em inglês, como a lista o imprime.

Um número ONU não tem dígito verificador. UN1219 lido como UN1210 é outro produto válido, da mesma classe 3. Confira o número junto com o nome e o grupo de embalagem, e não só a existência dele.

Três rotas

Respondem na hora, sem job e sem webhook. Use a mesma chave de autenticação das outras rotas. O número vale com ou sem o prefixo: UN1219, UN 1219 e 1219 são o mesmo.

Um número, várias entradas

A lista repete o número numa entrada por grupo de embalagem, e cada entrada tem a própria quantidade limitada e as próprias instruções de embalagem. A consulta devolve as entradas como a lista as imprime:

curl "https://comexdoc.com.br/v1/tabelas/onu/UN1133" \
  -H "Authorization: Bearer cxd_live_..."

{
  "numero": "1133",
  "entradas": [
    { "nome": "ADHESIVES containing flammable liquid", "classe": "3",
      "grupo_embalagem": "I", "quantidade_limitada": "500 ml", ... },
    { "nome": "ADHESIVES containing flammable liquid", "classe": "3",
      "grupo_embalagem": "II", "quantidade_limitada": "5 L", ... },
    { "nome": "ADHESIVES containing flammable liquid", "classe": "3",
      "grupo_embalagem": "III", "quantidade_limitada": "5 L", ... }
  ],
  "tabela": { "fonte": "UN Model Regulations, Rev. 24 (2025)", ... }
}

Para saber se um grupo é permitido, procure a entrada com aquele grupo_embalagem. Se não houver, o grupo declarado não existe para o número.

Buscar

# por prefixo do número
curl "https://comexdoc.com.br/v1/tabelas/onu?q=121" \
  -H "Authorization: Bearer cxd_live_..."

# por pedaço do nome, em inglês
curl "https://comexdoc.com.br/v1/tabelas/onu?q=isopropanol" \
  -H "Authorization: Bearer cxd_live_..."

Dígitos, com ou sem UN na frente, são lidos como prefixo do número; qualquer outra coisa, como pedaço do nome. O campo interpretado_como diz como o termo foi lido. Sem termo, a rota pagina a lista inteira na ordem do número.

Lote

curl -X POST "https://comexdoc.com.br/v1/tabelas/onu/lote" \
  -H "Authorization: Bearer cxd_live_..." \
  -H "Content-Type: application/json" \
  -d '{"numeros": ["1219", "UN1133", "9999"]}'

Cada item volta na ordem do pedido, com encontrado e as entradas do número. Um número que não existe volta com encontrado: false, e um valor que não é número ONU volta com numero: null. Repetidos saem uma vez só.

O que vem em cada entrada

Os valores saem como a lista os imprime. Onde a lista escreve uma nota no lugar do valor, como See SP 277, a nota vem no campo. Nos campos de lista, a nota vem como item único: nos radioativos, instrucoes_embalagem traz ["See chapter 2.7 and section 4.1.9"], e os três campos seguintes vêm vazios, porque a lista imprime a nota sobre as quatro colunas. Onde a lista escreve NONE, não há instrução de embalagem: nos produtos fundidos, que só vão em tanque, e em veículos e unidades de transporte fumigadas.

Glossário (Apêndice B)

Algumas entradas, quase todas explosivos da classe 1, têm explicação no glossário das Recomendações. Nelas, apendice_b traz o termo do glossário, a explicação e a página. Nas demais, vem null. No portal, essas entradas aparecem com a tag glossário.

"apendice_b": {
  "termo": "AMMUNITION, INCENDIARY",
  "explicacao": "Ammunition containing incendiary substances which may be a solid, liquid or gel including white phosphorus. ...",
  "pagina": 396,
  "aviso": "The explanations in this Glossary are for information only and are not to be used for purposes of hazard classification."
}

Fonte e edição

A lista é a das Recomendações da ONU para o transporte de produtos perigosos, e toda resposta diz de qual edição ela é, no campo tabela.fonte. A lista é revista a cada dois anos.