Fatura + NF-e para contas a pagar

​

O que você precisa

• Uma chave de API de empresa ou uma chave de organização. A receita só faz leituras, então a chave de organização funciona e traz as faturas de todas as empresas da organização de uma vez. Veja Chaves de API.
• O mês de referência das faturas, no formato AAAA-MM.

​

Passo a passo

curl -G "https://api.salvy.com.br/api/v3/invoices" \
  -H "Authorization: Bearer $SALVY_API_KEY" \
  --data-urlencode "monthYear=2026-08" \
  --data-urlencode "pageSize=200"

{
  "data": [
    {
      "id": "0198c2f1-3815-45b7-9e60-8e137cad845c",
      "companyId": "0198c2f1-3815-45b7-9e60-8e137cad8450",
      "status": "pending",
      "isLate": false,
      "amountCents": 174108,
      "dueDate": "2026-09-10",
      "referenceMonth": "2026-08"
    }
  ],
  "pagination": { "page": 1, "pageSize": 200, "totalCount": 1, "totalPages": 1 }
}

curl "https://api.salvy.com.br/api/v3/invoices/0198c2f1-3815-45b7-9e60-8e137cad845c" \
  -H "Authorization: Bearer $SALVY_API_KEY"

{
  "id": "0198c2f1-3815-45b7-9e60-8e137cad845c",
  "status": "pending",
  "amountCents": 174108,
  "dueDate": "2026-09-10",
  "items": [
    { "product": "telecom", "description": "Plano Salvy de Telefonia Móvel", "quantity": 1, "unitAmountCents": 140178 },
    { "product": "telecom", "description": "Cobranças não recorrentes", "quantity": 1, "unitAmountCents": 33930 }
  ],
  "nfe": { "number": 12345, "amountCents": 174108 }
}

curl "https://api.salvy.com.br/api/v3/invoices/0198c2f1-3815-45b7-9e60-8e137cad845c/pdf" \
  -H "Authorization: Bearer $SALVY_API_KEY" \
  -o fatura.pdf

curl "https://api.salvy.com.br/api/v3/invoices/0198c2f1-3815-45b7-9e60-8e137cad845c/nfe/pdf" \
  -H "Authorization: Bearer $SALVY_API_KEY" \
  -o nfe.pdf

curl "https://api.salvy.com.br/api/v3/invoices/0198c2f1-3815-45b7-9e60-8e137cad845c/nfe/xml" \
  -H "Authorization: Bearer $SALVY_API_KEY" \
  -o nfe.xml

​

Sem código: workflow do n8n

1. No n8n, crie um workflow e importe o arquivo (menu ⋯ > Import from File, ou cole o conteúdo do arquivo no editor).
2. Crie uma credencial Bearer Auth com a sua chave de API e selecione-a nos cinco nós HTTP.
3. Preencha o mesReferencia no nó Dados de teste e execute. Se deixar vazio, vale o mês anterior.
4. Conecte o destino dos arquivos depois dos nós finais: e-mail do contas a pagar, SFTP, Google Drive ou o seu ERP.
5. Para rodar todo mês, ative o workflow. As faturas são geradas no dia 1º de cada mês, e o nó Agenda mensal dispara no dia 5, às 8h, buscando o mês anterior. Os dias entre a geração e a agenda são uma margem para a fatura já estar disponível.

​

Como implementar

• Gatilho: uma rotina mensal. As faturas são geradas no dia 1º de cada mês; rodar no dia 5 dá margem para a fatura já estar disponível. Também dá para chamar o fluxo a partir do seu ERP.
• Destino dos arquivos: e-mail do contas a pagar, SFTP, uma pasta compartilhada ou a importação do seu ERP.
• Somente leitura: a receita não altera nada na Salvy, então pode ser executada quantas vezes for preciso.

​

Cuidados

​

Variações

• Só telecom. Adicione product=telecom na lista de faturas para ignorar as faturas de outros produtos da Salvy.
• Cobrar o que está em atraso. Filtre por isLate: true para montar um alerta de faturas vencidas e ainda abertas.
• Rateio por centro de custo. Para lançar o custo de telecom por centro de custo, use o detalhamento por linha da fatura em GET /api/v3/invoices/{id}/phone-accounts.