Navegar na documentação

Entender o resultado

Diagnóstico do cadastro

Antes de emitir com CBS/IBS, o cadastro de produtos e serviços precisa estar certo. O diagnóstico confere cada item contra as tabelas oficiais.

O que é verificado

  • NCM (produtos) e NBS (serviços): formato e existência na tabela oficial;
  • se o item está sujeito ao Imposto Seletivo;
  • cClassTrib: se existe, se vale para o documento e se está vinculado ao NCM/NBS;
  • códigos com tratamento específico disponíveis para aquele NCM/NBS (reduções, alíquota zero, regimes específicos);
  • para o Simples Nacional, a atividade (cAtivSN).

Arquivo CSV

Separador ; ou ,, em UTF-8 (com ou sem BOM), com cabeçalho:

cadastro.csv
codigo;descricao;documento;regime;ncm;nbs;cClassTrib;cAtivSN
P001;Arroz branco tipo 1 5kg;NFe;regular;1006.30.21;;200003;
P002;Cerveja lata 350ml;NFe;regular;22030000;;;
S001;Consultoria em TI;NFSe;regular;;122011200;;
P003;Cadeira escritório;NFe;simples;94017100;;;01
ColunaValores
documentoNFe (produto) ou NFSe (serviço)
regimeregular ou simples (regime do emitente)
ncm / nbsCom ou sem pontos. NCM para NF-e, NBS para NFS-e.
cClassTribOpcional. Vazio: o diagnóstico sugere candidatos.
cAtivSNObrigatório quando regime=simples.

Status de cada item

StatusSignificado
OKNada a fazer.
ALERTAVálido, mas vale revisar (há tratamento específico disponível ou o item tem IS).
PENDENTEFalta informação, como o cClassTrib.
ERRONCM/NBS inexistente, cClassTrib inválido ou não vinculado.

Pela API

curl
curl -X POST "https://app.marco33.com.br/v1/diagnosticos/cadastro" \
  -H "Authorization: Bearer m33_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "dataReferencia": "2027-01-01",
        "itens": [{ "codigo": "P002", "documento": "NFe", "regime": "regular", "ncm": "22030000" }] }'

O diagnóstico não fica guardado: a resposta é a única cópia.

PróximoColetor de pasta