API REST

API de geração de documentos

Gere documentos em PDF programaticamente. Envie um JSON com os dados e receba o arquivo pronto — ideal para integrar ao seu sistema, ERP ou fluxo de automação.

Autenticação

Crie uma chave de API na sua conta e envie-a no header Authorization:

Authorization: Bearer dfk_live_xxxxxxxxxxxxxxxx

Endpoint

POST https://meudocfacil.site/api/v1/documents

Parâmetros do corpo (JSON):

type — tipo do documento (obrigatório).
data — objeto com os dados do documento.
watermark — booleano (padrão false).

Tipos suportados:

orcamentoreciboproposta-comercialcontrato-de-prestacao-de-servicoordem-de-servicocardapiodeclaracaoprocuracaorecibo-de-aluguelcarta-de-cobranca

Exemplo com cURL

curl -X POST https://meudocfacil.site/api/v1/documents \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "orcamento",
    "watermark": false,
    "data": {
      "brand": { "name": "Minha Empresa", "document": "12.345.678/0001-90" },
      "client": { "name": "Cliente Exemplo" },
      "items": [
        { "description": "Serviço de exemplo", "quantity": 1, "unitPrice": 250.0 }
      ]
    }
  }' \
  --output orcamento.pdf

Exemplo com Node.js

const res = await fetch("https://meudocfacil.site/api/v1/documents", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DOCFACIL_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "recibo",
    data: { brand: { name: "Minha Empresa" }, amount: 150, payerName: "João" },
  }),
});
const pdf = Buffer.from(await res.arrayBuffer());
require("fs").writeFileSync("recibo.pdf", pdf);

Resposta

Em caso de sucesso, a resposta é o arquivo PDF (Content-Type: application/pdf). Erros retornam JSON com a chave error e o status HTTP correspondente (401 sem chave válida, 400 dados inválidos).

Os campos de data seguem os mesmos dos geradores. Veja os campos disponíveis usando o gerador de orçamento e os demais.