> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salvy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão geral

> Guias passo a passo que resolvem problemas reais da sua operação combinando endpoints da API da Salvy.

A [referência da API](/api-reference/v3/introduction) explica o que cada endpoint faz. As receitas mostram como combiná-los para resolver um problema de ponta a ponta, como bloquear as linhas de quem saiu da empresa ou ratear a fatura por centro de custo.

Cada receita traz:

* **O problema** que ela resolve e para quem é útil.
* **O que você precisa** antes de começar: tipo de chave e endpoints usados.
* **O passo a passo**, com uma requisição por etapa e o motivo de cada uma.
* **Um workflow do n8n** pronto para baixar e testar, sem precisar escrever código.
* **Cuidados e variações**, como paginação, reexecução segura e testes no sandbox.

<Tip>
  Todas as receitas usam a **v3** da API. Comece com uma chave de sandbox
  (`salvy_test_`) e só troque para produção depois de validar o fluxo. Veja
  [Ambientes](/api-reference/v3/environments).
</Tip>

## Pessoas e RH

<CardGroup cols={2}>
  <Card title="Admissão → colaborador + linha" icon="user-plus" href="/api-reference/v3/recipes/admission-create-line">
    Quando o RH admite alguém, cadastre o colaborador e peça a linha dele no
    mesmo centro de custo.
  </Card>

  <Card title="Desligamento → bloqueio de linhas" icon="user-minus" href="/api-reference/v3/recipes/offboarding-block-lines">
    Quando o RH desliga um colaborador, bloqueie automaticamente todas as linhas
    ativas dele.
  </Card>
</CardGroup>

## Financeiro

<CardGroup cols={2}>
  <Card title="Rateio de telecom por centro de custo" icon="chart-pie" href="/api-reference/v3/recipes/cost-center-allocation">
    Divida a fatura de telecom do mês por centro de custo, pronta para o
    lançamento contábil.
  </Card>

  <Card title="Fatura + NF-e para contas a pagar" icon="file-invoice" href="/api-reference/v3/recipes/invoice-nfe-accounts-payable">
    Baixe todo mês a fatura com boleto e Pix e os arquivos da NF-e, sem entrar
    no painel.
  </Card>
</CardGroup>

## Gestão de linhas

<CardGroup cols={2}>
  <Card title="Consumo de dados: maiores e menores" icon="chart-simple" href="/api-reference/v3/recipes/data-usage-ranking">
    Descubra quais linhas mais e menos consomem dados em relação à franquia do
    plano.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.