Pular para o conteúdo principal
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. 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 US10,00∗∗—ocompradorpagaportransfere^nciabancaˊria,queexigeumpisodeUS 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 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. 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. 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.