> ## Documentation Index > Fetch the complete documentation index at: https://docs.caratuva.com/llms.txt > Use this file to discover all available pages before exploring further. # Faturamento > Crie, aprove, envie e reconcilie faturas pelo painel. Uma fatura na Caratuva é um pedido para cobrar um valor específico de um comprador específico. Cada fatura tem seu próprio ciclo de vida, sua própria trilha de auditoria e seu próprio link de pagamento hospedado. Você pode gerenciar faturas de duas formas: * **Pelo painel** — coberto neste guia. A Caratuva é seu sistema-fonte de faturas. * **Pelo seu ERP via API** — veja [Payment intents](/pt-BR/api-reference/payment-intents). Seu ERP guarda a fatura; a Caratuva cuida da cobrança. Ambos os caminhos produzem a mesma experiência para o comprador e os mesmos eventos de webhook. Escolha o que combina com sua operação. ## Ciclo de vida ``` draft → awaiting_approval → approved → awaiting_buyer → buyer_kyc_pending → buyer_kyc_approved → fx_quoted → on_ramp_pending → fiat_received → offramp_pending → settled ``` `settled` é o estado terminal de sucesso. Os estados terminais sem sucesso são `expired`, `cancelled` e `buyer_kyc_rejected`. `on_ramp_failed` e `offramp_failed` são falhas em andamento que podem ser repetidas, em vez de terminais. (Esta é uma visão simplificada; alguns status intermediários/de repetição foram omitidos.) ## Criando uma fatura No painel, vá em **Faturas** e clique em **Nova** para abrir o formulário de criação. ### Cabeçalho * **Comprador** — nome, e-mail, país. O e-mail é onde o convite do link de pagamento chega. Escolha com cuidado; enviar para o endereço errado significa começar de uma fatura nova. * **Moeda** — moeda do comprador (USD, EUR ou BRL). A Caratuva cota o câmbio para BRL automaticamente quando o comprador confirma. * **Valor** — quanto o comprador paga a você. Precisão de duas casas decimais. \*\*Faturas em USD devem ser de no mínimo US$ 10,00** — o comprador paga por transferência bancária, que exige um piso de US$ 10, então uma fatura menor em USD não pode ser paga online. * **Vencimento** *(opcional)* — a fatura expira automaticamente se não for paga até essa data. * **Referência / ID externo** *(opcional)* — seu número interno de pedido. Volta em todo webhook para o ERP reconciliar. ### Itens Adicione quantos itens quiser. Cada item tem descrição, quantidade, preço unitário e subtotal. Os itens aparecem literalmente na página de pagamento do comprador — servem para clareza dele, não para classificação fiscal (a Caratuva não valida NCM, HS ou códigos de origem aqui). ### Detalhes de exportação *(opcional)* O formulário também coleta campos específicos de exportação quando relevante: número da DU-E, referência do contrato de exportação, incoterm e porto de embarque. Eles ajudam seus próprios registros e a reconciliação. (Um bloco de "observações" de texto livre voltado ao comprador existe apenas na superfície de payment intents da API, não neste formulário do painel.) ### Salvar Salvar deixa a fatura em `draft`. Daqui você pode editar à vontade. Quando estiver satisfeito, clique em **Enviar para aprovação**. ## Aprovação (dupla aprovação / four-eyes) A Caratuva oferece uma regra de dupla aprovação (four-eyes) para desembolsos maiores. Sua organização pode definir um **limite de aprovação**: qualquer fatura cujo valor atinja ou ultrapasse esse limite é criada em `awaiting_approval`, e **o colega que a criou não pode aprová-la** — outro colega precisa fazê-lo. Faturas abaixo do limite (ou qualquer fatura se nenhum limite for definido) vão direto para `draft` e podem ser aprovadas pela mesma pessoa que as criou. É um controle de compliance deliberado, focado onde os valores são grandes o suficiente para importar. Quando uma fatura precisa de aprovação: 1. A fatura é criada em `awaiting_approval` em vez de `draft`. 2. Seus outros colegas são notificados de que há uma fatura aguardando. 3. Um colega diferente de quem criou abre a fatura, revisa e **aprova** ou **rejeita**. 4. A aprovação leva a fatura para `approved`. A rejeição leva para `cancelled` e registra o motivo. Se sua equipe é pequena, adicione um segundo colega para que faturas acima do limite tenham um aprovador separado — quem cria não pode aprovar a própria. Faturas acima do limite devem ser criadas pelo painel por uma pessoa, não via chave de API. ## Convidando o comprador Após aprovada, clique em **Convidar comprador**. A Caratuva envia por e-mail um magic link para a página de pagamento hospedada em `pay.caratuva.com`. A fatura vai para `awaiting_buyer`. Você também pode: * **Copiar o link** — enviar pelo seu canal (CRM, ERP, WhatsApp, etc.). O link é não-adivinhável, mas não confere acesso por si só — o login ainda exige o e-mail do comprador. * **Reenviar o convite** — para compradores que perderam o e-mail original. Há um limite por e-mail de comprador para evitar enchente de inbox. Veja [Links de pagamento](/pt-BR/payment-links) para o que o comprador vê a partir daqui. ## Acompanhando a liquidação A página de detalhe da fatura mostra a linha do tempo ao vivo de cada transição com timestamp. Os mesmos eventos também saem como webhooks; veja [Webhooks](/pt-BR/api-reference/webhooks). Dois estados importam mais para operação: * **`settled`** — os fundos chegaram à sua conta bancária brasileira registrada via PIX. Marque o pedido como pago nos seus sistemas downstream. * **`buyer_kyc_rejected`** — terminal: o comprador não passou na verificação de identidade. As falhas em andamento `on_ramp_failed` e `offramp_failed` podem ser repetidas, em vez de terminais; a página de detalhe mostra o motivo exato em cada caso. ## Cancelando uma fatura Você pode cancelar uma fatura até `fx_quoted`, inclusive — ou seja, a qualquer momento antes de o comprador financiar o on-ramp. A partir de `on_ramp_pending`, o pagamento do comprador já está em andamento e a fatura não pode mais ser cancelada; qualquer reversão acontece então pelos seus sistemas downstream. O cancelamento exige um motivo (texto livre). O comprador é avisado automaticamente que a fatura não pode mais ser paga. ## Editando após criação Uma fatura permanece editável enquanto está em `draft` ou `awaiting_approval`. Ela se torna imutável depois de **aprovada** — a fatura que você aprova é a fatura que o comprador paga. Se o comprador ou o valor estiver errado após a aprovação, cancele e crie uma nova. (Você também pode usar **Reatribuir comprador** na página de detalhe para mover uma fatura para outro comprador quando um fluxo de KYC fica travado.) ## Operações em lote A criação em lote é só pela API — veja [Payment intents](/pt-BR/api-reference/payment-intents). A visão de lista do painel não oferece exportação em massa no momento. ## Dicas * **Use o campo de referência / ID externo.** Mesmo que opere principalmente pelo painel, um ID externo estável facilita a reconciliação contábil depois. * **Defina vencimentos curtos.** Um vencimento de 7 dias mantém o contas a receber limpo e automatiza o follow-up. * **Teste no modo teste primeiro.** Um comprador novo no modo teste deixa você caminhar o fluxo todo e aprender o que seus compradores verão.