Pular para o conteúdo

Envio de correspondências pelo seu ERP

Conecte seu ERP, CRM ou sistema próprio à API e envie correspondências com os dados que já estão lá.

Contas novas ganham R$ 50 em créditos, o suficiente para 3 cartas simples.

curl https://api.cartaflow.com.br/v1/letters \
  -H "Authorization: Bearer $CARTAFLOW_API_KEY" \
  -H "Idempotency-Key: fatura-2026-10-0042" \
  -F "to[name]=Destinatário Exemplo" \
  -F "to[address_line1]=Rua Exemplo, 128" \
  -F "to[address_line2]=Ap. 52" \
  -F "to[district]=Centro" \
  -F "to[city]=São Paulo" \
  -F "to[state]=SP" \
  -F "to[cep]=01001-000" \
  -F "color=true" \
  -F "file=@fatura-outubro.pdf"
Exemplo ilustrativo da API, sujeito a mudanças antes do lançamento.

Por que integrar

Os endereços dos clientes, os contratos e as faturas já estão no seu sistema. Quando alguém precisa enviar uma correspondência, costuma exportar os dados, copiar o endereço, gerar o documento e imprimir por fora. É nessa cópia que aparecem os erros, como um CEP trocado ou um documento que vai para o cliente errado.

Com a integração, o próprio sistema manda o PDF e o endereço para a CartaFlow. O envio sai com os dados do cadastro e fica registrado junto com o cliente.

Mini PC branco com um envelope encostado

Como funciona com a CartaFlow

  1. Crie a chave de API

    No painel da CartaFlow. Guarde a chave no cofre de segredos do seu sistema, nunca no código.

  2. Ligue os campos

    Nome, endereço e CEP vêm do cadastro de clientes que você já tem.

  3. Crie o envio

    Uma requisição HTTP com o PDF e o destinatário, em qualquer linguagem.

  4. Guarde o retorno

    Salve o id do envio no registro do cliente para consultar a situação depois.

Um exemplo na prática

Por exemplo: uma empresa de manutenção de elevadores fatura pelo ERP, e parte dos clientes pediu a fatura impressa. No fechamento do mês, uma rotina do ERP separa as faturas desses clientes e chama a API da CartaFlow uma vez para cada uma.

O id de cada envio volta para o ERP e fica no cadastro do cliente. Quem do financeiro quiser saber se a fatura foi postada encontra a informação no próprio ERP.

{
  "id": "ltr_8Kq2wX4m",
  "object": "letter",
  "status": "received",
  "pages": 2,
  "to": {
    "name": "Destinatário Exemplo",
    "cep": "01001-000",
    "city": "São Paulo",
    "state": "SP"
  },
  "created_at": "2026-10-13T14:20:00Z"
}
Exemplo ilustrativo: o campo id identifica o envio nas consultas seguintes.

Formas comuns de integrar

A API funciona com qualquer sistema que consiga fazer requisições HTTP.

  • ERP

    Uma rotina no fechamento do faturamento cria os envios do período, um por cliente.

  • CRM

    Uma automação cria o envio quando o cliente muda de etapa, por exemplo quando a proposta vira contrato.

  • Sistema próprio

    O seu backend chama a API no momento do evento, como faria com qualquer outro serviço.

Por onde enviar e quanto custa

Envie pelo painel, sem programar, ou deixe o seu sistema enviar automaticamente pela API.

Painel

Também funciona

Pelo site, sem programar

Para testar um envio antes de integrar, ou para envios avulsos fora do sistema.

API

Mais indicado

Pelo seu sistema, automático

Os envios saem com os dados do cadastro, sem exportar nem copiar nada.

Quanto custa

Cada envio custa o valor por envio do seu plano, mais a mensalidade, se houver. O plano mais econômico depende de quantos envios você faz por mês: Avulso até 24 envios por mês, Essencial de 25 a 256 envios por mês, Profissional de 257 a 1.466 envios por mês e Escala a partir de 1.467 envios por mês.

Calcular meu plano

Perguntas frequentes

Veja todas as respostas em perguntas frequentes.

A CartaFlow funciona com qualquer ERP ou CRM?

A integração é feita pela API REST, então funciona com qualquer sistema que consiga fazer requisições HTTP, direto ou por uma ferramenta de automação.

Em quais linguagens posso usar a API?

Em qualquer linguagem com um cliente HTTP. Os exemplos desta página estão em cURL, Node.js e Python.

Como a API é autenticada?

Com uma chave de API enviada no cabeçalho Authorization, no formato Bearer. Você cria a chave no painel da CartaFlow.

Preciso de um desenvolvedor para integrar?

Para a integração pela API, sim, ou de uma ferramenta de automação que faça requisições HTTP. Sem integração, você faz os envios pelo painel.

Envie a primeira carta pelo seu sistema grátis.

Contas novas ganham R$ 50 em créditos, o suficiente para 3 cartas simples.