{"openapi":"3.2.0","info":{"title":"U2D Nota Fiscal","description":"Emissão de NFS-e (Padrão Nacional), NF-e (modelo 55) e NFC-e (modelo 65) por API.                                 Envie o JSON com os dados fiscais; o servidor calcula tributos e totais, numera, assina                                 e transmite de forma assíncrona (202 + polling no GET ou webhook). Toda rota de                                 documento exige `X-Emitente-Id`; emissões exigem `Idempotency-Key`. Erros em RFC 9457.                                 Autenticação: `Authorization: Bearer` com access token do Keycloak                                 (client_credentials do client do integrador).","version":"v1"},"servers":[{"url":"https://api.u2dnotafiscal.com.br","description":"Produção"},{"url":"https://api-sandbox.u2dnotafiscal.com.br","description":"Sandbox"}],"security":[{"jwt":[]}],"tags":[{"name":"NF-e","description":"NF-e modelo 55: emissão, DANFE, cancelamento, CC-e e inutilização."},{"name":"Status SEFAZ","description":"Status do web service da SEFAZ por UF (rota pública)."},{"name":"Tabelas","description":"Tabelas fiscais: NCM, CEST, cClassTrib e alíquotas do IBS/CBS."},{"name":"Conta","description":"Conta do integrador, produtos contratados, plano, consumo e faturas."},{"name":"Produtos","description":"Produtos (itens da NF-e e da NFC-e) do emitente."},{"name":"Clientes","description":"Destinatários, tomadores e consumidores do emitente."},{"name":"Emitentes","description":"Emitentes da conta: cadastro, certificado A1, CSC e séries."},{"name":"NFC-e","description":"NFC-e modelo 65: emissão, contingência offline, DANFCe e eventos."},{"name":"Webhook","description":"Aviso de mudança de status dos documentos."},{"name":"NFS-e","description":"NFS-e do Padrão Nacional: emissão (DPS), cancelamento, substituição e DANFSe."}],"paths":{"/api/v1/produtos/{id}":{"get":{"tags":["Produtos"],"summary":"Consultar produto","operationId":"getProduto","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MercadoriaResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"put":{"tags":["Produtos"],"summary":"Alterar produto","operationId":"updateProduto","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MercadoriaRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MercadoriaResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"delete":{"tags":["Produtos"],"summary":"Excluir produto","operationId":"deleteProduto","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/emitentes/{id}":{"get":{"tags":["Emitentes"],"summary":"Consultar emitente","operationId":"getEmitente","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EmitenteResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"put":{"tags":["Emitentes"],"summary":"Alterar emitente","operationId":"updateEmitente","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmitenteRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EmitenteResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/emitentes/{id}/series":{"get":{"tags":["Emitentes"],"summary":"Listar séries","operationId":"listSeries","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Serie"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"put":{"tags":["Emitentes"],"summary":"Configurar série","operationId":"putSerie","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SerieRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Serie"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/emitentes/{id}/perfil-fiscal/{produto}":{"get":{"tags":["Emitentes"],"summary":"Consultar perfil fiscal","operationId":"getPerfilFiscal","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"produto","in":"path","required":true,"schema":{"type":"string","enum":["NFE","NFCE","NFSE"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PerfilResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"put":{"tags":["Emitentes"],"summary":"Definir perfil fiscal","operationId":"putPerfilFiscal","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"produto","in":"path","required":true,"schema":{"type":"string","enum":["NFE","NFCE","NFSE"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerfilRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PerfilResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/emitentes/{id}/csc":{"get":{"tags":["Emitentes"],"summary":"Listar CSC","operationId":"listCsc","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CscResponse"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"put":{"tags":["Emitentes"],"summary":"Definir CSC (NFC-e)","operationId":"putCsc","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CscRequest"}}},"required":true},"responses":{"204":{"description":"No Content"},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/emitentes/{id}/certificado":{"get":{"tags":["Emitentes"],"summary":"Consultar certificado A1","operationId":"getCertificado","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CertificadoInfo"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"put":{"tags":["Emitentes"],"summary":"Enviar certificado A1","operationId":"uploadCertificado","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"arquivo":{"type":"string","format":"binary"},"senha":{"type":"string"}},"required":["arquivo","senha"]}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CertificadoInfo"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/conta/webhook":{"get":{"tags":["Webhook"],"summary":"Consultar webhook","operationId":"getWebhook","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WebhookResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"put":{"tags":["Webhook"],"summary":"Configurar webhook","operationId":"putWebhook","parameters":[{"name":"rotacionarSegredo","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WebhookResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"delete":{"tags":["Webhook"],"summary":"Remover webhook","operationId":"deleteWebhook","responses":{"200":{"description":"OK"},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/clientes/{id}":{"get":{"tags":["Clientes"],"summary":"Consultar cliente","operationId":"getCliente","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClienteResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"put":{"tags":["Clientes"],"summary":"Alterar cliente","operationId":"updateCliente","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClienteRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClienteResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"delete":{"tags":["Clientes"],"summary":"Excluir cliente","operationId":"deleteCliente","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/produtos":{"get":{"tags":["Produtos"],"summary":"Listar produtos","operationId":"listProdutos","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"busca","in":"query","required":false,"schema":{"type":"string"}},{"name":"pagina","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"tamanho","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaginaResponseMercadoriaResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"post":{"tags":["Produtos"],"summary":"Cadastrar produto","operationId":"createProduto","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MercadoriaRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MercadoriaResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfse":{"get":{"tags":["NFS-e"],"summary":"Listar NFS-e","operationId":"listNfse","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["PENDENTE","PROCESSANDO","AUTORIZADA","REJEITADA","CANCELADA","SUBSTITUIDA"]}}},{"name":"competenciaDe","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"competenciaAte","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"tomador","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"pagina","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"tamanho","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaginaResponseNfseResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"post":{"tags":["NFS-e"],"summary":"Emitir NFS-e","operationId":"emitNfse","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"Obrigatória. Mesma chave + mesmo corpo devolve o mesmo documento (200, Idempotent-Replayed: true); mesma chave + outro corpo = 409. Recomendado: UUID.","required":true,"schema":{"type":"string","example":"3f1c2b9e-5a7d-4c1e-9b2f-8d6a0e4c7b21","maxLength":100,"minLength":1}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NfseRequest"}}},"required":true},"responses":{"200":{"description":"Repetição idempotente (mesma Idempotency-Key e mesmo corpo): o documento já existente.","headers":{"Location":{"schema":{"type":"string","format":"uri"}},"Idempotent-Replayed":{"schema":{"type":"string","enum":["true"]}}},"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfseResponse"}}}},"202":{"description":"Documento novo gravado como PENDENTE; acompanhar pelo Location (GET) ou webhook.","headers":{"Location":{"schema":{"type":"string","format":"uri"}}},"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfseResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"409":{"description":"Idempotency-Key já usada com outro corpo (idempotency-conflito).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"422":{"description":"Regra de negócio: emitente sem certificado/série/IE, etc.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfse/{id}/substituicao":{"post":{"tags":["NFS-e"],"summary":"Substituir NFS-e","operationId":"replaceNfse","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"Obrigatória. Mesma chave + mesmo corpo devolve o mesmo documento (200, Idempotent-Replayed: true); mesma chave + outro corpo = 409. Recomendado: UUID.","required":true,"schema":{"type":"string","example":"3f1c2b9e-5a7d-4c1e-9b2f-8d6a0e4c7b21","maxLength":100,"minLength":1}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubstituicaoRequest"}}},"required":true},"responses":{"200":{"description":"Repetição idempotente (mesma Idempotency-Key e mesmo corpo): o documento já existente.","headers":{"Location":{"schema":{"type":"string","format":"uri"}},"Idempotent-Replayed":{"schema":{"type":"string","enum":["true"]}}},"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfseResponse"}}}},"202":{"description":"Documento novo gravado como PENDENTE; acompanhar pelo Location (GET) ou webhook.","headers":{"Location":{"schema":{"type":"string","format":"uri"}}},"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfseResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"409":{"description":"Idempotency-Key já usada com outro corpo (idempotency-conflito).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"422":{"description":"Regra de negócio: emitente sem certificado/série/IE, etc.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfse/{id}/sincronizar":{"post":{"tags":["NFS-e"],"summary":"Sincronizar NFS-e com a Sefin","operationId":"syncNfse","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfseResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfse/{id}/cancelamento":{"post":{"tags":["NFS-e"],"summary":"Cancelar NFS-e","operationId":"cancelNfse","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelamentoRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfseResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe":{"get":{"tags":["NF-e"],"summary":"Listar NF-e","operationId":"listNfe","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["PENDENTE","PROCESSANDO","AUTORIZADA","REJEITADA","DENEGADA","CANCELADA","CONTINGENCIA"]}}},{"name":"emissaoDe","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"emissaoAte","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"destinatario","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"pagina","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"tamanho","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaginaResponseNfeResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"post":{"tags":["NF-e"],"summary":"Emitir NF-e","operationId":"emitNfe","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"Obrigatória. Mesma chave + mesmo corpo devolve o mesmo documento (200, Idempotent-Replayed: true); mesma chave + outro corpo = 409. Recomendado: UUID.","required":true,"schema":{"type":"string","example":"3f1c2b9e-5a7d-4c1e-9b2f-8d6a0e4c7b21","maxLength":100,"minLength":1}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NfeRequest"}}},"required":true},"responses":{"200":{"description":"Repetição idempotente (mesma Idempotency-Key e mesmo corpo): o documento já existente.","headers":{"Location":{"schema":{"type":"string","format":"uri"}},"Idempotent-Replayed":{"schema":{"type":"string","enum":["true"]}}},"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfeResponse"}}}},"202":{"description":"Documento novo gravado como PENDENTE; acompanhar pelo Location (GET) ou webhook.","headers":{"Location":{"schema":{"type":"string","format":"uri"}}},"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfeResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"409":{"description":"Idempotency-Key já usada com outro corpo (idempotency-conflito).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"422":{"description":"Regra de negócio: emitente sem certificado/série/IE, etc.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/{id}/sincronizar":{"post":{"tags":["NF-e"],"summary":"Sincronizar NF-e com a SEFAZ","operationId":"syncNfe","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfeResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/{id}/carta-correcao":{"post":{"tags":["NF-e"],"summary":"Emitir carta de correção","operationId":"createCartaCorrecao","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CartaCorrecaoRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EventoNfe"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/{id}/cancelamento":{"post":{"tags":["NF-e"],"summary":"Cancelar NF-e","operationId":"cancelNfe","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelamentoRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfeResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/inutilizacao":{"post":{"tags":["NF-e"],"summary":"Inutilizar numeração de NF-e","operationId":"inutilizarNfe","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InutilizacaoRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Inutilizacao"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/calculo":{"post":{"tags":["NF-e"],"summary":"Calcular NF-e (prévia)","operationId":"calculateNfe","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NfeRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CalculoNfeResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce":{"get":{"tags":["NFC-e"],"summary":"Listar NFC-e","operationId":"listNfce","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["PENDENTE","PROCESSANDO","AUTORIZADA","REJEITADA","DENEGADA","CANCELADA","CONTINGENCIA"]}}},{"name":"emissaoDe","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"emissaoAte","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"consumidor","in":"query","required":false,"schema":{"type":"string"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"pagina","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"tamanho","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaginaResponseNfceResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"post":{"tags":["NFC-e"],"summary":"Emitir NFC-e","operationId":"emitNfce","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","description":"Obrigatória. Mesma chave + mesmo corpo devolve o mesmo documento (200, Idempotent-Replayed: true); mesma chave + outro corpo = 409. Recomendado: UUID.","required":true,"schema":{"type":"string","example":"3f1c2b9e-5a7d-4c1e-9b2f-8d6a0e4c7b21","maxLength":100,"minLength":1}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NfceRequest"}}},"required":true},"responses":{"200":{"description":"Repetição idempotente (mesma Idempotency-Key e mesmo corpo): o documento já existente.","headers":{"Location":{"schema":{"type":"string","format":"uri"}},"Idempotent-Replayed":{"schema":{"type":"string","enum":["true"]}}},"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfceResponse"}}}},"202":{"description":"Documento novo gravado como PENDENTE; acompanhar pelo Location (GET) ou webhook.","headers":{"Location":{"schema":{"type":"string","format":"uri"}}},"content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfceResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"409":{"description":"Idempotency-Key já usada com outro corpo (idempotency-conflito).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"422":{"description":"Regra de negócio: emitente sem certificado/série/IE, etc.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/{id}/sincronizar":{"post":{"tags":["NFC-e"],"summary":"Sincronizar NFC-e com a SEFAZ","operationId":"syncNfce","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfceResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/{id}/cancelamento":{"post":{"tags":["NFC-e"],"summary":"Cancelar NFC-e","operationId":"cancelNfce","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelamentoRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfceResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/inutilizacao":{"post":{"tags":["NFC-e"],"summary":"Inutilizar numeração de NFC-e","operationId":"inutilizarNfce","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InutilizacaoRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Inutilizacao"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/calculo":{"post":{"tags":["NFC-e"],"summary":"Calcular NFC-e (prévia)","operationId":"calculateNfce","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NfceRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CalculoNfceResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/emitentes":{"get":{"tags":["Emitentes"],"summary":"Listar emitentes","operationId":"listEmitentes","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EmitenteResponse"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"post":{"tags":["Emitentes"],"summary":"Cadastrar emitente","operationId":"createEmitente","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmitenteRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EmitenteResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/emitentes/certificado/inspecao":{"post":{"tags":["Emitentes"],"summary":"Inspecionar certificado A1","operationId":"inspectCertificado","requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"arquivo":{"type":"string","format":"binary"},"senha":{"type":"string"}},"required":["arquivo","senha"]}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CertificadoInspecao"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/conta/webhook/teste":{"post":{"tags":["Webhook"],"summary":"Enviar evento de teste","operationId":"testWebhook","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EntregaResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/conta/webhook/entregas/{id}/reenviar":{"post":{"tags":["Webhook"],"summary":"Reenviar entrega do webhook","operationId":"retryWebhookEntrega","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EntregaResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/clientes":{"get":{"tags":["Clientes"],"summary":"Listar clientes","operationId":"listClientes","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"busca","in":"query","required":false,"schema":{"type":"string"}},{"name":"pagina","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"tamanho","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaginaResponseClienteResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}},"post":{"tags":["Clientes"],"summary":"Cadastrar cliente","operationId":"createCliente","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClienteRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ClienteResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/tabelas/ncm":{"get":{"tags":["Tabelas"],"summary":"Pesquisar NCM","operationId":"searchNcm","parameters":[{"name":"busca","in":"query","required":false,"schema":{"type":"string","default":""}},{"name":"tamanho","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NcmPagina"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/tabelas/ncm/{codigo}":{"get":{"tags":["Tabelas"],"summary":"Consultar NCM","operationId":"getNcm","parameters":[{"name":"codigo","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Ncm"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/tabelas/ibs-cbs":{"get":{"tags":["Tabelas"],"summary":"Listar classificações do IBS/CBS","operationId":"listIbsCbs","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SituacaoIbsCbs"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/tabelas/ibs-cbs/aliquotas":{"get":{"tags":["Tabelas"],"summary":"Consultar alíquotas de referência do IBS/CBS","operationId":"getAliquotasIbsCbs","parameters":[{"name":"data","in":"query","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AliquotasIbsCbs"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/tabelas/cest":{"get":{"tags":["Tabelas"],"summary":"Consultar CEST pelo NCM","operationId":"getCest","parameters":[{"name":"ncm","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Cest"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/tabelas-oficiais/novidades":{"get":{"tags":["Tabelas"],"summary":"Novidades das tabelas oficiais","operationId":"getTabelasOficiaisNovidades","parameters":[{"name":"emUso","in":"query","required":false,"schema":{"type":"array","default":[],"items":{"type":"string"}}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Novidades"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/status-servico":{"get":{"tags":["Status SEFAZ"],"summary":"Consultar status da SEFAZ","operationId":"getStatusServico","parameters":[{"name":"uf","in":"query","required":true,"schema":{"type":"string","enum":["RO","AC","AM","RR","PA","AP","TO","MA","PI","CE","RN","PB","PE","AL","SE","BA","MG","ES","RJ","SP","PR","SC","RS","MS","MT","GO","DF"]}},{"name":"modelo","in":"query","required":false,"schema":{"type":"string","default":"NFE","enum":["NFE","NFCE"]}},{"name":"ambiente","in":"query","required":false,"schema":{"type":"string","default":"HOMOLOGACAO","enum":["PRODUCAO","HOMOLOGACAO"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StatusServicoResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}},"security":[]}},"/api/v1/produtos/gtin/{gtin}":{"get":{"tags":["Produtos"],"summary":"Consultar GTIN","operationId":"getGtin","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"gtin","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GtinResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfse/{id}":{"get":{"tags":["NFS-e"],"summary":"Consultar NFS-e","operationId":"getNfse","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfseResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfse/{id}/xml":{"get":{"tags":["NFS-e"],"summary":"Baixar XML da NFS-e","operationId":"getNfseXml","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/xml":{"schema":{"type":"string"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfse/{id}/danfse":{"get":{"tags":["NFS-e"],"summary":"Baixar DANFSe","operationId":"getNfseDanfse","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"byte"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfse/tributacao-municipal":{"get":{"tags":["NFS-e"],"summary":"Consultar tributação municipal","operationId":"getTributacaoMunicipal","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"municipio","in":"query","required":true,"schema":{"type":"string"}},{"name":"codigoTributacaoNacional","in":"query","required":true,"schema":{"type":"string"}},{"name":"competencia","in":"query","required":false,"schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OpcoesTributacaoMunicipal"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfse/resumo":{"get":{"tags":["NFS-e"],"summary":"Resumo de NFS-e","operationId":"getNfseResumo","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"competencia","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ResumoResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfse/resumo/mensal":{"get":{"tags":["NFS-e"],"summary":"Resumo mensal de NFS-e","operationId":"getNfseResumoMensal","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"de","in":"query","required":true,"schema":{"type":"string"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResumoResponse"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/{id}":{"get":{"tags":["NF-e"],"summary":"Consultar NF-e","operationId":"getNfe","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfeResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/{id}/xml":{"get":{"tags":["NF-e"],"summary":"Baixar XML da NF-e","operationId":"getNfeXml","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/xml":{"schema":{"type":"string"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/{id}/eventos":{"get":{"tags":["NF-e"],"summary":"Listar eventos da NF-e","operationId":"listNfeEventos","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EventoNfe"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/{id}/eventos/{eventoId}/xml":{"get":{"tags":["NF-e"],"summary":"Baixar XML de evento da NF-e","operationId":"getNfeEventoXml","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"eventoId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/xml":{"schema":{"type":"string"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/{id}/danfe":{"get":{"tags":["NF-e"],"summary":"Baixar DANFE","operationId":"getNfeDanfe","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"byte"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/resumo/mensal":{"get":{"tags":["NF-e"],"summary":"Resumo mensal de NF-e","operationId":"getNfeResumoMensal","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"de","in":"query","required":true,"schema":{"type":"string"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResumoResponse"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfe/inutilizacoes":{"get":{"tags":["NF-e"],"summary":"Listar inutilizações de NF-e","operationId":"listNfeInutilizacoes","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Inutilizacao"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/{id}":{"get":{"tags":["NFC-e"],"summary":"Consultar NFC-e","operationId":"getNfce","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/NfceResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/{id}/xml":{"get":{"tags":["NFC-e"],"summary":"Baixar XML da NFC-e","operationId":"getNfceXml","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/xml":{"schema":{"type":"string"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/{id}/eventos":{"get":{"tags":["NFC-e"],"summary":"Listar eventos da NFC-e","operationId":"listNfceEventos","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EventoNfe"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/{id}/eventos/{eventoId}/xml":{"get":{"tags":["NFC-e"],"summary":"Baixar XML de evento da NFC-e","operationId":"getNfceEventoXml","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"eventoId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"application/xml":{"schema":{"type":"string"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/{id}/danfce":{"get":{"tags":["NFC-e"],"summary":"Baixar DANFCe","operationId":"getNfceDanfce","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"largura","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":80}}],"responses":{"200":{"description":"OK","content":{"application/pdf":{"schema":{"type":"string","format":"byte"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"Recurso inexistente ou de outro emitente/conta.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/resumo/mensal":{"get":{"tags":["NFC-e"],"summary":"Resumo mensal de NFC-e","operationId":"getNfceResumoMensal","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"de","in":"query","required":true,"schema":{"type":"string"}},{"name":"ate","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ResumoResponse"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/nfce/inutilizacoes":{"get":{"tags":["NFC-e"],"summary":"Listar inutilizações de NFC-e","operationId":"listNfceInutilizacoes","parameters":[{"name":"X-Emitente-Id","in":"header","description":"Emitente (CNPJ/CPF cadastrado na conta) dono do documento.","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Inutilizacao"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/emitentes/inscricao-estadual":{"get":{"tags":["Emitentes"],"summary":"Consultar inscrição estadual","operationId":"getInscricaoEstadual","parameters":[{"name":"cnpj","in":"query","required":true,"schema":{"type":"string"}},{"name":"uf","in":"query","required":true,"schema":{"type":"string","enum":["RO","AC","AM","RR","PA","AP","TO","MA","PI","CE","RN","PB","PE","AL","SE","BA","MG","ES","RJ","SP","PR","SC","RS","MS","MT","GO","DF"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ConsultaInscricaoEstadual"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/conta":{"get":{"tags":["Conta"],"summary":"Consultar a conta","operationId":"getConta","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ContaResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/conta/webhook/entregas":{"get":{"tags":["Webhook"],"summary":"Listar entregas do webhook","operationId":"listWebhookEntregas","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["PENDENTE","ENTREGUE","FALHOU"]}},{"name":"pagina","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"tamanho","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":20}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PaginaResponseEntregaResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/conta/uso":{"get":{"tags":["Conta"],"summary":"Consultar o consumo do mês","operationId":"getContaUso","parameters":[{"name":"competencia","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/UsoResponse"}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/api/v1/conta/faturas":{"get":{"tags":["Conta"],"summary":"Listar faturas","operationId":"listContaFaturas","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/FaturaResponse"}}}}},"400":{"description":"Requisição inválida; `campos` lista o caminho JSON de cada erro.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"401":{"description":"Sem token, token inválido ou expirado (nao-autenticado).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"403":{"description":"Token sem conta_id, conta inativa ou produto não contratado.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}}},"components":{"schemas":{"Difal":{"type":"object","properties":{"aliquotaInterna":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"aliquotaInterestadual":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"aliquotaFcp":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"IbsCbs":{"type":"object","properties":{"cst":{"type":"string"},"classificacaoTributaria":{"type":"string"}}},"Icms":{"type":"object","properties":{"origem":{"type":"integer","format":"int32"},"cst":{"type":"string"},"csosn":{"type":"string"},"aliquota":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"reducaoBase":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"aliquotaFcp":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"mvaSt":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"reducaoBaseSt":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"aliquotaSt":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"aliquotaFcpSt":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"aliquotaCreditoSn":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"percentualDiferimento":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"difal":{"$ref":"#/components/schemas/Difal"}}},"Ipi":{"type":"object","properties":{"cst":{"type":"string"},"codigoEnquadramento":{"type":"string"},"aliquota":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"MercadoriaRequest":{"type":"object","properties":{"codigo":{"type":"string","maxLength":60,"minLength":0},"descricao":{"type":"string","maxLength":120,"minLength":0},"gtin":{"type":"string"},"unidade":{"type":"string","maxLength":6,"minLength":0},"ncm":{"type":"string","minLength":1},"cest":{"type":"string"},"cfop":{"type":"string","minLength":1},"valorUnitario":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"tributacao":{"$ref":"#/components/schemas/TributacaoMercadoria"}},"required":["cfop","codigo","descricao","ncm","tributacao"]},"PisCofins":{"type":"object","properties":{"cst":{"type":"string"},"aliquota":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"TributacaoMercadoria":{"type":"object","properties":{"icms":{"$ref":"#/components/schemas/Icms"},"ipi":{"$ref":"#/components/schemas/Ipi"},"pis":{"$ref":"#/components/schemas/PisCofins"},"cofins":{"$ref":"#/components/schemas/PisCofins"},"ibsCbs":{"$ref":"#/components/schemas/IbsCbs"}}},"MercadoriaResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"codigo":{"type":"string"},"descricao":{"type":"string"},"gtin":{"type":"string"},"unidade":{"type":"string"},"ncm":{"type":"string"},"cest":{"type":"string"},"cfop":{"type":"string"},"valorUnitario":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"tributacao":{"$ref":"#/components/schemas/TributacaoMercadoria"},"criadoEm":{"type":"string","format":"date-time"},"atualizadoEm":{"type":"string","format":"date-time"}}},"EmitenteRequest":{"type":"object","properties":{"cnpjCpf":{"type":"string","minLength":1},"razaoSocial":{"type":"string","maxLength":150,"minLength":0},"nomeFantasia":{"type":"string","maxLength":150,"minLength":0},"inscricaoEstadual":{"type":"string","maxLength":20,"minLength":0},"inscricaoMunicipal":{"type":"string","maxLength":15,"minLength":0},"endereco":{"$ref":"#/components/schemas/EnderecoDto"},"telefone":{"type":"string"},"email":{"type":"string","format":"email","maxLength":80,"minLength":0},"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"regimeTributario":{"type":"string","enum":["SIMPLES_NACIONAL","SIMPLES_NACIONAL_EXCESSO_SUBLIMITE","REGIME_NORMAL","MEI"]},"regimeEspecialTributacao":{"type":"string","enum":["NENHUM","ATO_COOPERADO","ESTIMATIVA","MICROEMPRESA_MUNICIPAL","NOTARIO_REGISTRADOR","PROFISSIONAL_AUTONOMO","SOCIEDADE_PROFISSIONAIS","OUTROS"]},"ativo":{"type":"boolean"}},"required":["ambiente","cnpjCpf","endereco","razaoSocial","regimeTributario"]},"EnderecoDto":{"type":"object","properties":{"logradouro":{"type":"string","maxLength":255,"minLength":0},"numero":{"type":"string","maxLength":60,"minLength":0},"complemento":{"type":"string","maxLength":156,"minLength":0},"bairro":{"type":"string","maxLength":60,"minLength":0},"codigoMunicipio":{"type":"string","minLength":1},"uf":{"type":"string","enum":["RO","AC","AM","RR","PA","AP","TO","MA","PI","CE","RN","PB","PE","AL","SE","BA","MG","ES","RJ","SP","PR","SC","RS","MS","MT","GO","DF"]},"cep":{"type":"string","minLength":1}},"required":["bairro","cep","codigoMunicipio","logradouro","numero","uf"]},"EmitenteResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"cnpjCpf":{"type":"string"},"razaoSocial":{"type":"string"},"nomeFantasia":{"type":"string"},"inscricaoEstadual":{"type":"string"},"inscricaoMunicipal":{"type":"string"},"endereco":{"$ref":"#/components/schemas/EnderecoDto"},"telefone":{"type":"string"},"email":{"type":"string"},"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"regimeTributario":{"type":"string","enum":["SIMPLES_NACIONAL","SIMPLES_NACIONAL_EXCESSO_SUBLIMITE","REGIME_NORMAL","MEI"]},"regimeEspecialTributacao":{"type":"string","enum":["NENHUM","ATO_COOPERADO","ESTIMATIVA","MICROEMPRESA_MUNICIPAL","NOTARIO_REGISTRADOR","PROFISSIONAL_AUTONOMO","SOCIEDADE_PROFISSIONAIS","OUTROS"]},"ativo":{"type":"boolean"},"criadoEm":{"type":"string","format":"date-time"},"atualizadoEm":{"type":"string","format":"date-time"}}},"SerieRequest":{"type":"object","properties":{"tipo":{"type":"string","enum":["NFE","NFCE","NFSE"]},"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"serie":{"type":"string","minLength":1},"proximoNumero":{"type":"integer","format":"int64","minimum":0},"padrao":{"type":"boolean"}},"required":["ambiente","proximoNumero","serie","tipo"]},"Serie":{"type":"object","properties":{"tipo":{"type":"string","enum":["NFE","NFCE","NFSE"]},"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"serie":{"type":"string"},"proximoNumero":{"type":"integer","format":"int64"},"padrao":{"type":"boolean"}}},"PerfilRequest":{"type":"object","properties":{"cfop":{"type":"string","minLength":1},"tributacao":{"$ref":"#/components/schemas/TributacaoMercadoria"}},"required":["cfop","tributacao"]},"PerfilResponse":{"type":"object","properties":{"cfop":{"type":"string"},"tributacao":{"$ref":"#/components/schemas/TributacaoMercadoria"},"padrao":{"type":"boolean"}}},"CscRequest":{"type":"object","properties":{"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"idToken":{"type":"string","minLength":1},"csc":{"type":"string","minLength":1}},"required":["ambiente","csc","idToken"]},"CertificadoInfo":{"type":"object","properties":{"titular":{"type":"string"},"titularNome":{"type":"string"},"validoDe":{"type":"string","format":"date-time"},"validoAte":{"type":"string","format":"date-time"},"fingerprintSha256":{"type":"string"},"enviadoEm":{"type":"string","format":"date-time"}}},"WebhookRequest":{"type":"object","properties":{"url":{"type":"string","maxLength":500,"minLength":0},"ativo":{"type":"boolean"}},"required":["url"]},"WebhookResponse":{"type":"object","properties":{"url":{"type":"string"},"ativo":{"type":"boolean"},"segredo":{"type":"string"},"criadoEm":{"type":"string","format":"date-time"},"atualizadoEm":{"type":"string","format":"date-time"}}},"ClienteRequest":{"type":"object","properties":{"cnpjCpf":{"type":"string","minLength":1},"nome":{"type":"string","maxLength":60,"minLength":0},"indicadorIe":{"type":"string","enum":["CONTRIBUINTE","ISENTO","NAO_CONTRIBUINTE"]},"inscricaoEstadual":{"type":"string"},"inscricaoMunicipal":{"type":"string","maxLength":15,"minLength":0},"endereco":{"$ref":"#/components/schemas/EnderecoDto"},"telefone":{"type":"string"},"email":{"type":"string","maxLength":60,"minLength":0}},"required":["cnpjCpf","endereco","nome"]},"ClienteResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"cnpjCpf":{"type":"string"},"nome":{"type":"string"},"indicadorIe":{"type":"string","enum":["CONTRIBUINTE","ISENTO","NAO_CONTRIBUINTE"]},"inscricaoEstadual":{"type":"string"},"inscricaoMunicipal":{"type":"string"},"endereco":{"$ref":"#/components/schemas/EnderecoResponse"},"telefone":{"type":"string"},"email":{"type":"string"},"criadoEm":{"type":"string","format":"date-time"},"atualizadoEm":{"type":"string","format":"date-time"}}},"EnderecoResponse":{"type":"object","properties":{"logradouro":{"type":"string"},"numero":{"type":"string"},"complemento":{"type":"string"},"bairro":{"type":"string"},"codigoMunicipio":{"type":"string"},"uf":{"type":"string","enum":["RO","AC","AM","RR","PA","AP","TO","MA","PI","CE","RN","PB","PE","AL","SE","BA","MG","ES","RJ","SP","PR","SC","RS","MS","MT","GO","DF"]},"cep":{"type":"string"}}},"EnderecoTomador":{"type":"object","properties":{"logradouro":{"type":"string"},"numero":{"type":"string"},"complemento":{"type":"string"},"bairro":{"type":"string"},"codigoMunicipio":{"type":"string"},"cep":{"type":"string"}}},"NfseRequest":{"type":"object","properties":{"serie":{"type":"string"},"competencia":{"type":"string","format":"date"},"tomador":{"$ref":"#/components/schemas/Tomador"},"servico":{"$ref":"#/components/schemas/Servico"},"valorServico":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"issqn":{"$ref":"#/components/schemas/TributacaoIssqn"},"retencoesFederais":{"$ref":"#/components/schemas/TributacaoFederal"},"ibsCbs":{"$ref":"#/components/schemas/IbsCbs"},"tributosAproximados":{"$ref":"#/components/schemas/TributosAproximados"}},"required":["competencia","issqn","servico","valorServico"]},"Servico":{"type":"object","properties":{"codigoTributacaoNacional":{"type":"string"},"codigoTributacaoMunicipal":{"type":"string"},"codigoNbs":{"type":"string"},"descricao":{"type":"string"},"codigoMunicipioPrestacao":{"type":"string"},"informacoesComplementares":{"type":"string"}}},"Tomador":{"type":"object","properties":{"cnpjCpf":{"type":"string"},"inscricaoMunicipal":{"type":"string"},"nome":{"type":"string"},"endereco":{"$ref":"#/components/schemas/EnderecoTomador"},"telefone":{"type":"string"},"email":{"type":"string"}}},"TributacaoFederal":{"type":"object","properties":{"valorRetidoCp":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorRetidoIrrf":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorRetidoCsll":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"TributacaoIssqn":{"type":"object","properties":{"tributacao":{"type":"string","enum":["OPERACAO_TRIBUTAVEL","IMUNIDADE","EXPORTACAO","NAO_INCIDENCIA"]},"retencao":{"type":"string","enum":["NAO_RETIDO","RETIDO_TOMADOR","RETIDO_INTERMEDIARIO"]},"aliquota":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"TributosAproximados":{"type":"object","properties":{"percentualFederal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"percentualEstadual":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"percentualMunicipal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"ErroNfse":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":"string"},"complemento":{"type":"string"}}},"NfseResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["PENDENTE","PROCESSANDO","AUTORIZADA","REJEITADA","CANCELADA","SUBSTITUIDA"]},"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"serie":{"type":"string"},"numeroDps":{"type":"integer","format":"int64"},"idDps":{"type":"string"},"chaveAcesso":{"type":"string"},"numeroNfse":{"type":"string"},"dataHoraProcessamento":{"type":"string","format":"date-time"},"valorServico":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorLiquido":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIss":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIbsCbs":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"erros":{"type":"array","items":{"$ref":"#/components/schemas/ErroNfse"}},"criadoEm":{"type":"string","format":"date-time"},"atualizadoEm":{"type":"string","format":"date-time"},"substituiNfseId":{"type":"string","format":"uuid"},"chaveSubstituida":{"type":"string"},"motivoSubstituicao":{"type":"string","enum":["DESENQUADRAMENTO_SIMPLES","ENQUADRAMENTO_SIMPLES","INCLUSAO_IMUNIDADE_ISENCAO","EXCLUSAO_IMUNIDADE_ISENCAO","REJEICAO_TOMADOR_INTERMEDIARIO","OUTROS"]},"substituidaPorNfseId":{"type":"string","format":"uuid"},"competencia":{"type":"string","format":"date"},"tomador":{"$ref":"#/components/schemas/Tomador"},"servico":{"$ref":"#/components/schemas/Servico"},"issqn":{"$ref":"#/components/schemas/TributacaoIssqn"},"retencoesFederais":{"$ref":"#/components/schemas/TributacaoFederal"},"ibsCbs":{"$ref":"#/components/schemas/IbsCbs"},"tributosAproximados":{"$ref":"#/components/schemas/TributosAproximados"}}},"SubstituicaoRequest":{"type":"object","properties":{"motivo":{"type":"string","enum":["DESENQUADRAMENTO_SIMPLES","ENQUADRAMENTO_SIMPLES","INCLUSAO_IMUNIDADE_ISENCAO","EXCLUSAO_IMUNIDADE_ISENCAO","REJEICAO_TOMADOR_INTERMEDIARIO","OUTROS"]},"descricaoMotivo":{"type":"string"},"serie":{"type":"string"},"competencia":{"type":"string","format":"date"},"tomador":{"$ref":"#/components/schemas/Tomador"},"servico":{"$ref":"#/components/schemas/Servico"},"valorServico":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"issqn":{"$ref":"#/components/schemas/TributacaoIssqn"},"retencoesFederais":{"$ref":"#/components/schemas/TributacaoFederal"},"ibsCbs":{"$ref":"#/components/schemas/IbsCbs"},"tributosAproximados":{"$ref":"#/components/schemas/TributosAproximados"}},"required":["competencia","issqn","motivo","servico","valorServico"]},"CancelamentoRequest":{"type":"object","properties":{"motivo":{"type":"string","enum":["ERRO_NA_EMISSAO","SERVICO_NAO_PRESTADO","OUTROS"]},"justificativa":{"type":"string","minLength":1}},"required":["justificativa","motivo"]},"Cartao":{"type":"object","properties":{"integrado":{"type":"boolean"},"cnpjCredenciadora":{"type":"string"},"bandeira":{"type":"string"},"autorizacao":{"type":"string"}}},"Cobranca":{"type":"object","properties":{"fatura":{"$ref":"#/components/schemas/Fatura"},"duplicatas":{"type":"array","items":{"$ref":"#/components/schemas/Duplicata"}}}},"Destinatario":{"type":"object","properties":{"cnpjCpf":{"type":"string"},"nome":{"type":"string"},"indicadorIe":{"type":"string","enum":["CONTRIBUINTE","ISENTO","NAO_CONTRIBUINTE"]},"inscricaoEstadual":{"type":"string"},"endereco":{"$ref":"#/components/schemas/EnderecoNfe"},"telefone":{"type":"string"},"email":{"type":"string"}}},"Duplicata":{"type":"object","properties":{"numero":{"type":"string"},"vencimento":{"type":"string","format":"date"},"valor":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"EnderecoNfe":{"type":"object","properties":{"logradouro":{"type":"string"},"numero":{"type":"string"},"complemento":{"type":"string"},"bairro":{"type":"string"},"codigoMunicipio":{"type":"string"},"cep":{"type":"string"}}},"Fatura":{"type":"object","properties":{"numero":{"type":"string"},"valorOriginal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"desconto":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorLiquido":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"InformacoesAdicionais":{"type":"object","properties":{"complementares":{"type":"string"},"fisco":{"type":"string"}}},"ItemNfe":{"type":"object","properties":{"codigo":{"type":"string"},"gtin":{"type":"string"},"descricao":{"type":"string"},"ncm":{"type":"string"},"cest":{"type":"string"},"cfop":{"type":"string"},"unidade":{"type":"string"},"quantidade":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorUnitario":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"desconto":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"frete":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"seguro":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"outrasDespesas":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"pedidoCompra":{"type":"string"},"informacoesAdicionais":{"type":"string"},"icms":{"$ref":"#/components/schemas/Icms"},"ipi":{"$ref":"#/components/schemas/Ipi"},"pis":{"$ref":"#/components/schemas/PisCofins"},"cofins":{"$ref":"#/components/schemas/PisCofins"},"ibsCbs":{"$ref":"#/components/schemas/IbsCbs"}}},"NfeRequest":{"type":"object","properties":{"serie":{"type":"string"},"naturezaOperacao":{"type":"string","maxLength":60,"minLength":0},"tipoOperacao":{"type":"string","enum":["ENTRADA","SAIDA"]},"finalidade":{"type":"string","enum":["NORMAL","COMPLEMENTAR","AJUSTE","DEVOLUCAO"]},"consumidorFinal":{"type":"boolean"},"presenca":{"type":"string","enum":["NAO_SE_APLICA","PRESENCIAL","INTERNET","TELEATENDIMENTO","ENTREGA_DOMICILIO","PRESENCIAL_FORA_ESTABELECIMENTO","OUTROS"]},"destinatario":{"$ref":"#/components/schemas/Destinatario"},"itens":{"type":"array","items":{"$ref":"#/components/schemas/ItemNfe"},"maxItems":990,"minItems":0},"transporte":{"$ref":"#/components/schemas/Transporte"},"pagamentos":{"type":"array","items":{"$ref":"#/components/schemas/Pagamento"}},"cobranca":{"$ref":"#/components/schemas/Cobranca"},"referencias":{"type":"array","items":{"type":"string"}},"informacoesAdicionais":{"$ref":"#/components/schemas/InformacoesAdicionais"}},"required":["destinatario","itens","naturezaOperacao","presenca"]},"Pagamento":{"type":"object","properties":{"forma":{"type":"string","enum":["DINHEIRO","CHEQUE","CARTAO_CREDITO","CARTAO_DEBITO","CREDITO_LOJA","VALE_ALIMENTACAO","VALE_REFEICAO","VALE_PRESENTE","VALE_COMBUSTIVEL","BOLETO","DEPOSITO","PIX_DINAMICO","TRANSFERENCIA","FIDELIDADE","PIX_ESTATICO","SEM_PAGAMENTO","OUTROS"]},"valor":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"descricao":{"type":"string"},"aPrazo":{"type":"boolean"},"cartao":{"$ref":"#/components/schemas/Cartao"}}},"Transportadora":{"type":"object","properties":{"cnpjCpf":{"type":"string"},"nome":{"type":"string"},"inscricaoEstadual":{"type":"string"},"endereco":{"type":"string"},"municipio":{"type":"string"},"uf":{"type":"string","enum":["RO","AC","AM","RR","PA","AP","TO","MA","PI","CE","RN","PB","PE","AL","SE","BA","MG","ES","RJ","SP","PR","SC","RS","MS","MT","GO","DF"]}}},"Transporte":{"type":"object","properties":{"modalidade":{"type":"string","enum":["EMITENTE","DESTINATARIO","TERCEIROS","PROPRIO_REMETENTE","PROPRIO_DESTINATARIO","SEM_FRETE"]},"transportadora":{"$ref":"#/components/schemas/Transportadora"},"veiculo":{"$ref":"#/components/schemas/Veiculo"},"volumes":{"type":"array","items":{"$ref":"#/components/schemas/Volume"}}}},"Veiculo":{"type":"object","properties":{"placa":{"type":"string"},"uf":{"type":"string","enum":["RO","AC","AM","RR","PA","AP","TO","MA","PI","CE","RN","PB","PE","AL","SE","BA","MG","ES","RJ","SP","PR","SC","RS","MS","MT","GO","DF"]},"rntc":{"type":"string"}}},"Volume":{"type":"object","properties":{"quantidade":{"type":"integer","format":"int64"},"especie":{"type":"string"},"marca":{"type":"string"},"numeracao":{"type":"string"},"pesoLiquido":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"pesoBruto":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"ErroSefaz":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":"string"}}},"NfeResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["PENDENTE","PROCESSANDO","AUTORIZADA","REJEITADA","DENEGADA","CANCELADA","CONTINGENCIA"]},"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"serie":{"type":"string"},"numero":{"type":"integer","format":"int64"},"chaveAcesso":{"type":"string"},"protocolo":{"type":"string"},"dataEmissao":{"type":"string","format":"date-time"},"dataHoraAutorizacao":{"type":"string","format":"date-time"},"valorTotal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"totais":{"$ref":"#/components/schemas/Totais"},"erros":{"type":"array","items":{"$ref":"#/components/schemas/ErroSefaz"}},"criadoEm":{"type":"string","format":"date-time"},"atualizadoEm":{"type":"string","format":"date-time"},"naturezaOperacao":{"type":"string"},"tipoOperacao":{"type":"string","enum":["ENTRADA","SAIDA"]},"finalidade":{"type":"string","enum":["NORMAL","COMPLEMENTAR","AJUSTE","DEVOLUCAO"]},"consumidorFinal":{"type":"boolean"},"presenca":{"type":"string","enum":["NAO_SE_APLICA","PRESENCIAL","INTERNET","TELEATENDIMENTO","ENTREGA_DOMICILIO","PRESENCIAL_FORA_ESTABELECIMENTO","OUTROS"]},"destinatario":{"$ref":"#/components/schemas/Destinatario"},"itens":{"type":"array","items":{"$ref":"#/components/schemas/ItemNfe"}},"transporte":{"$ref":"#/components/schemas/Transporte"},"pagamentos":{"type":"array","items":{"$ref":"#/components/schemas/Pagamento"}},"cobranca":{"$ref":"#/components/schemas/Cobranca"},"referencias":{"type":"array","items":{"type":"string"}},"informacoesAdicionais":{"$ref":"#/components/schemas/InformacoesAdicionais"}}},"Totais":{"type":"object","properties":{"baseIcms":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIcms":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorFcp":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"baseSt":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorSt":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorFcpSt":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorFcpDifal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorDifal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorProdutos":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorFrete":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorSeguro":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorDesconto":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorOutros":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIpi":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorPis":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorCofins":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorNota":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorTroco":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"temIbsCbs":{"type":"boolean"},"baseIbsCbs":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIbsUf":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIbsMunicipal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorCbs":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"CartaCorrecaoRequest":{"type":"object","properties":{"correcao":{"type":"string","minLength":1}},"required":["correcao"]},"EventoNfe":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"nfeId":{"type":"string","format":"uuid"},"tipo":{"type":"string","enum":["CANCELAMENTO","CARTA_CORRECAO","CANCELAMENTO_SUBSTITUICAO"]},"sequencia":{"type":"integer","format":"int32"},"texto":{"type":"string"},"registrado":{"type":"boolean"},"protocolo":{"type":"string"},"dataHoraRegistro":{"type":"string","format":"date-time"},"erros":{"type":"array","items":{"$ref":"#/components/schemas/ErroSefaz"}},"criadoEm":{"type":"string","format":"date-time"}}},"InutilizacaoRequest":{"type":"object","properties":{"serie":{"type":"string","minLength":1},"numeroInicial":{"type":"integer","format":"int64","minimum":0},"numeroFinal":{"type":"integer","format":"int64","minimum":0},"justificativa":{"type":"string","minLength":1}},"required":["justificativa","numeroFinal","numeroInicial","serie"]},"Inutilizacao":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"emitenteId":{"type":"string","format":"uuid"},"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"serie":{"type":"string"},"numeroInicial":{"type":"integer","format":"int64"},"numeroFinal":{"type":"integer","format":"int64"},"justificativa":{"type":"string"},"homologada":{"type":"boolean"},"protocolo":{"type":"string"},"dataHoraRegistro":{"type":"string","format":"date-time"},"erros":{"type":"array","items":{"$ref":"#/components/schemas/ErroSefaz"}},"criadoEm":{"type":"string","format":"date-time"},"modelo":{"type":"string","enum":["NFE","NFCE"]}}},"CalculoNfeResponse":{"type":"object","properties":{"totais":{"$ref":"#/components/schemas/Totais"},"interestadual":{"type":"boolean"},"itens":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}}},"Item":{"type":"object","properties":{"numero":{"type":"integer","format":"int32"},"valorProduto":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"baseIcms":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIcms":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"baseSt":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorSt":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorFcp":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorFcpSt":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorCreditoSn":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorDifal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorFcpDifal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIpi":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorPis":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorCofins":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"baseIbsCbs":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIbsUf":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIbsMunicipal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorCbs":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"}}},"ItemPedidoNfce":{"type":"object","properties":{"produto":{"type":"string"},"codigo":{"type":"string"},"gtin":{"type":"string"},"descricao":{"type":"string"},"ncm":{"type":"string"},"cest":{"type":"string"},"cfop":{"type":"string"},"unidade":{"type":"string"},"quantidade":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorUnitario":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"desconto":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"informacoesAdicionais":{"type":"string"},"icms":{"$ref":"#/components/schemas/Icms"},"pis":{"$ref":"#/components/schemas/PisCofins"},"cofins":{"$ref":"#/components/schemas/PisCofins"},"ibsCbs":{"$ref":"#/components/schemas/IbsCbs"}}},"NfceRequest":{"type":"object","properties":{"serie":{"type":"string"},"naturezaOperacao":{"type":"string","maxLength":60,"minLength":0},"presenca":{"type":"string","enum":["NAO_SE_APLICA","PRESENCIAL","INTERNET","TELEATENDIMENTO","ENTREGA_DOMICILIO","PRESENCIAL_FORA_ESTABELECIMENTO","OUTROS"]},"consumidor":{"$ref":"#/components/schemas/Destinatario"},"itens":{"type":"array","items":{"$ref":"#/components/schemas/ItemPedidoNfce"},"maxItems":990,"minItems":0},"pagamentos":{"type":"array","items":{"$ref":"#/components/schemas/Pagamento"},"maxItems":100,"minItems":0},"informacoesAdicionais":{"$ref":"#/components/schemas/InformacoesAdicionais"}},"required":["itens"]},"Contingencia":{"type":"object","properties":{"em":{"type":"string","format":"date-time"},"justificativa":{"type":"string"},"prazoTransmissao":{"type":"string","format":"date-time"}}},"NfceResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["PENDENTE","PROCESSANDO","AUTORIZADA","REJEITADA","DENEGADA","CANCELADA","CONTINGENCIA"]},"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"serie":{"type":"string"},"numero":{"type":"integer","format":"int64"},"chaveAcesso":{"type":"string"},"protocolo":{"type":"string"},"dataEmissao":{"type":"string","format":"date-time"},"dataHoraAutorizacao":{"type":"string","format":"date-time"},"valorTotal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"totais":{"$ref":"#/components/schemas/Totais"},"erros":{"type":"array","items":{"$ref":"#/components/schemas/ErroSefaz"}},"criadoEm":{"type":"string","format":"date-time"},"atualizadoEm":{"type":"string","format":"date-time"},"tipoEmissao":{"type":"string","enum":["NORMAL","CONTINGENCIA_OFFLINE"]},"qrCode":{"type":"string"},"urlChave":{"type":"string"},"contingencia":{"$ref":"#/components/schemas/Contingencia"},"naturezaOperacao":{"type":"string"},"presenca":{"type":"string","enum":["NAO_SE_APLICA","PRESENCIAL","INTERNET","TELEATENDIMENTO","ENTREGA_DOMICILIO","PRESENCIAL_FORA_ESTABELECIMENTO","OUTROS"]},"consumidor":{"$ref":"#/components/schemas/Destinatario"},"itens":{"type":"array","items":{"$ref":"#/components/schemas/ItemNfe"}},"pagamentos":{"type":"array","items":{"$ref":"#/components/schemas/Pagamento"}},"informacoesAdicionais":{"$ref":"#/components/schemas/InformacoesAdicionais"},"regularizacao":{"type":"array","items":{"$ref":"#/components/schemas/Regularizacao"}}}},"Regularizacao":{"type":"object","properties":{"numero":{"type":"integer","format":"int64"},"chaveAcesso":{"type":"string"},"situacao":{"type":"string","enum":["PENDENTE","CANCELADA","INUTILIZADA"]}}},"CalculoNfceResponse":{"type":"object","properties":{"totais":{"$ref":"#/components/schemas/Totais"},"itens":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}}},"CertificadoInspecao":{"type":"object","properties":{"titular":{"type":"string"},"nomeTitular":{"type":"string"},"validoDe":{"type":"string","format":"date-time"},"validoAte":{"type":"string","format":"date-time"},"fingerprintSha256":{"type":"string"}}},"EntregaResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"evento":{"type":"string"},"documentoTipo":{"type":"string","enum":["NFE","NFCE","NFSE"]},"documentoId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["PENDENTE","ENTREGUE","FALHOU"]},"tentativas":{"type":"integer","format":"int32"},"proximoEnvio":{"type":"string","format":"date-time"},"ultimoHttpStatus":{"type":"integer","format":"int32"},"ultimoErro":{"type":"string"},"criadoEm":{"type":"string","format":"date-time"},"entregueEm":{"type":"string","format":"date-time"},"payload":{"type":"string"}}},"Ncm":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":"string"},"descricaoCompleta":{"type":"string"}}},"NcmPagina":{"type":"object","properties":{"vigencia":{"type":"string"},"itens":{"type":"array","items":{"$ref":"#/components/schemas/Ncm"}}}},"Classificacao":{"type":"object","properties":{"codigo":{"type":"string"},"descricao":{"type":"string"},"modelos":{"type":"array","items":{"type":"integer","format":"int32"},"uniqueItems":true}}},"SituacaoIbsCbs":{"type":"object","properties":{"cst":{"type":"string"},"descricao":{"type":"string"},"classificacoes":{"type":"array","items":{"$ref":"#/components/schemas/Classificacao"}}}},"AliquotasIbsCbs":{"type":"object","properties":{"inicio":{"type":"string","format":"date"},"fim":{"type":"string","format":"date"},"cbs":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"ibsUf":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"ibsMunicipal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"fundamento":{"type":"string"}}},"Cest":{"type":"object","properties":{"codigo":{"type":"string"},"segmento":{"type":"string"},"descricao":{"type":"string"},"ncmPrefixo":{"type":"string"}}},"Novidade":{"type":"object","properties":{"anexo":{"type":"string"},"arquivoEmUso":{"type":"string"},"arquivoPublicado":{"type":"string"},"url":{"type":"string","format":"uri"},"versao":{"type":"string"},"data":{"type":"string","format":"date"}}},"Novidades":{"type":"object","properties":{"verificadoEm":{"type":"string","format":"date-time"},"novidades":{"type":"array","items":{"$ref":"#/components/schemas/Novidade"}}}},"StatusServicoResponse":{"type":"object","properties":{"uf":{"type":"string","enum":["RO","AC","AM","RR","PA","AP","TO","MA","PI","CE","RN","PB","PE","AL","SE","BA","MG","ES","RJ","SP","PR","SC","RS","MS","MT","GO","DF"]},"modelo":{"type":"string","enum":["NFE","NFCE"]},"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"cStat":{"type":"string"},"xMotivo":{"type":"string"},"emOperacao":{"type":"boolean"},"tempoMedioSegundos":{"type":"integer","format":"int32"},"dataHoraRecebimento":{"type":"string","format":"date-time"},"dataHoraRetorno":{"type":"string","format":"date-time"},"observacao":{"type":"string"},"consultadoEm":{"type":"string","format":"date-time"}}},"PaginaResponseMercadoriaResponse":{"type":"object","properties":{"itens":{"type":"array","items":{"$ref":"#/components/schemas/MercadoriaResponse"}},"pagina":{"type":"integer","format":"int32"},"tamanho":{"type":"integer","format":"int32"},"totalItens":{"type":"integer","format":"int64"},"totalPaginas":{"type":"integer","format":"int32"}}},"GtinResponse":{"type":"object","properties":{"gtin":{"type":"string"},"tipoGtin":{"type":"string"},"descricao":{"type":"string"},"ncm":{"type":"string"},"cest":{"type":"string"},"cests":{"type":"array","items":{"type":"string"}}}},"PaginaResponseNfseResponse":{"type":"object","properties":{"itens":{"type":"array","items":{"$ref":"#/components/schemas/NfseResponse"}},"pagina":{"type":"integer","format":"int32"},"tamanho":{"type":"integer","format":"int32"},"totalItens":{"type":"integer","format":"int64"},"totalPaginas":{"type":"integer","format":"int32"}}},"Opcao":{"type":"object","properties":{"codigoServico":{"type":"string"},"codigoTributacaoMunicipal":{"type":"string"},"incidencia":{"type":"boolean"},"aliquota":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"vigenciaInicio":{"type":"string","format":"date"}}},"OpcoesTributacaoMunicipal":{"type":"object","properties":{"codigoMunicipio":{"type":"string"},"codigoTributacaoNacional":{"type":"string"},"competencia":{"type":"string","format":"date"},"opcoes":{"type":"array","items":{"$ref":"#/components/schemas/Opcao"}}}},"ResumoResponse":{"type":"object","properties":{"competencia":{"type":"string"},"quantidadeAutorizadas":{"type":"integer","format":"int64"},"valorServico":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorIss":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorLiquido":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"porStatus":{"type":"object","additionalProperties":{"type":"integer","format":"int64"}}}},"PaginaResponseNfeResponse":{"type":"object","properties":{"itens":{"type":"array","items":{"$ref":"#/components/schemas/NfeResponse"}},"pagina":{"type":"integer","format":"int32"},"tamanho":{"type":"integer","format":"int32"},"totalItens":{"type":"integer","format":"int64"},"totalPaginas":{"type":"integer","format":"int32"}}},"PaginaResponseNfceResponse":{"type":"object","properties":{"itens":{"type":"array","items":{"$ref":"#/components/schemas/NfceResponse"}},"pagina":{"type":"integer","format":"int32"},"tamanho":{"type":"integer","format":"int32"},"totalItens":{"type":"integer","format":"int64"},"totalPaginas":{"type":"integer","format":"int32"}}},"CscResponse":{"type":"object","properties":{"ambiente":{"type":"string","enum":["PRODUCAO","HOMOLOGACAO"]},"idToken":{"type":"string"}}},"ConsultaInscricaoEstadual":{"type":"object","properties":{"cnpj":{"type":"string"},"uf":{"type":"string","enum":["RO","AC","AM","RR","PA","AP","TO","MA","PI","CE","RN","PB","PE","AL","SE","BA","MG","ES","RJ","SP","PR","SC","RS","MS","MT","GO","DF"]},"inscricoes":{"type":"array","items":{"$ref":"#/components/schemas/InscricaoEstadual"}}}},"InscricaoEstadual":{"type":"object","properties":{"inscricao":{"type":"string"},"uf":{"type":"string","enum":["RO","AC","AM","RR","PA","AP","TO","MA","PI","CE","RN","PB","PE","AL","SE","BA","MG","ES","RJ","SP","PR","SC","RS","MS","MT","GO","DF"]},"ativa":{"type":"boolean"},"fonte":{"type":"string"},"regimeApuracao":{"type":"string"}}},"ContaResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"nome":{"type":"string"},"produtos":{"type":"array","items":{"type":"string","enum":["NFE","NFCE","NFSE"]}},"ativo":{"type":"boolean"},"plano":{"$ref":"#/components/schemas/PlanoResponse"}}},"PlanoResponse":{"type":"object","properties":{"codigo":{"type":"string"},"nome":{"type":"string"},"valorMensal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"notasIncluidas":{"type":"integer","format":"int32"},"valorNotaAdicional":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"maxEmitentes":{"type":"integer","format":"int32"},"recursos":{"type":"array","items":{"type":"string","enum":["API","WEBHOOK"]}}}},"PaginaResponseEntregaResponse":{"type":"object","properties":{"itens":{"type":"array","items":{"$ref":"#/components/schemas/EntregaResponse"}},"pagina":{"type":"integer","format":"int32"},"tamanho":{"type":"integer","format":"int32"},"totalItens":{"type":"integer","format":"int64"},"totalPaginas":{"type":"integer","format":"int32"}}},"UsoResponse":{"type":"object","properties":{"competencia":{"type":"string"},"plano":{"type":"string"},"notasIncluidas":{"type":"integer","format":"int32"},"notasUsadas":{"type":"integer","format":"int32"},"notasExcedentes":{"type":"integer","format":"int32"},"valorNotaAdicional":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorExcedenteEstimado":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"porProduto":{"type":"object","additionalProperties":{"type":"integer","format":"int32"}}}},"FaturaResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"contaId":{"type":"string","format":"uuid"},"competencia":{"type":"string"},"plano":{"type":"string"},"valorMensal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"notasIncluidas":{"type":"integer","format":"int32"},"notasUsadas":{"type":"integer","format":"int32"},"notasExcedentes":{"type":"integer","format":"int32"},"valorNotaAdicional":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorExcedente":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"valorTotal":{"type":"string","format":"decimal","example":"1234.50","pattern":"^-?\\d+(\\.\\d+)?$"},"fechadaEm":{"type":"string","format":"date-time"}}},"PaginaResponseClienteResponse":{"type":"object","properties":{"itens":{"type":"array","items":{"$ref":"#/components/schemas/ClienteResponse"}},"pagina":{"type":"integer","format":"int32"},"tamanho":{"type":"integer","format":"int32"},"totalItens":{"type":"integer","format":"int64"},"totalPaginas":{"type":"integer","format":"int32"}}},"Problema":{"type":"object","description":"Erro RFC 9457 (application/problem+json).","properties":{"campos":{"type":"array","items":{"type":"object","properties":{"campo":{"type":"string","example":"itens[0].icms.csosn"},"mensagem":{"type":"string"}}}},"title":{"type":"string"},"instance":{"type":"string"},"detail":{"type":"string"},"type":{"type":"string","format":"uri","example":"https://u2d.com.br/problemas/requisicao-invalida"},"status":{"type":"integer","format":"int32"}}}},"securitySchemes":{"jwt":{"type":"http","description":"Access token (ES256) do realm do Keycloak do ambiente, pedido por client_credentials com o client do integrador.","scheme":"bearer","bearerFormat":"JWT"},"keycloak":{"type":"oauth2","description":"Client do sistema integrador no Keycloak (client_credentials). Sandbox: realm u2d-nota-fiscal-sandbox.","flows":{"clientCredentials":{"tokenUrl":"https://auth.u2dtecnologia.com.br/realms/u2d-nota-fiscal/protocol/openid-connect/token","scopes":{}}}}}}}