{"openapi":"3.0.0","paths":{"/v1/simulacoes":{"post":{"description":"Aceita multipart (XMLs no campo \"arquivos\", opcionais \"cenarioId\" ou \"cenario\") ou JSON { \"documentos\": [...], \"cenarioId\"?: \"...\", \"cenario\"?: {...} }. Sem cenário, usa o padrão da empresa. XMLs inválidos não derrubam o lote: aparecem em \"rejeitados\". Cada documento enviado conta na cota mensal.","operationId":"PublicaController_simular","parameters":[],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"arquivos":{"type":"array","items":{"type":"string","format":"binary"}},"cenarioId":{"type":"string","format":"uuid"}}}},"application/json":{"schema":{"type":"object","properties":{"arquivos":{"type":"array","items":{"type":"string","format":"binary"}},"cenarioId":{"type":"string","format":"uuid"}}}}}},"responses":{"201":{"description":""}},"security":[{"bearer":[]}],"summary":"Simula notas (NF-e, NFC-e, NFS-e) e guarda o resultado","tags":["Simulações"]}},"/v1/conferencias":{"post":{"description":"Sem cenário. Cada nota enviada conta na cota mensal compartilhada. Persiste somente o resultado. Tolerância monetária: R$ 0,01 por campo/item e total; alíquotas: 0,0001 ponto percentual. Status OK, DIVERGENTE ou ERRO. NFS-e não tem geração XML oficial.","operationId":"PublicaController_conferir","parameters":[],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"oneOf":[{"type":"object","required":["arquivos"],"properties":{"arquivos":{"type":"array","items":{"type":"string","format":"binary"}}}},{"type":"object","required":["documentos"],"properties":{"documentos":{"type":"array","items":{"type":"object","description":"Documento canônico, incluindo cClassTribNota, cstNota, ibsCbsDeclarado e totaisDeclarados. Ver /docs/conferencia."}}}}]}},"application/json":{"schema":{"oneOf":[{"type":"object","required":["arquivos"],"properties":{"arquivos":{"type":"array","items":{"type":"string","format":"binary"}}}},{"type":"object","required":["documentos"],"properties":{"documentos":{"type":"array","items":{"type":"object","description":"Documento canônico, incluindo cClassTribNota, cstNota, ibsCbsDeclarado e totaisDeclarados. Ver /docs/conferencia."}}}}]}}}},"responses":{"201":{"description":"Conferência concluída e resultado salvo","content":{"application/json":{"schema":{"type":"object","required":["id","criadaEm","origem","resumo","documentos","rejeitados"],"properties":{"id":{"type":"string","format":"uuid"},"criadaEm":{"type":"string","format":"date-time"},"origem":{"type":"string","enum":["plataforma","api","webhook"]},"resumo":{"type":"object","required":["documentos","ok","divergentes","erros"],"properties":{"documentos":{"type":"integer","minimum":0},"ok":{"type":"integer","minimum":0},"divergentes":{"type":"integer","minimum":0},"erros":{"type":"integer","minimum":0}}},"documentos":{"type":"array","items":{"type":"object","required":["id","tipo","status","problemas","avisos"],"properties":{"id":{"type":"string"},"tipo":{"type":"string","enum":["NFe","NFCe","NFSe"]},"status":{"type":"string","enum":["OK","DIVERGENTE","ERRO"]},"problemas":{"type":"array","items":{"type":"object","required":["campo","declarado","esperado","mensagem"],"properties":{"item":{"type":"integer"},"campo":{"type":"string"},"declarado":{"nullable":true,"description":"Valor ou código declarado; null quando ausente"},"esperado":{"nullable":true,"description":"Valor ou código oficial; null quando não determinado"},"mensagem":{"type":"string"}}}},"grupoEsperado":{"type":"string","description":"XML gerado pela calculadora oficial com itens e totais. Indisponível para NFS-e ou cálculo incompleto."},"avisos":{"type":"array","items":{"type":"string"}}}}},"rejeitados":{"type":"array","items":{"type":"object","properties":{"arquivo":{"type":"string"},"erro":{"type":"string"}}}}}}}}}},"security":[{"bearer":[]}],"summary":"Confere CBS/IBS/IS na data de emissão e devolve o grupo XML esperado","tags":["Simulações","Conferências"]}},"/v1/simulacoes/{id}":{"get":{"operationId":"PublicaController_obter","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Busca uma simulação feita antes (por API, webhook ou plataforma)","tags":["Simulações"]}},"/v1/cenarios":{"get":{"operationId":"PublicaController_listarCenarios","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Lista os cenários da empresa (o padrão vem primeiro)","tags":["Simulações","Cenários"]}},"/v1/diagnosticos/cadastro":{"post":{"description":"Corpo: { \"dataReferencia\"?: \"AAAA-MM-DD\", \"itens\": [{ \"codigo\", \"descricao\"?, \"documento\": \"NFe\"|\"NFSe\", \"regime\": \"regular\"|\"simples\", \"ncm\"? (NF-e), \"nbs\"? (NFS-e), \"cClassTrib\"?, \"cAtivSN\"? (Simples) }] }. Não fica guardado.","operationId":"PublicaController_diagnosticar","parameters":[],"responses":{"200":{"description":""}},"security":[{"bearer":[]}],"summary":"Diagnóstico do cadastro de produtos e serviços","tags":["Simulações","Diagnóstico"]}},"/w/{token}":{"post":{"description":"O próprio link é a credencial: não precisa de chave. Envie o XML no corpo (Content-Type: application/xml), vários XMLs em multipart (campo \"arquivos\") ou JSON { \"documentos\": [...] }. Usa o cenário do webhook ou o padrão da empresa.","operationId":"WebhookEntradaController_receber","parameters":[{"name":"token","required":true,"in":"path","description":"parte final do link gerado na plataforma (wh_...)","schema":{"type":"string"}},{"name":"modo","required":false,"in":"query","description":"Sobrescreve o modo configurado para este envio. Ambos consome duas unidades por nota e inclui conferencia completa na resposta.","schema":{"enum":["simulacao","conferencia","ambos"],"type":"string"}}],"responses":{"200":{"description":""}},"summary":"Recebe notas do ERP para simulação, conferência ou ambos","tags":["Webhook de entrada"]}}},"info":{"title":"Marco33 API","description":"Simulação da reforma tributária (CBS/IBS/IS) sobre as suas notas fiscais, com as calculadoras oficiais.","version":"1.0","contact":{}},"tags":[],"servers":[],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"chave de API (m33_...) gerada na plataforma"}},"schemas":{}}}