Para agentes de IA

Seu agente prepara. Seu usuário emite.

O Reciba tem uma API aberta para agentes de IA (ChatGPT, Claude, Gemini e afins) prepararem documentos de serviço a pedido de um humano: o agente preenche o rascunho com os dados da conversa e entrega o link; o usuário revisa a prévia completa e emite — 3 documentos grátis pra testar, depois R$ 1 no Pix, com a logo dele e sem cadastro.

Por que o agente não emite sozinho?

Porque o valor do documento está na cadeia de confiança: assinatura eletrônica com e-mail confirmado, registro com data/hora e IP, e QR de verificação pública, na forma do art. 10, §2º, da MP 2.200-2/2001. Essa cadeia começa num ato humano — e é exatamente isso que faz o documento valer alguma coisa quando chega na outra parte. Emissão automática em massa destruiria o que o seu usuário está comprando.

Endpoints

  • GET /api/agent — doc viva em JSON (política + tipos).
  • GET /api/agent/openapi.json — OpenAPI 3.1, um POST /api/agent/draft/{tipo} por tipo, com o schema de campos derivado do próprio motor.
  • POST /api/agent/draft/{tipo} — cria o rascunho e devolve editarUrl (entregue ao usuário; o link é a credencial dele).
  • GET /api/agent/verificar/{codigo} — verificação de autenticidade pelo código do QR/link: emissão registrada, e-mail confirmado, aceite da contraparte. Aberta, sem chave.

Os 16 tipos de documento

  • Orçamento de serviço (orcamento) — Serviços e materiais discriminados, total automático e validade. O clássico de quem fecha serviço.
  • Ordem de serviço (ordem-servico) — Número automático, serviço descrito, peças e data agendada. Organiza o trabalho no papel.
  • Recibo de pagamento (recibo-pagamento) — Quem pagou, quanto e por quê — com o valor por extenso saindo sozinho.
  • Recibo de prestação de serviço (recibo-prestacao) — O recibo de quem prestou serviço: descrição do que foi feito + valor por extenso.
  • Recibo de aluguel (recibo-aluguel) — Mês de referência, encargos discriminados e valor por extenso. Todo dia 5, pronto.
  • Proposta comercial (proposta) — Apresentação, escopo em blocos, investimento e próximos passos. Fecha negócio.
  • Fatura simples (fatura) — A cobrança organizada: itens, total, vencimento e a chave Pix no papel.
  • Recibo de salário (recibo-salario) — O pagamento do mês, preto no branco: valor, competência e a assinatura de quem recebeu.
  • Vale (vale) — Adiantou dinheiro? O vale registra quanto, pra quem e de onde desconta.
  • Comprovante de vale-transporte (vale-transporte) — A entrega do vale-transporte do mês, com valor, competência e assinatura.
  • Romaneio de entrega (romaneio) — A lista da entrega: o que vai, quanto vai e quem confere no destino.
  • Declaração de residência (declaracao-residencia) — Comprove seu endereço na hora: autodeclaração na forma da Lei 7.115/83, verificável pelo QR.
  • Declaração de união estável (declaracao-uniao-estavel) — Vocês dois declaram a convivência — pra plano de saúde, dependente e cadastros.
  • Declaração de renda (declaracao-renda) — Autônomo declara a própria renda — pra aluguel, cadastro e crédito simples.
  • Nota promissória (nota-promissoria) — A promessa de pagamento com data marcada — o título clássico, pronto pra imprimir e assinar.
  • Contrato de prestação de serviços (contrato-prestacao) — O combinado por escrito: objeto, valor, prazo e garantia — com aceite registrado.

Regras da casa

  • Rascunho é grátis e sem chave — o mesmo poder do wizard público, com rate limit por IP.
  • Nenhum e-mail é enviado pelo fluxo de agente; nenhuma cobrança acontece via API.
  • O editarUrl é a credencial do documento: entregue só ao usuário atendido.
  • Rascunhos abandonados são podados; documento emitido tem link permanente.

Descoberta: /llms.txt. Dúvidas ou volume maior: [email protected].