{"openapi":"3.1.0","info":{"title":"Reciba Agent API","version":"1.0.0","description":"Agentes preparam documentos (orçamento, recibo, fatura…) como rascunho; o humano revisa a prévia e emite (3 grátis, depois R$ 1 no Pix). Nenhuma emissão sem ação humana."},"servers":[{"url":"https://reciba.com.br"}],"paths":{"/api/agent/draft/orcamento":{"post":{"operationId":"criarRascunho_orcamento","summary":"Preparar Orçamento de serviço (rascunho — o humano revisa e emite)","description":"Serviços e materiais discriminados, total automático e validade. O clássico de quem fecha serviço. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prestadorNome":{"type":"string","description":"Seu nome ou o do seu negócio"},"prestadorDoc":{"type":"string","description":"Seu CPF ou CNPJ — Aparece no cabeçalho do orçamento. Pode deixar em branco."},"prestadorCidade":{"type":"string","description":"Sua cidade/UF"},"clienteNome":{"type":"string","description":"Nome do cliente"},"clienteTelefone":{"type":"string","description":"Telefone do cliente — Opcional."},"itens":{"type":"array","description":"Serviços e materiais — Descrição, quantidade e valor de cada item. O total sai sozinho.","items":{"type":"object","properties":{"descricao":{"type":"string","description":"Descrição"},"qtd":{"type":"string","description":"Qtd"},"valorUnit":{"type":"string","description":"Valor unitário em reais"}}}},"validade":{"type":"string","description":"Este orçamento vale até — Formato AAAA-MM-DD"},"condicoesPagamento":{"type":"string","description":"Condições de pagamento"},"prazoExecucao":{"type":"string","description":"Prazo de execução"},"observacoes":{"type":"string","description":"Observações — Opcional. Ex.: material por conta do cliente."}},"required":["prestadorNome","clienteNome","itens","validade","condicoesPagamento","prazoExecucao"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/ordem-servico":{"post":{"operationId":"criarRascunho_ordem_servico","summary":"Preparar Ordem de serviço (rascunho — o humano revisa e emite)","description":"Número automático, serviço descrito, peças e data agendada. Organiza o trabalho no papel. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clienteNome":{"type":"string","description":"Nome do cliente"},"enderecoServico":{"type":"string","description":"Endereço do serviço — Opcional. Onde o serviço vai ser feito."},"descricaoServico":{"type":"string","description":"Descrição do serviço"},"pecas":{"type":"array","description":"Peças e materiais — Opcional. O total sai sozinho.","items":{"type":"object","properties":{"descricao":{"type":"string","description":"Descrição"},"qtd":{"type":"string","description":"Qtd"},"valorUnit":{"type":"string","description":"Valor unitário em reais"}}}},"dataAgendada":{"type":"string","description":"Data agendada — Formato AAAA-MM-DD"},"responsavel":{"type":"string","description":"Responsável / técnico"},"observacoes":{"type":"string","description":"Observações — Opcional."}},"required":["clienteNome","descricaoServico","dataAgendada","responsavel"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/recibo-pagamento":{"post":{"operationId":"criarRascunho_recibo_pagamento","summary":"Preparar Recibo de pagamento (rascunho — o humano revisa e emite)","description":"Quem pagou, quanto e por quê — com o valor por extenso saindo sozinho. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recebedorNome":{"type":"string","description":"Quem recebeu (seu nome)"},"recebedorDoc":{"type":"string","description":"Seu CPF ou CNPJ — Opcional."},"pagadorNome":{"type":"string","description":"Quem pagou"},"pagadorDoc":{"type":"string","description":"CPF ou CNPJ de quem pagou — Opcional."},"valor":{"type":"string","description":"Valor recebido — O valor por extenso sai sozinho no recibo. — Valor em reais, ex.: \"1500,00\""},"referente":{"type":"string","description":"Referente a"},"formaPagamento":{"type":"string","enum":["Pix","Dinheiro","Cartão","Transferência","Outro"],"description":"Forma de pagamento"},"dataLocal":{"type":"string","description":"Data e local"}},"required":["recebedorNome","pagadorNome","valor","referente","formaPagamento","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/recibo-prestacao":{"post":{"operationId":"criarRascunho_recibo_prestacao","summary":"Preparar Recibo de prestação de serviço (rascunho — o humano revisa e emite)","description":"O recibo de quem prestou serviço: descrição do que foi feito + valor por extenso. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recebedorNome":{"type":"string","description":"Quem prestou o serviço (seu nome)"},"recebedorDoc":{"type":"string","description":"Seu CPF ou CNPJ — Opcional."},"pagadorNome":{"type":"string","description":"Quem pagou"},"pagadorDoc":{"type":"string","description":"CPF ou CNPJ de quem pagou — Opcional."},"descricaoServico":{"type":"string","description":"Serviço prestado"},"valor":{"type":"string","description":"Valor recebido — O valor por extenso sai sozinho no recibo. — Valor em reais, ex.: \"1500,00\""},"formaPagamento":{"type":"string","enum":["Pix","Dinheiro","Cartão","Transferência","Outro"],"description":"Forma de pagamento"},"garantia":{"type":"string","description":"Garantia do serviço — Opcional — vazia, não aparece no recibo."},"dataLocal":{"type":"string","description":"Data e local"}},"required":["recebedorNome","pagadorNome","descricaoServico","valor","formaPagamento","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/recibo-aluguel":{"post":{"operationId":"criarRascunho_recibo_aluguel","summary":"Preparar Recibo de aluguel (rascunho — o humano revisa e emite)","description":"Mês de referência, encargos discriminados e valor por extenso. Todo dia 5, pronto. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locadorNome":{"type":"string","description":"Locador (quem recebe o aluguel)"},"locadorDoc":{"type":"string","description":"CPF ou CNPJ do locador — Opcional."},"locatarioNome":{"type":"string","description":"Locatário (quem paga o aluguel)"},"enderecoImovel":{"type":"string","description":"Endereço do imóvel"},"competencia":{"type":"string","description":"Mês de referência — O mês do aluguel que este recibo cobre. — Formato AAAA-MM"},"valor":{"type":"string","description":"Valor do aluguel — O valor por extenso sai sozinho no recibo. — Valor em reais, ex.: \"1500,00\""},"encargos":{"type":"array","description":"Encargos discriminados — Opcional. Ex.: condomínio, IPTU, água.","items":{"type":"object","properties":{"descricao":{"type":"string","description":"Encargo"},"valor":{"type":"string","description":"Valor"}}}},"dataLocal":{"type":"string","description":"Data e local"}},"required":["locadorNome","locatarioNome","enderecoImovel","competencia","valor","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/proposta":{"post":{"operationId":"criarRascunho_proposta","summary":"Preparar Proposta comercial (rascunho — o humano revisa e emite)","description":"Apresentação, escopo em blocos, investimento e próximos passos. Fecha negócio. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"clienteNome":{"type":"string","description":"Pra quem é a proposta"},"apresentacao":{"type":"string","description":"Quem somos"},"escopo":{"type":"array","description":"O que a proposta cobre — Cada bloco tem um título e uma descrição.","items":{"type":"object","properties":{"titulo":{"type":"string","description":"Título"},"descricao":{"type":"string","description":"Descrição"}}}},"investimento":{"type":"array","description":"Investimento — Itens e valores. O total sai sozinho.","items":{"type":"object","properties":{"descricao":{"type":"string","description":"Descrição"},"qtd":{"type":"string","description":"Qtd"},"valorUnit":{"type":"string","description":"Valor unitário em reais"}}}},"condicoes":{"type":"string","description":"Condições"},"validade":{"type":"string","description":"Esta proposta vale até — Formato AAAA-MM-DD"},"proximosPassos":{"type":"string","description":"Próximos passos — Opcional. Ex.: aprovou? A gente agenda a visita técnica."}},"required":["clienteNome","apresentacao","escopo","investimento","condicoes","validade"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/fatura":{"post":{"operationId":"criarRascunho_fatura","summary":"Preparar Fatura simples (rascunho — o humano revisa e emite)","description":"A cobrança organizada: itens, total, vencimento e a chave Pix no papel. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cobradorNome":{"type":"string","description":"Quem cobra (seu nome ou o do seu negócio)"},"cobradorDoc":{"type":"string","description":"Seu CPF ou CNPJ — Opcional."},"clienteNome":{"type":"string","description":"Cliente (quem vai pagar)"},"clienteDoc":{"type":"string","description":"CPF ou CNPJ do cliente — Opcional."},"itens":{"type":"array","description":"O que está sendo cobrado — O total sai sozinho, somando os itens.","items":{"type":"object","properties":{"descricao":{"type":"string","description":"Descrição"},"qtd":{"type":"string","description":"Qtd"},"valorUnit":{"type":"string","description":"Valor unitário em reais"}}}},"vencimento":{"type":"string","description":"Vencimento — Formato AAAA-MM-DD"},"formaPagamento":{"type":"string","enum":["Pix","Transferência","Dinheiro","Cartão","Boleto"],"description":"Forma de pagamento"},"instrucoesPagamento":{"type":"string","description":"Instruções de pagamento — Opcional — a chave Pix ou os dados da conta, do jeito que o cliente precisa."},"dataLocal":{"type":"string","description":"Data e local"}},"required":["cobradorNome","clienteNome","itens","vencimento","formaPagamento","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/recibo-salario":{"post":{"operationId":"criarRascunho_recibo_salario","summary":"Preparar Recibo de salário (rascunho — o humano revisa e emite)","description":"O pagamento do mês, preto no branco: valor, competência e a assinatura de quem recebeu. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"empregadorNome":{"type":"string","description":"Quem paga (você ou sua empresa)"},"empregadorDoc":{"type":"string","description":"Seu CPF ou CNPJ — Opcional."},"empregadoNome":{"type":"string","description":"Quem recebe o salário"},"empregadoDoc":{"type":"string","description":"CPF de quem recebe — Opcional."},"valor":{"type":"string","description":"Valor líquido pago — O valor por extenso sai sozinho no recibo. — Valor em reais, ex.: \"1500,00\""},"competencia":{"type":"string","description":"Mês do salário (competência) — Formato AAAA-MM"},"formaPagamento":{"type":"string","enum":["Pix","Dinheiro","Transferência","Depósito"],"description":"Forma de pagamento"},"observacoes":{"type":"string","description":"Observações — Opcional — adiantamentos, descontos combinados, horas extras."},"dataLocal":{"type":"string","description":"Data e local"}},"required":["empregadorNome","empregadoNome","valor","competencia","formaPagamento","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/vale":{"post":{"operationId":"criarRascunho_vale","summary":"Preparar Vale (rascunho — o humano revisa e emite)","description":"Adiantou dinheiro? O vale registra quanto, pra quem e de onde desconta. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"concedenteNome":{"type":"string","description":"Quem dá o vale (você ou seu negócio)"},"concedenteDoc":{"type":"string","description":"Seu CPF ou CNPJ — Opcional."},"beneficiarioNome":{"type":"string","description":"Quem recebe o vale"},"beneficiarioDoc":{"type":"string","description":"CPF de quem recebe — Opcional."},"valor":{"type":"string","description":"Valor do vale — O valor por extenso sai sozinho. — Valor em reais, ex.: \"1500,00\""},"referente":{"type":"string","description":"Referente a"},"descontarDe":{"type":"string","description":"A descontar de — Opcional — de onde o valor será descontado."},"formaPagamento":{"type":"string","enum":["Pix","Dinheiro","Transferência"],"description":"Como foi pago"},"dataLocal":{"type":"string","description":"Data e local"}},"required":["concedenteNome","beneficiarioNome","valor","referente","formaPagamento","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/vale-transporte":{"post":{"operationId":"criarRascunho_vale_transporte","summary":"Preparar Comprovante de vale-transporte (rascunho — o humano revisa e emite)","description":"A entrega do vale-transporte do mês, com valor, competência e assinatura. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"empregadorNome":{"type":"string","description":"Empregador (você ou sua empresa)"},"empregadorDoc":{"type":"string","description":"Seu CPF ou CNPJ — Opcional."},"empregadoNome":{"type":"string","description":"Empregado(a) que recebe"},"empregadoDoc":{"type":"string","description":"CPF de quem recebe — Opcional."},"competencia":{"type":"string","description":"Mês do benefício (competência) — Formato AAAA-MM"},"valor":{"type":"string","description":"Valor total entregue — O valor por extenso sai sozinho. — Valor em reais, ex.: \"1500,00\""},"quantidade":{"type":"string","description":"Quantidade de passagens ou recargas — Opcional."},"formaEntrega":{"type":"string","description":"Como foi entregue — Opcional."},"dataLocal":{"type":"string","description":"Data e local"}},"required":["empregadorNome","empregadoNome","competencia","valor","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/romaneio":{"post":{"operationId":"criarRascunho_romaneio","summary":"Preparar Romaneio de entrega (rascunho — o humano revisa e emite)","description":"A lista da entrega: o que vai, quanto vai e quem confere no destino. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"remetenteNome":{"type":"string","description":"Quem envia (você ou sua empresa)"},"remetenteDoc":{"type":"string","description":"Seu CPF ou CNPJ — Opcional."},"destinatarioNome":{"type":"string","description":"Destinatário (quem recebe)"},"enderecoEntrega":{"type":"string","description":"Endereço de entrega — Opcional."},"itens":{"type":"array","description":"Itens da entrega — Descrição, quantidade e unidade (cx, un, m³…). Valores ficam na fatura.","items":{"type":"object","properties":{"descricao":{"type":"string","description":"Descrição"},"qtd":{"type":"string","description":"Qtd"},"unidade":{"type":"string","description":"Unidade"}}}},"motorista":{"type":"string","description":"Motorista ou responsável pelo transporte — Opcional."},"placa":{"type":"string","description":"Placa do veículo — Opcional."},"observacoes":{"type":"string","description":"Observações — Opcional."},"dataLocal":{"type":"string","description":"Data e local"}},"required":["remetenteNome","destinatarioNome","itens","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/declaracao-residencia":{"post":{"operationId":"criarRascunho_declaracao_residencia","summary":"Preparar Declaração de residência (rascunho — o humano revisa e emite)","description":"Comprove seu endereço na hora: autodeclaração na forma da Lei 7.115/83, verificável pelo QR. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"declaranteNome":{"type":"string","description":"Seu nome completo"},"declaranteDoc":{"type":"string","description":"Seu CPF — É o documento que identifica quem declara — a declaração afirma o endereço em seu nome."},"declaranteRg":{"type":"string","description":"RG — Opcional."},"endereco":{"type":"string","description":"Endereço completo"},"cidadeUf":{"type":"string","description":"Cidade e UF"},"cep":{"type":"string","description":"CEP — Opcional."},"desdeQuando":{"type":"string","description":"Mora lá desde — Opcional — dá contexto a quem confere."},"finalidade":{"type":"string","description":"Pra que vai usar — Opcional — algumas instituições pedem a finalidade escrita no texto."},"dataLocal":{"type":"string","description":"Data e local"}},"required":["declaranteNome","declaranteDoc","endereco","cidadeUf","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/declaracao-uniao-estavel":{"post":{"operationId":"criarRascunho_declaracao_uniao_estavel","summary":"Preparar Declaração de união estável (rascunho — o humano revisa e emite)","description":"Vocês dois declaram a convivência — pra plano de saúde, dependente e cadastros. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"declarante1Nome":{"type":"string","description":"Seu nome completo"},"declarante1Doc":{"type":"string","description":"Seu CPF"},"declarante2Nome":{"type":"string","description":"Nome completo de quem convive com você"},"declarante2Doc":{"type":"string","description":"CPF dele(a)"},"desdeQuando":{"type":"string","description":"Convivem desde — O início da convivência — mês e ano bastam."},"endereco":{"type":"string","description":"Endereço em que moram juntos"},"cidadeUf":{"type":"string","description":"Cidade e UF"},"finalidade":{"type":"string","description":"Pra que vão usar — Opcional — algumas instituições pedem a finalidade no texto."},"dataLocal":{"type":"string","description":"Data e local"}},"required":["declarante1Nome","declarante1Doc","declarante2Nome","declarante2Doc","desdeQuando","endereco","cidadeUf","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/declaracao-renda":{"post":{"operationId":"criarRascunho_declaracao_renda","summary":"Preparar Declaração de renda (rascunho — o humano revisa e emite)","description":"Autônomo declara a própria renda — pra aluguel, cadastro e crédito simples. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"declaranteNome":{"type":"string","description":"Seu nome completo"},"declaranteDoc":{"type":"string","description":"Seu CPF ou CNPJ — MEI pode declarar pelo CNPJ; autônomo sem empresa, pelo CPF."},"atividade":{"type":"string","description":"O que você faz"},"rendaMensal":{"type":"string","description":"Renda mensal média — O valor por extenso sai sozinho. — Valor em reais, ex.: \"1500,00\""},"periodo":{"type":"string","description":"Referente a que período — Opcional — dá lastro ao número."},"finalidade":{"type":"string","description":"Pra que vai usar — Opcional."},"dataLocal":{"type":"string","description":"Data e local"}},"required":["declaranteNome","declaranteDoc","atividade","rendaMensal","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/nota-promissoria":{"post":{"operationId":"criarRascunho_nota_promissoria","summary":"Preparar Nota promissória (rascunho — o humano revisa e emite)","description":"A promessa de pagamento com data marcada — o título clássico, pronto pra imprimir e assinar. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"emitenteNome":{"type":"string","description":"Quem promete pagar (você)"},"emitenteDoc":{"type":"string","description":"Seu CPF ou CNPJ"},"emitenteEndereco":{"type":"string","description":"Seu endereço"},"beneficiarioNome":{"type":"string","description":"A quem você vai pagar"},"beneficiarioDoc":{"type":"string","description":"CPF ou CNPJ de quem recebe — Opcional, mas ajuda a identificar sem dúvida."},"valor":{"type":"string","description":"Valor da promissória — O valor por extenso sai sozinho — requisito clássico do título. — Valor em reais, ex.: \"1500,00\""},"vencimento":{"type":"string","description":"Data do pagamento (vencimento) — Formato AAAA-MM-DD"},"pracaPagamento":{"type":"string","description":"Cidade onde será paga"},"numeroTitulo":{"type":"string","description":"Número do título — Opcional. Parcelou em várias promissórias? Numere: 1/4, 2/4…"},"dataLocal":{"type":"string","description":"Local e data de emissão"}},"required":["emitenteNome","emitenteDoc","emitenteEndereco","beneficiarioNome","valor","vencimento","pracaPagamento","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/draft/contrato-prestacao":{"post":{"operationId":"criarRascunho_contrato_prestacao","summary":"Preparar Contrato de prestação de serviços (rascunho — o humano revisa e emite)","description":"O combinado por escrito: objeto, valor, prazo e garantia — com aceite registrado. Cria um RASCUNHO com os campos informados e devolve o link de edição/prévia para entregar ao usuário. Nada é emitido nem cobrado por esta chamada.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contratadoNome":{"type":"string","description":"Você ou seu negócio (quem presta o serviço)"},"contratadoDoc":{"type":"string","description":"Seu CPF ou CNPJ — Opcional."},"contratanteNome":{"type":"string","description":"Quem contrata (cliente)"},"contratanteDoc":{"type":"string","description":"CPF ou CNPJ de quem contrata — Opcional."},"objeto":{"type":"string","description":"O serviço combinado"},"valor":{"type":"string","description":"Valor total do serviço — O valor por extenso sai sozinho. — Valor em reais, ex.: \"1500,00\""},"formaPagamento":{"type":"string","description":"Como será pago"},"prazoExecucao":{"type":"string","description":"Prazo de execução"},"garantia":{"type":"string","description":"Garantia do serviço — Opcional — vazia, a cláusula não aparece."},"observacoes":{"type":"string","description":"Outras condições combinadas — Opcional."},"dataLocal":{"type":"string","description":"Data e local"}},"required":["contratadoNome","contratanteNome","objeto","valor","formaPagamento","prazoExecucao","dataLocal"],"additionalProperties":false}}}},"responses":{"200":{"description":"Rascunho criado; devolve editarUrl para o usuário revisar e emitir."},"429":{"description":"Rate limit — tente mais tarde."}}}},"/api/agent/verificar/{codigo}":{"get":{"operationId":"verificarDocumento","summary":"Verificar a autenticidade de um documento do Reciba","description":"Recebe o código público (32 hex, do QR ou do link reciba.com.br/d/<codigo>) e devolve o resumo da verificação: emissão registrada, autenticação por e-mail confirmado e aceite da contraparte.","parameters":[{"name":"codigo","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{32}$"}}],"responses":{"200":{"description":"Resumo da verificação."},"404":{"description":"Código não encontrado."}}}}}}