{ "info": { "name": "dofiscal API v2.0 - Motor de Cálculo Tributário", "description": "Collection completa da dofiscal API com autenticação JWT, sistema de créditos e cálculo de impostos.\n\n**Features:**\n- 🔐 Autenticação JWT Bearer\n- 💳 Sistema de créditos (10 grátis no cadastro)\n- 📊 Cálculo ICMS + PIS/COFINS (Sistema Atual)\n- 🆕 Cálculo IBS + CBS (Sistema Reforma)\n- 📄 Conversão de XML CTe com impostos da reforma\n\n**Como usar:**\n1. Execute: Registrar Usuário (cria conta, SEM token)\n2. Execute: Fazer Login (retorna access_token)\n3. O token é salvo automaticamente em {{token}}\n4. Teste os outros endpoints!", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "dofiscal" }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://dofiscal.com.br", "type": "string" }, { "key": "token", "value": "", "type": "string" }, { "key": "refresh_token", "value": "", "type": "string" } ], "item": [ { "name": "🔐 Autenticação", "item": [ { "name": "1. Registrar Usuário (10 Créditos Grátis - SEM Token)", "event": [ { "listen": "test", "script": { "exec": [ "if (pm.response.code === 201) {", " const jsonData = pm.response.json();", " if (jsonData.session) {", " pm.collectionVariables.set('token', jsonData.session.access_token);", " pm.collectionVariables.set('refresh_token', jsonData.session.refresh_token);", " console.log('✅ Token salvo automaticamente!');", " console.log('💳 Créditos:', jsonData.user.credits);", " }", "}" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"email\": \"teste{{$timestamp}}@gmail.com\",\n \"password\": \"Senha123!\",\n \"name\": \"Usuário Teste Postman\",\n \"company\": \"Empresa Teste Ltda\",\n \"cnpj\": \"12.345.678/0001-90\",\n \"phone\": \"(11) 98765-4321\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/auth/register", "host": ["{{baseUrl}}"], "path": ["api", "auth", "register"] }, "description": "Registra um novo usuário no sistema.\n\n**Campos obrigatórios:** email, password\n**Campos opcionais:** name, company, cnpj, phone\n\n**Benefícios:**\n- ✅ 10 créditos grátis automáticos\n- ✅ Token JWT retornado\n- ✅ Registro no banco via trigger\n\n**Nota:** O script de teste salva automaticamente o token na variável {{token}}" }, "response": [] }, { "name": "2. Login", "event": [ { "listen": "test", "script": { "exec": [ "if (pm.response.code === 200) {", " const jsonData = pm.response.json();", " if (jsonData.session) {", " pm.collectionVariables.set('token', jsonData.session.access_token);", " pm.collectionVariables.set('refresh_token', jsonData.session.refresh_token);", " console.log('✅ Token salvo!');", " console.log('💳 Créditos:', jsonData.user.credits);", " }", "}" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"email\": \"seu-email@gmail.com\",\n \"password\": \"SuaSenha123!\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/auth/login", "host": ["{{baseUrl}}"], "path": ["api", "auth", "login"] }, "description": "Faz login de um usuário existente.\n\n**Retorna:**\n- access_token (válido por 1 hora)\n- refresh_token (válido por 7 dias)\n- Informações do usuário (incluindo créditos)" }, "response": [] }, { "name": "3. Renovar Token", "event": [ { "listen": "test", "script": { "exec": [ "if (pm.response.code === 200) {", " const jsonData = pm.response.json();", " if (jsonData.session) {", " pm.collectionVariables.set('token', jsonData.session.access_token);", " pm.collectionVariables.set('refresh_token', jsonData.session.refresh_token);", " console.log('✅ Token renovado!');", " }", "}" ], "type": "text/javascript" } } ], "request": { "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"refresh_token\": \"{{refresh_token}}\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/auth/refresh", "host": ["{{baseUrl}}"], "path": ["api", "auth", "refresh"] }, "description": "Renova o access_token usando o refresh_token.\n\nUse quando o access_token expirar (após 1 hora)." }, "response": [] }, { "name": "4. Ver Perfil", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/auth/profile", "host": ["{{baseUrl}}"], "path": ["api", "auth", "profile"] }, "description": "Obtém perfil completo do usuário autenticado." }, "response": [] }, { "name": "5. Ver Créditos", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/auth/credits", "host": ["{{baseUrl}}"], "path": ["api", "auth", "credits"] }, "description": "Consulta saldo de créditos do usuário." }, "response": [] }, { "name": "6. Logout", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "POST", "header": [], "url": { "raw": "{{baseUrl}}/api/auth/logout", "host": ["{{baseUrl}}"], "path": ["api", "auth", "logout"] }, "description": "Faz logout do usuário (invalida token)." }, "response": [] } ] }, { "name": "💰 Operações com Créditos", "item": [ { "name": "Calcular Impostos - Sistema Atual (2025)", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"valorFrete\": 1000,\n \"dataEmissao\": \"2025-06-15\",\n \"ufOrigem\": \"SP\",\n \"ufDestino\": \"RJ\",\n \"municipioDestino\": \"Rio de Janeiro\",\n \"cst\": \"00\",\n \"cClassTrib\": \"00\",\n \"regimeTributario\": \"presumido\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/calcular-impostos", "host": ["{{baseUrl}}"], "path": ["api", "calcular-impostos"] }, "description": "Calcula impostos usando o sistema ATUAL (ICMS + PIS/COFINS).\n\n**Consome:** 1 crédito\n**Sistema:** Automático baseado na data\n**Alíquotas:** Todas do banco de dados" }, "response": [] }, { "name": "Calcular Impostos - Sistema Reforma (2026)", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"valorFrete\": 1000,\n \"dataEmissao\": \"2026-06-15\",\n \"ufOrigem\": \"SP\",\n \"ufDestino\": \"RJ\",\n \"municipioDestino\": \"Rio de Janeiro\",\n \"cst\": \"00\",\n \"cClassTrib\": \"00\",\n \"regimeTributario\": \"presumido\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/calcular-impostos", "host": ["{{baseUrl}}"], "path": ["api", "calcular-impostos"] }, "description": "Calcula impostos usando o sistema da REFORMA (IBS + CBS + ICMS + PIS/COFINS).\n\n**Consome:** 1 crédito\n**Período:** 2026 = transição (ambos sistemas coexistem)\n**Alíquotas:** Todas do banco de dados" }, "response": [] }, { "name": "Calcular Impostos - Compra Governamental (com Redutor)", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"valorFrete\": 5000,\n \"dataEmissao\": \"2026-09-20\",\n \"ufOrigem\": \"MG\",\n \"ufDestino\": \"SP\",\n \"municipioDestino\": \"São Paulo\",\n \"cst\": \"00\",\n \"cClassTrib\": \"00\",\n \"regimeTributario\": \"presumido\",\n \"compraGovernamental\": true,\n \"pRedutorGoverno\": 30\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/calcular-impostos", "host": ["{{baseUrl}}"], "path": ["api", "calcular-impostos"] }, "description": "Exemplo com **REDUTOR GOVERNAMENTAL** de 30%.\n\n**📋 Parâmetros especiais:**\n- `compraGovernamental`: true\n- `pRedutorGoverno`: 30 (percentual de redução)\n\n**💡 Como funciona:**\n- IBS e CBS têm redução de 30% para compras do governo\n- ICMS, PIS e COFINS permanecem normais\n- Economia significativa para licitações públicas\n\n**📊 Resultado esperado:**\n- IBS: reduzido em 30%\n- CBS: reduzido em 30%\n- Total: menor que operação normal\n\n**💳 CONSUMO:** 1 crédito" }, "response": [] }, { "name": "Ver Histórico de Cálculos", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/historico?limit=50&offset=0", "host": ["{{baseUrl}}"], "path": ["api", "historico"], "query": [ { "key": "limit", "value": "50", "description": "Número máximo de registros" }, { "key": "offset", "value": "0", "description": "Número de registros a pular (paginação)" } ] }, "description": "Retorna histórico de todos os cálculos realizados pelo usuário." }, "response": [] }, { "name": "Ver Estatísticas", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/api/estatisticas", "host": ["{{baseUrl}}"], "path": ["api", "estatisticas"] }, "description": "Retorna estatísticas de uso:\n- Total de cálculos\n- Total de créditos usados\n- Sistema mais usado\n- Créditos disponíveis" }, "response": [] }, { "name": "Converter XML CTe (2 Créditos) - Retorna JSON", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/json", "description": "Retorna JSON com XML dentro de 'xmlConvertido' + detalhes", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"xmlContent\": \"\\n\\n \\n \\n 35\\n 12345678\\n 5353\\n Transporte de Carga\\n 57\\n 1\\n 123456\\n 2026-01-15T10:30:00-03:00\\n 1\\n 1\\n 2\\n 0\\n 0\\n 1.0\\n 3550308\\n São Paulo\\n SP\\n 01\\n 0\\n 3550308\\n São Paulo\\n SP\\n 3304557\\n Rio de Janeiro\\n RJ\\n 0\\n \\n \\n 12345678000190\\n Transportadora Exemplo LTDA\\n TransEx\\n \\n Rua Exemplo\\n 123\\n Centro\\n 3550308\\n São Paulo\\n 01000000\\n SP\\n \\n \\n \\n 98765432000100\\n Remetente Exemplo SA\\n \\n Av Principal\\n 456\\n Industrial\\n 3550308\\n São Paulo\\n 02000000\\n SP\\n \\n \\n \\n 11122233000144\\n Destinatário Exemplo LTDA\\n \\n Rua Destino\\n 789\\n Comercial\\n 3304557\\n Rio de Janeiro\\n 20000000\\n RJ\\n \\n \\n \\n 1500.00\\n 1500.00\\n \\n Frete\\n 1500.00\\n \\n \\n \\n \\n \\n 00\\n 1500.00\\n 12.00\\n 180.00\\n \\n \\n \\n \\n \\n 10000.00\\n Produtos Diversos\\n Categoria\\n \\n \\n \\n 35260112345678000190550010001234561123456789\\n \\n \\n \\n \\n\",\n \"dataEmissao\": \"2026-01-15\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/converter-xml", "host": ["{{baseUrl}}"], "path": ["api", "converter-xml"] }, "description": "Converte XML de CTe do formato antigo (apenas ICMS) para o novo padrão da reforma tributária (com IBS e CBS).\n\n**📥 PARÂMETROS OBRIGATÓRIOS:**\n- `xmlContent`: String com o XML CTe completo (versão 3.00)\n- `dataEmissao`: Data no formato YYYY-MM-DD (ex: \"2026-01-15\")\n\n**🎯 FORMATO DE RESPOSTA (escolha via header `Accept`):**\n\n**OPÇÃO 1: JSON** (padrão - `Accept: application/json`)\n- Retorna JSON estruturado com XML dentro de `xmlConvertido`\n- Inclui impostos calculados, detalhes e informações extras\n- Melhor para debug e visualização\n\n**OPÇÃO 2: XML PURO** (`Accept: application/xml`)\n- Retorna XML diretamente (Content-Type: application/xml)\n- Informações extras nos headers de resposta:\n - `X-Credits-Used: 2`\n - `X-Credits-Remaining: 8`\n - `X-IBS-Total: 1.5`\n - `X-CBS-Total: 13.5`\n - `X-Impostos-Total: 15`\n- Melhor para integração direta\n\n**💳 CONSUMO:** 2 créditos\n\n**📊 EXEMPLO DE RESPOSTA JSON:**\n```json\n{\n \"success\": true,\n \"data\": {\n \"xmlConvertido\": \"\\n...com IBS e CBS...\",\n \"impostos\": {\n \"ibs\": {\n \"estadual\": \"1.35\",\n \"municipal\": \"0.15\",\n \"total\": \"1.5\"\n },\n \"cbs\": \"13.5\",\n \"total\": \"15\"\n },\n \"detalhes\": {\n \"anoAplicado\": 2026,\n \"periodoTransicao\": \"Transição (2026-2032)\",\n \"camposAdicionados\": [\"IBSCBS\", \"gIBSUF\", \"gIBSMun\"],\n \"camposRemovidos\": [\"ICMS\"]\n }\n },\n \"meta\": {\n \"creditsUsed\": 2,\n \"creditsRemaining\": 8\n }\n}\n```\n\n**📊 EXEMPLO DE RESPOSTA XML:**\n```xml\n\n\n \n ...\n \n \n 1500\n 0.1\n 1.5\n 0.9\n 13.5\n \n \n \n\n```\n\n**⚠️ IMPORTANTE:**\n- O XML deve ser uma string válida (com escape de aspas: \\\")\n- A data deve estar no formato ISO (YYYY-MM-DD)\n- O XML deve conter os campos obrigatórios: UFEnv, UFFim, vTPrest" }, "response": [] }, { "name": "Converter XML CTe (2 Créditos) - Retorna XML Puro", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "POST", "header": [ { "key": "Accept", "value": "application/xml", "description": "Retorna XML puro diretamente (melhor para integração)", "type": "text" } ], "body": { "mode": "raw", "raw": "{\n \"xmlContent\": \"\\n\\n \\n \\n 35\\n 12345678\\n 5353\\n Transporte de Carga\\n 57\\n 1\\n 123456\\n 2026-01-15T10:30:00-03:00\\n 1\\n 1\\n 2\\n 0\\n 0\\n 1.0\\n 3550308\\n São Paulo\\n SP\\n 01\\n 0\\n 3550308\\n São Paulo\\n SP\\n 3304557\\n Rio de Janeiro\\n RJ\\n 0\\n \\n \\n 12345678000190\\n Transportadora Exemplo LTDA\\n TransEx\\n \\n Rua Exemplo\\n 123\\n Centro\\n 3550308\\n São Paulo\\n 01000000\\n SP\\n \\n \\n \\n 98765432000100\\n Remetente Exemplo SA\\n \\n Av Principal\\n 456\\n Industrial\\n 3550308\\n São Paulo\\n 02000000\\n SP\\n \\n \\n \\n 11122233000144\\n Destinatário Exemplo LTDA\\n \\n Rua Destino\\n 789\\n Comercial\\n 3304557\\n Rio de Janeiro\\n 20000000\\n RJ\\n \\n \\n \\n 1500.00\\n 1500.00\\n \\n Frete\\n 1500.00\\n \\n \\n \\n \\n \\n 00\\n 1500.00\\n 12.00\\n 180.00\\n \\n \\n \\n \\n \\n 10000.00\\n Produtos Diversos\\n Categoria\\n \\n \\n \\n 35260112345678000190550010001234561123456789\\n \\n \\n \\n \\n\",\n \"dataEmissao\": \"2026-01-15\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/converter-xml", "host": ["{{baseUrl}}"], "path": ["api", "converter-xml"] }, "description": "Retorna o XML convertido **DIRETAMENTE** (Content-Type: application/xml).\n\n**🎯 DIFERENÇA:** Esta versão usa `Accept: application/xml` para receber o XML puro sem wrapper JSON.\n\n**📤 RESPOSTA:**\nXML puro com IBS e CBS calculados:\n```xml\n\n\n \n \n \n 1500\n 0.1\n 1.5\n 0.9\n 13.5\n ...\n ...\n \n \n \n\n```\n\n**📋 HEADERS DE RESPOSTA (informações extras):**\n- `Content-Type: application/xml; charset=utf-8`\n- `X-Credits-Used: 2`\n- `X-Credits-Remaining: 8`\n- `X-IBS-Total: 1.5`\n- `X-CBS-Total: 13.5`\n- `X-Impostos-Total: 15`\n- `X-Ano-Aplicado: 2026`\n\n**✅ VANTAGENS:**\n- Pronto para salvar em arquivo .xml\n- Ideal para integração com sistemas\n- Menor tamanho de resposta\n- Fácil de processar com parsers XML\n\n**💳 CONSUMO:** 2 créditos" }, "response": [] }, { "name": "Validar XML CTe (1 Crédito)", "request": { "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{token}}", "type": "string" } ] }, "method": "POST", "header": [], "body": { "mode": "raw", "raw": "{\n \"xmlContent\": \"\\n\\n \\n \\n 35\\n 5353\\n Transporte de Carga\\n 57\\n \\n \\n\"\n}", "options": { "raw": { "language": "json" } } }, "url": { "raw": "{{baseUrl}}/api/validar-xml", "host": ["{{baseUrl}}"], "path": ["api", "validar-xml"] }, "description": "Valida se o XML de CTe está no formato correto antes de converter.\n\n**📥 ENTRADA:**\n- XML CTe para validar\n\n**📤 RETORNO:**\n- Status de validação (válido/inválido)\n- Lista de erros encontrados (se houver)\n- Estrutura do XML detectada\n\n**💳 CONSUMO:** 1 crédito\n\n**📊 EXEMPLO DE RESPOSTA (XML Válido):**\n```json\n{\n \"success\": true,\n \"valid\": true,\n \"message\": \"XML válido\",\n \"estrutura\": {\n \"versao\": \"3.00\",\n \"modelo\": \"57\",\n \"campos_encontrados\": [\"ide\", \"emit\", \"dest\", \"vPrest\", \"imp\"]\n },\n \"meta\": {\n \"creditsUsed\": 1,\n \"creditsRemaining\": 9\n }\n}\n```\n\n**📊 EXEMPLO DE RESPOSTA (XML Inválido):**\n```json\n{\n \"success\": false,\n \"valid\": false,\n \"message\": \"XML inválido\",\n \"erros\": [\n \"Campo obrigatório 'ide' não encontrado\",\n \"Namespace XML incorreto\"\n ],\n \"meta\": {\n \"creditsUsed\": 1,\n \"creditsRemaining\": 9\n }\n}\n```" }, "response": [] } ] } ] }