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| Coluna | Valores |
|---|---|
documento | NFe (produto) ou NFSe (serviço) |
regime | regular ou simples (regime do emitente) |
ncm / nbs | Com ou sem pontos. NCM para NF-e, NBS para NFS-e. |
cClassTrib | Opcional. Vazio: o diagnóstico sugere candidatos. |
cAtivSN | Obrigatório quando regime=simples. |
Status de cada item
| Status | Significado |
|---|---|
| OK | Nada a fazer. |
| ALERTA | Válido, mas vale revisar (há tratamento específico disponível ou o item tem IS). |
| PENDENTE | Falta informação, como o cClassTrib. |
| ERRO | NCM/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